=== BNR Curs Valutar (Shortcode + Widget) ===
Contributors: grig
Tags: bnr, curs valutar, exchange rate, ron, eur, usd, shortcode, widget, converter
Requires at least: 5.0
Tested up to: 6.9.1
Requires PHP: 7.2
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Preia cursul valutar BNR din XML-ul oficial și îl afișează în site prin shortcodes, widget și un mini-convertor.

== Description ==

Pluginul preia cursul valutar de la BNR (XML oficial) și îl memorează în cache (transients), ca să nu facă request la fiecare afișare.

Funcționalități:
* Shortcode-uri:
  * `[bnr_rates]` – listă/tabel/inline cu mai multe valute
  * `[bnr_rate]` – o singură valută
  * `[bnr_converter]` – mini convertor (RON <-> valute și valute între ele)
* Widget clasic: „BNR: Curs valutar + Convertor”
* Cache cu transients (configurabil prin atributul `ttl`)
* Sursele XML pot fi modificate din `Settings -> Curs BNR`
* Suport pentru valute cu multiplier (ex. 100 HUF) – normalizează implicit la 1 unitate

Surse oficiale:
* https://www.bnr.ro/nbrfxrates.xml
* https://www.bnr.ro/nbrfxrates10days.xml

== Installation ==

1. Încarcă arhiva ZIP din `Plugins -> Add New -> Upload Plugin`.
2. Activează pluginul.
3. Folosește shortcodes în pagini/articole sau adaugă widgetul în `Appearance -> Widgets`.

== Shortcodes ==

= 1) Mai multe valute (tabel) =
`[bnr_rates currencies="EUR,USD,GBP" format="table"]`

Atribute:
* `currencies` (ex. `EUR,USD,GBP`)
* `format` = `table` | `list` | `inline`
* `mode` = `daily` | `10days`
* `date` = `latest` sau `YYYY-MM-DD` (mai ales cu `10days`)
* `decimals` (ex. `4`)
* `show_date` = `1` / `0`
* `show_multiplier` = `1` pentru „exact ca BNR” (ex. 100 HUF), altfel normalizează la 1 unitate
* `ttl` (cache în secunde)

= 2) O singură valută =
`[bnr_rate currency="EUR" prefix="1 EUR = " suffix=" RON"]`

= 3) Mini convertor =
`[bnr_converter currencies="EUR,USD,GBP" default_from="RON" default_to="EUR"]`

== Settings ==

După activare, mergi la `Settings -> Curs BNR`.

Poți modifica:
* URL XML curs zilnic
* URL XML ultimele 10 zile

La salvarea setărilor, cache-ul este golit automat.

Pagina oficială BNR de referință pentru fișierele XML:
https://www.bnr.ro/23988-cursurile-pietei-valutare-in-format-xml

Important: în câmpurile de setări trebuie introdus URL-ul fișierului XML, nu URL-ul paginii HTML de documentație.

== Frequently Asked Questions ==

= De ce unele valute (ex. HUF) par „prea mari/mici”? =
BNR publică uneori cursul pentru 100 unități (multiplier). Pluginul normalizează implicit la 1 unitate. Dacă vrei exact cum e în tabelul BNR, folosește `show_multiplier="1"` la `[bnr_rates]`.

= Pot folosi convertorul între două valute (ex. USD -> EUR)? =
Da. Convertorul permite `Din` și `În` orice pereche disponibilă.

== Changelog ==

= 1.2.0 =
* Adăugată pagina `Settings -> Curs BNR`
* URL-ul XML pentru cursul zilnic poate fi modificat
* URL-ul XML pentru ultimele 10 zile poate fi modificat
* Cache separat în funcție de URL-ul sursă
* Cache golit automat la salvarea sursei XML
* Adăugat link către pagina oficială BNR despre fișierele XML


= 1.1.1 =
* Fix: mini-convertor funcțional (JSON ne-escapat în HTML)
* Widget: link în footer către pagina modulului
* Actualizat Plugin URI


= 1.1.0 =
* Adăugat widget
* Adăugat mini-convertor (shortcode + în widget)
* Mutat stilurile/JS în fișiere de assets
* Adăugat uninstall pentru curățarea cache-ului

= 1.0.0 =
* Prima versiune: `[bnr_rates]` și `[bnr_rate]`

== License ==
GPLv2 or later
