Składnia files.ini
W głównym folderze każdego stylu musi znajdować się plik files.ini. Służy on do listowania plików w panelu administracyjnym (Zaawansowana edycja) oraz „oceny”, czy styl został zmodyfikowany.
Plik składa się z pięciu sekcji:
- [box_list] - pliki szablonów modułów, folder /boxes
- [tpl_list] - pliki szablonów, folder /scripts
- [css_list] - arkusze stylów, folder /styles
- [js_list] - skrypty JavaScript, folder /js
- [img_list] - pliki graficzne, folder /images
W każdej sekcji opisane są pliki wg standardu:
0.file = "" 0.path = "" 0.desc = "" 0.md5 = "" 1.file = "" 1.path = "" 1.desc = "" 1.md5 = "" 2.file = "" 2.path....
- file - nazwa pliku
- path - podfolder w którym się znajduje, lub wartość pusta
- desc - opis zawartości pliku, lub wartość pusta
- md5 - suma kontrolna pliku
Przykładowy plik box.tpl znajdujący się w podfolderze Menu oraz main.css:
[box_list] 0.file = "box.tpl" 0.path = "Menu" 0.desc = "Moduł menu" 0.md5 = "5fda60638b5ad161e65d48ef969295e6" [css_list] 0.file = "main.css" 0.path = "" 0.desc = "Główny styl" 0.md5 = "daf61df65a7c98bb02fb09d0d9249f1c" 0.main = 1
W powyższym kodzie plik main.css dysponuje dodatkowym parametrem main = 1. Implikuje on, że dany plik jest głównym arkuszem stylów i jest wyświetlany w panelu administracyjnym pod opcją „Pokaż oryginalny arkusz stylów”. Tylko jeden plik CSS może mieć wartość main = 1.
Dostępne są jeszcze 3 opcje dla plików graficznych:
- logo = 1
- background = 1
- favicon = 1
Każda z tych opcji musi zostać przypisana do jednego pliku. Pozwala to aplikacji zlokalizować kolejno plik loga, tła oraz ikony. Dzięki temu, pliki te można później podmieniać za pomocą panelu administracyjnego.
Sumy MD5 plików służą do określenia, czy styl został zmodyfikowany przez administratora. Odpowiednie ostrzeżenie jest wówczas wyświetlane w Galerii stylów. Ręczna modyfikacja plików może uniemożliwić automatyczną aktualizację, co w przypadku większych zmian w w szablonach grozi niestabilnym działaniem sklepu.