Файл настроек шаблона (config.ini)

Начиная с версии Moguta.CMS 8.15, при разработке шаблона с компонентной структурой, в корне шаблона необходимо иметь файл с настройками – config.ini.
Файл содержит 4 раздела:

• [MAIN];
• [COLORS];
• [SETTINGS];
• [MISC];

Раздел [MAIN] – Основные настройки шаблона 

В разделе доступны следующие опции:

1. Родительский шаблон – TEMPLATE_INHERIT_FROM

   Если необходимо при отсутствии каких-либо файлов в данном шаблоне, искать в другом(родительском) шаблоне, то в этой опции необходимо указать название папки этого шаблона.

2. Наследование от стандартного шаблона – TEMPLATE_INHERIT_FROM_STANDARD

   Если необходимо при отсутствии каких-либо файлов в данном шаблоне, искать их в стандартном шаблоне moguta-standard, то в этой опции необходимо указать значение 1.

3. Способ подключения цветовой схемы – TEMPLATE_COLOR_FILES

   • Значение separate – будет подключаться один основной файл style.css + отдельные стили цветовых схем из папки css/color-scheme. 
     Если вы не планируете использовать цветовые схемы – тоже используйте значение 1;

   • При значении style, для цветовых схем будут использоваться копии основного файла стилей из папки css.

   • variable – для использования CSS-переменных, значения которых пользователь сможет задать самостоятельно в панели управления;

   Подробнее о способах подключения цветовых схем

Раздел [COLORS] – стандартные значения для CSS-переменных

Если вы используете CSS-переменные для цветовых схем шаблона, то в данном разделе вам нужно указать хотя бы одно стандартное значение для каждой из переменных.

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

Стандартные значения прописываются по шаблону:

1[main-color] = '#4854a2'

Имя CSS-переменной прописывается в квадратных скобках, сразу после порядкового номера цветовой схемы.
Например, если бы необходимо было сделать 5 стандартных цветовых схем с 2-мя переменными:

1[main-color] = '#4854a2'
1[secondary-color] = '#772088'
2[main-color] = '#9d9eaa'
2[secondary-color] = '#208863'
3[main-color] = '#c1cd14'
3[secondary-color] = '#df7120'
4[main-color] = '#cd1435'
4[secondary-color] = '#44df20'
5[main-color] = '#1433cd'
5[secondary-color] = '#20df89'

Подробнее о способах подключения цветовых схем

[SETTINGS] – переопределение настроек движка

В данном разде вы можете переопределить любую настройку движка, заданную в разделе «Настройки» в панелт управления.

Например, было бы очень полезным, сразу при включении шаблона выставить размер миниатюр изображений, чтобы они строго соответствовали размерам блоков, в которых они будут выводиться:

widthPreview = 540; Ширина большой миниатюры изображения товара
heightPreview = 360; Высота большой миниатюры изображения товара
widthSmallPreview = 300; Высота маленькой миниатюры изображения товара
heightSmallPreview = 200; Высота маленькой миниатюры изображения товара

Названия свойств соответствуют значению в столбце option в таблице mg-settings в БД.

[MISC] – Собственные настройки

В разделе [MISC] вы можете хранить свои переменные и использовать их в любом месте шаблона при помощи функции MG::get('templateVars')['variable'], например:

В config.ini

; Выводить сайдбар на сайте
SHOW_SIDEBAR = 0

В шаблоне

<?php
// Получаем значение SHOW_SIDEBAR из файла config.ini шаблона
if (MG::get('templateVars')['SHOW_SIDEBAR']): ?>
<aside>
    ....
</aside>
<?php endif; ?>