{"id":19620701,"url":"https://github.com/vllur/kurs_nbp","last_synced_at":"2026-04-03T10:32:44.533Z","repository":{"id":179503584,"uuid":"196146787","full_name":"vllur/kurs_nbp","owner":"vllur","description":"Drupal 8 module for fetching exchange rates from NBP.","archived":false,"fork":false,"pushed_at":"2023-02-04T09:42:49.000Z","size":74,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-05T05:51:12.229Z","etag":null,"topics":["currency-exchange-rates","drupal-module"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vllur.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-07-10T06:38:19.000Z","updated_at":"2023-04-04T04:50:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"24a2e358-2ddb-4df3-9406-3f31a3571565","html_url":"https://github.com/vllur/kurs_nbp","commit_stats":null,"previous_names":["vllur/kurs_nbp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vllur%2Fkurs_nbp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vllur%2Fkurs_nbp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vllur%2Fkurs_nbp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vllur%2Fkurs_nbp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vllur","download_url":"https://codeload.github.com/vllur/kurs_nbp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251246187,"owners_count":21558759,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["currency-exchange-rates","drupal-module"],"created_at":"2024-11-11T11:19:43.038Z","updated_at":"2026-04-03T10:32:44.502Z","avatar_url":"https://github.com/vllur.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kurs NBP\n`kurs_nbp` is a simple Drupal 8 module for fetching exchange rates from NBP (Narodowy Bank Polski).\n\n![Kurs NPB block](img/README.md/0.png)\n\nIt provides customizable block for displaying selected exchange rates.\n\n\n## Installation\nTo install the module, follow these steps:\n1. [Download](https://github.com/vllur/kurs_nbp/archive/master.zip) latest .zip (or .tar.gz) archive.\n1. In your Drupal website, go to `Manage \u003e Extend \u003e Install new module`.\n1. Drag the archive file on the `Browse...` button or select it by file dialogue.\n1. Click `install`.\n1. Navigate to `Manage \u003e Extend` and type in the search box \"Kurs NBP\".\n1. Check the box near the module name, and click `Install`.\n\nNow you can start using it. If you got stuck on anything, check the [Troubleshooting]() section of this readme.\n\nTo uninstall the module, go to `Manage \u003e Extend`, select \"Uninstall\" tab and remove it.\n\nFor complete removal you can delete the `kurs_nbp` (or `kurs_nbp-master`) directory from your Drupal installation - you can probably find it in `htdocs/modules`.\n\n\n## Usage\nAfter a succesful installation, you can make use of the new 'Kurs NBP' block in your website.\n\nTo do this, navigate to `Manage \u003e Structure \u003e Block layout` and press `Place block` button near the name of section where you want to put your block.\n\nNow find \"Kurs NBP\" block and press `Place block` near it - a popup will show up, allowing you to manipulate the properties of this block instance - see [Variables]() below.\n\nAfter you have done configuring, press `Save block`. Now you can go back to home page of your site and see the exchange rates.\n\nFor now, you an place as many blocks as you want, however they will share the same style - different currencies works fine.\n\n### Variables\nTo customize your block, you can modify the default values of the currencies and style fields.\n\n![Drupal block settings](img/README.md/1.png)\n\n#### Currencies\n*Type space separated currencies. Default: \"USD EUR\"*\n\nThis field can be feed with any number of vaild three letter currency names, case insensitive.\n\n#### Style\n*Choose between \"light\" or \"dark\". Default: \"dark\"*\n\nThis field takes only two strings - 'light' or 'dark'. It changes the color scheme of all 'Kurs NBP' blocks if all of them have the same setting.\n\n![Dark style](img/README.md/2.png)\n![Light style](img/README.md/3.png)\n\n\n## Files\n`src/Plugin/Block/KursBlock.php` is the main source file. It contains logic of both input and output, as well as manipulating the data.\n\n`config/install/kurs.nbp.settings.yml` is holding the default values for user input.\n\n`css/` directory contains all styling.\n\n`css/KursBlock.css` - here you can find all styling, except the colors.\n\n`css/dark.css` - colors for the dark style.\n\n`css/light.css` - colors for the light style.\n\n\n## Troubleshooting\nIf something goes wrong, follow these steps:\n - clear all cache - you can do it either from the admin panel (`Configuration \u003e Development \u003e Performance`, `Clear all caches` button), or via drush (`drush cr`)\n - uninstall module, clear the cache and install it again\n\nIf it does not solve your problem, feel free to post an [issue](https://github.com/vllur/kurs_nbp/issues/new) describing the situation.\n\n\n## Contributing\nIf you have an idea or you have found a bug, open an [issue](https://github.com/vllur/kurs_nbp/issues/new).\n\n\n## License\nThis repository and its content are under the terms of MIT license. See [LICENSE](LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvllur%2Fkurs_nbp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvllur%2Fkurs_nbp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvllur%2Fkurs_nbp/lists"}