LinkNacional Multi Currency for GiveWP

Description

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

1. Currency Selection: Donors select their preferred currency from an elegant dropdown
2. Real-Time Conversion: Plugin fetches current exchange rates and displays amounts
3. Payment Processing: Converts foreign currency to BRL for Brazilian payment processors
4. 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

1. Navigate to Donations → Settings → General → Currency Settings
2. Enable Multi Currency option
3. Set your Default Currency (recommended: BRL)
4. Select Enabled Currencies for your donation forms
5. Save settings

Form-Level Configuration

1. Edit any GiveWP donation form
2. Go to Currency Options tab
3. Choose between Global Options or form-specific settings
4. Configure Default Currency and Enabled Currencies for this form
5. 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!

`bash