Description
Hugoatcanada Dollar Blue Bubble adds a small floating widget to your WordPress site showing the current Argentine “Dollar Blue” exchange rate, fetched automatically from DolarAPI.com.
Built for Argentine stores and websites that price in US dollars and want visitors to see the reference exchange rate without leaving the page.
Features:
- Configurable floating bubble (left/right side, custom pixel height)
- Shows buy and sell rates, with the date and time of the last update
- Fully customizable colors from the admin panel
[dolar_blue_bubble_rate]shortcode to show the rate anywhere in a page, post, or form (for example, Contact Form 7)- Can be limited to the front page only, or to shop/product pages if you use WooCommerce
- Configurable caching so the external API isn’t queried on every page load
- Does not require WooCommerce or any other plugin
If this plugin was useful to you, a small donation is always appreciated (and completely optional — it never affects how the plugin works). See the “Donate” link on this page.
External services
This plugin connects to DolarAPI.com, a free, public, third-party API that provides the current Argentine “Dollar Blue” exchange rate. It is needed to show the up-to-date rate in the floating bubble and in the [dolar_blue_bubble_rate] shortcode.
- What is sent: no personal data, cookies, or user identifiers are sent. The plugin performs a plain, unauthenticated HTTP GET request to
https://dolarapi.com/v1/dolares/blueto retrieve the current buy/sell rate. - When it is sent: whenever the cached rate has expired (the cache duration is configurable in the plugin’s settings, 20 minutes by default) and a page where the bubble or the shortcode is used is visited.
- Response caching: the response is cached using WordPress transients to avoid querying the API on every page load.
This service is provided by DolarAPI.com (an open-source project): Legal notice / Terms. DolarAPI.com does not publish a separate privacy policy, as it is an unauthenticated, read-only API that does not require or process personal data from visitors of sites using it.
Screenshots
Installation
- Upload the
hugoatcanada-dollar-blue-bubblefolder to/wp-content/plugins/, or install it directly from the Plugins search screen. - Activate the plugin from the “Plugins” menu.
- Go to Settings Dollar Blue Bubble to configure position, colors, and behavior.
FAQ
-
Do I need WooCommerce to use this plugin?
-
No. It works on any WordPress site, with or without a store.
-
Where does the exchange rate come from?
-
From the free, public DolarAPI.com API. See the “External services” section below for details.
-
Can I show the value inside a Contact Form 7 form?
-
The
[dolar_blue_bubble_rate]shortcode works in regular page content. Inside the Contact Form 7 form editor it is not processed by default (CF7 uses its own tag syntax), so a small additional plugin is needed to enable WordPress shortcodes there.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Hugoatcanada Dollar Blue Bubble” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Hugoatcanada Dollar Blue Bubble” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.2.1
- Escaped the value returned by the
[dolar_blue_bubble_rate]shortcode callback.
1.2.0
- Renamed the plugin to comply with WordPress.org naming guidelines.
- Moved inline CSS/JS to properly enqueued assets via
wp_enqueue_style()/wp_enqueue_script(). - Renamed internal functions, options, and identifiers to use a distinct 4+ character prefix.
- Documented the use of the DolarAPI.com external service.
1.1.0
- Added custom pixel height option.
- Fixed the close button hiding the entire bubble instead of just collapsing the panel.
1.0.0
- Initial release.