{"id":202017,"date":"2024-09-09T10:03:02","date_gmt":"2024-09-09T10:03:02","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/nbp-archive\/"},"modified":"2025-02-10T18:18:45","modified_gmt":"2025-02-10T18:18:45","slug":"archive-nbp","status":"publish","type":"plugin","link":"https:\/\/pap-aw.wordpress.org\/plugins\/archive-nbp\/","author":23113395,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.1","stable_tag":"1.1","tested":"6.7.5","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"Archive NBP","header_author":"Ihar Dounar","header_description":"NBP exchange rates archive.","assets_banners_color":"","last_updated":"2025-02-10 18:18:45","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/wpdv.eu","header_plugin_uri":"","header_author_uri":"https:\/\/wpdv.eu","rating":0,"author_block_rating":0,"active_installs":0,"downloads":844,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0":{"tag":"1.0","author":"igvar","date":"2024-09-09 11:16:06"},"1.1":{"tag":"1.1","author":"igvar","date":"2025-02-10 18:18:45"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3148618,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":{"anbp-blocks\/currency-chart":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"anbp-blocks\/currency-chart","version":"1.1","title":"Currency Chart","category":"archive-nbp","icon":"chart-line","description":"Currency Chart Block for Archive NBP plugin","example":{},"attributes":{"currency":{"type":"string","default":"2"},"date_begin":{"type":"string","default":"2002-01-01"},"date_end":{"type":"string","default":"2100-01-01"}},"supports":{"html":false,"color":{"background":true,"text":true}},"textdomain":"archive-nbp","editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css","style":"file:.\/style-index.css","render":"file:.\/render.php","viewScript":"file:.\/view.js"},"anbp-blocks\/currency-converter":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"anbp-blocks\/currency-converter","version":"1.1","title":"Currency Converter","category":"archive-nbp","icon":"calculator","description":"Currency Converter Block for Archive NBP plugin","example":{},"attributes":{"selectedCurrencies":{"type":"array","default":[]}},"supports":{"html":false,"color":{"background":true,"text":true}},"textdomain":"archive-nbp","editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css","style":"file:.\/style-index.css","render":"file:.\/render.php","viewScript":"file:.\/view.js"},"anbp-blocks\/last-rates":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"anbp-blocks\/last-rates","version":"1.1","title":"Last Rates","category":"archive-nbp","icon":"list-view","description":"Last Rates Block for Archive NBP plugin","example":{},"attributes":{"selectedCurrencies":{"type":"array","default":[]},"rateDate":{"type":"string","default":"2100-01-01"}},"supports":{"html":false,"color":{"background":true,"text":true}},"textdomain":"archive-nbp","editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css","style":"file:.\/style-index.css","render":"file:.\/render.php","viewScript":"file:.\/view.js"}},"tagged_versions":["1.0","1.1"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3148571,"resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3148571,"resolution":"2","location":"assets","locale":""},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":3148571,"resolution":"3","location":"assets","locale":""},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":3148571,"resolution":"4","location":"assets","locale":""},"screenshot-5.jpg":{"filename":"screenshot-5.jpg","revision":3148571,"resolution":"5","location":"assets","locale":""},"screenshot-6.jpg":{"filename":"screenshot-6.jpg","revision":3148571,"resolution":"6","location":"assets","locale":""},"screenshot-7.jpg":{"filename":"screenshot-7.jpg","revision":3148571,"resolution":"7","location":"assets","locale":""}},"screenshots":{"1":"List of available Gutenberg blocks.","2":"Archive NBP Currency Chart Block (admin area).","3":"Archive NBP Currency Chart Block (public area).","4":"Archive NBP Currency Rates Block (admin area).","5":"Archive NBP Currency Rates Block (public area).","6":"Archive NBP Currency Converter Block (admin area).","7":"Archive NBP Currency Converter Block (public area)."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1445,21292,231479,231480,231478],"plugin_category":[],"plugin_contributors":[231481],"plugin_business_model":[],"class_list":["post-202017","plugin","type-plugin","status-publish","hentry","plugin_tags-archive","plugin_tags-exchange-rates","plugin_tags-kursy-walut","plugin_tags-narodowy-bank-polski","plugin_tags-nbp","plugin_contributors-igvar","plugin_committers-igvar"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/archive-nbp\/assets\/icon-256x256.png?rev=3148618","icon_2x":"https:\/\/ps.w.org\/archive-nbp\/assets\/icon-256x256.png?rev=3148618","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/archive-nbp\/assets\/screenshot-1.jpg?rev=3148571","caption":"List of available Gutenberg blocks."},{"src":"https:\/\/ps.w.org\/archive-nbp\/assets\/screenshot-2.jpg?rev=3148571","caption":"Archive NBP Currency Chart Block (admin area)."},{"src":"https:\/\/ps.w.org\/archive-nbp\/assets\/screenshot-3.jpg?rev=3148571","caption":"Archive NBP Currency Chart Block (public area)."},{"src":"https:\/\/ps.w.org\/archive-nbp\/assets\/screenshot-4.jpg?rev=3148571","caption":"Archive NBP Currency Rates Block (admin area)."},{"src":"https:\/\/ps.w.org\/archive-nbp\/assets\/screenshot-5.jpg?rev=3148571","caption":"Archive NBP Currency Rates Block (public area)."},{"src":"https:\/\/ps.w.org\/archive-nbp\/assets\/screenshot-6.jpg?rev=3148571","caption":"Archive NBP Currency Converter Block (admin area)."},{"src":"https:\/\/ps.w.org\/archive-nbp\/assets\/screenshot-7.jpg?rev=3148571","caption":"Archive NBP Currency Converter Block (public area)."}],"raw_content":"<!--section=description-->\n<p>This plugin collect and allow to view historical currency rates from Bank of Poland by using custom Gutenberg Blocks, shortcodes and REST API. \nThe plugin use Narodowy Bank Polski public API for collecting the rates.\nEndpoint: https:\/\/api.nbp.pl\/api\/exchangerates\/tables\/a\nBank of Poland API description and terms of use: https:\/\/api.nbp.pl\/en.html\nAfter plugin installation your site will provide Bank of Poland historical data using your local database and directly from your domain as REST API service (see FAQ about endpoints).<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to your \/wp-content\/plugins\/ folder.<\/li>\n<li>Go to the <strong>Plugins<\/strong> page and activate the plugin.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='which%20api%20endpoints%20can%20i%20use%20after%20installation'><h3>Which API endpoints can I use after installation<\/h3><\/dt>\n<dd><ol>\n<li>List of currencies rates for available needed date and date before it. \nExample: https:\/\/your-domain-name.com\/wp-json\/archive-nbp\/v1\/date-rates\/YYYY-MM-DD\/AAA,BBB\nWhere: YYYY - year; MM-month; DD-day; AAA,BBB -  ISO 4217 currency codes, for example - USD,EUR <\/li>\n<li>List of rates for needed currency and dates range.\nExample: https:\/\/your-domain-name.com\/wp-json\/archive-nbp\/v1\/currencies-period\/YYYY-MM-DD\/YYYY-MM-DD\/AAA\nWhere: YYYY - year; MM-month; DD-day; AAA,BBB -  ISO 4217 currency code, for example - USD<\/li>\n<\/ol><\/dd>\n<dt id='which%20gutenberg%20blocks%20can%20i%20use%20after%20installation'><h3>Which Gutenberg Blocks can I use after installation<\/h3><\/dt>\n<dd><ol>\n<li>Currency Chart - show rates for needed currency and dates range as a chart. If you want to have the last available date on the chart always then set Date end parameter far in the future.<\/li>\n<li>Last Rates - show rates for needed date. Set the date far in the future if you want to show last rates always.<\/li>\n<li>Currency Converter - allow to calculate any amount in different currencies using last available rates in the table.<\/li>\n<\/ol><\/dd>\n<dt id='currency%20chart%20shortcode%20using'><h3>Currency Chart shortcode using<\/h3><\/dt>\n<dd><p>Currency Chart - show rates for needed currency and dates range as a chart. If you want to have the last available date on the chart always then set Date end parameter far in the future.\nAllowed parameters:\n- \"date_begin\" (YYYY-MM-DD).\n- \"date_end\" (YYYY-MM-DD). If you want to have the last available date on the chart always then set this parameter far in the future.\n- \"currency\" (3 symb ISO from the list - 'USD','EUR','AUD','HKD','CAD','NZD','SGD','HUF','CHF','GBP','UAH','JPY','CZK','DKK','ISK','NOK','SEK','RON','BGN','TRY','ILS','CLP','PHP','MXN','ZAR','BRL','MYR','IDR','THB','INR','KRW','CNY','XDR')<\/p>\n\n<p><strong>Examples of use:<\/strong><\/p>\n\n<p><strong>[anbp_currency_chart]<\/strong> - Will show the whole available period chart for default currency - USD.\n<strong>[anbp_currency_chart date_begin=\"2024-01-01\" date_end=\"2100-01-01\" currency=\"EUR\"]<\/strong> - Will show the chart from 2024-01-01 till last available date for currency - EUR.<\/p><\/dd>\n<dt id='last%20rates%20shortcode%20using'><h3>Last Rates shortcode using<\/h3><\/dt>\n<dd><p>Last Rates - show rates for needed date. Set the date far in the future if you want to show last rates always.\nAllowed parameters:\n- \"currencies\". The coma separated 3 symbols ISO list of currencies. Available currencies - ('USD','EUR','AUD','HKD','CAD','NZD','SGD','HUF','CHF','GBP','UAH','JPY','CZK','DKK','ISK','NOK','SEK','RON','BGN','TRY','ILS','CLP','PHP','MXN','ZAR','BRL','MYR','IDR','THB','INR','KRW','CNY','XDR').\n- \"date\" (YYYY-MM-DD). Set this parameter far in the future if you want to have the last available date always.<\/p>\n\n<p><strong>Examples of use:<\/strong><\/p>\n\n<p><strong>[anbp_last_rates]<\/strong> - Will show the table with list of all available in the plugin currencies for last available date in database. \n<strong>[anbp_last_rates currencies=\"EUR, USD, GBP\" date=\"2025-02-10\"]<\/strong> - Will show the table of rates for 3 currencies EUR, USD, GBP for 2025-02-10 or last available date in the DB.<\/p><\/dd>\n<dt id='currency%20converter%20shortcode%20using'><h3>Currency Converter shortcode using<\/h3><\/dt>\n<dd><p>Currency Converter - allow to calculate any amount in different currencies using last available rates in the table.\nAllowed parameters:\n- \"currencies\". The coma separated 3 symbols ISO list of currencies. Available currencies - ('USD','EUR','AUD','HKD','CAD','NZD','SGD','HUF','CHF','GBP','UAH','JPY','CZK','DKK','ISK','NOK','SEK','RON','BGN','TRY','ILS','CLP','PHP','MXN','ZAR','BRL','MYR','IDR','THB','INR','KRW','CNY','XDR').<\/p>\n\n<p><strong>Examples of use:<\/strong><\/p>\n\n<p><strong>[anbp_currency_converter]<\/strong> - The calculation list will include all currencies available in the system.\n<strong>[anbp_currency_converter currencies=\"EUR, USD, GBP\"]<\/strong> - The calculation list will include only 3 currencies from the list EUR, USD, GBP and PLN as a base currency.<\/p><\/dd>\n<dt id='are%20any%20translation%20available%20for%20the%20plugin%3F'><h3>Are any translation available for the plugin?<\/h3><\/dt>\n<dd><p>Plugin support 2 languages: <strong>English<\/strong> and <strong>Polish<\/strong>.<\/p><\/dd>\n<dt id='how%20to%20uninstall%20the%20plugin%3F'><h3>How to uninstall the plugin?<\/h3><\/dt>\n<dd><p>Simply deactivate and delete the plugin.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1<\/h4>\n\n<ul>\n<li>Adding shortcodes for each blocks. <\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Plugin released.<\/li>\n<\/ul>","raw_excerpt":"A WordPress plugin to display Bank of Poland currencies rates. Allow to view rates as Gutenberg blocks, shortcodes or REST API endpoints from the DB.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/202017","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=202017"}],"author":[{"embeddable":true,"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/igvar"}],"wp:attachment":[{"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=202017"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=202017"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=202017"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=202017"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=202017"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pap-aw.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=202017"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}