Dostępne makra

LastModified

Umieszcza datę ostatniej modyfikacji danej strony bazującą na obiektach znajdujących się na stronie. Data jest domyślnie wyświetlana według preferencji danego użytkownika. Opcjonalnie, makro może przyjmować dwa parametry - pierwszy to tekst jaki ma być umieszczony przed wyświetlaną datą, drugi oznacza format wyświetlanej daty - po więcej szczegółów zobacz opis makra D (data).

Przykład:

*LastModified("Ostatnia aktualizacja strony: ","%c %D, %y");

Umieszcza tytuł danej strony.

UWAGA: Jeżeli jesteś w trybie administracji lub użyjesz funkcję obiektu zagłębiającą się do kolejnych podstron, to zamiast tytułu strony wyświetlony zostanie link (odnośnik) powrotu do tej strony.

r

Make Page Printable
Umieszcza na stronie link (odnośnik), którego wybór powoduje wyświetlenie strony sformatowanej do wydruku. Opis odnośnika może być zdefiniowany w tym makro, przykładowo

*r("Wersja strony do wydruku");.

Styl strony wyświetlonej do wydruku będzie domyślnie zamieniony na styl "Make Page Printable" zdefiniowany w Menedżerze Stylów. Poprzez to makro można również zdefiniować inny styl według którego strona ta zostanie wyświetlona, przykładowo:

*r("Wersja strony do wydruku","WebGUI");

UWAGI: Możesz również użyć specjalnego wariantu tego makro

*r(linkonly);

które zwraca tylko sam link (odnośnik) adresu URL tworzącego wersję strony do wydruku i nic ponadto.

Do tego makro przyporządkowana jest klasa stylu CSS: .makePrintableLink.

Search

Umieszcza na stronie okienko wyszukiwarki, które związane jest z wbudowanym mechanizmem wyszukiwarki WebGUI.

UWAGA: Do tego makro przyporządkowana jest klasa stylu CSS .searchBox.

Umieszcza na stronie odstęp (pusty blok treści), który przykładowo wykorzystywany jest do tworzenia kolorowych obszarów na stronie z tagami DIV i TABLE. Makro wymaga podania dwóch parametrów ? szerokości i wysokości bloku.

Przykład: *Spacer("100","50");

Makro służy do 'importowania' wobiektu np. ze strony A do stylu strony w konkretne miejsce.

*WobjectProxy( wobjectId [param-name, param value ... ] );

objectId - mandatory parameter, ID of wobject

param-name, param value - form parameters

Makro powiązane z modułem TiNews (dostępny w panelu  administracji).

Za jego pomocą można przygotować np: baner, sekcję news, galerię zdjęć, inne.

Makro pozwala na zmianę domyślnego stylu strony.

Przykład:

styl bazowy (nazwa indywidualna): "Wersja graficzna",
nowy tymczasowy dla wszystkich (nazwa indywidualna): "Wersja tekstowa"
ID stylu nowego (id ustawianego stylu): "2"

Możliwe szersze zastosowanie:

*SwitchStyle("Styl podstawowy",2,"Styl czerwony",3,"Styl zielony");

Makro wczytujące pliki CSS na 'życzenie' do sekcji 'Head'.

*SetHeaderLink("NAME","VERSION","URL","PARAMS....");

Gdzie PARAMS to lista dodatkowych parametrów podawanych parami KEY,VALUE ...

NAME - unikalna nazwa pozwalająca zespolić wszystkie wywołania tego samego zasobu. Najczęściej nazwa pliku
VERSION - standardowe wersjonowanie zasobu np 1.1.1, czyli podajemy trzy cyfry rozdzielone kropkami.

Można stosować np. przy ładowaniu slidera - dodatkowe pliki CSS/JS zostaną wczytane wyłącznie przy uruchomieniu danego makra.

Przykład:

*SetHeaderLink("swiper-bundle.css","1.1.0","/images/template/swiper/swiper-bundle.min.css");

Makro wczytujące pliki CSS na 'życzenie' do sekcji 'Footer'.

*SetBodyLink("NAME","VERSION","URL","PARAMS....");

Przykład:

*SetBodyLink("swiper-bundle.css","1.1.0","/images/template/swiper/swiper-bundle.min.css");

