=== Hugoatcanada Dollar Blue Bubble ===
Contributors: hugoatcanada
Donate link: https://paypal.me/hughieiam
Tags: dolar blue, argentina, exchange rate, currency, woocommerce
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Displays a floating bubble on your site with the current Argentine "Dollar Blue" exchange rate.

== 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.

== Installation ==

1. Upload the `hugoatcanada-dollar-blue-bubble` folder to `/wp-content/plugins/`, or install it directly from the Plugins search screen.
2. Activate the plugin from the "Plugins" menu.
3. Go to Settings → Dollar Blue Bubble to configure position, colors, and behavior.

== Frequently Asked Questions ==

= 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.

== 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/blue` to 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](https://dolarapi.com/docs/legal). 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 ==

1. Floating bubble on the site.
2. Settings panel.

== 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.

== Upgrade Notice ==

= 1.2.0 =
Internal rename and technical compliance update, no visible changes for existing users.
