Документация ПрофиCRM: Встраивание лендингов Сайты 24

ПрофиCRM: Встраивание лендингов Сайты 24 размещает лендинги Сайты 24 на любых страницах сайта, сохраняя его шапку, меню, подвал и SEO-настройки.

Решение помогает использовать редактор Сайты 24 для подготовки содержимого, но выводить это содержимое в нужном разделе сайта со штатной шапкой, подвалом, меню и настройками шаблона.

Что добавляет решение

• Компонент proficrm:landing.embed для размещения лендинга на физических страницах сайта.
• Кнопку Сайты 24 в стандартном визуальном HTML-редакторе Битрикс для вставки страницы в текстовые HTML-поля, где вставка компонентов недоступна.
• Выбор лендинга по ID в параметрах компонента.
• Режим вывода на всю ширину страницы.
• Передачу SEO и social meta-тегов из настроек лендинга в физическую страницу сайта.
• Пункт Сайты 24 в административном меню, если штатный модуль landing скрывает его из меню.

Где используется

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

На динамической странице или в HTML-поле, где вставка компонентов недоступна, используйте кнопку Сайты 24 в стандартном визуальном HTML-редакторе Битрикс. Например, так можно встроить страницу в подробное описание элемента инфоблока.

Например, тестовая страница /landing_page/.

Установка

1. Установите решение ПрофиCRM: Встраивание лендингов Сайты 24 в административном разделе Битрикс.
2. Подготовьте и опубликуйте страницу в Сайты 24.
3. Откройте страницу сайта или HTML-поле, где нужно вывести её содержимое.

Выберите способ размещения

Оба способа выводят содержимое опубликованной страницы Сайты 24 внутри существующей страницы сайта. Подробные инструкции находятся в подразделах ниже.

На физической (статической) странице, где редактор поддерживает компоненты, используйте компонент proficrm:landing.embed.

Как разместить компонент

1. Откройте страницу в визуальном редакторе.
2. В панели компонентов раскройте группу ПрофиCRM.
3. Добавьте компонент Вывод страницы Сайты 24.
4. Выберите опубликованную страницу Сайты 24.
5. Настройте ширину и применение SEO-настроек, затем сохраните страницу.

Важно. Если редактор поддерживает вставку компонентов, кнопка Сайты 24 на его панели намеренно скрыта.

Параметры компонента

Параметры из этой таблицы, включая настройку Растянуть встроенную страницу на всю доступную ширину, применяются только при размещении страницы через компонент.

Пример подключения в PHP

<?php
$APPLICATION->IncludeComponent(
    'proficrm:landing.embed',
    '',
    [
        'LANDING_ID' => 21,
        'FULL_WIDTH' => 'Y',
        'APPLY_META' => 'Y',
        'LANDING_STYLE_MODE' => 'SCOPED',
    ],
    false,
    [
        'HIDE_ICONS' => 'Y',
    ]
);
?>

LANDING_ID должен соответствовать ID опубликованной страницы Сайты 24.

Какие meta-теги применяются

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

Все это делается внутри компонента и не требует правок ядра Битрикс или шаблона сайта. Если шаблон сайта дополнительно формирует свои social meta-теги, он может вывести дополнительные теги, но компонент передает значения лендинга через стандартные свойства страницы.

В редакторах, где добавление компонентов недоступно, решение добавляет кнопку Сайты 24 в стандартный визуальный HTML-редактор Битрикс. С её помощью страницу можно встроить в HTML-поле динамического элемента, например в подробное описание элемента инфоблока.

Если в редакторе доступна панель компонентов, кнопка не показывается. В этом случае добавьте компонент Вывод страницы Сайты 24 из группы ПрофиCRM.

Как встроить страницу

1. Откройте нужное HTML-поле в режиме визуального редактора.
2. Нажмите кнопку Сайты 24 на панели редактора.
3. Выберите опубликованную страницу Сайты 24.
4. Выберите значение параметра Подключение стилей Сайты 24. По умолчанию рекомендуется режим Изолированные стили Сайты 24.
5. При необходимости включите параметр Применить SEO-настройки страницы.
6. Нажмите Сохранить, а затем сохраните саму страницу или элемент.

В окне добавления также доступны действия Создать страницу Сайты 24 и Обновить список. Если опубликованных страниц нет, решение покажет соответствующее сообщение.

Управление встроенной страницей

В редакторе страница отображается специальным элементом. Откройте его контекстное меню правой кнопкой мыши:

