Создание языковых зависимых файлов JavaScript для модулей CMS

Языковые зависимые файлы JavaScript

CMS bluetronix может создавать собственные JavaScript-файлы для каждого активированного языка вашего сайта. Таким образом, языковые тексты и функции доступны напрямую внутри соответствующего JavaScript-файла.

Необходимые файлы создаются автоматически, как только вы сохраняете конфигурацию модуля. При этом CMS учитывает как стандартные файлы, так и ваши индивидуальные настройки.

Это руководство основано на документации "Интеграция и настройка модулей CMS". Вы уже должны быть знакомы с папкой разработчика bx_Mod и использованием собственных _own-файлов.

1. Автоматическое создание файлов JavaScript

Когда вы сохраняете конфигурацию модуля, CMS автоматически заново создает все необходимые языковые JavaScript-файлы.

Создаются исключительно те языковые версии, которые вы активировали через модуль Lang.

Активированные языки определяются в глобальной конфигурации модуля:

bx_Mod/config_own.php

Если вы активировали, например, немецкий, английский и испанский языки, CMS создаст соответствующие JavaScript-файлы для этих трех языков.

Смена цветовой схемы или макета больше не изменяет JavaScript-файлы. Автоматическое создание происходит при сохранении конфигурации модуля.

2. Ручное создание файлов JavaScript

Кроме автоматического создания, вы можете вручную создать языковые JavaScript-файлы.

Для этого как администратор перейдите по следующему адресу. Замените пример домена на адрес вашего CMS:

https://xxxx.bxserver.net/bx_Mod/BxScript.php

С помощью этого вызова вы можете заново создать JavaScript-файлы независимо от сохранения конфигурации модуля.

3. Глобальная конфигурация модуля

Глобальная конфигурация модуля находится по адресу:

bx_Mod/config_own.php

Этот файл содержит индивидуальные настройки вашего проекта. Он настраивается после установки в соответствии с требованиями пользователя.

Здесь, в частности, определяется, какие модули и области должны использоваться, например, магазин или блог. Кроме того, учитываются активированные языки.

Таким образом, конфигурация служит важной основой для создания языковых JavaScript-файлов.

4. Конфигурации модулей и языковые файлы

При создании CMS учитывает конфигурационные файлы соответствующих модулей. К ним относятся стандартная конфигурация, индивидуальные настройки и языковые тексты.

На примере модуля магазина это:

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.php

Файлы выполняют различные задачи:

config.php: Содержит стандартную конфигурацию модуля магазина.

config_own.php: Содержит ваши индивидуальные настройки конфигурации.

config_text_de.php: Содержит стандартные немецкие тексты модуля магазина.

config_text_de_own.php: Содержит ваши индивидуальные изменения немецких текстов.

Для других активированных языков учитываются соответствующие языковые файлы.

Не изменяйте стандартные файлы напрямую, насколько это возможно. Используйте для индивидуальных настроек предусмотренные _own-файлы, чтобы ваши изменения сохранились при обычных обновлениях CMS.

5. Стандартный JavaScript и собственные настройки

Общие файлы JavaScript находятся в папке разработчика bx_script.

Для центральных JavaScript-функций учитываются следующие файлы:

/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.js

BxScript.js — это стандартный файл CMS bluetronix. Он может быть перезаписан при обновлении системы.

Файлы BxScript_own.js и BxScript_own_min.js предназначены для индивидуальных настроек.

Эти файлы могут быть учтены при создании языковых JavaScript-файлов.

6. JavaScript заголовка и собственные настройки

Кроме общих файлов JavaScript, существуют отдельные файлы для заголовка вашего веб-сайта.

/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.js

BxHeadScript.js содержит функции заголовка JavaScript, предоставляемые CMS. Этот стандартный файл может быть перезаписан при обновлении системы.

Для собственных настроек доступны BxHeadScript_own.js и BxHeadScript_own_min.js.

Также из этих файлов создаются соответствующие языковые версии.

7. Созданные файлы JavaScript

Из существующих конфигурационных, языковых и JavaScript-файлов CMS создаёт отдельные файлы для каждого активированного языка.

Например, создаются следующие общие файлы JavaScript:

/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.js

Кроме того, создаются соответствующие файлы заголовка JavaScript:

/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.js

Языковые коды обозначают соответствующий язык. Например, de означает немецкий, en — английский, ru — русский и es — испанский.

CMS создаёт только файлы для фактически активированных языков.

8. Оптимизация созданных файлов JavaScript

Во время создания JavaScript-файлы дополнительно оптимизируются. Это позволяет удалить ненужные комментарии и лишние пробелы.

Простая оптимизация включает следующие шаги:

1. Строки, начинающиеся с //, удаляются.

2. Строки, содержащие только пробелы, удаляются.

3. Несколько пробелов могут быть заменены на один пробел.

Полная минификация в настоящее время не является обязательной.

Оптимизация уменьшает ненужные содержимое в созданных JavaScript-файлах.

9. Автоматическая интеграция языковых зависимых файлов JavaScript

CMS bluetronix проверяет при создании вашего веб-сайта, существует ли соответствующий JavaScript-файл для текущего выбранного языка.

В HTML-верстке, например, общий JavaScript-файл может быть встроен с помощью следующей CMS-разметки:

__FV_/bx_script/BxScript_own_min.js__

Если посетитель открывает немецкую языковую версию вашего веб-сайта и соответствующий языковой файл существует, CMS автоматически заменит разметку на:

__FV_/bx_script/BxScript_de.js__

То же самое правило применяется к файлу заголовка JavaScript.

Из:

__FV_/bx_script/BxHeadScript_own_min.js__

становится, например:

__FV_/bx_script/BxHeadScript_de.js__

Существная HTML-интеграция не требует отдельной настройки для каждого языка.

Если подходящий языковой файл отсутствует, остается подключенным общий JavaScript-файл.

10. Обновление кэша браузера по дате изменения файла

Чтобы браузеры после изменений не загружали устаревший JavaScript-файл из кэша, CMS дополнительно может использовать дату последнего изменения соответствующего файла.

Подключенный JavaScript-файл получает параметр версии.

Пример:

BxScript_de.js?v=DATEI_AENDERUNGS_DATUM

Если файл изменяется, может измениться и параметр версии. Таким образом браузер распознает измененную версию файла и может загрузить его заново.

Этот метод может использоваться как для общих JavaScript-файлов, так и для JavaScript-файлов заголовка.

11. Резюме

CMS bluetronix автоматически создает отдельные JavaScript-файлы для каждого активированного языка вашего веб-сайта.

Создание происходит при каждом сохранении конфигурации модуля. Кроме того, вы можете запустить его вручную через bx_Mod/BxScript.php.

При создании учитываются глобальная конфигурация модуля, конфигурационные и языковые файлы модулей, а также стандартные и собственные JavaScript-файлы.

В макете CMS автоматически определяет, есть ли подходящий языковой файл, и подключает его вместо общего JavaScript-файла.

Для индивидуальных настроек используйте предусмотренные _own-файлы, чтобы ваши изменения сохранились при обычных системных обновлениях.