| difer Magellan CMF | | | Aktualności | | | Oferta | | | Dokumentacja | | | Kontakt |
Szablony - składnia znaczników
Składnia znaczników jest wyjątkowo prosta i podobna do wielu innych rozwiązań, dzięki czemu ewentualna migracja szablonów z innych parserów nie powinna powodować większych trudności. Elementy / komendy zawarte są w nawiasach klamrowych { i }.
Aktualnie dostępne znaczniki
{nazwa}
Podstawienie elementu / zmiennej. W miejsce znacznika wstawiana jest zmienna z tablicy zmiennych parsera (tablicy elementów do podstawienia).
{nazwa.klucz}
Jak wyżej, ale dotyczy zmiennych jeśli są elementami tablic. Kropka oddziela kolejne klucze / podklucze.
{blok:nazwa}
fragment
{/blok:nazwa}
Objęcie fragmentu w blok daje możliwość sterowania obecnością fragmentu w treści szablonu. Sterowanie odbywa się z kontrolera / modułu. Wszystkie bloki w szablonie są domyślnie ustawione w tryb ukrywania. Wywołanie metody aktywuj_blok(nazwa) na obiekcie widoku powoduje uaktywnienie obecności fragmentu.
{_blok:nazwa}
Wstawia w miejsce swojego wystąpienia zawartość bloku zadeklarowanego znacznikiem {blok:nazwa} ... (wstawienie kopii bloku). Sterowanie obecnością podobnie jak w przypadku poprzedniego znacznika.
{tpl:nazwa_pliku}
Wstawia do aktualnie parsowanego szablonu zawartość z innego pliku szablonu, określonego w nazwa_pliku. Nazwa pliku może posiadać dowolne rozszerzenie, nie może zawierać spacji. Wstawienie następuje w miejscu gdzie wystąpił znacznik. Plik musi być obecny w katalogu szablonów. Brak pliku nie powoduje błędu - znacznik jest wówczas usuwany z treści szablonu.
{include:nazwa_pliku}
Powoduje wczytanie i wykonanie skryptu php znajdującego się w obrębie katalogu szablonów. Skrypt musi w sobie ustawiać zmienną $_return, która jest wstawiana w miejsce znacznika. Używanie tego znacznika jest zalecane tylko w przypadku ostatecznosci lub w przypadku bardzo skomplikowanych serwisów.
{sekcja:nazwa}
fragment
{/sekcja:nazwa}
Znacznik pętli obejmujący swoim otwarciem i zamknięciem fragment powtarzany tyle razy, ile elementów posiada tablica o nazwie nazwa. Tablica znajduje się w tablicy zmiennych parsera (tablicy elementów do podstawienia). Jeśli fragment zawiera zmienne do podstawienia, np. to podczas parsowania pętli zostaną one zaindeksowane ($id[0]...$id[n]) i przypisane zostaną im odpowiednie wartości. Jeśli okaże się, że zmienna indeksowana nie istnieje parser spróbuje podstawić zmienną bez indeksu ($id, z tablicy zmiennych do podstawienia).
{if(zmienna=='wartość')}{zmienna2} fragment { /if}
Instrukcja warunkowa. Jeśli zmienna jest równa wartości to do zmiennej2 przypisz zawartość fragmentu. Warunek może być warunkiem ==,!=, >, <, >=, <=, !, czyli podobonie jak w składni języka php. Zmienna i zmienna2 są elementami z tablicy zmiennych parsera (tablicy elementów do podstawienia).
{if:nazwa(zmienna=='wartość')} fragment {/if:nazwa}
Instrukcja warunkowa dla pętli (o nazwie określonej znacznikiem sekcja). Działa jak w poprzednim przypadku z tą różnicą, że jeśli warunek jest spełniony przypisanie zawartości fragmentu następuje do tej samej zmiennej (jeśli zmienna równa się wartości, to do zmiennej przypisz zawartość fragmentu).
Aktualnie dostępne znaczniki
{nazwa}
Podstawienie elementu / zmiennej. W miejsce znacznika wstawiana jest zmienna z tablicy zmiennych parsera (tablicy elementów do podstawienia).
{nazwa.klucz}
Jak wyżej, ale dotyczy zmiennych jeśli są elementami tablic. Kropka oddziela kolejne klucze / podklucze.
{blok:nazwa}
fragment
{/blok:nazwa}
Objęcie fragmentu w blok daje możliwość sterowania obecnością fragmentu w treści szablonu. Sterowanie odbywa się z kontrolera / modułu. Wszystkie bloki w szablonie są domyślnie ustawione w tryb ukrywania. Wywołanie metody aktywuj_blok(nazwa) na obiekcie widoku powoduje uaktywnienie obecności fragmentu.
{_blok:nazwa}
Wstawia w miejsce swojego wystąpienia zawartość bloku zadeklarowanego znacznikiem {blok:nazwa} ... (wstawienie kopii bloku). Sterowanie obecnością podobnie jak w przypadku poprzedniego znacznika.
{tpl:nazwa_pliku}
Wstawia do aktualnie parsowanego szablonu zawartość z innego pliku szablonu, określonego w nazwa_pliku. Nazwa pliku może posiadać dowolne rozszerzenie, nie może zawierać spacji. Wstawienie następuje w miejscu gdzie wystąpił znacznik. Plik musi być obecny w katalogu szablonów. Brak pliku nie powoduje błędu - znacznik jest wówczas usuwany z treści szablonu.
{include:nazwa_pliku}
Powoduje wczytanie i wykonanie skryptu php znajdującego się w obrębie katalogu szablonów. Skrypt musi w sobie ustawiać zmienną $_return, która jest wstawiana w miejsce znacznika. Używanie tego znacznika jest zalecane tylko w przypadku ostatecznosci lub w przypadku bardzo skomplikowanych serwisów.
{sekcja:nazwa}
fragment
{/sekcja:nazwa}
Znacznik pętli obejmujący swoim otwarciem i zamknięciem fragment powtarzany tyle razy, ile elementów posiada tablica o nazwie nazwa. Tablica znajduje się w tablicy zmiennych parsera (tablicy elementów do podstawienia). Jeśli fragment zawiera zmienne do podstawienia, np. to podczas parsowania pętli zostaną one zaindeksowane ($id[0]...$id[n]) i przypisane zostaną im odpowiednie wartości. Jeśli okaże się, że zmienna indeksowana nie istnieje parser spróbuje podstawić zmienną bez indeksu ($id, z tablicy zmiennych do podstawienia).
{if(zmienna=='wartość')}{zmienna2} fragment { /if}
Instrukcja warunkowa. Jeśli zmienna jest równa wartości to do zmiennej2 przypisz zawartość fragmentu. Warunek może być warunkiem ==,!=, >, <, >=, <=, !, czyli podobonie jak w składni języka php. Zmienna i zmienna2 są elementami z tablicy zmiennych parsera (tablicy elementów do podstawienia).
{if:nazwa(zmienna=='wartość')} fragment {/if:nazwa}
Instrukcja warunkowa dla pętli (o nazwie określonej znacznikiem sekcja). Działa jak w poprzednim przypadku z tą różnicą, że jeśli warunek jest spełniony przypisanie zawartości fragmentu następuje do tej samej zmiennej (jeśli zmienna równa się wartości, to do zmiennej przypisz zawartość fragmentu).
v: 6.0.80 | © 2002-2007 difer.net |
