WordPress Plugin Documentation
Learn how to install, configure, and customize your currency converter widget
Table of Contents
1 Installation
Method 1: Install from WordPress (Recommended)
- Go to your WordPress admin dashboard
- Navigate to Plugins > Add New
- Search for "Currency.Wiki Converter"
- Click "Install Now" and then "Activate"
Method 2: Manual Installation
- Download the plugin from WordPress.org
- Go to Plugins > Add New > Upload Plugin
- Choose the downloaded ZIP file and click "Install Now"
- Activate the plugin after installation
2 Using Gutenberg Block
The easiest way to add the currency converter to your pages:
- Edit any page or post using the Gutenberg editor
- Click the + button to add a new block
- Search for "Currency Converter" or browse the Widgets category
- Configure the widget using the sidebar panel on the right
Tip: You can see a live preview of your widget as you change settings in the block editor.
3 Shortcode Usage
You can also add the widget using shortcodes in posts, pages, or theme templates:
Basic Usage
[currencywiki_converter]
Available Attributes
| Attribute | Default | Description |
|---|---|---|
| style | compact | Widget style (compact, inline, tall, mini-chart, etc.) |
| theme | auto | Color theme (auto, light, dark) |
| from | USD | Default source currency (3-letter ISO code) |
| to | EUR | Default target currency (3-letter ISO code) |
| amount | 1 | Default amount to convert |
| accent | #3b82f6 | Accent color (hex code like #3b82f6) |
| embed | script | Embed method (script or iframe) |
| width | auto | Custom width in pixels |
| height | auto | Custom height in pixels |
Examples
Dark theme widget:
[currencywiki_converter theme="dark"]
Custom currencies and amount:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
Mini chart style:
[currencywiki_converter style="mini-chart"]
Using iframe embed (for theme compatibility):
[currencywiki_converter embed="iframe"]
4 Widget Styles
Choose from multiple widget styles to match your website design:
mini
Minimal converter, perfect for tight spaces (250x140px)
square
Square 1:1 aspect ratio converter (250x250px)
compact
Small, space-efficient converter (280x200px)
inline
Horizontal layout, great for headers (450x120px)
tall
Vertical layout with classic labels (220x360px)
mini-chart
Compact converter with historical chart (250x260px)
multi-expandable
Convert to multiple currencies, users can add/remove (300x400px)
multi-fixed
Fixed list of multiple currency conversions (280x360px)
rates-compact
Simple exchange rates list (260x260px)
rates-viewer
Full rates viewer with chart (350x420px)
rates-viewer-compact
Compact rates viewer with chart (300x340px)
Tip: Use the Widget Builder in your WordPress admin to preview all styles before adding them to your site.
5 Configuration Options
The plugin settings page in your WordPress admin allows you to configure default options:
Theme Options
- auto - Automatically matches your site's color scheme
- light - Always use light background
- dark - Always use dark background
Embed Method
- script - Default. Widget loads inline with full functionality. Currency dropdowns display over surrounding content.
- iframe - Fallback option. Widget loads in isolated iframe. Use if you experience style conflicts with your theme.
Note: If currency dropdowns appear behind other elements or get cut off, try switching to iframe embed mode.
6 Troubleshooting
Widget not showing?
Make sure the plugin is activated. Check if any caching plugins need to be cleared. Try using the iframe embed method if script embed doesn't work.
Widget looks broken or styles conflict?
Some WordPress themes may conflict with the widget script. Switch to iframe embed mode by adding embed="iframe" to your shortcode.
Currency dropdown hidden or cut off?
This can happen when container elements have overflow:hidden. Try using iframe embed mode, or adjust your theme's CSS to allow overflow on the widget container.
Widget showing old rates?
Exchange rates update automatically. If you're using a caching plugin, make sure to exclude the widget scripts from caching or clear your cache after making changes.
Need Help?
Can't find what you're looking for? Our support team is here to help.
