Документация для разработчиков
Темная тема

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

Внимание! Мы настоятельно рекомендуем ознакомиться сначала с 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 Клюквенный

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

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

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

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


Пользовательские комментарии

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх