Wszystkie znaczniki patTemplate muszą zawierać nazwy, które umożliwiają odróżnienie znaczników XML patTemplate od pozostałych znaczników HTML, xHTML i innych znaczników XML. Domyślną nazwą jest patTemplate ale oczywiście można ją zmieniać, najlepiej w z wykorzystaniem metody nazwanej setNamespace.

Szaty grficzne są częścią stron html, które mogą być wyświetlane za pomocą engine'u szat graficznych. Aby pewnie zidentyfikować część stron jako szablon graficzny pat Templates wykorzystuje znaczniki XML aby przypisać do szaty graficznej unikalną nazwę i różne atrybuty (zobacz Znaczniki patTemplate i Atrybuty aby poznać listę wszystkich znaczników i atrybutów). Podczas analizowania pliku szablonu parser dzieli stronę na kilka kawałków i traktuje je jako oddzielne szaty graficzne. Stosując API patTemplate możesz ukryć, wyświetlać albo powtarzać bieżący szablon.

Szablon graficzny może zawierać tyle szablonów ile sobie tylko życzysz. Szablony mogą być następujących typów (definiowanych poprzez użycie atrybutów type="...")

• Standard - na wyjściu szata graficzna jest zawsze taka sama
• OddEven - możesz przypisać sub-szablony do tego typu: Parzysty i Nieparzysty (Odd and Even), które będą podmieniane, gdy szablon jest przeładowywany
• Modulo - jest podobny do typu OddEven z tą małą różnicą, że możesz mieć więcej niż 2 sub-szablony. OddEven jest prostym typem, specjalnym przypadkiem Modulo kiedy atrybut jest równy 2
• Condition - możesz przypisać tak wiele szablonów jak sobie życzysz ale musisz przypisać jeden, który będzie użyty do porównania określonych warunków sub-szablonów. To pozwoli ci zdefiniować różny kod HTML dla każdej wartości twojej warunkowej zmiennej, którą możesz mieć. Są dwa specjalne warunki: domyślny (default), który jest podobny do przełącznika switch/case i pusty, który wyświetla się kiedy nie ma żadnej wartości przypisanej do zmiennej warunkowej
• SimpleCondition - niekorzystna sytuacja, która często się pojawia podczas powstania błędu to wyświetlenie komunikatu błędu. Standardowo możesz ustawić komunikat błędu jeśli jest takowa albo możesz ukryć szablon poprzez użycie setAttribute() jeśli nie ma odpowiedniej strony błędów. Poprzez zastosowanie szablonu typu SimpleCondition możesz przypisać listę zmiennych, które muszą być ustawione jeśli szablon ma zostać wyświetlony. Jeśli, któraś z nich nie jest ustawiona szablon się nie wyświetli.

PatTemplate wykorzystuje zmienne podobnie do innych języków programowania. Można stosować zmienne lokalne (przypisane za pomocą metody addVar) i zmienne globalne (przypisane metodą addGlobalVar).

Zmienne globalne mogą być tylko zmiennymi skalarnymi (string, integer ...) a zmienne lokalne mogą być tylko tablicami. Jeśli przypiszesz jakąś tablicę do zmiennej, szablon gdzie wystąpiło przypisanie zostanie powtórzony.

Jeśli warunkowy szablon ma ustawione useglobals="yes" atrybuty globalne zostaną wykorzystane jeśli nie żadne lokalne zmienne nie są ustawione.

Zmienne muszą być zapisywane dużymi literami i mogą tylko zawierać znaki, cyfry i podkreślenia (_). Zmienne zawsze są zamknięte nawiasami klamrowymi, np {FOO}.

Zmienne są zamieniane na przenoszone przez nie wartości podczas przetwarzania szablonu.

Jest kilka predefiniowanych zmiennych systemowych, które są dostępne kiedy ustawisz atrybut addsystemvars.

• PAT_ROW_VAR - możesz ją wykorzystać gdy chcesz ponumerować szablon, który jest automatycznie powtarzany. Po prostu wstaw zmienną PAT_ROW_VAR do swojego szablonu jeśli chcesz aby pojawiała się numeracja (może być wykorzystywana przez JavaScript - mouseovers)
• PAT_LOOPS -
• PAT_IS_FIRST -
• PAT_IS_LAST -
• PAT_IS_ODD -
• PAT_IS_EVEN –
• PATTEMPLATE_VERSION –
• PAT_MODULO_REP –
• PAT_MODULO -

Tłumaczenie A.Sobkowicz
Źródło: help.mamboserver.com