Modul Náhrady nám umožňuje definovat pravidla, která automaticky zamění určitý vzor v textu za jiný obsah až ve chvíli, kdy se článek zobrazuje na webu. Typicky slouží ke vkládání opakujícího se nebo složitějšího kódu — například vloženého videa, mapy nebo tlačítka — pomocí krátké značky, kterou v článku napíšeme místo celého kódu. Náhrady jsou společné pro celý web (jeden sdílený seznam) a uplatňují se na obsah a perex článků.
Kde modul najdeme
Modul otevřeme v administraci přes položku Náhrady. Obrazovka nabízí v záhlaví tlačítka Import, Export a Nová náhrada, pod nimi pole pro hledání a tabulku se všemi pravidly.
Jak náhrada funguje
Každé pravidlo spojuje dvojici „co hledat“ a „čím nahradit“:
- Šablona (hledej) — vzor, který se v textu vyhledává; zapisuje se jako regulární výraz.
- Náhrada — obsah (zpravidla HTML kód), kterým se nalezený vzor při zobrazení nahradí.
V praxi tedy do článku napíšeme jen dohodnutou značku a návštěvník na webu uvidí až výsledný kód (přehrávač videa apod.). Kromě vlastních pravidel se v obsahu článku vždy doplní i systémové značky {id} (číslo článku) a {lang} (jazyk).
Vlastnosti náhrady
Při zakládání nebo úpravě pravidla vyplňujeme:
- Název — pojmenování pravidla (musí být jedinečné); zadáváme ho jen při založení, později už ho neměníme.
- Popis — doplňující text, k čemu pravidlo slouží.
- Ukázka kódu — příklad značky, kterou do článku vkládáme; slouží jako nápověda.
- Šablona (hledej) a Náhrada — vlastní pravidlo (viz výše).
- Aktivní — příznak zapnutí pravidla.
- Viditelné v editoru — pokud je zapnuté, nabízí se pravidlo přímo v textovém editoru článku jako vkládatelný prvek, takže značku nemusíme psát ručně.
- Block prvek — určuje, že se prvek v editoru chová jako blok (samostatný odstavec), ne jako vložka uvnitř textu.
- Barva badge — barva odznaku, kterým se vložený prvek označí v editoru (hexadecimální kód, nebo výběr z palety).
Seznam a hledání
Do pole Hledání zadáme část textu a potvrdíme tlačítkem Hledej (nebo klávesou Enter); tlačítko Reset vrátí hledání i řazení na výchozí stav. Tabulka zobrazuje sloupce ID, Název, Popis, Ukázka kódu a Viditelné (zda se pravidlo nabízí v editoru). Kliknutím na záhlaví ID, Název nebo Viditelné seznam přeřadíme. U každého řádku máme tlačítka Upravit a Smazat, pod tabulkou je stránkování a volba počtu záznamů na stránku (20/50/100).
Založení, úprava a mazání
Tlačítkem Nová náhrada otevřeme okno s formulářem výše a založení dokončíme tlačítkem Vytvořit. Tlačítkem Upravit u řádku změníme existující pravidlo (název už neměníme). Tlačítkem Smazat pravidlo odstraníme — systém se nejdříve zeptá na potvrzení.
Export a import
Pravidla lze přenášet mezi weby souborem ve formátu JSON:
- Export stáhne buď všechna pravidla, nebo jen ta, která si v tabulce označíme zaškrtávátky (u tlačítka se pak zobrazí počet vybraných). Hodí se i jako záloha před větší úpravou.
- Import načte pravidla ze souboru. Každý záznam se vkládá jako nový; pokud už existuje pravidlo se stejným názvem, doplní se k importovanému název příznak „- duplicita“ (případně „- duplicita 2“ atd.), takže se nic nepřepíše.