linknacional

MarcosAlexandre

<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>
<h3>Why Choose LinkNacional Multi Currency for GiveWP?</h3>
<ul>
<li><strong>Real-Time Exchange Rates</strong>: Automatic currency conversion using live exchange rates from reliable APIs</li>
<li><strong>Multiple Currency Support</strong>: Accept donations in USD, EUR, JPY, GBP, SAR, MXN, CHF, and BRL</li>
<li><strong>GiveWP 3.0+ Compatible</strong>: Full support for modern GiveWP forms and legacy templates</li>
<li><strong>PayPal Integration</strong>: Special currency conversion handling for PayPal Commerce payments</li>
<li><strong>Fallback Protection</strong>: Multiple API sources ensure currency rates are always available</li>
<li><strong>Easy Configuration</strong>: Simple form-by-form or global currency settings</li>
<li><strong>Professional Interface</strong>: Clean, intuitive currency selector for donors</li>
</ul>
<h3>Key Features at a Glance</h3>
<ul>
<li><strong>8 Supported Currencies</strong>: Brazilian Real, US Dollar, Euro, Japanese Yen, British Pound, Saudi Riyal, Mexican Peso, Swiss Franc</li>
<li><strong>Dynamic Currency Selector</strong>: Interactive dropdown for donors to choose their preferred currency</li>
<li><strong>Real-Time Conversion</strong>: Live exchange rates with automatic fallback systems</li>
<li><strong>Form-Level Control</strong>: Configure different currencies per donation form</li>
<li><strong>Global Settings</strong>: Set default currencies across all forms</li>
<li><strong>PayPal Compatibility</strong>: Seamless integration with PayPal Commerce Gateway</li>
<li><strong>Legacy Support</strong>: Works with both modern and legacy GiveWP form templates</li>
<li><strong>Developer Friendly</strong>: Hooks and filters for customization</li>
<li><strong>Multilingual Ready</strong>: Full internationalization support with English, Portuguese, and Spanish translations</li>
</ul>
<h3>How It Works</h3>
<ol>
<li><strong>Currency Selection</strong>: Donors select their preferred currency from an elegant dropdown</li>
<li><strong>Real-Time Conversion</strong>: Plugin fetches current exchange rates and displays amounts</li>
<li><strong>Payment Processing</strong>: Converts foreign currency to BRL for Brazilian payment processors</li>
<li><strong>Seamless Experience</strong>: Donors see familiar currency while payments process correctly</li>
</ol>
<h3>Perfect For</h3>
<ul>
<li><strong>International Nonprofits</strong>: Accept donations from supporters worldwide</li>
<li><strong>Brazilian Organizations</strong>: Process international donations through local payment systems</li>
<li><strong>Fundraising Campaigns</strong>: Expand reach to global donor base</li>
<li><strong>Multi-Regional Causes</strong>: Serve diverse communities with localized currency options</li>
</ul>
<h3>Technical Highlights</h3>
<ul>
<li><strong>API Integration</strong>: Multiple exchange rate sources for reliability</li>
<li><strong>Smart Fallback</strong>: Offline rates ensure continuous operation</li>
<li><strong>Performance Optimized</strong>: Efficient currency switching and calculation</li>
<li><strong>Security First</strong>: Secure API calls and data handling</li>
<li><strong>WordPress Standards</strong>: Follows all WordPress coding and security standards</li>
</ul>
<p><strong>Note</strong>: This plugin requires GiveWP and is optimized for Brazilian Real (BRL) as the base processing currency.</p>
<h3>Configuration</h3>
<h3>Initial Setup</h3>
<ol>
<li>Navigate to <strong>Donations <span aria-hidden="true" class="wp-exclude-emoji">→</span> Settings <span aria-hidden="true" class="wp-exclude-emoji">→</span> General <span aria-hidden="true" class="wp-exclude-emoji">→</span> Currency Settings</strong></li>
<li>Enable <strong>Multi Currency</strong> option</li>
<li>Set your <strong>Default Currency</strong> (recommended: BRL)</li>
<li>Select <strong>Enabled Currencies</strong> for your donation forms</li>
<li>Save settings</li>
</ol>
<h3>Form-Level Configuration</h3>
<ol>
<li>Edit any GiveWP donation form</li>
<li>Go to <strong>Currency Options</strong> tab</li>
<li>Choose between <strong>Global Options</strong> or form-specific settings</li>
<li>Configure <strong>Default Currency</strong> and <strong>Enabled Currencies</strong> for this form</li>
<li>Update form</li>
</ol>
<h3>Requirements</h3>
<ul>
<li><strong>GiveWP Plugin</strong>: Version 2.19.2 or higher</li>
<li><strong>Currency Setting</strong>: Base currency must be Brazilian Real (BRL)</li>
<li><strong>Decimal Places</strong>: Set to 0 in GiveWP currency settings for optimal performance</li>
</ul>
<h3>External Services</h3>
<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>
<h4>Link Nacional Exchange Rate API</h4>
<ul>
<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>
<li><strong>What it is used for</strong>: Primary source for real-time currency exchange rates to convert donation amounts between different currencies</li>
<li><strong>What data is sent</strong>: Currency code (e.g., USD, EUR, BRL) to retrieve exchange rates for that specific currency</li>
<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>
</ul>
<h4>Frankfurter API (Fallback Service)</h4>
<ul>
<li><strong>What the service is</strong>: Frankfurter Exchange Rate API (https://api.frankfurter.app/) – A free, open-source currency exchange rate service</li>
<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>
<li><strong>What data is sent</strong>: Currency codes for base and target currencies (e.g., “from=USD&to=EUR,BRL”) to retrieve exchange rates</li>
<li><strong>When data is sent</strong>: Only when the primary Link Nacional API fails to provide exchange rates or returns an error</li>
</ul>
<p><strong>Important Notes</strong>:<br />
– Exchange rates are cached for 1 hour in WordPress to improve performance and reduce external service requests<br />
– No personal or sensitive data is transmitted to these services, only currency codes<br />
– These external connections are essential for the plugin’s core functionality of multi-currency support<br />
– If both services are unavailable, the plugin falls back to cached rates stored locally</p>
<h3>Source Code</h3>
<p>The compiled JavaScript files are available in the plugin:<br />
* <code>/resource/payPalCommerceGateway.js</code> – Compiled PayPal Commerce integration<br />
* <code>/resource/give-multi-currency-coin-selector.js</code> – Compiled currency selector</p>
<p>The uncompiled source code is available on GitHub:<br />
* <strong>Repository</strong>: https://github.com/LinkNacional/give-multimoeda<br />
* <strong>Development Branch</strong>: https://github.com/LinkNacional/give-multimoeda/tree/dev</p>
<p>To rebuild the JavaScript files (for developers):<br />
1. Clone the repository<br />
2. Run <code>npm install</code> to install dependencies<br />
3. Run <code>npm run build</code> to compile files</p>
<h3>Support</h3>
<p>For technical support, feature requests, or bug reports:</p>
<ul>
<li><strong>Support Portal</strong>: <a href="https://www.linknacional.com.br/suporte/" rel="nofollow ugc">Link Nacional Support</a></li>
<li><strong>Documentation</strong>: <a href="https://www.linknacional.com.br/wordpress/givewp/multimoeda/" rel="nofollow ugc">Plugin Documentation</a></li>
<li><strong>GitHub</strong>: Report issues on our <a href="https://github.com/LinkNacional/multi-currency-for-give" rel="nofollow ugc">GitHub repository</a></li>
</ul>
<p><strong>Professional WordPress Development</strong>: Need custom modifications or have a special project? <a href="https://www.linknacional.com.br/wordpress/" rel="nofollow ugc">Contact our development team</a></p>
<h3>Recommended Plugins</h3>
<ul>
<li><strong><a href="https://wordpress.org/plugins/give/" rel="ugc">GiveWP</a></strong> – The #1 donation plugin for WordPress (Required)</li>
<li><strong><a href="https://givewp.com/addons/recurring-donations/" rel="nofollow ugc">Give – Recurring Donations</a></strong> – Accept recurring donations</li>
<li><strong><a href="https://givewp.com/addons/fee-recovery/" rel="nofollow ugc">Give – Fee Recovery</a></strong> – Let donors cover transaction fees</li>
<li><strong><a href="https://givewp.com/addons/form-field-manager/" rel="nofollow ugc">Give – Form Field Manager</a></strong> – Customize donation forms</li>
</ul>
<p><strong>Transform your donation forms into a global fundraising platform with LinkNacional Multi Currency for GiveWP today!</strong></p>


LinkNacional Multi Currency for GiveWP

Transform your GiveWP donation forms with seamless multi-currency support and real-time exchange rates.

flutterwave

<p>Accept payment via MasterCard, Visa, Mpesa, PayPal, TIGO, Mobile money, Bank accounts and Barter.</p>
<h3>Getting Started</h3>
<h4>Minimum Requirements</h4>
<ul>
<li>Latest release versions of WordPress and WooCommerce (<a href="https://developer.woocommerce.com/?p=9998" rel="nofollow ugc">read more here</a>)</li>
<li>PHP version 7.0 or greater (PHP 7.4 or greater is recommended)</li>
<li>MySQL version 5.6 or greater</li>
</ul>
<p>Visit the <a href="https://docs.woocommerce.com/document/server-requirements/" rel="nofollow ugc">WooCommerce server requirements documentation</a> for a detailed list of server requirements.</p>


Flutterwave

Accept Credit card, Debit card and Bank account payment directly on your store with the official Flutterwave for Woo commerce.

LinkNacional Multi Currency for GiveWP vs Flutterwave