Каталог assets

Данный каталог содержит всю «оформительскую» часть шаблона. В нём есть некоторые предопределенные файлы/каталоги.

CSS и SASS

В css размещаются готовые css-файлы, которые будут автоматически подключены в секцию HEAD страницы.

Если css-файл не требуется подключать, то он должен иметь префикс имени «_» или «-».

Каталог sass содержит исходный css-код, после компиляции которого, результат помещается в css. В Default-шаблоне используются css-фреймворк Bootstrap 4 и Berry CSS, но при желании вы можете использовать любой другой вариант.

Подкаталог css/lazy имеет специальное назначение — файлы из него будут подключены в конце BODY страницы. Обычно здесь размещают css-файлы иконок и прочих стилей, которые могут быть загружены после основных данных.

Подкаталог css/profiles содержит css-профили, выбор которых доступен в админ-панели. При этом содержимое css-файла вставляется прямо в HEAD-секцию. Но, если имя файла профиля начинается с theme-, то он подключается внешним css-файлом.

JS. jQuery

В каталоге js находятся js-файлы шаблона. В этом каталоге автоматически подключается только файл my.js (в секцию HEAD).

Для того, чтобы автоматически загрузить js-файлы, их следует разместить в js/autoload — они будут подключены в секции HEAD.

Чтобы разместить файл в конце BODY, его следует разместить в каталоге js/lazy.

Если файл начинается с префикса «_» или «-», то его подключение игнорируется.

Как правило в шаблоне требуется поддержка jQuery, поскольку многие плагины его активно используют. В MaxSite CMS используется jQuery 1.8.2 (последняя самая полная версия до «урезания» разработчиками) и она уже входит в комплект системы (как и ряд других jQuery-плагинов) и подключается автоматически в HEAD каждой страницы.

При необходимости вы можете использовать свой вариант jQuery. Для этого разместите её как assets/js/jquery.min.js. Этот файл будет подключен вместо «стандартного».

При этом учитывайте, что работоспособность многих плагинов окажется под вопросом.

Также можно указать адрес jQuery через set-переменные. В файле custom/set_val.php добавьте строчку с адресом библиотеки:

mso_set_val('jquery_url', 'полный http-адрес');

Если подключение css или js файлы было через функции mso_add_file(), mso_load_script() или mso_load_style(), то MaxSite CMS не будет подключать дублирующиеся файлы.

Прочие каталоги

Каталог fonts, images и т.д. могут быть произвольными.