Proměnné webu
Občas se na webu v textu vyskytuje nějaký obsah, který se časem mění a přitom se navíc opakuje na více místech. Typicky třeba aktuální akademický rok. V takovém případě je potřeba při změně akademického roku najít všechny jeho výskyty napříč stránkami a ručně opravit. To může být dost frustrující. Řešením může být právě modul pro proměnné webu. Díky němu do textu napíšete jen zástupné symboly, které se při vykreslení stránky nahradí centrálně nastavenými hodnotami.
Pokud chcete využívat proměnné na vašem webu, kontaktujte nás. Na web vám přidáme potřebný modul.
Chci požádat o modul pro proměnné webu
Jak to funguje
- Jedná se o modul, ve kterém se centrálně definují proměnné a jejich hodnoty. V textech na stránkách se pak na patřičných místech umístí zástupné symboly ve tvaru:
- ?{alias}?
- Máme takto tedy definovanou např. proměnnou s názvem:
- akademickyRok s hodnotou: 2023/2024
- Na vlastní stránku ji v Umbraco do textu vkládáme ve tvaru:
- ?{akademickyRok}?
- A při vykreslení stránky se zobrazí jako:
- 2023/2024.
Nastavení proměnných webu
Pokud už tedy máte pod svým webem v části „Nastavení webu“ přidaný modul „Proměnné webu“, můžete jej začít využívat.
Nejprve klikněte pravým tlačítkem na modul „Proměnné webu“, dejte „Vytvořit“ a vytvořte „Nastavení proměnných pro časové období“. To si nějak pojmenujte pro lepší orientaci, např. „Akademický rok 2023/2024“.
Zde pak zadáváte „Datum OD“ a „Datum DO“. Jde o časové rozmezí, ve kterém se budou dané texty takto nahrazovat. Datumy od a do jsou ale nepovinné. Pokud nezadáte dolní časovou hranici, platí proměnné okamžitě od uložení a zveřejnění. Pokud nezadáte horní časovou hranici, jejich platnost neskončí nikdy. Pokud tedy nezadáte ani jedno datum, jsou proměnné platné pořád.
Dále je zde samotná „Definice proměnných“. Do ní můžete tlačítkem „+“ přidávat vlastní proměnné webu. U každé zadáte její název a vlastní text pro nahrazení. Text je potřeba zadat ve všech jazykových verzích webu. Pokud jednu verzi necháte prázdnou, nebude v tomto jazyce nahrazení dané proměnné funkční.
A pak už můžete na konkrétních stránkách pod vaším webem vkládat při editaci v Umbraco zástupné symboly – placeholdery s názvy proměnných. Tyto symboly je možno použít téměř všude; v textu, v odkazech, v popiscích tlačítek, článků, a dalších komponent.
Na dané stránce se pak uživatelům zobrazí příslušný text.
Další možnosti použití
Více nastavení proměnných (tedy uzlů typu „Nastavení proměnných pro časové období“) může být platných zároveň. Hodnoty proměnných jsou pak výsledkem jejich sjednocení. Pokud je proměnná definována ve více obdobích, výsledná hodnota se vezme z posledního (dle pořadí stránek v Umbracu). Můžete mít tedy jedno nastavení "globální proměnné", které se nebude měnit často, a pod ním pak nastavení dílčích proměnných pro jednotlivá období. Zároveň můžete nějakou hodnotu proměnné z globálního nastavení přebít hodnotou pro určité období.
Možnost více nastavení proměnných se dá využít i pro omezení oprávnění pro jejich úpravy. Můžete pro různé skupiny uživatelů vytvořit více potomků typu „Nastavení proměnných pro časové období“ tak, aby nezasahovali do hodnot, které se jich netýkají.
Chyby v zástupných symbolech
Pokud je v textu použit zástupný symbol, k němuž není definována hodnota, zobrazí se na webu v původní podobě bez nahrazení. Zároveň je v budoucnu v plánu tuto situaci zaznamenat a upozornit editory webu, to se ale zatím neděje.