Цветовые темы

Внимание! Мы настоятельно рекомендуем ознакомиться сначала с REST-документацией модуля Сайты, чтобы понять как модуль функционирует (тем более REST доступен и в коробочной версии). Данную документацию рассматривайте как подспорье при работе в коробке, когда вам действительно мало функционала REST, или вы хотите детальнее разобраться в API.

Темы

В настоящий момент в системе присутствуют цветовые темы, представленные ниже. Стоит учитывать, что в шаблоне присутствует как тема визуального отображения (формы, цвета), так и тема шрифтов. Сайт по шаблону всегда создается в определенной цветовой теме и в определенной шрифтовой теме. Как правило, они совпадают (шрифтовая тема это небольшой дополнительный файл). Затем, когда пользователь меняет визуальную тему, шрифтовая тема внутри остается неизменной и может меняться только программно разработчиком. Это намеренное поведение системы.

Код темы	Название темы
1construction	Янтарный
2business	Фиолетово-синий
3corporate	Малибу
accounting	Желто-зеленый
agency	Пастельный красный
app	Умеренный бирюзовый
architecture	Закат солнца
charity	Желтый
consulting	Светло-зелёное море
courses	Умеренный аквамариновый
event	Амарантовый
gym	Индиго Крайола
lawyer	Карминно-розовый
music	Дикий арбуз
photography	Нефтяной
real-estate	Оранжевый закат
restaurant	Малиновый
shipping	Красный
spa	Цитрусовый
travel	Киноварь
wedding	Клюквенный

Примечание. Названия тем с цифрами в начале - не описка. Часть тем именно так и называется.

Расширение тем

Чтобы добавить следующую тему, требуется совершить следующий порядок действий:

Прежде всего по пути тем создать директорию вашей темы /bitrix/templates/<TEMPLATE_ID>/themes/<YOUR_CODE>/ и аналогичную директорию для шрифтовой темы /bitrix/templates/<TEMPLATE_ID>/themes-typo/<YOUR_CODE>/. Где <YOUR_CODE> – код вашей темы, например, mytheme.
По аналогии соседних тем (или на основании) создать ваши собственные файлы в данных директориях. Все файлы в данных директориях будут подключены как стили на страницу.

Зарегистрировать вашу тему через обработчик

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler('landing', 'onGetThemeColors',
	function(\Bitrix\Main\Event $event)
	{
		$result = new \Bitrix\Main\Entity\EventResult;
		$colors = $event->getParameter('colors');

		$colors['mytheme'] = array(
			'name' => 'Моя тема',
			'color' => '#cdcdcd',
		'base' => true
		);

		$result->modifyFields(array(
			'colors' => $colors
		));

		return $result;
	}
);

В примере мы регистрируем тему:
– с кодом mytheme
– с названием 'Моя тема'
– с цветом #cdcdcd (для показа в интерфейсе)
– ключ base может отсутствовать, в случае true отвечает за вывод темы в предпросмотре шаблона.

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