{"id":398784,"date":"2026-11-05T22:10:31","date_gmt":"2026-11-05T22:10:31","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/allratestoday-currency-converter\/"},"modified":"2026-11-05T22:11:18","modified_gmt":"2026-11-05T22:11:18","slug":"allratestoday-currency-converter","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/allratestoday-currency-converter\/","author":23599208,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.4","requires":"6.3","requires_php":"7.4","requires_plugins":null,"header_name":"AllRatesToday Currency Converter","header_author":"AllRatesToday","header_description":"Free currency converter and official central-bank exchange rate widgets. Blocks and shortcodes, no API key needed.","assets_banners_color":"","last_updated":"2026-11-05 22:11:18","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/allratestoday.com\/widget\/","header_author_uri":"https:\/\/allratestoday.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":41,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"chathurangac8","date":"2026-11-05 22:11:18","revision":3786815}},"upgrade_notice":{"1.0.0":"<p>First release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3786820,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3786820,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3786820,"resolution":false,"location":"assets","locale":false}},"assets_banners":[],"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3786869,"resolution":false,"location":"assets","locale":"","contents":"{\"$schema\":\"https:\\\/\\\/playground.wordpress.net\\\/blueprint-schema.json\",\"meta\":{\"title\":\"AllRatesToday Currency Converter demo\",\"description\":\"A sample page with the Currency Converter and Official Exchange Rate blocks.\",\"author\":\"chathurangac8\"},\"landingPage\":\"\\\/\",\"preferredVersions\":{\"php\":\"8.3\",\"wp\":\"latest\"},\"login\":true,\"steps\":[{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"allratestoday-currency-converter\"},\"options\":{\"activate\":true}},{\"step\":\"setSiteOptions\",\"options\":{\"blogname\":\"Currency Converter Demo\",\"blogdescription\":\"AllRatesToday Currency Converter plugin\",\"artcc_show_credit\":\"1\"}},{\"step\":\"runPHP\",\"code\":\"<?php\\nrequire_once 'wordpress\\\/wp-load.php';\\n$content = '<!-- wp:paragraph --><p>This page shows the two blocks the plugin adds. Edit the page to change the currencies, or add the blocks to any other post.<\\\/p><!-- \\\/wp:paragraph -->'\\n\\t. '<!-- wp:heading --><h2 class=\\\"wp-block-heading\\\">Currency Converter<\\\/h2><!-- \\\/wp:heading -->'\\n\\t. '<!-- wp:paragraph --><p>Without an API key the converter uses the European Central Bank reference rates.<\\\/p><!-- \\\/wp:paragraph -->'\\n\\t. '<!-- wp:allratestoday\\\/converter {\\\"base\\\":\\\"USD\\\",\\\"target\\\":\\\"EUR\\\",\\\"amount\\\":100} \\\/-->'\\n\\t. '<!-- wp:heading --><h2 class=\\\"wp-block-heading\\\">Official Exchange Rate<\\\/h2><!-- \\\/wp:heading -->'\\n\\t. '<!-- wp:paragraph --><p>One currency pair as the central bank published it, with the publication date.<\\\/p><!-- \\\/wp:paragraph -->'\\n\\t. '<!-- wp:allratestoday\\\/official-rate {\\\"bank\\\":\\\"ecb\\\",\\\"source\\\":\\\"USD\\\",\\\"target\\\":\\\"EUR\\\"} \\\/-->'\\n\\t. '<!-- wp:allratestoday\\\/official-rate {\\\"bank\\\":\\\"boe\\\",\\\"source\\\":\\\"GBP\\\",\\\"target\\\":\\\"USD\\\"} \\\/-->'\\n\\t. '<!-- wp:heading --><h2 class=\\\"wp-block-heading\\\">Shortcode<\\\/h2><!-- \\\/wp:heading -->'\\n\\t. '<!-- wp:paragraph --><p>The same converter from a shortcode, in the dark theme:<\\\/p><!-- \\\/wp:paragraph -->'\\n\\t. '<!-- wp:shortcode -->[allratestoday_converter base=\\\"GBP\\\" target=\\\"JPY\\\" amount=\\\"50\\\" theme=\\\"dark\\\"]<!-- \\\/wp:shortcode -->';\\n$page_id = wp_insert_post( array(\\n\\t'post_title'   => 'Currency Converter Demo',\\n\\t'post_name'    => 'currency-converter-demo',\\n\\t'post_content' => $content,\\n\\t'post_status'  => 'publish',\\n\\t'post_type'    => 'page',\\n) );\\nupdate_option( 'show_on_front', 'page' );\\nupdate_option( 'page_on_front', $page_id );\\n\"}]}"}},"all_blocks":{"allratestoday\/converter":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"allratestoday\/converter","version":"1.0.0","title":"Currency Converter","category":"widgets","icon":"money-alt","description":"Live currency converter. Free ECB reference rates, or real-time rates with an AllRatesToday API key.","keywords":["currency","exchange rate","converter","forex"],"textdomain":"allratestoday-currency-converter","attributes":{"base":{"type":"string","default":"USD"},"target":{"type":"string","default":"EUR"},"amount":{"type":"number","default":1},"theme":{"type":"string","enum":["light","dark"],"default":"light"}},"supports":{"html":false,"align":["wide","full"]},"editorScript":"file:.\/index.js"},"allratestoday\/official-rate":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"allratestoday\/official-rate","version":"1.0.0","title":"Official Exchange Rate","category":"widgets","icon":"bank","description":"One currency pair as published by a central bank or tax authority, with its publication date.","keywords":["central bank","exchange rate","ecb","official rate"],"textdomain":"allratestoday-currency-converter","attributes":{"bank":{"type":"string","default":"ecb"},"source":{"type":"string","default":"USD"},"target":{"type":"string","default":"EUR"},"theme":{"type":"string","enum":["light","dark"],"default":"light"}},"supports":{"html":false},"editorScript":"file:.\/index.js"}},"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[290966,8504,12584,21292,162],"plugin_category":[43,45],"plugin_contributors":[290967],"plugin_business_model":[],"class_list":["post-398784","plugin","type-plugin","status-publish","hentry","plugin_tags-central-bank","plugin_tags-currency","plugin_tags-currency-converter","plugin_tags-exchange-rates","plugin_tags-widget","plugin_category-customization","plugin_category-ecommerce","plugin_contributors-chathurangac8","plugin_committers-chathurangac8"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/allratestoday-currency-converter\/assets\/icon.svg?rev=3786820","icon":"https:\/\/ps.w.org\/allratestoday-currency-converter\/assets\/icon.svg?rev=3786820","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Add a currency converter or an official exchange rate to any post, page or widget area.<\/p>\n\n<p><strong>Currency Converter block<\/strong> \u2014 amount, from\/to currency and a swap button. Without an API key it uses the official European Central Bank reference rates (30 currencies, updated each working day). Add a free AllRatesToday API key for real-time rates across 160+ currencies.<\/p>\n\n<p><strong>Official Exchange Rate block<\/strong> \u2014 one currency pair exactly as published by a central bank or tax authority, with the publication date: the European Central Bank, Bank of England, Reserve Bank of India, Bank of Japan, Swiss National Bank, HMRC, the US Treasury and 100+ more. Useful for invoices, tax and travel pages that need a citable rate.<\/p>\n\n<ul>\n<li>Two blocks: Currency Converter and Official Exchange Rate<\/li>\n<li>Shortcodes for classic themes and widget areas<\/li>\n<li>Light and dark themes<\/li>\n<li>Lightweight: the scripts load only on pages that use a widget<\/li>\n<li>No account needed<\/li>\n<\/ul>\n\n<h4>Shortcodes<\/h4>\n\n<pre><code>[allratestoday_converter base=\"USD\" target=\"EUR\" amount=\"100\" theme=\"light\"]\n\n[allratestoday_official_rate bank=\"ecb\" source=\"USD\" target=\"EUR\" theme=\"light\"]\n<\/code><\/pre>\n\n<p>Bank codes: see the <a href=\"https:\/\/allratestoday.com\/central-bank-rates-api\/institutions\/\">list of publishers<\/a>.<\/p>\n\n<h4>Credit link<\/h4>\n\n<p>The free AllRatesToday service requires a visible \"Exchange rates by AllRatesToday\" link under each widget. The plugin never adds it on its own: widgets stay hidden from visitors until you tick <strong>Show the credit link<\/strong> in Settings \u2192 AllRatesToday. Until then, administrators see a note where the widget would be.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin displays exchange rates from the AllRatesToday API (https:\/\/allratestoday.com). The rates are not stored in WordPress; your visitors' browsers request them directly when a page with a widget loads.<\/p>\n\n<ul>\n<li><strong>When:<\/strong> each time a visitor views a page containing a Currency Converter or Official Exchange Rate widget, and each time they change the amount or currencies in the converter.<\/li>\n<li><strong>What is sent:<\/strong> the requested currency codes and, for the official-rate widget, the bank code. If you saved an API key, it is sent with converter requests. As with any web request, the visitor's IP address and browser user agent reach the service.<\/li>\n<li><strong>Endpoints:<\/strong> <code>https:\/\/allratestoday.com\/api\/v1\/symbols<\/code>, <code>https:\/\/allratestoday.com\/api\/open\/central-bank\/{bank}<\/code> and, with an API key, <code>https:\/\/allratestoday.com\/api\/widget\/rate<\/code>.<\/li>\n<\/ul>\n\n<p>Service provider: AllRatesToday. <a href=\"https:\/\/allratestoday.com\/terms\/\">Terms of service<\/a> \u00b7 <a href=\"https:\/\/allratestoday.com\/privacy-policy\/\">Privacy policy<\/a><\/p>\n\n<h3>Third-party code<\/h3>\n\n<pre><code>assets\/widget.js and `assets\/official-rates.js` are the AllRatesToday widget scripts (MIT licence, https:\/\/github.com\/AllRates-Today\/allratestoday-widget), included unminified.\n<\/code><\/pre>\n\n<!--section=installation-->\n<ol>\n<li>Install the plugin from Plugins \u2192 Add New, or upload the <code>allratestoday-currency-converter<\/code> folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate it.<\/li>\n<li>Go to Settings \u2192 AllRatesToday and tick <strong>Show the credit link<\/strong>. Optionally paste an API key.<\/li>\n<li>Add the <strong>Currency Converter<\/strong> or <strong>Official Exchange Rate<\/strong> block, or use a shortcode.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20an%20api%20key%3F\"><h3>Do I need an API key?<\/h3><\/dt>\n<dd><p>No. Without a key the converter uses the European Central Bank reference rates and the official-rate widget works for every supported publisher. A free key from https:\/\/allratestoday.com\/register gives the converter real-time rates for 160+ currencies.<\/p><\/dd>\n<dt id=\"is%20my%20api%20key%20visible%3F\"><h3>Is my API key visible?<\/h3><\/dt>\n<dd><p>Yes. It is written into the page HTML so visitors' browsers can request rates, which means anyone can copy it and use your quota. Watch usage in your AllRatesToday dashboard and rotate the key there if needed, or leave the key empty and use the free ECB rates.<\/p><\/dd>\n<dt id=\"why%20is%20the%20widget%20not%20showing%3F\"><h3>Why is the widget not showing?<\/h3><\/dt>\n<dd><p>Tick <strong>Show the credit link<\/strong> in Settings \u2192 AllRatesToday. The free service requires the link, so the plugin keeps widgets hidden until you agree to show it.<\/p><\/dd>\n<dt id=\"are%20these%20rates%20suitable%20for%20tax%20or%20customs%3F\"><h3>Are these rates suitable for tax or customs?<\/h3><\/dt>\n<dd><p>The Official Exchange Rate widget shows the rate exactly as the named central bank or tax authority published it, with its publication date. Check which publisher and date your rules require.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release: Currency Converter and Official Exchange Rate blocks and shortcodes.<\/li>\n<\/ul>","raw_excerpt":"Free currency converter and official central-bank exchange rate widgets. Blocks and shortcodes, no API key needed.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/398784","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=398784"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/chathurangac8"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=398784"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=398784"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=398784"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=398784"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=398784"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=398784"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}