Vlastní blok vyvíjejte pro opakovanou specializovanou funkci, kterou jádrové bloky a vzory bezpečně nepokryjí. Navrhněte minimum srozumitelných ovládacích prvků, dostupný náhled, validaci a bezpečný veřejný výstup. Uložený formát verzujte a migraci připravte dříve, než změníte strukturu.
Vlastní blok pro Gutenberg poskytuje redaktorovi specializované rozhraní pro obsah, který běžné bloky nedokážou bezpečně vyjádřit. Může jít o kalkulačku, propojený seznam referencí, technickou tabulku nebo interaktivní prvek. Vývoj vlastního bloku však s sebou nese dlouhodobou kompatibilitu, migrace uloženého obsahu a testování editoru i veřejné stránky. Není vhodnou odpovědí na každou odlišnou sekci.
Nejprve je třeba ověřit, zda úlohu nevyřeší kombinace jádrových bloků, vzor nebo serverově vykreslená komponenta s jednoduchými poli. Vlastní blok má smysl, když opakovaná struktura potřebuje validaci, dynamická data nebo chráněné chování. Kvalitu neurčuje efektní panel nastavení, ale schopnost redaktora vytvořit správný obsah bez technických znalostí.
Ověřte, zda vlastní blok opravdu potřebujete
Sepište obsahovou úlohu a omezení. Pokud redaktor potřebuje opakovaně vkládat nadpis, text a tlačítko ve známém rozložení, je vzor z jádrových bloků jednodušší. Pokud vybírá konkrétní reference z databáze, zadává strukturované parametry nebo spouští výpočet, vlastní blok může snížit chybovost. Rozhodnutí podložte několika reálnými použitími, nikoli jedinou návrhovou obrazovkou.
Porovnejte také vlastní pole v šabloně a samostatný typ obsahu. Často aktualizovaný seznam lidí by neměl být ručně uložen v desítkách bloků; lepší je zvolit zdroj a výstup generovat. Kritickou byznys logiku oddělte do pluginu nebo služby a blok ať zůstane rozhraním. Šablona vzhledu pak může změnit vzhled bez ztráty funkcí a dat.
Navrhněte redakční rozhraní kolem úlohy
Používejte známé ovládací prvky WordPressu a názvy z jazyka redaktora. Nejčastější hodnoty patří přímo na plátno, pokročilé možnosti do bočního panelu. Každá volba má mít výchozí hodnotu a smysluplný prázdný stav. Pokud blok potřebuje šedesát nastavení vzhledu, pravděpodobně supluje designový systém místo jedné obsahové funkce.
Náhled v editoru má být dostatečně podobný veřejnému výsledku, nemusí však provádět rizikové externí akce. Zobrazte stav načítání, chybu, nulové výsledky i omezené oprávnění. Redaktor musí umět blok označit, přesunout a odstranit pomocí klávesnice. Instrukce nevkládejte pouze do placeholderu, který po začátku psaní zmizí.
- Minimum ovládacích prvků pro jednu úlohu
- Srozumitelné výchozí hodnoty
- Náhled chyb a prázdného stavu
- Ovládání dostupné klávesnicí
Vyberte statické, nebo dynamické vykreslování
Statický blok ukládá výsledné HTML do obsahu. Je rychlý na zobrazení a méně závislý na serverové logice, ale změna uloženého markupu může vyžadovat deprecaci a migraci starých verzí. Hodí se pro obsah, který se po publikování nemění bez redakčního uložení. Výstup musí zůstat sémantický a odolný vůči chybějícím atributům.
Dynamický blok ukládá atributy a HTML vytváří na serveru při zobrazení. Je vhodný pro aktuální data, dotazy nebo centrálně se měnící výstup. Vyžaduje bezpečné escapování, cache a kontrolu výkonu. Náhled v editoru může volat REST rozhraní s oprávněním. Rozhodujte podle životnosti dat, nikoli podle osobní preference vývojáře.
Chraňte kompatibilitu uloženého obsahu
Atributy mají mít jasný typ a stabilní význam. Přejmenování pole, změna zdroje hodnoty nebo odstranění obalu může způsobit hlášení neplatného bloku. U statického výstupu zachovejte starou verzi v deprecations a připravte transformaci. Migraci testujte na obsahu vytvořeném každou podporovanou verzí, nikoli jen na novém prázdném bloku.
Neukládejte do atributů odvozená data, která lze spolehlivě vypočítat, ani tajemství či citlivé odpovědi API. Při zrušení bloku nabídněte transformaci na jádrové bloky nebo zachování čitelného obsahu. Dokumentujte vlastnictví a závislosti. Web nesmí přijít o text jen proto, že se změnil plugin nebo název komponenty.
- Stabilní význam atributů
- Deprecation pro starý uložený markup
- Transformace při nahrazení bloku
- Testy nad historickým obsahem
Testujte výkon, bezpečnost a vydání
Skripty a styly načítejte pouze tam, kde se blok používá, pokud architektura umožňuje dělení. Serverový dotaz nevolejte pro každý záznam zvlášť; používejte přiměřenou cache a limity. Všechny vstupy validujte, URL a text escapujte a u administrativní akce kontrolujte oprávnění i nonce. Externí volání má timeout a bezpečný náhradní stav.
Automatické testy pokryjí serializaci, migraci atributů a serverový výstup. Ručně projděte vložení, kopírování, undo, duplikování, opětovné otevření i změnu šablony. Vydání blokového pluginu verzujte a nejprve ověřte ve stagingu s kopií reálného obsahu. Redaktorům stručně vysvětlete nový účel a situace, kdy mají použít běžný vzor.
Časté dotazy
Je vlastní Gutenberg blok lepší než shortcode?
Pro vizuální redakci často nabízí lepší náhled, validovaná pole a lepší objevitelnost. Shortcode může zůstat vhodný pro úzký existující případ, ale jeho parametry a chyby redaktor vidí hůře. Migraci je třeba posoudit podle obsahu.
Má vlastní blok patřit do šablony, nebo do pluginu?
Blok nesoucí funkci nebo data obvykle patří do pluginu, aby přežil změnu tématu. Čistě prezentační varianta úzce vázaná na design může být součástí tématu. Hranici určujte podle významu a životnosti.
Co se stane se starými bloky po změně kódu?
Při nekompatibilní změně mohou být označeny jako neplatné nebo zobrazit starý výstup. Proto je třeba zachovat deprecations, transformace a testovací vzorky historického obsahu a změnu nasadit přes staging.
Zdroje a další čtení
Adam Antoni vyvíja weby, aplikácie a softvér na mieru. Prepája firemné systémy, automatizuje procesy a vytvára AI agentov. Pôsobí v Spišskej Novej Vsi a spolupracuje s firmami na celom Slovensku.
