Tworzenie plików JavaScript zależnych od języka dla modułów CMS
CMS bluetronix automatycznie generuje zoptymalizowane pliki JavaScript dla każdego aktywnego języka twojej strony internetowej. Dowiesz się, jak łączyć pliki standardowe, indywidualne modyfikacje i teksty modułów zależne od języka oraz jak CMS automatycznie włącza odpowiednie pliki do twojej strony.
Pliki JavaScript zależne od języka
System CMS bluetronix może generować osobne pliki JavaScript dla każdego aktywowanego języka na twojej stronie. Dzięki temu teksty i funkcje zależne od języka są bezpośrednio dostępne w danym pliku JavaScript.
Potrzebne pliki są automatycznie tworzone, gdy zapisujesz konfigurację modułu. System CMS uwzględnia zarówno pliki standardowe, jak i twoje indywidualne dostosowania.
Ten samouczek opiera się na dokumentacji „Integracja i dostosowywanie modułów CMS”. Powinieneś być już zaznajomiony z folderem dewelopera bx_Mod i używaniem własnych plików _own.
1. Automatyczne generowanie plików JavaScript
Gdy zapisujesz konfigurację modułu, system CMS automatycznie tworzy wszystkie potrzebne pliki JavaScript zależne od języka.
Tworzone są wyłącznie wersje językowe, które włączyłeś za pomocą modułu Lang.
Aktywowane języki ustalane są w globalnej konfiguracji modułu:
bx_Mod/config_own.phpNa przykład, jeśli aktywujesz niemiecki, angielski i hiszpański, system CMS tworzy odpowiednie pliki JavaScript dla tych trzech języków.
Zmiana zestawu kolorów lub układu nie zmienia już plików JavaScript. Automatyczne tworzenie odbywa się podczas zapisywania konfiguracji modułu.
2. Ręczne generowanie plików JavaScript
Oprócz automatycznego tworzenia, możesz ręcznie wygenerować pliki JavaScript zależne od języka.
Aby to zrobić, jako administrator, otwórz następujący adres. Zastąp przykładową domenę adresem swojego CMS:
https://xxxx.bxserver.net/bx_Mod/BxScript.phpDzięki temu wywołaniu możesz ponownie generować pliki JavaScript niezależnie od zapisywania konfiguracji modułu.
3. Globalna konfiguracja modułu
Globalna konfiguracja modułu znajduje się pod:
bx_Mod/config_own.phpTen plik zawiera indywidualne ustawienia twojego projektu. Jest konfigurowany po instalacji zgodnie z wymaganiami użytkownika.
Określa się tutaj między innymi, jakie moduły i obszary powinny być używane, na przykład sklep lub blog. Uwzględniane są również aktywowane języki.
Konfiguracja stanowi zatem ważną podstawę do generowania plików JavaScript zależnych od języka.
4. Konfiguracje modułów i pliki językowe
Podczas generowania system CMS uwzględnia pliki konfiguracyjne poszczególnych modułów. Należą do nich standardowe konfiguracje, indywidualne dostosowania oraz teksty zależne od języka.
Na przykładzie modułu sklepu są to:
bx_Mod/Shop/config.php
bx_Mod/Shop/config_own.php
bx_Mod/Shop/config_text_de.php
bx_Mod/Shop/config_text_de_own.phpPliki spełniają różne zadania:
config.php: Zawiera standardową konfigurację modułu sklepu.
config_own.php: Zawiera twoje indywidualne ustawienia konfiguracyjne.
config_text_de.php: Zawiera standardowe niemieckie teksty modułu sklepu.
config_text_de_own.php: Zawiera twoje indywidualne dostosowania niemieckich tekstów.
Dla innych aktywowanych języków uwzględniane są odpowiednie pliki językowe.
Staraj się nie zmieniać standardowych plików bezpośrednio. Używaj przewidzianych plików _own do indywidualnych dostosowań, aby zachować swoje zmiany podczas zwykłych aktualizacji CMS.
5. Standardowy JavaScript i własne modyfikacje
Ogólne pliki JavaScript znajdują się w folderze dewelopera bx_script.
Do centralnych funkcji JavaScript uwzględniane są następujące pliki:
/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.jsBxScript.js to domyślny plik systemu CMS bluetronix. Może być nadpisany podczas aktualizacji systemu.
Pliki BxScript_own.js i BxScript_own_min.js są przeznaczone do indywidualnych dostosowań.
Te pliki mogą być uwzględniane przy generowaniu plików JavaScript zależnych od języka.
6. JavaScript nagłówkowy i własne modyfikacje
Oprócz ogólnych plików JavaScript istnieją oddzielne pliki dla nagłówka twojej strony internetowej.
/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.jsBxHeadScript.js zawiera funkcje JavaScript dla nagłówka udostępniane przez system CMS. Ten domyślny plik może być nadpisany podczas aktualizacji systemu.
Do własnych dostosowań dostępne są pliki BxHeadScript_own.js i BxHeadScript_own_min.js.
Odpowiednie wersje zależne od języka są również generowane z tych plików.
7. Wytworzone pliki JavaScript
Na podstawie istniejących plików konfiguracyjnych, językowych i JavaScript system CMS generuje oddzielne pliki dla każdego aktywowanego języka.
Na przykład powstają następujące ogólne pliki JavaScript:
/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.jsDodatkowo tworzone są odpowiednie pliki JavaScript dla nagłówka:
/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.jsSkróty językowe oznaczają dany język. Na przykład de oznacza niemiecki, en oznacza angielski, ru oznacza rosyjski, a es oznacza hiszpański.
System CMS generuje tylko pliki dla rzeczywiście aktywowanych języków.
8. Optymalizacja wytworzonych plików JavaScript
Podczas generowania pliki JavaScript są dodatkowo optymalizowane. Dzięki temu można usunąć zbędne komentarze i nadmiarowe spacje.
Prosta optymalizacja obejmuje następujące kroki:
1. Linie zaczynające się od // są usuwane.
2. Linie zawierające tylko spacje są usuwane.
3. Wiele spacji może być zastąpionych pojedynczą spacją.
Pełna minifikacja obecnie nie jest konieczna.
Optymalizacja redukuje zbędne treści w generowanych plikach JavaScript.
9. Automatyczne włączanie plików JavaScript zależnych od języka
System CMS bluetronix sprawdza przy tworzeniu twojej strony internetowej, czy dla aktualnie wybranego języka dostępny jest odpowiedni plik JavaScript.
W układzie HTML ogólny plik JavaScript może być na przykład włączony za pomocą następującego znacznika CMS:
__FV_/bx_script/BxScript_own_min.js__Gdy odwiedzający otworzy niemiecką wersję językową twojej strony internetowej i odpowiedni plik językowy jest dostępny, system CMS automatycznie zastępuje znacznik:
__FV_/bx_script/BxScript_de.js__To samo dotyczy pliku JavaScript dla nagłówka.
Z:
__FV_/bx_script/BxHeadScript_own_min.js__na przykład:
__FV_/bx_script/BxHeadScript_de.js__Nie trzeba dostosowywać istniejącego włączenia HTML dla każdego języka oddzielnie.
Jeśli odpowiedni plik językowy nie jest dostępny, pozostaje włączony ogólny plik JavaScript.
10. Aktualizacja pamięci podręcznej przeglądarki przez datę zmiany pliku
Aby przeglądarki nie ładowały przestarzałego pliku JavaScript z pamięci podręcznej po dokonaniu zmiany, CMS może dodatkowo wykorzystać datę zmiany odpowiedniego pliku.
Włączony plik JavaScript otrzymuje w tym celu parametr wersji.
Przykład:
BxScript_de.js?v=DATEI_AENDERUNGS_DATUMJeśli plik ulegnie zmianie, może również zmienić się parametr wersji. W ten sposób przeglądarka rozpoznaje zmienioną wersję pliku i może go ponownie załadować.
Ta metoda może być stosowana zarówno dla ogólnych plików JavaScript, jak i dla plików JavaScript nagłówków.
11. Podsumowanie
CMS bluetronix automatycznie tworzy oddzielne pliki JavaScript dla każdego aktywowanego języka Twojej strony internetowej.
Generowanie odbywa się przy każdym zapisaniu konfiguracji modułu. Dodatkowo możesz je uruchomić ręcznie za pośrednictwem bx_Mod/BxScript.php.
Podczas tworzenia uwzględniane są globalna konfiguracja modułu, pliki konfiguracji i pliki językowe modułów, a także standardowe i własne pliki JavaScript.
W układzie CMS automatycznie rozpoznaje, czy dostępny jest odpowiedni plik językowy, i włącza go zamiast ogólnego pliku JavaScript.
Do indywidualnych dostosowań zawsze używaj przeznaczonych do tego plików _own, aby Twoje zmiany pozostały podczas normalnych aktualizacji systemu.
FAQ
co klienci często nas pytają
Kiedy są generowane pliki JavaScript zależne od języka?
CMS bluetronix generuje pliki automatycznie, gdy zapisujesz konfigurację modułu. Przy tym pliki JavaScript są na nowo tworzone dla wszystkich aktywowanych języków.
Jak mogę ręcznie ponownie wygenerować pliki JavaScript?
Jako administrator przejdź pod adres https://xxxx.bxserver.net/bx_Mod/BxScript.php. Zastąp przykładową domenę adresem swojego CMS.
Czy pliki JavaScript są generowane dla wszystkich dostępnych języków?
Nie. CMS tworzy wyłącznie wersje językowe, które aktywowałeś za pomocą modułu Lang. Odpowiednie ustawienia określane są w pliku bx_Mod/config_own.php.
Czy pliki JavaScript są zmieniane przy zmianie zestawu kolorów lub układu?
Nie. Zestaw kolorów lub układ nie zmienia już plików JavaScript. Automatyczne ponowne tworzenie odbywa się podczas zapisywania konfiguracji modułu.
Jakie pliki mogę dostosować indywidualnie?
Do indywidualnych dostosowań JavaScript masz między innymi dostępne pliki BxScript_own.js, BxScript_own_min.js, BxHeadScript_own.js i BxHeadScript_own_min.js. Moduły mają również własne pliki konfiguracyjne i językowe oznaczone jako _own.
Co się dzieje z domyślnymi plikami JavaScript podczas aktualizacji CMS?
Domyślne pliki BxScript.js i BxHeadScript.js mogą zostać nadpisane podczas aktualizacji systemu. Dlatego powinieneś przechowywać własne zmiany wyłącznie w przeznaczonych do tego plikach _own.
Jak CMS rozpoznaje, który plik JavaScript ma zostać włączony?
CMS sprawdza przy tworzeniu strony, czy dla aktualnie wybranego języka istnieje odpowiedni plik JavaScript. Na przykład, jeśli istnieje BxScript_de.js, jest on włączany dla niemieckiej wersji językowej zamiast ogólnego pliku.
Jak zapobiec ładowaniu przez odwiedzających przestarzałych plików JavaScript z pamięci podręcznej przeglądarki?
CMS może przy włączaniu plików JavaScript dodatkowo używać daty zmiany pliku jako parametru wersji. Dzięki temu przeglądarka będzie mogła ładować nową wersję pliku po dokonaniu zmian.