Makro wczytujące pliki JS na 'życzenie' do sekcji 'Head'.

Makro wczytujące pliki JS na 'życzenie' do sekcji 'Footer'.

^SetFooterScript("NAME","VERSION","URL","PARAMS....");

Makro pobiera dane z pola tytułu strony.

Zastosowanie:

*Page(menuTitle);

Makro pobiera URL obrazka dodawanego we właściwościach strony.

Zastosowanie:

<img src="*pi();" alt="obrazek strony">

To makro głównie jest wykorzystywane do generowania dynamicznych zapytań do bazy danych w raportach SQL Reports. Dzięki temu makro możesz uzyskać wartość dowolnego pola formularza, podając jako parametr nazwę tego pola, przykładowo:

*FormParam("Numertelefonu");

Wyświetla wartość zmiennej środowiskowej serwera podanej jako parametr. Na każdym serwerze dostępny jest inny zestaw i wartości zmiennych środowiskowych.

Lista zmiennych dostępna jest w trybie 'Wyświetlania błędów'.

Przykład:

*Env("REMOTE_ADDR");

Prosta instrukcja warunkowa (IF/THEN/ELSE ? ?Jeżeli warunek jest spełniony to wykonaj pierwszą instrukcji, w przeciwnym wypadku wykonaj drugą instrukcję?) umożliwiająca kontrolę wyglądu strony i wyświetlanych wiadomości.

Przykłady:

Wyświetla napis Szczęśliwego Nowego Roku w dniu 1 stycznia:

*If('0308' eq '0101' , Szczęśliwego Nowego Roku);

Wyświetla wiadomość dla użytkowników z podsieci 192.168.1.* oraz dla użytkowników spoza tej sieci:

*If('*Env("REMOTE_ADDR");' =~ /^192.168.1/,"Witaj użytkowniku naszej sieci 192.168.1.*","Witaj obcy przybyszu");

Wyświetla wiadomość dla użytkowników korzystających z systemu Windows:

*If('*Env("HTTP_USER_AGENT");' =~ /windows/i,"Czy wiesz że system Linux jest bezpłatny?");

Wyświetla wiadomość dla użytkowników korzystających z dostępu poprzez serwer proxy:

*If('*Env("HTTP_VIA");' ne "", Korzystasz z serwera proxy, Nie korzystasz z serwera proxy...);

Wyświetla wiadomość dla użytkowników zależną od pory dnia:

*If(*D("%J");<=12,Witaj o poranku,

If Macro failed: syntax error at (eval 714) line 1, near "<"

Expression: 3<=18
Display if true: Witaj po południu
Display if false: Dobry wieczór);

Bieżąca data i czas.

Datę można skonfigurować używając dodatkowo symboli definiowania formatu. Przykładowo, jeżeli zdefiniowałeś makro w postaci *D("%c %D, %y"); to wyświetli ono datę w przykładowej postaci Luty 26, 2004. Oto dostępne symbole definiowania formatu daty:

%% %
%y rok w postaci czterocyfrowej liczby
%Y rok w postaci dwucyfrowej liczby
%m miesiąc w postaci dwucyfrowej liczby
%M liczba oznaczająca numer miesiąca
%c nazwa miesiąca
%d dzień miesiąca w postaci dwucyfrowej liczby
%D liczba oznaczająca dzień miesiąca
%w nazwa dnia tygodnia
%h dwucyfrowa liczba oznaczająca godzinę dnia (w zakresie 0-12)
%H liczba oznaczająca godzinę dnia (w zakresie 0-12)
%j dwucyfrowa liczba oznaczająca godzinę dnia (w zakresie 0-24)
%J liczba oznaczająca godzinę dnia (w zakresie 0-24)
%p pisane małą literą słowo am/pm (oznaczającę porę przed i po południu)
%P pisane dużą literą słowo AM/PM (oznaczające porę przed i po południu)
%z ustawiony przez użytkownika format prezentowania daty
%Z ustawiony przez użytkownika format prezentowania czasu

Sprawdzenie czy użytkownik należy do grupy.

Przykład:

<tmpl_if expr="isInGroup(17)"></tmpl_if>

