Breadcrumbs

Drobečková navigace pro WordPress, s daty pro libovolnou šablonu

Breadcrumbs vygeneruje trasu typu Domů › Kategorie › Příspěvek a nechá kompletně na tobě, jak ji vykreslíš — přes PHP funkci, shortcode, nebo přímo v Twig šabloně. K trase navíc automaticky přidá schema.org strukturovaná data pro vyhledávače.

Hlavní funkce

  • Funkce smrk_breadcrumbs() vrací strukturované pole {label, url, is_home, is_current} — žádné vnucené HTML
  • Shortcode [smrk_breadcrumbs] pro rychlé použití bez psaní PHP
  • Na weby s Timberem se stejná data zpřístupní i jako Twig funkce — {{ fn('smrk_breadcrumbs') }} funguje bez dalšího propojování
  • Nastavitelný text nebo vlastní HTML pro štítek „Domů“
  • Nastavitelný oddělovač trasy (text i HTML)
  • Volitelné zařazení archivních stránek vybraných typů obsahu do trasy
  • Automatický výstup schema.org BreadcrumbList (JSON-LD) pro rich snippety ve výsledcích vyhledávání

Jak to funguje

smrk_breadcrumbs() sestaví trasu podle aktuálního WP_Query kontextu (typ obsahu, taxonomie, archiv, vyhledávání) a vrátí pole jednotlivých kroků jako čistá data, bez jediného tagu HTML — jak trasu vykreslíš (ul/li, span s oddělovači, cokoliv) je čistě na šabloně tématu.

Pokud modul detekuje aktivní Timber, zaregistruje stejnou funkci i jako Twig function, takže {{ fn('smrk_breadcrumbs') }} funguje v šabloně bez jakéhokoliv dalšího propojovacího kódu. Ze stejných dat se navíc sestaví JSON-LD blok se schema.org typem BreadcrumbList a vypíše se do <head>.

Časté dotazy

Musím trasu vykreslovat přesně tak, jak to dělá modul?
Ne — funkce vrací jen strukturovaná data, HTML a CSS si napíšeš přesně podle potřeb vlastní šablony.
Funguje to i bez Timberu?
Ano, základ je čistá PHP funkce a shortcode. Twig funkce se zaregistruje navíc jen tehdy, když web Timber skutečně používá.
Pomůže to i s SEO?
Ano, k trase se automaticky přidávají schema.org strukturovaná data (BreadcrumbList), díky kterým může vyhledávač zobrazit trasu přímo ve výsledcích.