{"id":261720,"date":"2026-01-22T12:33:58","date_gmt":"2026-01-22T12:33:58","guid":{"rendered":"https:\/\/br.wordpress.org\/plugins\/give-multi-currency\/"},"modified":"2026-01-30T13:31:37","modified_gmt":"2026-01-30T13:31:37","slug":"lknaci-multi-currency-for-givewp","status":"publish","type":"plugin","link":"https:\/\/ps.wordpress.org\/plugins\/lknaci-multi-currency-for-givewp\/","author":15590126,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"3.1.6","stable_tag":"3.1.6","tested":"6.9.4","requires":"5.0","requires_php":"7.4","requires_plugins":null,"header_name":"LinkNacional Multi Currency for GiveWP","header_author":"Link Nacional","header_description":"Adds currency selection options to GiveWP forms.","assets_banners_color":"35495b","last_updated":"2026-01-30 13:31:37","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.linknacional.com.br\/wordpress\/plugins\/","header_plugin_uri":"https:\/\/www.linknacional.com.br\/wordpress\/givewp\/multimoeda\/","header_author_uri":"https:\/\/www.linknacional.com.br","rating":0,"author_block_rating":0,"active_installs":0,"downloads":169,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"3.1.5":{"tag":"3.1.5","author":"linknacional","date":"2026-01-22 12:33:23"},"3.1.6":{"tag":"3.1.6","author":"linknacional","date":"2026-01-30 13:31:37"}},"upgrade_notice":{"3.1.4":"<ul>\n<li>Remove plugin updater.<\/li>\n<\/ul>","3.1.3":"<p>Important update with improved API reliability and fallback systems. Recommended for all users.<\/p>","3.1.0":"<p>Major PayPal integration improvements. Essential for sites using PayPal Commerce Gateway.<\/p>","3.0.0":"<p>Major update with GiveWP 3.0 support. Please test in staging environment before updating production sites.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3450482,"resolution":"256x256","location":"assets","locale":""},"icon-512x512.png":{"filename":"icon-512x512.png","revision":3450482,"resolution":"512x512","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3450482,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3450482,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["3.1.5","3.1.6"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"<strong>Currency selector on donation form<\/strong> - Clean dropdown interface for donors","2":"<strong>Global settings page<\/strong> - Configure default currencies and global options","3":"<strong>Form-specific settings<\/strong> - Per-form currency configuration options","4":"<strong>Admin currency options<\/strong> - Complete currency management interface","5":"<strong>PayPal integration<\/strong> - Seamless PayPal Commerce compatibility","6":"<strong>Multi-language support<\/strong> - Interface in multiple languages"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[12584,5800,32417,43889,24514],"plugin_category":[45],"plugin_contributors":[211810,173088],"plugin_business_model":[],"class_list":["post-261720","plugin","type-plugin","status-publish","hentry","plugin_tags-currency-converter","plugin_tags-donations","plugin_tags-givewp","plugin_tags-international-payments","plugin_tags-multi-currency","plugin_category-ecommerce","plugin_contributors-linknacional","plugin_contributors-marcosalexandre","plugin_committers-linknacional"],"banners":{"banner":"https:\/\/ps.w.org\/lknaci-multi-currency-for-givewp\/assets\/banner-772x250.png?rev=3450482","banner_2x":"https:\/\/ps.w.org\/lknaci-multi-currency-for-givewp\/assets\/banner-1544x500.jpg?rev=3450482","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/lknaci-multi-currency-for-givewp\/assets\/icon-256x256.png?rev=3450482","icon_2x":"https:\/\/ps.w.org\/lknaci-multi-currency-for-givewp\/assets\/icon-256x256.png?rev=3450482","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p><strong>LinkNacional Multi Currency for GiveWP<\/strong> is the ultimate solution for enabling international donations in your GiveWP-powered fundraising campaigns. This powerful plugin automatically converts foreign currencies to Brazilian Real (BRL) for payment processing while displaying donation amounts in the donor's preferred currency, creating a seamless and familiar donation experience for supporters worldwide.<\/p>\n\n<h3>Why Choose LinkNacional Multi Currency for GiveWP?<\/h3>\n\n<ul>\n<li><strong>Real-Time Exchange Rates<\/strong>: Automatic currency conversion using live exchange rates from reliable APIs<\/li>\n<li><strong>Multiple Currency Support<\/strong>: Accept donations in USD, EUR, JPY, GBP, SAR, MXN, CHF, and BRL<\/li>\n<li><strong>GiveWP 3.0+ Compatible<\/strong>: Full support for modern GiveWP forms and legacy templates<\/li>\n<li><strong>PayPal Integration<\/strong>: Special currency conversion handling for PayPal Commerce payments<\/li>\n<li><strong>Fallback Protection<\/strong>: Multiple API sources ensure currency rates are always available<\/li>\n<li><strong>Easy Configuration<\/strong>: Simple form-by-form or global currency settings<\/li>\n<li><strong>Professional Interface<\/strong>: Clean, intuitive currency selector for donors<\/li>\n<\/ul>\n\n<h3>Key Features at a Glance<\/h3>\n\n<ul>\n<li><strong>8 Supported Currencies<\/strong>: Brazilian Real, US Dollar, Euro, Japanese Yen, British Pound, Saudi Riyal, Mexican Peso, Swiss Franc<\/li>\n<li><strong>Dynamic Currency Selector<\/strong>: Interactive dropdown for donors to choose their preferred currency<\/li>\n<li><strong>Real-Time Conversion<\/strong>: Live exchange rates with automatic fallback systems<\/li>\n<li><strong>Form-Level Control<\/strong>: Configure different currencies per donation form<\/li>\n<li><strong>Global Settings<\/strong>: Set default currencies across all forms<\/li>\n<li><strong>PayPal Compatibility<\/strong>: Seamless integration with PayPal Commerce Gateway<\/li>\n<li><strong>Legacy Support<\/strong>: Works with both modern and legacy GiveWP form templates<\/li>\n<li><strong>Developer Friendly<\/strong>: Hooks and filters for customization<\/li>\n<li><strong>Multilingual Ready<\/strong>: Full internationalization support with English, Portuguese, and Spanish translations<\/li>\n<\/ul>\n\n<h3>How It Works<\/h3>\n\n<ol>\n<li><strong>Currency Selection<\/strong>: Donors select their preferred currency from an elegant dropdown<\/li>\n<li><strong>Real-Time Conversion<\/strong>: Plugin fetches current exchange rates and displays amounts<\/li>\n<li><strong>Payment Processing<\/strong>: Converts foreign currency to BRL for Brazilian payment processors<\/li>\n<li><strong>Seamless Experience<\/strong>: Donors see familiar currency while payments process correctly<\/li>\n<\/ol>\n\n<h3>Perfect For<\/h3>\n\n<ul>\n<li><strong>International Nonprofits<\/strong>: Accept donations from supporters worldwide<\/li>\n<li><strong>Brazilian Organizations<\/strong>: Process international donations through local payment systems<\/li>\n<li><strong>Fundraising Campaigns<\/strong>: Expand reach to global donor base<\/li>\n<li><strong>Multi-Regional Causes<\/strong>: Serve diverse communities with localized currency options<\/li>\n<\/ul>\n\n<h3>Technical Highlights<\/h3>\n\n<ul>\n<li><strong>API Integration<\/strong>: Multiple exchange rate sources for reliability<\/li>\n<li><strong>Smart Fallback<\/strong>: Offline rates ensure continuous operation<\/li>\n<li><strong>Performance Optimized<\/strong>: Efficient currency switching and calculation<\/li>\n<li><strong>Security First<\/strong>: Secure API calls and data handling<\/li>\n<li><strong>WordPress Standards<\/strong>: Follows all WordPress coding and security standards<\/li>\n<\/ul>\n\n<p><strong>Note<\/strong>: This plugin requires GiveWP and is optimized for Brazilian Real (BRL) as the base processing currency.<\/p>\n\n<h3>Configuration<\/h3>\n\n<h3>Initial Setup<\/h3>\n\n<ol>\n<li>Navigate to <strong>Donations \u2192 Settings \u2192 General \u2192 Currency Settings<\/strong><\/li>\n<li>Enable <strong>Multi Currency<\/strong> option<\/li>\n<li>Set your <strong>Default Currency<\/strong> (recommended: BRL)<\/li>\n<li>Select <strong>Enabled Currencies<\/strong> for your donation forms<\/li>\n<li>Save settings<\/li>\n<\/ol>\n\n<h3>Form-Level Configuration<\/h3>\n\n<ol>\n<li>Edit any GiveWP donation form<\/li>\n<li>Go to <strong>Currency Options<\/strong> tab<\/li>\n<li>Choose between <strong>Global Options<\/strong> or form-specific settings<\/li>\n<li>Configure <strong>Default Currency<\/strong> and <strong>Enabled Currencies<\/strong> for this form<\/li>\n<li>Update form<\/li>\n<\/ol>\n\n<h3>Requirements<\/h3>\n\n<ul>\n<li><strong>GiveWP Plugin<\/strong>: Version 2.19.2 or higher<\/li>\n<li><strong>Currency Setting<\/strong>: Base currency must be Brazilian Real (BRL)<\/li>\n<li><strong>Decimal Places<\/strong>: Set to 0 in GiveWP currency settings for optimal performance<\/li>\n<\/ul>\n\n<h3>External Services<\/h3>\n\n<p>This plugin connects to external services to obtain real-time exchange rates for currency conversion. These services are essential for providing accurate and up-to-date currency exchange information to display donation amounts in different currencies.<\/p>\n\n<h4>Link Nacional Exchange Rate API<\/h4>\n\n<ul>\n<li><strong>What the service is<\/strong>: Link Nacional Exchange Rate API (https:\/\/api.linknacional.com\/cotacao\/) - A currency exchange rate service provided by Link Nacional<\/li>\n<li><strong>What it is used for<\/strong>: Primary source for real-time currency exchange rates to convert donation amounts between different currencies<\/li>\n<li><strong>What data is sent<\/strong>: Currency code (e.g., USD, EUR, BRL) to retrieve exchange rates for that specific currency<\/li>\n<li><strong>When data is sent<\/strong>: Every time a donation form with multi-currency enabled is loaded or when currency rates need to be refreshed (cached for 1 hour)<\/li>\n<\/ul>\n\n<h4>Frankfurter API (Fallback Service)<\/h4>\n\n<ul>\n<li><strong>What the service is<\/strong>: Frankfurter Exchange Rate API (https:\/\/api.frankfurter.app\/) - A free, open-source currency exchange rate service<\/li>\n<li><strong>What it is used for<\/strong>: Alternative\/fallback exchange rate source when the primary Link Nacional API is unavailable or fails to respond<\/li>\n<li><strong>What data is sent<\/strong>: Currency codes for base and target currencies (e.g., \"from=USD&amp;to=EUR,BRL\") to retrieve exchange rates<\/li>\n<li><strong>When data is sent<\/strong>: Only when the primary Link Nacional API fails to provide exchange rates or returns an error<\/li>\n<\/ul>\n\n<p><strong>Important Notes<\/strong>: \n- Exchange rates are cached for 1 hour in WordPress to improve performance and reduce external service requests\n- No personal or sensitive data is transmitted to these services, only currency codes\n- These external connections are essential for the plugin's core functionality of multi-currency support\n- If both services are unavailable, the plugin falls back to cached rates stored locally<\/p>\n\n<h3>Source Code<\/h3>\n\n<p>The compiled JavaScript files are available in the plugin:\n* <code>\/resource\/payPalCommerceGateway.js<\/code> - Compiled PayPal Commerce integration\n* <code>\/resource\/give-multi-currency-coin-selector.js<\/code> - Compiled currency selector<\/p>\n\n<p>The uncompiled source code is available on GitHub:\n* <strong>Repository<\/strong>: https:\/\/github.com\/LinkNacional\/give-multimoeda\n* <strong>Development Branch<\/strong>: https:\/\/github.com\/LinkNacional\/give-multimoeda\/tree\/dev<\/p>\n\n<p>To rebuild the JavaScript files (for developers):\n1. Clone the repository\n2. Run <code>npm install<\/code> to install dependencies\n3. Run <code>npm run build<\/code> to compile files<\/p>\n\n<h3>Support<\/h3>\n\n<p>For technical support, feature requests, or bug reports:<\/p>\n\n<ul>\n<li><strong>Support Portal<\/strong>: <a href=\"https:\/\/www.linknacional.com.br\/suporte\/\">Link Nacional Support<\/a><\/li>\n<li><strong>Documentation<\/strong>: <a href=\"https:\/\/www.linknacional.com.br\/wordpress\/givewp\/multimoeda\/\">Plugin Documentation<\/a><\/li>\n<li><strong>GitHub<\/strong>: Report issues on our <a href=\"https:\/\/github.com\/LinkNacional\/multi-currency-for-give\">GitHub repository<\/a><\/li>\n<\/ul>\n\n<p><strong>Professional WordPress Development<\/strong>: Need custom modifications or have a special project? <a href=\"https:\/\/www.linknacional.com.br\/wordpress\/\">Contact our development team<\/a><\/p>\n\n<h3>Recommended Plugins<\/h3>\n\n<ul>\n<li><strong><a href=\"https:\/\/wordpress.org\/plugins\/give\/\">GiveWP<\/a><\/strong> - The #1 donation plugin for WordPress (Required)<\/li>\n<li><strong><a href=\"https:\/\/givewp.com\/addons\/recurring-donations\/\">Give - Recurring Donations<\/a><\/strong> - Accept recurring donations<\/li>\n<li><strong><a href=\"https:\/\/givewp.com\/addons\/fee-recovery\/\">Give - Fee Recovery<\/a><\/strong> - Let donors cover transaction fees<\/li>\n<li><strong><a href=\"https:\/\/givewp.com\/addons\/form-field-manager\/\">Give - Form Field Manager<\/a><\/strong> - Customize donation forms<\/li>\n<\/ul>\n\n\n\n<p><strong>Transform your donation forms into a global fundraising platform with LinkNacional Multi Currency for GiveWP today!<\/strong><\/p>\n\n<!--section=installation-->\n<h3>1. Using WordPress Admin Dashboard (Recommended)<\/h3>\n\n<ol>\n<li>Navigate to <strong>Plugins \u2192 Add New<\/strong><\/li>\n<li>Click <strong>Upload Plugin<\/strong> and select the plugin ZIP file<\/li>\n<li>Click <strong>Install Now<\/strong> and then <strong>Activate<\/strong><\/li>\n<li>Go to <strong>Donations \u2192 Settings \u2192 General \u2192 Currency Settings<\/strong> to configure<\/li>\n<\/ol>\n\n<h3>2. Manual Installation via FTP<\/h3>\n\n<ol>\n<li>Extract the plugin ZIP file<\/li>\n<li>Upload the extracted folder to <code>wp-content\/plugins\/<\/code><\/li>\n<li>Activate the plugin in <strong>Plugins<\/strong> dashboard<\/li>\n<\/ol>\n\n<h3>3. WP-CLI Installation<\/h3>\n\n<pre><code>`bash\n<\/code><\/pre>\n\n<p>wp plugin activate multi-currency-for-give\n    `<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"what%20currencies%20are%20supported%3F\"><h3>What currencies are supported?<\/h3><\/dt>\n<dd><p>The plugin supports 8 major currencies: Brazilian Real (BRL), US Dollar (USD), Euro (EUR), Japanese Yen (JPY), British Pound (GBP), Saudi Riyal (SAR), Mexican Peso (MXN), and Swiss Franc (CHF).<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20all%20payment%20gateways%3F\"><h3>Does it work with all payment gateways?<\/h3><\/dt>\n<dd><p>The plugin works with most payment gateways, with special optimization for PayPal Commerce. It converts currencies for processing while maintaining the donor experience.<\/p><\/dd>\n<dt id=\"can%20i%20set%20different%20currencies%20for%20different%20forms%3F\"><h3>Can I set different currencies for different forms?<\/h3><\/dt>\n<dd><p>Yes! You can configure currencies globally or set specific currencies for individual donation forms.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20exchange%20rate%20apis%20are%20unavailable%3F\"><h3>What happens if exchange rate APIs are unavailable?<\/h3><\/dt>\n<dd><p>The plugin includes multiple fallback systems, including offline rates, to ensure continuous operation even if primary APIs are temporarily unavailable.<\/p><\/dd>\n<dt id=\"is%20the%20plugin%20compatible%20with%20givewp%203.0%3F\"><h3>Is the plugin compatible with GiveWP 3.0?<\/h3><\/dt>\n<dd><p>Absolutely! The plugin fully supports both GiveWP 3.0+ modern forms and legacy templates.<\/p><\/dd>\n<dt id=\"can%20i%20customize%20the%20currency%20selector%20appearance%3F\"><h3>Can I customize the currency selector appearance?<\/h3><\/dt>\n<dd><p>Yes, the plugin includes CSS classes and hooks for customization. Advanced users can modify the appearance through themes or custom CSS.<\/p><\/dd>\n<dt id=\"does%20it%20support%20recurring%20donations%3F\"><h3>Does it support recurring donations?<\/h3><\/dt>\n<dd><p>Yes, the plugin works seamlessly with GiveWP's recurring donation features.<\/p><\/dd>\n<dt id=\"what%20about%20transaction%20fees%20and%20conversion%20rates%3F\"><h3>What about transaction fees and conversion rates?<\/h3><\/dt>\n<dd><p>The plugin displays current market exchange rates. Payment processor fees are handled according to your gateway's standard policies.<\/p><\/dd>\n<dt id=\"is%20technical%20support%20available%3F\"><h3>Is technical support available?<\/h3><\/dt>\n<dd><p>Yes! Visit our <a href=\"https:\/\/www.linknacional.com.br\/suporte\/\">support page<\/a> or create a ticket for assistance.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>3.1.6 - 2026\/01\/30<\/h4>\n\n<ul>\n<li>Fix wordpress issues.<\/li>\n<\/ul>\n\n<h4>3.1.5 - 2025\/12\/30<\/h4>\n\n<ul>\n<li>Fix wordpress issues.<\/li>\n<\/ul>\n\n<h4>3.1.4 - 2025\/11\/10<\/h4>\n\n<ul>\n<li>Remove plugin updater.<\/li>\n<\/ul>\n\n<h4>3.1.3 - 2025\/06\/27<\/h4>\n\n<ul>\n<li>Added fallback routes for API error handling<\/li>\n<li>Improved reliability with multiple exchange rate sources<\/li>\n<li>Enhanced error handling and recovery<\/li>\n<\/ul>\n\n<h4>3.1.2 - 2025\/05\/02<\/h4>\n\n<ul>\n<li>Fixed action hook implementation<\/li>\n<li>Improved plugin stability<\/li>\n<\/ul>\n\n<h4>3.1.1 - 2025\/04\/23<\/h4>\n\n<ul>\n<li>Updated PayPal script integration<\/li>\n<li>Enhanced PayPal Commerce compatibility<\/li>\n<\/ul>\n\n<h4>3.1.0 - 2025\/03\/12<\/h4>\n\n<ul>\n<li>Added currency conversion during PayPal payment processing<\/li>\n<li>Improved PayPal Commerce Gateway integration<\/li>\n<li>Enhanced payment flow for international transactions<\/li>\n<\/ul>\n\n<h4>3.0.3 - 2024\/11\/29<\/h4>\n\n<ul>\n<li>Added Swiss Franc (CHF) currency support<\/li>\n<li>Expanded currency options for European donors<\/li>\n<\/ul>\n\n<h4>3.0.2 - 2024\/09\/26<\/h4>\n\n<ul>\n<li>Added decimal value handling improvements<\/li>\n<li>Enhanced calculation accuracy<\/li>\n<\/ul>\n\n<h4>3.0.1 - 2024\/08\/27<\/h4>\n\n<ul>\n<li>Visual improvements in plugin display<\/li>\n<li>UI\/UX enhancements for better user experience<\/li>\n<\/ul>\n\n<h4>3.0.0 - 2024\/08\/16<\/h4>\n\n<ul>\n<li>Added support for GiveWP 3.0.0 forms<\/li>\n<li>Major code refactoring and optimization<\/li>\n<li>Bug fixes and performance improvements<\/li>\n<li>Cleanup of legacy code<\/li>\n<\/ul>\n\n<h4>2.7.0 - 2024\/06\/13<\/h4>\n\n<ul>\n<li>Added Mexican Peso (MXN) support<\/li>\n<li>Added notifications for inactive Link Nacional plugins<\/li>\n<li>Enhanced plugin ecosystem integration<\/li>\n<\/ul>\n\n<h4>2.6.0 - 2023\/12\/23<\/h4>\n\n<ul>\n<li>Added Saudi Riyal (SAR) support<\/li>\n<li>Updated exchange rate API endpoints<\/li>\n<li>Added comprehensive changelog system<\/li>\n<\/ul>\n\n<p><a href=\"https:\/\/github.com\/LinkNacional\/multi-currency-for-give\/blob\/main\/CHANGELOG.md\">View complete changelog<\/a><\/p>","raw_excerpt":"Transform your GiveWP donation forms with seamless multi-currency support and real-time exchange rates.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/261720","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=261720"}],"author":[{"embeddable":true,"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/linknacional"}],"wp:attachment":[{"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=261720"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=261720"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=261720"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=261720"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=261720"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ps.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=261720"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}