Makro (My Account Link) wyświetla link (odnośnik) do informacji o koncie użytkownika. Możliwe jest dodatkowo zdefiniowanie wyświetlanej nazwy linku, przykładowo:

*a("Informacja o koncie");

UWAGI: Możesz również użyć specjalnej wersji tego makra *a(linkonly); zwracającej sam tylko link do konta bez jego opisu. Z tym makro związana jest klasa stylu CSS .myAccountLink.

Wyświetla krótki tekst informujący użytkownika zalogowanego jako administrator o pozostawaniu w trybie administracji - przykładowo:

*AdminText("Jesteś w trybie administracji!");

Umieszcza na stronie link (odnośnik) umożliwiający włączenie lub wyłączenie trybu administracji ? link widoczny będzie tylko dla administratorów i menedżerów zawartości serwisu. Dodatkowo możliwe jest zdefiniowanie wyświetlanej nazwy linku, przykładowo:

*AdminToggle("Włącz/Wyłącz tryb edycji");

Wyświetla użytkownikowi informację że może on edytować daną stronę.

Przykład:

*CanEditText(*AdminToggle;);

*EditableToggle;
*EditableToggle();

Makro wyświetla link umożliwiający użytkownikom samodzielne dodanie się do danej grupy użytkowników. Pierwszym parametrem jest nazwa grupy, drugim nazwa linku do dodania się do grupy.

UWAGA: Jeżeli użytkownik nie jest zalogowany lub należy już do danej grupy lub ustawienia grupy nie zezwalają na samodzielne dodawanie się do nich użytkowników, to link nie zostanie wyświetlony.

Makro wyświetla link umożliwiający użytkownikom samodzielne usunięcie się z danej grupy użytkowników. Pierwszym parametrem jest nazwa grupy, drugim nazwy linku jaka zostanie wyświetlona.

UWAGA: Jeżeli użytkownik nie jest zalogowany lub nie należy do danej grupy lub ustawienia grupy nie zezwalają na samodzielne usuwanie się z nich użytkowników, to link nie zostanie wyświetlony.

Wyświetla krótki tekst informujący użytkownika jeżeli należy on do danej grupy. Można również zdefiniować alternatywny tekst wyświetlany dla użytkowników którzy nie należą do danej grupy.

Przykład:

*GroupText("Visitors","Załóż konto w naszym systemie aby móc korzystać z wszystkich jego funkcji!","Doceniamy naszych zarejestrowanych użytkowników!");

*L;
*L();

Wyświetla niewielki blok formularza umożliwiającego zalogowanie się (Login Box). Można ustawić szerokość bloku logowania - przykładowo *L(20);. Możesz również zdefiniować treść wiadomości jaka zostanie wyświetlona użytkownikowi po zalogowaniu się - przykładowo: 

*L(20,Witaj *a(*@;);. Kliknij %here% jeżeli chcesz się wylogować!);

UWAGA: Do tego makro przyporządkowana jest klasa stylu CSS .loginBox.

Wyświetla link (odnośnik) umożliwiający zalogowanie lub wylogowania się, w zależności czy użytkownik jest czy też nie jest zalogowany. Opcjonalnie można zdefiniować swoją własną wersję nazwy takiego linku - przykładowo:

*LoginToggle("Kliknij tutaj aby się zalogować.","Kliknij tutaj aby się zalogować.");

Dostępna jest również specjalna forma wywołania tego makro:

*LoginToggle(linkonly);

zwracająca sam adres URL linku bez jego opisu.

Wyświetla nazwę użytkownika (Username) który bieżąco jest zalogowany.

Wyświetla identyfikator (ID) użytkownika który bieżąco jest zalogowa/ny.

Pobieranie danych na bazie ID użytkownika np. w artykule

Autor: *User('firstName',ownerId); *User('lastName',ownerId);

ownerId: <tmpl_var ownerId>
*User('firstName');
*User('firstName',<tmpl_var ownerId>);
*User('lastName',<tmpl_var ownerId>);

Crumb Trail

Wyświetla pasek z dynamicznie generowaną ścieżką do danej strony, począwszy od katalogu głównego związanego z daną stroną. Opcjonalnie możesz zdefiniować własną formę rozdzielenia wyświetlanych elementów ścieżki - przykładowo:

 *C(::);

