Używanie zmiennych z "Ściągawki" edytora projektu

Zmienne i metody

Na stronach edytora projektów dostępnych w backendzie niektórych aplikacji (Sklep, Witryna, Blog, Zdjęcia), w prawym dolnym rogu znajduje się link "Ściągawka". Za pomocą tego linku można otworzyć obszar podpowiedzi z listą zmiennych i metod, które można zastosować w szablonach danej aplikacji.

Zmienne i metody są potrzebne po to, aby w łatwy i szybki sposób dodawać do stron internetowych różne dane, których ręczne umieszczanie było niewygodne lub wręcz niemożliwe. Na przykład, zmienna {$wa_url} dodaje do szablonu względny adres URL instalacji frameworka >Web Systems Pro<. Jeśli framework jest zainstalowany i dostępny pod adresem https://yourdomain.com/, względny URL instalacji to /. Jeśli framework jest zainstalowany pod adresem https://yourdomain.com/folder/, jego względny URL to /folder/. Względne adresy URL są używane np. do dodawania obrazów do stron internetowych. Oczywiście, możesz ręcznie określić względny adres URL, taki jak / lub /folder/, ale w tym przypadku możesz uniknąć użycia katalogu instalacyjnego frameworka i mieć łatwą kontrolę nad wyglądem strony. Kod HTML ze zmienną {$wa_url} może wyglądać mniej więcej tak:

<img src="{$wa_url}wa-data/public/site/images/logo.png">

Innym przykładem jest metoda {$wa->locale()}. Metoda zwraca nazwę locale języka użytkownika. Na przykład dla języka polskiego wartość ta wynosi "pl_PL", a dla angielskiego "en_US". Nazwa locale może być użyta do wygenerowania różnych treści na stronie przy użyciu następujących warunków:

{if $wa->locale() == 'pl_PL'}
    ...zawartość strony dla użytkowników mówiących po polsku...
{else}
    ...zawartość dla wszystkich innych użytkowników...
{/if}

Zakładki "Ściągawki"

Każda aplikacja, która posiada edytor projektów, wyświetla w "Ściągawki" kilka zakładek: zakładkę z nazwą aplikacji (np. Sklep lub Zdjęcia), oraz zakładki "$wa" i "Smarty".

Aplikacja "Witryna" nie posiada zakładki z nazwą aplikacji, ponieważ korzysta jedynie ze zmiennych systemowych i metod opisanych w pozostałych zakładkach - nie posiada własnych zmiennych i metod do wykorzystania w szablonach.

Zakładka z nazwą aplikacji zawiera nazwy i opisy zmiennych dostępnych tylko dla tej aplikacji. Na przykład w edytorze projektu sklepu internetowego dostępne są metody uzyskiwania informacji o produktach lub kategoriach o określonym identyfikatorze, aplikacja "Zdjęcia" oferuje zmienne do uzyskiwania informacji o albumach oraz metody uzyskiwania list zdjęć według różnych cech.

Zakładka "$wa" zawiera informacje o zmiennych systemowych i metodach frameworka Web-systems.pro. Na przykład, wymienia zmienne pozwalające uzyskać adres URL instalacji frameworka i bieżący adres URL osady, metody pozwalające uzyskać pełny adres URL bieżącej strony, zawartość ciągu User-Agent oraz inne zmienne i metody przydatne do rozwijania i udoskonalania motywu projektu.

Zakładka "Smarty" krótko opisuje kluczowe cechy silnika Smarty dostępne dla projektanta motywu, np. reguły pobierania wartości zmiennych lub ustawiania nowych wartości, pracę z tablicami i obiektami, używanie warunków, itp. Więcej szczegółów na temat funkcji Smarty można znaleźć w jego oficjalnej dokumentacji.