Hugoatcanada Dollar Blue Bubble

설명

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

스크린샷

설치

  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.

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.

후기

이 플러그인에 대한 평가가 없습니다.

기여자 & 개발자

“Hugoatcanada Dollar Blue Bubble”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다.

기여자

자국어로 “Hugoatcanada Dollar Blue Bubble”(을)를 번역하세요.

개발에 관심이 있으십니까?

코드 탐색하기는, SVN 저장소를 확인하시거나, 개발 기록을 RSS로 구독하세요.

변경이력

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.