(domyślnie jest to znak >).

UWAGA: Z tym makro związana jest klasa stylu CSS .crumbTrail.

Home Link

Wyświetla link do strony głównej serwisu. Dodatkowo możliwe jest zdefiniowanie nazwy tego linku, przykładowo:

*H("Strona główna");

UWAGI: Możesz użyć specjalnej wersji tego makra *H(linkonly); zwracającej sam link bez jego nazwy. Z tym makro związana jest klasa stylu CSS .homeLink.

Current Menu (Vertical)

Wyświetla pionowe menu zawierające podstrony w stosunku do bieżącego poziomu. Dodatkowo możliwe jest zdefiniowanie liczby poziomów na które menu będzie mogło się zagłębić. Domyślnie wyświetla tylko pierwszy podpoziom. Przykładowo, aby umożliwić zejście maksymalnie do trzeciego podpoziomu, należy podać makro w postaci:

*M(3);

- podając w makro wartość "0", umożliwi to rozwijanie menu do dowolnego podpoziomu stron.

Current Menu (Horizontal)

Wyświetla horyzontalne menu zawierające strony z danego podpoziomu stron. Opcjonalnie można zdefiniować separator wyświetlanych w menu stron, przykładowo:

*m(:--:);

- domyśnym separatorem jest ·.

Wyświetla rozwijane w dół menu zawierające podstrony na poprzednim poziomie stron.

Przykład:

*PreviousDropMenu;

Previous Menu (Vertical)

Wyświetla pionowe menu zawierające podstrony na poprzednim poziomie stron. Dodatkowo możliwe jest zdefiniowanie maksymalnej liczby podpoziomów do jakiej menu to będzie się rozwijało - domyślnie jest to jeden poziom. Przykładowo, aby zagłębiać się maksymalnie trzy podpoziomy, makro powinno mieć postać:

*P(3);

- podając tę wartość w makro na "0", umożliwi to rozwijanie menu do dowolnego podpoziomu stron.

Previous Menu (Horizontal)

Wyświetla horyzontalne menu zawierające strony na poprzednim podpoziomie stron. Opcjonalnie można zdefiniować separator wyświetlanych w menu stron, przykładowo:

*p(:--:);

Wyświetla horyzontalne menu nazw wszystkich katalogów głównych systemu. Opcjonalnie można zdefiniować separator wyświetlanych w menu stron, przykładowo:

*rootmenu(|);

Wyświetla menu z nazwami wszystkich katalogów głównych systemu (oprócz katalogu WebGUI), w którym przemieszczanie się po pozycjach menu jest podobne jak nawigacja po formularzach.

UWAGA: Z tym makro związane są dwie klasy stylów CSS: .RootTabOn{} i .RootTabOff{}.

Przykład:

