Home  .  difer  .  Logowanie klientów
strona główna strona główna


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).



v: 6.0.80 | © 2002-2007  difer.net  |  difer Magellan 6.0.80