{"id":271226,"date":"2026-03-10T16:13:18","date_gmt":"2026-03-10T16:13:18","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/smart-convert-free-currency-unit-conversion-with-geoip\/"},"modified":"2026-04-02T11:14:16","modified_gmt":"2026-04-02T11:14:16","slug":"smart-convert-currency-unit-conversion","status":"publish","type":"plugin","link":"https:\/\/pcd.wordpress.org\/plugins\/smart-convert-currency-unit-conversion\/","author":10122470,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.2","stable_tag":"1.0.2","tested":"6.9.4","requires":"5.4","requires_php":"7.2","requires_plugins":null,"header_name":"Smart Convert \u2013 Currency & Unit Conversion","header_author":"Petr Nov\u00e1k","header_description":"A conversion engine featuring daily updated exchange rates for 153 currencies and 105 physical units. Includes automatic visitor currency detection via IP, high-performance object caching, custom output templates, and native Gutenberg block support.","assets_banners_color":"e4f5f4","last_updated":"2026-04-02 11:14:16","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/petrnovak.cz\/plugins\/","header_author_uri":"https:\/\/www.petrnovak.cz\/","rating":0,"author_block_rating":0,"active_installs":10,"downloads":365,"num_ratings":0,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"PetrNovak","date":"2026-03-11 10:27:45"},"1.0.1":{"tag":"1.0.1","author":"PetrNovak","date":"2026-03-13 14:04:36"},"1.0.2":{"tag":"1.0.2","author":"PetrNovak","date":"2026-04-02 11:14:16"}},"upgrade_notice":{"1.0.2":"<p>Translations were updated.<\/p>","1.0.1":"<p>This update adds translator comments to improve clarity for localization tools and human translators.<\/p>","1.0.0":"<p>This is the first stable release of Smart Convert \u2013 Currency &amp; Unit Conversion.\nPlease ensure your server supports PHP 7.2 or higher.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3479793,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3479793,"resolution":"256x256","location":"assets","locale":""},"icon.svg":{"filename":"icon.svg","revision":3479793,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3479844,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3479844,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":{"smart-convert-currency-unit-conversion\/convert":{"name":"smart-convert-currency-unit-conversion\/convert","title":"Convert"}},"tagged_versions":["1.0.0","1.0.1","1.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3479579,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3479579,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3479579,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3479579,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3479579,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3479579,"resolution":"6","location":"assets","locale":""}},"screenshots":{"1":"<strong>General Settings:<\/strong> Configure update intervals, number formatting, and global exchange rate markups.","2":"<strong>Template Manager:<\/strong> Manage default settings or export and import custom display formats via JSON.","3":"<strong>Live Rates Dashboard:<\/strong> Monitor active exchange rates and their last update times in a clear table.","4":"<strong>Custom Unit Builder:<\/strong> Create bidirectional custom units with equation previews (e.g., Pallet to Boxes).","5":"<strong>Conversion Modal:<\/strong> Easily insert conversions with a smart popup that handles amounts, currencies, and formats.","6":"<strong>Interactive Tooltips:<\/strong> Hover over a conversion to see the exact rate, timestamp, and markup details.","7":"<strong>Particle Update UI:<\/strong> Visual feedback during manual rate updates and data synchronization."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[12584,21292,2493,22278,19417],"plugin_category":[],"plugin_contributors":[257451],"plugin_business_model":[],"class_list":["post-271226","plugin","type-plugin","status-publish","hentry","plugin_tags-currency-converter","plugin_tags-exchange-rates","plugin_tags-geoip","plugin_tags-measurement","plugin_tags-unit-converter","plugin_contributors-petrnovak","plugin_committers-petrnovak"],"banners":{"banner":"https:\/\/ps.w.org\/smart-convert-currency-unit-conversion\/assets\/banner-772x250.png?rev=3479844","banner_2x":"https:\/\/ps.w.org\/smart-convert-currency-unit-conversion\/assets\/banner-1544x500.png?rev=3479844","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/smart-convert-currency-unit-conversion\/assets\/icon.svg?rev=3479793","icon":"https:\/\/ps.w.org\/smart-convert-currency-unit-conversion\/assets\/icon.svg?rev=3479793","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/smart-convert-currency-unit-conversion\/assets\/screenshot-1.png?rev=3479579","caption":"<strong>General Settings:<\/strong> Configure update intervals, number formatting, and global exchange rate markups."},{"src":"https:\/\/ps.w.org\/smart-convert-currency-unit-conversion\/assets\/screenshot-2.png?rev=3479579","caption":"<strong>Template Manager:<\/strong> Manage default settings or export and import custom display formats via JSON."},{"src":"https:\/\/ps.w.org\/smart-convert-currency-unit-conversion\/assets\/screenshot-3.png?rev=3479579","caption":"<strong>Live Rates Dashboard:<\/strong> Monitor active exchange rates and their last update times in a clear table."},{"src":"https:\/\/ps.w.org\/smart-convert-currency-unit-conversion\/assets\/screenshot-4.png?rev=3479579","caption":"<strong>Custom Unit Builder:<\/strong> Create bidirectional custom units with equation previews (e.g., Pallet to Boxes)."},{"src":"https:\/\/ps.w.org\/smart-convert-currency-unit-conversion\/assets\/screenshot-5.png?rev=3479579","caption":"<strong>Conversion Modal:<\/strong> Easily insert conversions with a smart popup that handles amounts, currencies, and formats."},{"src":"https:\/\/ps.w.org\/smart-convert-currency-unit-conversion\/assets\/screenshot-6.png?rev=3479579","caption":"<strong>Interactive Tooltips:<\/strong> Hover over a conversion to see the exact rate, timestamp, and markup details."}],"raw_content":"<!--section=description-->\n<p>Smart Convert \u2013 Currency &amp; Unit Conversion is not just another calculator, it is a complete conversion infrastructure for WordPress sites. Designed for performance and flexibility, it handles everything from simple currency exchanges to complex, non-linear physical unit conversions (like Temperature).<\/p>\n\n<p>Whether you run a travel blog, or a technical documentation hub, this plugin ensures your visitors see accurate conversions in a format that fits your design.<\/p>\n\n<p>\ud83d\ude80 My Ambition: Premium Features for Free With this initial release, my goal is to set a new standard for what a free plugin can offer. I believe advanced tools shouldn't be locked behind a paywall. That is why Smart Convert includes enterprise-grade features usually found only in paid versions: a Custom Unit Builder, a Template Engine, Import\/Export capabilities, and Automatic Geolocation\u2014all completely free.<\/p>\n\n<h3>\ud83c\udf1f Key Features<\/h3>\n\n<p><strong>\ud83d\udcb0 Advanced Currency Engine<\/strong>\n* <strong>Rates:<\/strong> Supports 153 global currencies + cryptocurrencies (BTC, ETH, etc.).\n* <strong>Smart Geo-Location:<\/strong> Automatically detects visitor IP to display their local currency (powered by ipinfo.io).\n* <strong>\"Spread\" &amp; Fees:<\/strong> Add a percentage markup (e.g., 2%) to exchange rates to simulate bank fees or retail pricing.\n* <strong>Smart Rounding:<\/strong> Intelligently adjusts decimals (e.g., 0 decimals for JPY, 6 decimals for BTC).<\/p>\n\n<p><strong>\ud83d\udccf Comprehensive Unit Converter<\/strong>\n* <strong>105+ Built-in Units:<\/strong> Covers 14 categories including Length, Mass, Volume, Temperature, Pressure, Energy, Speed, and Data.\n* <strong>Bi-Directional Custom Units:<\/strong> Creating a unit like \"Box\" (e.g., 1 Box = 12 Items). The plugin automatically generates the reverse conversion logic for you.\n* <strong>Complex Math:<\/strong> Handles non-linear conversions (like Fahrenheit to Celsius) with precision offset calculations.<\/p>\n\n<p><strong>\ud83c\udfa8 Visual &amp; Editor Integration<\/strong>\n* <strong>Native Gutenberg Block:<\/strong> Visually configure conversions (Amount, From, To, Decimals) with a live backend preview.\n* <strong>Inline Toolbar Tool:<\/strong> Select any text in your post and convert it instantly using the rich text toolbar button.\n* <strong>Interactive Tooltips:<\/strong> Solves the common \"overflow:hidden\" clipping issue using a smart portal strategy to display rates on hover.\n* <strong>Template System:<\/strong> Design your output using placeholders like <code>{FROM}<\/code>, <code>{TO}<\/code>, <code>{RATE}<\/code>, and <code>{DATE}<\/code>.<\/p>\n\n<p><strong>\u2699\ufe0f Performance &amp; Workflow<\/strong>\n* <strong>Zero Database Bloat:<\/strong> Uses robust Object Caching and Transients.\n* <strong>Import\/Export:<\/strong> Transfer your custom templates and custom units between sites via JSON.\n* <strong>Privacy First:<\/strong> External connections are disabled by default until explicit consent is given via the Onboarding Wizard.<\/p>\n\n<h3>\ud83c\udf0d Internationalization &amp; Translations<\/h3>\n\n<p>Smart Convert \u2013 Currency &amp; Unit Conversion is fully localized and ready for global audiences. The plugin is translated into the following languages:<\/p>\n\n<ul>\n<li>English<\/li>\n<li>Spanish (Espa\u00f1ol)<\/li>\n<li>Japanese (\u65e5\u672c\u8a9e)<\/li>\n<li>German (Deutsch)<\/li>\n<li>French (Fran\u00e7ais)<\/li>\n<li>Russian (\u0420\u0443\u0441\u0441\u043a\u0438\u0439)<\/li>\n<li>Brazilian Portuguese (Portugu\u00eas do Brasil)<\/li>\n<li>Italian (Italiano)<\/li>\n<li>Czech (\u010ce\u0161tina)<\/li>\n<li>Dutch (Nederlands)<\/li>\n<li>Turkish (T\u00fcrk\u00e7e)<\/li>\n<li>Polish (Polski)<\/li>\n<li>Indonesian (Bahasa Indonesia)<\/li>\n<\/ul>\n\n<h3>\u2696\ufe0f Privacy &amp; External Services Disclosure<\/h3>\n\n<p>To provide up-to-date exchange rates and geolocation features, this plugin may connect to selected third-party services.\n<strong>No data is sent without your explicit consent via the settings page.<\/strong><\/p>\n\n<ol>\n<li><p><strong>Currency &amp; Unit Data (Google Sheets via Proxy)<\/strong><\/p>\n\n<ul>\n<li><strong>Service:<\/strong> Downloads conversion rates from public datasets.<\/li>\n<li><strong>Mechanism:<\/strong> Requests are routed through a static redirect wrapper on <code>petrnovak.cz<\/code> to ensure link stability.<\/li>\n<li><strong>Data Sent:<\/strong> Your server's IP address (standard HTTP request). No visitor data is sent.<\/li>\n<li><strong>Policy:<\/strong> <a href=\"https:\/\/policies.google.com\/privacy\">Google Privacy Policy<\/a><\/li>\n<li><strong>Proxy Policy:<\/strong> <a href=\"https:\/\/petrnovak.cz\/plugins\/smart-convert-currency-unit-conversion\/privacy-policy.php\">PetrNovak.cz Privacy Policy<\/a><\/li>\n<\/ul><\/li>\n<li><p><strong>Geolocation (IPinfo.io)<\/strong><\/p>\n\n<ul>\n<li><strong>Service:<\/strong> Used <strong>only<\/strong> if \"Auto-detect currency from IP\" is enabled in settings.<\/li>\n<li><strong>Mechanism:<\/strong> Sends the visitor's IP address to IPinfo.io to determine their country code (e.g., \"US\").<\/li>\n<li><strong>Data Sent:<\/strong> Visitor IP Address.<\/li>\n<li><strong>Policy:<\/strong> <a href=\"https:\/\/ipinfo.io\/privacy\">IPinfo Privacy Policy<\/a><\/li>\n<\/ul><\/li>\n<\/ol>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/smart-convert-currency-unit-conversion<\/code> directory, or install the plugin through the WordPress plugins screen.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress.<\/li>\n<li><strong>Onboarding:<\/strong> You will be redirected to a setup wizard.\nClick \"Connect &amp; Initialize\" to download the latest rates and unit definitions.<\/li>\n<li>Navigate to <strong>Settings \u2192 Smart Convert \u2013 Currency &amp; Unit Conversion<\/strong> to configure your default currency and display preferences.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"can%20i%20add%20my%20own%20units%20%28e.g.%2C%20%22pallets%22%20to%20%22kilograms%22%29%3F\"><h3>Can I add my own units (e.g., \"Pallets\" to \"Kilograms\")?<\/h3><\/dt>\n<dd><p>Yes!\nGo to the <strong>Units<\/strong> tab and scroll to \"Add Custom Unit\". You can define a name, symbol, and conversion factor.\nThe plugin handles the math for both directions automatically.<\/p><\/dd>\n<dt id=\"how%20does%20the%20gutenberg%20inline%20tool%20work%3F\"><h3>How does the Gutenberg Inline Tool work?<\/h3><\/dt>\n<dd><p>Highlight any number in your text editor (e.g., \"100\"), click the \"Money\/Convert\" icon in the toolbar, and a popup will appear letting you choose the target currency or unit.<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20slow%20down%20my%20site%3F\"><h3>Does this plugin slow down my site?<\/h3><\/dt>\n<dd><p>No. Exchange rates are cached in your database (transients) and updated only once daily via WP-Cron.\nThe frontend shortcode uses these cached values, so no external API calls happen when a visitor loads your page.<\/p><\/dd>\n<dt id=\"can%20i%20use%20this%20for%20cryptocurrencies%3F\"><h3>Can I use this for Cryptocurrencies?<\/h3><\/dt>\n<dd><p>Yes. The plugin supports major crypto assets like Bitcoin (BTC) and Ethereum (ETH).\nIt also includes logic to handle high-precision decimals (up to 6 places) for small crypto amounts.<\/p><\/dd>\n<dt id=\"what%20are%20the%20shortcode%20macros%2Fplaceholders%3F\"><h3>What are the Shortcode Macros\/Placeholders?<\/h3><\/dt>\n<dd><p>When creating a custom output template, you can use:\n* <code>{FROM}<\/code> - The source amount with symbol (e.g., $10)\n* <code>{TO}<\/code> - The converted amount with symbol (e.g., \u20ac8.50)\n* <code>{RATE}<\/code> - The exchange rate used (e.g., 0.85)\n* <code>{DATE}<\/code> - The date the rate was last updated\n* <code>{RATE_INFO}<\/code> - A formatted string showing rate + spread details (ideal for tooltips)<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Updated: Translations were updated.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Improved: Added translator comments to clarify string context for localization.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Added: 153 Currencies &amp; 105 Physical Units.<\/li>\n<li>Added: Native Gutenberg Block &amp; Inline Toolbar integration.<\/li>\n<li>Added: Custom Unit Builder with Import\/Export.<\/li>\n<li>Added: Template Manager for custom output formatting.<\/li>\n<li>Added: Geolocation (IP-to-Currency) support via IPinfo.io.<\/li>\n<li>Added: \"Spread\" feature for exchange rate markup.<\/li>\n<li>Security: Implemented strict nonce checks and capability validation on all AJAX endpoints.<\/li>\n<li>Performance: Implemented Object Caching for rate lookups.<\/li>\n<\/ul>","raw_excerpt":"The ultimate conversion engine: 153 Currencies, 105+ Units, Custom Unit Builder, GeoIP detection, and a native Gutenberg Block with live previews.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/271226","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=271226"}],"author":[{"embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/petrnovak"}],"wp:attachment":[{"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=271226"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=271226"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=271226"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=271226"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=271226"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pcd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=271226"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}