<style> .rootTabOn { line-height: 17px; font-size: 16px; spacing: 3px; border: 1px solid black; border-bottom-width: 0px; background-color: #333333; z-index: 10000; padding: 3px 9px 5px 9px; color: white; } .rootTabOn a, .rootTabOn a:visited { color: white; font-weight: bold; text-decoration: none; } .rootTabOff { line-height: 15px; font-size: 14px; border: 1px solid black; border-bottom-width: 0px; background-color: #c8c8c8; z-index: 1000; padding: 2px 9px 2px 9px; } .rootTabOff a, .rootTabOff a:visited { color: black; text-decoration: underline; } .rootTabOff a:hover { font-weight: bold; } </style>
*Root Tab;

Wyświetla rozwijalne w dół menu zaczynające się od wybranego punktu w hierarchii stron menu nawigacyjnego. Podaje się przy tym dwa parametry - pierwszy parametr to przetworzony do nazwy adresu URL tytuł strony od której menu ma się zaczynać, drugi podaje maksymalną liczbę podpoziomów do jakiego będzie się rozwijać dane menu.

Przykład:

*SpecificDropMenu("home",3);

Specific SubMenu (Vertical)

To makro pozwala na wyświetlenie pionowego podmenu strony podanej w makro jako parametr. Przykładowo możesz utworzyć podmenu strony głównej poprzez podania makra w postaci:

*S("indeks",0);

Pierwszy parametr to przetworzony do nazwy adresu URL tytuł strony (w tym przykładzie strona o nazwie 'indeks'), drugi parametr wskazuje na liczbę kolejnych podpoziomów na które menu może się zagłębiać, domyślnie jest to jeden podpoziom (wartość '0' oznacza brak ograniczeń). Aby przykładowo zagłębiać się maksymalnie do trzech podpoziomów, należy użyć makra w postaci:

*S("nazwa_strony",3);

Specific SubMenu (Horizontal)

To makro pozwala na wyświetlenie poziomego podmenu strony podanej w makro jako parametr (tytuł strony przetworzony do nazwy adresu URL). Przykładowo możesz wyświetlić podmenu strony "nazwastrony-serwisu" podając makro w postaci:

*s("nazwastrony-serwisu");

Opcjonalnie możliwe jest zdefiniowanie separatora stron w menu, przykładowo podając makro w postaci:

*s("nazwastronyserwisu",":--:");

Domyślnym separatorem jest znak ˇ.

To makro wyświetla podmenu strony razem z krótkim opisem każdej z pozycji. Można w tym makro zdefiniować liczbę określającą dopuszczalny poziom zagłębiania się w kolejne podpoziomy menu.

UWAGI: Z tym makro związane są następujące klasy stylów CSS:

.synopsis_sub, .synopsis_summary, oraz .synopsis_title.

Wyświetla rozwijane w dół menu najwyższego poziomu stron.

Przykład:

*TopDropMenu;

Top Level Menu (Vertical)

Wyświetla pionowe menu głównych stron serwisu (podstrony katalogu głównego). Dodatkowo można zdefiniować liczbę poziomów o jakie maksymalnie może się zagłębić to menu - domyślnie jest to jeden poziom. Przykładowo, aby ograniczyć wyświetlanie menu do maksimum trzech kolejnych poziomów, makro powinno mieć postać:

*T(3);

- wartość '0' oznacza brak ograniczenia.

Top Level Menu (Horizontal)

Wyświetla pionowe menu głównych stron serwisu (podstrony katalogu głównego). Opcjonalnie możliwe jest zdefiniowanie separatora stron w menu, przykładowo podając makro w postaci:

*t(:--:);

System URL

Adres URL głównego skryptu systemu (który wywoływany z parametrami generuje odpowiednie strony serwisu), przykładowo: /index.pl/.

Page URL

Adres URL bieżącej strony, przykładowo: /index.pl/nazwastrony.

Makro pokazuje pętlę najczęściej kupowanych produktów z aktualnie wybranym produktem.

Szczegóły

Makro pokazuje listę najczęściej kupowanych produktu.

Szczegóły

Makro generuje URL do listy zamówień użytkownika.

Szczegóły

Makro prezentuje koszty poszczególnych dostępnych dostaw.

Szczegóły

Makro generuje podgląd produktów dodanych do koszyka.

Szczegóły

Makro zwraca URL do strony koszyka.

Szczegóły

Makro generuje URL operacji opróżnienia koszyka.

Szczegóły

Makro generuje nawigację po drzewie kategorii sklepu.

Szczegóły

-- Makro wycofane --

Makro generuje rozwijalne menu na podstawie drzewa kategorii.

Makro bez szablonu.

Makro prezentujące drzew kategorii.

Szczegóły

Makro wyświetla w polu <title> strony nazwę wybranej kategorii.

Należy dodać je w polu 'tytuł' strony (za lub przed wprowadzoną treścią), na której umieszczona jest przeglądarka produktów.

Nazwa kategorii dodawana jest w trybie listy jak i szczegółów produktu.

Makro wyświetla ścieżkę od korzenia do wskazanej kategorii w drzewie zdefiniowanych kategorii.

Szczegóły

Makro wyświetla listę podkategori dla aktualnie wybranej kategorii.

Makro bez szablonu.

Makro wyświetla historię zmiany cen produktu.

Szczegóły

Makro zwraca kod HTML z linkiem do ostatnio oglądanej strony z przeglądarką produktów w trybie listy produktów. Jeśli adres URL jest pusty zwraca pusty kod HTML.

Link pamiętany jest nawet po przejściach po stronach nie zawierających przeglądarki produktów. Można więc powrócić do ostatniej listy produktów z dowolnej strony.

Makro zawiera opcjonalny parametr 'Etykieta':
*TiShopLastList("Etykieta");

Makro bez szablonu.

Makro zwraca adres URL do ostatnio oglądanej strony z przeglądarką produktów w trybie listy produktów. Jeśli adres URL jest pusty zwraca pustą wartość.

Makro bez szablonu.

Makro zwraca kod HTML z linkiem do ostatnio oglądanej strony z przeglądarką produktów. Jeśli adres URL jest pusty zwraca pusty kod HTML.

Makro zawiera opcjonalny parametr 'Etykieta':
*TiShopLastPage("Etykieta");

Makro bez szablonu.

Makro zwraca URL do ostatnio oglądanej strony z przeglądarką produktów. Jeśli adres URL jest pusty zwraca pustą wartość.

Makro bez szablonu.

Makro zwraca kod HTML z linkiem do ostatnio oglądanej strony z przeglądarką produktów w trybie szczegółów produktu. Jeśli adres URL jest pusty zwraca pusty kod HTML.

Makro zawiera opcjonalny parametr 'Etykieta':
*TiShopLastProduct("Etykieta");

Makro bez szablonu.

Makro zwraca URL do ostatnio oglądanej strony z przeglądarką produktów w trybie szczegółów produktu. Jeśli adres URL jest pusty zwraca pustą wartość.

Makro bez szablonu.

Makro wyświetla w polu <title> strony nazwę produktu.

Należy dodać je w polu 'tytuł' strony, na której umieszczona jest przeglądarka produktów.

Tytuł dodawany jest wyłącznie w trybie szczegółów produktu.

Makro generujące listę wszystkich producentów zdefiniowanych w bazie 'Producenci'.

Szczegóły

Makro wyświetla na liście produktów oraz stronie produktu informację o tym do jakich kategorii przypisany jest produkt.

Szczegóły

Makro pokazuje dane o możliwych dostawach.

Szczegóły

Makro ...

Szczegóły

Makro służy do prezentacji wybranych produktów w dowolnym miejscu szablonu strony.

Szczegóły

Makro wyświetla listę ostatnio oglądanych przez użytkownika produktów.

Szczegóły

Makro pozwalające zbudować prosty formularz wyszukiwania produktów.

Szukaj

Makro wyświetla produkty oznaczone jako 'oferta specjalna'.

Szczegóły

Makro prezentuje dostępne dla użytkownika rabaty przy uwzględnieniu większej wartości zamówienia.

Szczegóły

Makro prezentujące drzewo kategorii.

Kod HTML powiązany jest z klasą CSS 'tishop_category'.

Makro bez szablonu.

Makro pozwalające na zmianęwaluty.

Szczegóły

Makro do prezentacji zdjęcia produktu w wiadomości email.

Szczegóły

Makro wyświetla nazwę wybranej kategorii.

Dane dostępne są wyłącznie po wejściu na stronę kategorii sklepu lub szczegółów produktu.

Makro wyświetla kod wybranej kategorii.

Dane dostępne są wyłącznie po wejściu na stronę kategorii lub szczegółów produktu.

Makro przeznaczone do generowania URL dla modułów.

Szczegóły

Szablon operacji dodawania produktu do listy ulubionych.

Szczegóły

Makro pozwalające na zamianę nazwy skrótowej kraju na pełną nazwę.

Zastosowanie w procesie zamówienia, listach powiadomień oraz podglądzie zamówień po stronie operatora.

Możliwe sposoby wykorzystania:

Dla pojedynczej zmiennej (np. w procesie zamówienia):
<tmpl_if EXPR="field.type eq 'Country'">
*CountryLabel(<tmpl_var field.value>);<tmpl_else><tmpl_var field.value>
</tmpl_if>

-------------

Dla danych w pętli:

<tmpl_if EXPR="field.deliveryCountry.type eq 'Country'">
*CountryLabel(<tmpl_var field.deliveryCountry.value>);<tmpl_else><tmpl_var field.deliveryCountry.value>
</tmpl_if>

link do portalu o e-sklepach

Makro zwraca gotowy link do koszyka w trybie schowka.