WP Manifestindependent plugin directory
manifest / utilities / borderless-currency-calculator

Borderless Currency Calculator

A lightweight WordPress currency converter and calculator with live exchange rates, configurable currencies, currency flags, responsive design, and shortcode support.

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/anonymeniemc137/borderless-currency-calculator/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

A lightweight WordPress currency converter and calculator widget with live exchange rates, configurable currencies, currency flags, responsive design, and shortcode support.

Features

  • Live currency exchange rates
  • No API key required
  • Uses the Fawaz Ahmed Currency API
  • Select which currencies are available in the converter
  • Local currency list bundling (no external requests for settings page)
  • Configure default From and To currencies
  • Currency flags
  • Currency swap functionality
  • Responsive layout
  • Configurable appearance
  • Shortcode support
  • Two-decimal conversion values
  • Four-decimal exchange-rate display
  • Thousands separators for large amounts
  • WordPress Transients API caching
  • Cloudflare API fallback endpoint
  • No visitor account or personal information required

Shortcode

Add the following shortcode to any WordPress page, post, or shortcode-enabled area:

[bcc_currency_converter]

Requirements

  • WordPress 5.8 or higher
  • PHP 7.4 or higher

Installation

WordPress

  1. Download or clone the repository.
  2. Upload the borderless-currency-calculator folder to:
/wp-content/plugins/
  1. Activate Borderless Currency Calculator from the WordPress Plugins screen.
  2. Go to:
Settings > Borderless Currency Calculator
  1. Configure your currencies and appearance.
  2. Add the shortcode to your page:
[bcc_currency_converter]

Git

Clone the repository into your WordPress plugins directory:

git clone https://github.com/YOUR-USERNAME/borderless-currency-calculator.git

Exchange Rate API

This plugin uses the Fawaz Ahmed Currency API.

The API does not require an API key.

Exchange-rate responses are cached using WordPress transients to reduce repeated external requests. The currency list is bundled locally so the settings page does not need a separate external request.

The plugin uses a primary API endpoint and a documented Cloudflare fallback endpoint when the primary endpoint is unavailable.

Number Formatting

Converted amounts are displayed with two decimal places and thousands separators.

Example:

1,000.00 GBP = 1,338.26 USD

Exchange rates are displayed with four decimal places.

Example:

1 GBP = 1.3383 USD

Configuration

The plugin settings allow administrators to:

  • Select available currencies
  • Select default From currency
  • Select default To currency
  • Select all currencies
  • Clear all currency selections
  • Configure converter appearance
  • Configure frontend display options

Development

The plugin follows WordPress coding standards and includes a PHPCS configuration.

Run PHP syntax checks with:

php -l borderless-currency-calculator.php

Run PHP CodeSniffer with:

phpcs --standard=phpcs.xml.dist .

Privacy

Borderless Currency Calculator does not require visitors to create an account and does not collect visitor information.

Exchange-rate requests are sent to the Fawaz Ahmed Currency API to retrieve current exchange-rate data.

License

This plugin is licensed under the GPL v2 or later.

See the LICENSE file for details.

Credits

Exchange-rate data is provided by the Fawaz Ahmed Currency API project:

https://github.com/fawazahmed0/currency-api

Changelog

1.0.0

  • Initial WordPress.org submission release
  • Configurable currency selection
  • Live exchange rates
  • Currency flags
  • Currency swapping
  • Responsive converter
  • Shortcode support
  • Exchange-rate caching
  • Configurable frontend appearance