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