Motywy projektowe

Support10 października 2021

Aplikacja Witryna jest wspólnym edytorem projektów dla kilku innych (już wydanych lub będących w trakcie tworzenia) aplikacji: Witryna, Blog, Sklep.


Pliki szablonów

Webasyst posiada dwa standardowe miejsca do przechowywania szablonów projektowych (motywów):

  1. wa-apps/APP_ID/themes/ - oryginalny motyw w folderze aplikacji
  2. wa-data/public/APP_ID/themes/ - zmiany motywów własnych

Folder aplikacji (wa-apps/) zawiera oryginalny motyw, do którego jest on instalowany za pomocą aplikacji "Instalator". Gdy przynajmniej jeden szablon zostanie zmieniony za pomocą wbudowanego edytora aplikacji "Witryna", w folderze użytkownika wa-data/public/APP_ID/themes/ tworzona jest kopia oryginalnego motywu, a następnie używany jest tylko ten folder (oryginał pozostaje w folderze wa-apps/, ale nie można go zmienić w żaden inny sposób za pomocą edytora projektu).

Zalecamy używanie tylko wbudowanego edytora projektów do edycji szablonów projektów, ponieważ w tym przypadku zmiany w szablonach projektów zostaną zachowane podczas instalacji aktualizacji za pomocą "Instalatora". Jeśli wolisz edytować szablony bez użycia edytora projektów (np. przez FTP), sugerujemy, abyś edytował tylko kopię użytkownika motywu w wa-data/, aby zmiany nie zostały utracone podczas aktualizacji.


Wbudowany edytor projektów

Backend i frontend Web-systems.pro są oparte na silniku Smarty, więc możesz używać wszystkich narzędzi Smarty w swoich szablonach. W prawym dolnym rogu edytora znajduje się ściągawka z listą projektów i zmiennych, których można użyć w bieżącym szablonie.

W zależności od funkcjonalności, każda aplikacja udostępnia własny zestaw obowiązkowych szablonów projektowych według własnego uznania. Na przykład w aplikacji "Witryna" obowiązkowe są tylko szablony index.html (ogólny układ strony), page.html (wyprowadzenie zawartości pojedynczej strony) i error.html (wyświetlenie komunikatu o błędzie). W aplikacji "Blog" obowiązują jeszcze inne szablony: post.html (wyświetlenie pojedynczego wpisu), stream.html (wyświetlenie listy wpisów), comments.html (komentarze do wpisu). Twórca każdej aplikacji może zdecydować, z jakich szablonów powinien składać się motyw graficzny i które szablony są obowiązkowe.

Właściciel witryny internetowej może edytować wszystkie szablony projektowe za pomocą wbudowanego edytora projektowego, może również tworzyć własne szablony i dołączać je do szablonów głównych za pomocą dyrektywy Smarty {include file="..."}, ale nie może usuwać plików szablonów obowiązkowych, aby nie naruszyć integralności aplikacji.


Struktura motywu projektu

Motyw projektu to połączone w jednym folderze szablony HTML/Smarty, pliki JavaScript, CSS, obrazy i plik manifestu theme.xml.

Plik manifestu theme.xml musi zawierać podstawowe ustawienia motywu (nazwa, wersja) oraz pliki, które mogą być zmieniane w edytorze projektu.



Błąd w tekście? Zaznacz ją myszką i kliknij Ctrl + F1 lub kliknij na ten blok!