LinkNacional Multi Currency for GiveWP

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:

js – Compiled PayPal Commerce integration

js – Compiled currency selector

The uncompiled source code is available on GitHub:

com/LinkNacional/give-multimoeda

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!