System pomocy Kei.pl
Personalizacja

System szablonów webmail pozwala administratorowi serwera (user admin) zmienić:
- niektóre zmienne konfiguracyjne (np. nagłówki html)
- dowolną cześć HTML
- pliki graficzne
- szablony css
- texty

Dodatkowo, będzie mógł on utworzyć wiele własnych szablonów i podpinać je na poziomie:
- globalnym
- konta ftp
- domeny
- konta email

Pliki odpowiedzialne za konfigurację wyglądu webmail znajdują się w katalogu:
/home/conf/tld

1. PRAWA DOSTĘPU

Użytkownik admin ma pełne prawa do modyfikacji plików odpowiedzialnych za wygląd z jednym wyjątkiem - nie posiada prawa modyfikacji domyślnego szablonu (tpl/default). Wiąże się to z tym, iż aktualizacje KEI nadpisywałyby zmiany wprowadzone przez użytkownika. W związku z tym, iż admin nie może nadpisać swoimi plikami domyślną zawartość procedura ustawienia nowego szablonu wygląda następująco:

- skopiowanie szablonu default (tpl/default) do nowego katalogu (np tpl/moj_szablon).
Uwaga
- należy zapewnić prawo do odczytu wszystkim do wszystkich plików tego katalogu (z podkatalogami).
- wprowadzenie zmian przez użytkownika w swoim szablonie
- przepiecie systemu na nowy szablon (opis w następnym punkcie)

2. USTAWIANIE OBOWIĄZUJĄCEGO SZABLONU

System pozwala na podpięcie różnych szablonów na poziomie:
- globalnym
- konta ftp
- domeny
- konta email

Konfiguracja odpowiednich relacji opiera się na plikach z katalogu /home/conf/tld/tpl/.defaults
Dla poprawnego działania istotna jest nazwa i zawartość tych plików. Nazwa pliku określa zakres obowiązywania szablonu a jego treść o jaki szablon chodzi.

Nazwa pliku może mieć format:
1. poziom użytkownika - user: określa jaki szablon ma być wykorzystany dla użytkownika , przykład nazwy: user:jan.kowalski@domena.pl
2. poziom domeny - domain: określa jaki szablon ma być wykorzystany dla wszystkich użytkowników w domenie , przykład nazwy: domain:domena.pl
3. poziom ftp - ftp: określa jaki szablon ma być wykorzystany dla wszystkich użytkowników wszystkich domen, utrzymywanych na koncie ftp , przykład nazwy: ftp:domena
4. poziom globalny - global: global określa jaki szablon ma być szablonem podstawowym na całym serwerze.

Zawartość plików to zawsze nazwa szablonu czyli np (moj_szablon). Priorytet szukania jest następujący (od najwyższego): user -> domain -> ftp -> global

UWAGA - Jeśli system nie znajdzie żadnego szablonu na powyższej ścieżce będzie korzystał z szablonu domyślnego (tpl/default)

Wszelkich zmian w tym zakresie ustawiania powyższych zależności może dokonywać użytkownik admin.
Przykład na podpięcie nowego szablonu globalnie (najczęstsza sytuacja). Zeby zmienić globalnie obowiazujacy szablon na serwerze przez użytkownika admin (najczęstsza sytuacja) należy:
- utworzyć nowy szablon (przepis wyżej)
- w pliku /home/conf/tld/tpl/.defaults/global:global wpisać nazwę nowego szablonu, który został wcześniej utworzony.