Doplněk CNB Exchange Rates získává informace o aktuálních směnných kurzech ze zdrojových souborů zveřejněných Českou národní bankou (ČNB) a následně zajišťuje jejich výstupy v rámci Grav CMS, ať již na požadované stránce nebo v postranním widgetu.

Doplněk CNB Exchange Rates nalezne uplatnění v podstatě pouze u české komunity, popřípadě u uživatelů, kteří mají potřebu zveřejňovat kurzy na svých stránkách. De facto vznikl pouze jako vedlejší produkt testování určitých funkcionalit, které potřebuji použít v jiném doplňku, nicméně mi přišlo škoda jej nezveřejnit, když je hotový. Současně lze doplněk využít i jako vzorový příklad pro získávání informací z vnějších zdrojů ve strojově čitelné podobě. Snadno lze i „přeportovat“ kód z doplňku a použít jej napřímo na stránkách běžících na PHP mimo Grav.

Doplněk vrací pole obsahující kompletní informace o aktuálních kurzech, které je možné vypsat samostatně nebo hromadně. Samozřejmostí je třídění pole názvu země (má význam pouze u angličtiny, u češtiny je vhodné nechat výchozí řazení, které ctí diakritiku) nebo kódu měny. Výstup lze libovolně formátovat – po řádcích, do netříděných seznamů, popřípadě do tabulek.

Jednoduchý Twig kód:

{{ cnb()['USD']['country'] }} ({{ cnb()['USD']['currency'] }}) - {{ cnb()['USD']['amount'] }} {{ cnb()['USD']['code'] }} = {{ cnb()['USD']['rate'] }} CZK

zajistí tento výstup (kurz amerického dolaru ze dne 27. 2. 2023):

USA (dolar) - 1 USD = 22,380 CZK

Výpis všech dostupných měn zajistí například tento Twig kód:

{% for cnb in cnb() %}
    {{ cnb.country|e }} ({{ cnb.currency|e }}) - {{ cnb.amount|e }} {{ cnb.code|e }} = {{ cnb.rate|e }} CZK<br />
{% endfor %}

Základní informace jsou k dispozici v README.md. Podrobnější informace budou výhledově k dispozici v sekci demo.

Doplněk CNB Exchange Rates je aktuálně dostupný ve verzi 1.0.0 v repozitáři. Po validaci ze strany autorů Grav CMS bude k dispozici i v seznamu doplňků a současně i k přímé instalaci přes Admin Panel.