=== BN Currency Widget — Kursy NBP od bankowynet.pl ===
Contributors: bankowynet
Tags: currency, nbp, exchange-rates, kursy-walut, polish-zloty
Requires at least: 5.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Shortcode [bn_currency_widget] wyświetlający aktualne kursy walut NBP. Dane z bankowynet.pl REST API.

== Description ==

Lekki widget pokazujący aktualne kursy walut Narodowego Banku Polskiego (Tabela A) na dowolnej stronie WordPress. Plugin pobiera dane z publicznego REST API bankowynet.pl (cache 5 minut), brak konieczności konfiguracji.

= Funkcje =

* Shortcode `[bn_currency_widget]` — wstawia widget w treść posta/strony
* Gutenberg block (server-side rendered)
* Domyślnie pokazuje EUR/USD/GBP/CHF, konfigurowalna lista (max 12 walut)
* 3 rozmiary: small/medium/large
* Cache 5 minut w transient (mała obciążenie API)
* Branding link "Powered by bankowynet.pl" (wymagany przez TOS API)
* Brak JS na frontend (czysty PHP+HTML)
* Brak zewnętrznych zależności

= Użycie =

Najprostsze:
`[bn_currency_widget]`

Z konfiguracją:
`[bn_currency_widget codes="EUR,USD,GBP,CHF,NOK" size="large" title="Kursy NBP"]`

= Parametry =

* `codes` — lista 3-literowych kodów ISO walut, oddzielone przecinkami (domyślnie EUR,USD,GBP,CHF)
* `size` — small | medium | large (domyślnie medium)
* `title` — nagłówek widgetu (domyślnie "Kursy walut NBP", pusty string = bez nagłówka)
* `link` — yes | no (domyślnie yes; "no" ukrywa branding link, NIE zalecane — wymagane przez TOS API)

== Installation ==

1. Pobierz `bn-currency-widget.zip`
2. WordPress admin → Wtyczki → Dodaj nową → Wyślij wtyczkę → wybierz ZIP
3. Aktywuj wtyczkę
4. Wstaw `[bn_currency_widget]` w treść posta/strony

== Frequently Asked Questions ==

= Skąd pochodzą dane? =

Z publicznego REST API bankowynet.pl, które jest mirrorem Tabeli A NBP (źródło: api.nbp.pl, cache na bankowynet.pl 12 godzin).

= Jak często aktualizują się kursy? =

NBP publikuje Tabelę A raz dziennie ok. 12:00. Widget cachuje 5 minut, więc po każdym requestcie świeży kurs jest dostępny w przeciągu 5 minut od publikacji.

= Czy plugin obsługuje SSL/HTTPS? =

Tak. Wszystkie połączenia z bankowynet.pl idą przez HTTPS.

= Czy mogę używać własnego źródła danych? =

Plugin używa stałej `BN_CW_API_URL` (https://bankowynet.pl/wp-json/bn-currency/v1/rates). Możesz nadpisać przez wcześniejsze define() w wp-config.php LUB w mu-plugin przed loadem.

= Czy są wymagania API key? =

Nie. API bankowynet.pl jest publiczne (rate-limited per IP, ~60 req/min).

== Changelog ==

= 1.0.0 =
* Initial release.
* Shortcode `[bn_currency_widget]` z 4 parametrami.
* Gutenberg block (server-side render).
* Cache 5 min via transient.
* Branding link required.