1. Свойства встроенной страницы — изменить выбранную страницу, режим подключения стилей и применение SEO-настроек.
2. Редактировать страницу Сайты 24 — открыть страницу в редакторе Сайты 24.
3. Настройки страницы Сайты 24 — открыть настройки исходной страницы.
4. Удалить страницу из редактора — удалить встроенную страницу из текущего поля.

Важно. Удаление из редактора не удаляет исходную страницу Сайты 24.

Как формируется публичная страница

После сохранения в HTML-поле остаётся служебный элемент встроенной страницы. На публичной части решение заменяет его содержимым выбранной страницы Сайты 24 средствами PHP.

Если в настройках решения разрешена загрузка с помощью AJAX, она используется только как резервный способ: при ошибке PHP-встраивания или если PHP не вернул содержимое.

Подключение стилей Сайты 24

Изолированные стили Сайты 24 — режим по умолчанию. Bootstrap и тема Сайты 24 применяются только внутри контейнера встроенного лендинга, поэтому штатные блоки получают необходимое оформление и не изменяют меню, ширину и другие элементы шаблона сайта.

Оригинальные стили Сайты 24 подключают штатные глобальные файлы без изоляции. Этот режим подходит для совместимого или специально подготовленного шаблона; глобальные правила Bootstrap и темы Сайты 24 могут повлиять на остальные элементы страницы.

Для встраивания через визуальный редактор настройка растягивания на всю доступную ширину не предусмотрена. Параметр FULL_WIDTH относится только к компоненту proficrm:landing.embed.

В некоторых установках страница управления Сайты 24 доступна по прямой ссылке, но штатный пункт меню не отображается. Причина в том, что модуль landing может считать сайт B24-окружением и скрывать свой пункт в административном меню.

Что делает решение

Решение добавляет собственный admin/menu.php, который выводит пункт Сайты 24 только в режиме, где штатное меню landing скрыто. На обычной редакции, где штатный пункт уже есть, дубль не должен появляться.

Как выглядит пункт меню

После установки решения в режиме Битрикс24 у пользователей с правом записи W на модуль лендингов в левом административном меню появляется раздел Сайты. Внутри него отображается группа Сайты 24 со списком сайтов и пунктом Добавить сайт.

Ссылки меню

• Список сайтов ведет на landing_site.php?lang=ru&site=s1 и аналогичные страницы для других сайтов.
• Пункт Добавить сайт ведет на site_edit.php?lang=ru&landing=Y.

Кнопка Сайты 24 на панели управления

Если страница Сайты 24 размещена через компонент proficrm:landing.embed или встроена в визуальном редакторе и в настройках модуля включена опция Показывать кнопку «Сайты 24» на панели управления, на верхней панели Битрикс появляется кнопка Сайты 24. Она открывает быстрые действия для встроенной страницы.

Примечание. Исходный адрес Сайты 24, например /pub/site/3/, штатно используется модулем Сайты 24 для публикации и проверки страницы. Если основная публичная версия выводится через компонент proficrm:landing.embed, прямой адрес лучше закрыть от индексации, чтобы поисковые системы не воспринимали его как дубль. Для рабочих сайтов также можно ограничить прямой просмотр исходной страницы администраторами или ответственными за контент.

Настройки решения находятся в административном разделе Битрикс на странице настроек модуля ПрофиCRM: Встраивание лендингов Сайты 24.

Панель управления

Визуальный редактор

AJAX не является основным способом вывода. Сначала решение всегда пытается сформировать встроенную страницу средствами PHP.

Журнал событий

Решение может записывать события в стандартный журнал событий Битрикс. Можно включить или выключить журналирование и выбрать типы записей:

• ошибка;
• предупреждение;
• информация;
• отладка.

Если страница не выводится

• Проверьте, что выбранная страница Сайты 24 активна и опубликована.
• Если кнопки нет, проверьте, доступна ли в редакторе панель компонентов. Если доступна, отсутствие кнопки является штатным поведением — используйте компонент Вывод страницы Сайты 24. Если компоненты недоступны, проверьте настройку показа кнопки и очистите кеш Битрикс.
• Проверьте журнал событий решения.
• Если штатные блоки Сайты 24 отображаются без сетки или оформления, выберите Изолированные стили Сайты 24.
• Если после подключения оригинальных стилей изменились меню или ширина страницы, верните режим Изолированные стили Сайты 24 и очистите кеш.
• Включайте резервную загрузку с помощью AJAX только если вывод средствами PHP не сработал.