Интеграции приложений и плагинов

Slate предусматривает оформление и специальные места для ряда плагинов Webasyst. Плагины устанавливаются и настраиваются отдельно в своём приложении: тема не выдаёт лицензию, не создаёт данные плагина и не включает его вместо вас.

Как подключить интеграцию

Установите плагин, включите его для нужной витрины и заполните его настройки. Затем настройте место вывода в Slate. Часть возможностей включается в «Приложения и плагины → Приложение Магазин → Плагины», часть выбирается в составе шапки, страницы товара или главной.

Если блока нет на странице, проверьте четыре вещи: приложение установлено, плагин активен, у него есть данные для вывода, соответствующий элемент добавлен в тему. Например, пустой плейлист не превращается в видеоленту после включения блока. Тема проверяет, что плагин именно включён, а не просто установлен: у выключенного плагина вывода нет, а на его месте работает штатная возможность темы — например, обычный поиск в шапке вместо «Умного поиска PRO».

Поиск, каталог и выбор города

Для filterext тема сохраняет штатный идентификатор формы фильтров products-filters-form. Это место подключения плагина, а не обещание поддержки всех его дополнительных режимов: проверяйте нужный сценарий с установленной версией плагина.

Собственные подсказки темы отключаются, когда выбран поддерживаемый поисковый плагин, чтобы под полем не возникало двух списков. У «Поиска PRO» есть отдельные шаблоны результатов и фильтров; настройки того, какие данные участвуют в поиске, остаются в плагине.

Окно выбора города «SEO-регионов»

Кнопку города и окно выбора Slate оформляет сама: поиск города, сообщение «не найдено», список всех городов, отметку текущего региона и блокировку прокрутки страницы под открытым окном. Стили плагина для этого не нужны, поэтому в настройках «SEO-регионов» можно снять отметку «Подключать дефолтный CSS» — страница станет легче.

Эта отметка общая для всего сайта: плагин перестанет подключать свои стили на всех витринах. Если на одной из витрин работает другая тема, которая рассчитывает на оформление плагина, оставьте отметку включённой.

Окно закрывается крестиком или нажатием на фон вне него; после закрытия снова можно прокручивать страницу.

Окно города работает и на страницах «Сайта» и блога, если тема Slate установлена также для магазина: без неё у плагина нет оформления для таких страниц. Изменить вид окна специалист может собственными стилями.

Страница товара, корзина и оформление

Для покупки в один клик предусмотрены buy1click, buy1click2 и ewshopqorder. Выберите установленный плагин отдельно для нужных мест: «Страница товара → Блоки товара», «Каталог товаров → Отображение товаров», «Оформление заказа → Купить в один клик». По умолчанию такая кнопка скрыта; в быстром просмотре товара она не выводится.

В составе страницы товара можно включить блок «Группы товаров» (productgroup) и блок «Информация о доставке и оплате» (dp). Для групп также предусмотрен компактный вывод в карточках каталога. Данные групп и условия доставки заполняются в самих плагинах.

Блок «Групп товаров» оформлен темой так же, как выбор артикула: текстовые группы — плашками выбора, фото и цвета — плитками, над группой — подпись «Название: значение выбранного». Вид группы (фото, цвета или текст) задаётся в плагине: фото-группа всегда показывает фото товаров, цветовая — цвет значения характеристики. Собственные стили плагина на элементы темы не действуют, поэтому в настройках оформления плагина для темы Slate можно снять «Подключить CSS-стили плагина». Если в плагине включено «Ограничить высоту блока группы» и задано «Количество отображаемых строк в блоке», лишние строки вариантов сворачиваются под кнопку «Показать все» — это делает сама тема и работает при любом режиме библиотеки jQuery. В карточках каталога группы выводятся компактно и без заголовка.

В составе «Сведений о товаре» предусмотрены видео (ewshoppvideo), файлы (ewshoppattach) и комплекты (itemsets). Добавьте нужный пункт в список сведений, если его там нет. Видео и файлы выводятся из опубликованных материалов плагина; без данных соответствующего раздела не будет.

«Управление товарами в корзине» (ewshopmpcart) использует подготовленные шаблоны отметок, панели управления и исключённых товаров. «Умные артикулы» (smartsku) подключается при выборе артикула на странице товара. Настройки работы этих плагинов остаются в магазине.

«Гибкие скидки» (flexdiscount) работают на странице товара и в оформлении заказа. На товаре плагин пересчитывает свои блоки после выбора характеристики и изменения количества. Оформление заказа сохраняет штатное устройство Shop-Script, поэтому плагин, «Выбор города» и «Управление товарами в корзине» находят его без дополнительных настроек.

Для checkoutauth предусмотрена настройка «Оформление заказа → Форма входа вместо оформления для незалогиненного покупателя». Она показывает гостю формы плагина, когда доступны плагин и авторизация магазина. Обычные способы доставки, оплаты и ошибки оформления по-прежнему обрабатывает Shop-Script; подробнее — об оформлении заказа.

При активном «Согласии на cookie» (ewshopconsent) тема уступает ему вывод уведомления о cookie, чтобы рядом не было двух плашек. Баннер, окно настроек и плавающую кнопку плагина тема выводит своими шаблонами в цветах сайта: ссылки на политику и на согласие на обработку персональных данных — отдельными строками, кнопки «Принять» и «Отказаться» — одного вида и ширины.

Личный кабинет

В кабинете предусмотрены кнопки повторения заказа (wreorder) и отмены (wordercancel), отслеживание заказа (bnptracking), «Отзывы о товарах» (myreviews) и «Мои отзывы» — отзывы о сайте из приложения «Заявки» (sitereviews). Оба раздела отзывов выводятся карточками; если отзывов о товарах нет, показывается сообщение вместо пустой таблицы, а в «Моих отзывах» кнопка «Оставить отзыв» оформлена кнопкой темы. Доступность конкретного действия определяется плагином и состоянием заказа. Для «Автотрекера заказов» нужны включённая страница отслеживания и премиум-лицензия плагина: без страницы ссылки отслеживания в заказах нет.

«Избранное PRO» (wishlist) в кабинете выводится шаблонами темы: страница избранного внутри кабинета и пункт меню плагина; собственные пункт и плитка «Избранное» темы при этом скрываются. Блоки других плагинов в разделах кабинета показываются отдельной карточкой с полями и кнопками в стиле темы.

Для RetailCRM предусмотрены страницы бонусной программы и подписок внутри оформления кабинета Slate. Настройку CRM и доступность этих разделов обеспечивает интеграция магазина. Сам кабинет описан в отдельной статье.

Изображения и баннеры

Тема использует плагины изображений категорий (ewshopcimg), страниц магазина (ewshoppimg), пунктов приложения «Меню» (ewmenuimg) и записей блога (ewblogpimg). Загрузите изображения в соответствующем плагине и согласуйте группу и размеры с местом вывода. Без плагина картинок записей блога предусмотрена обложка из первой фотографии альбома записи, если такой альбом есть.

«Промобаннеры: дополнительные поля» (ewshopmarketing) добавляет ссылки и сведения о рекламе к акциям магазина. Slate использует эти поля в поддерживаемых баннерах акций. Отметка «Реклама» появляется, когда заполнены и рекламодатель, и ERID; место отметки задаётся в настройках баннера. Произвольная картинка из настройки темы не получает поля акции автоматически.

Ленты главной и материалы блога

Первые четыре блока требуют приложение «Магазин», даже если стоят на главной приложения «Сайт». Добавьте нужный блок в состав главной и заполните его настройки. Если приложение, плагин или данные отсутствуют, лента не показывается.

«Живые отзывы» по умолчанию выводятся карточками, как блок «Отзывы», со ссылкой «Все отзывы» из настроек блока. Прежний вид — собственная лента плагина — выбирается в поле «Вид блока»: «Лентой плагина».

Для блога предусмотрены «Похожие записи» (ewblogrelated), «Товары в записи» (ewblogproducts) и оформление вопросов и ответов (ewblogfaq). Для товаров в записи дополнительно нужен магазин. Списки и вопросы настраиваются в плагинах.

Поддержка и база знаний

Для приложения «Поддержка» (Helpdesk) предусмотрены публичная база знаний, поиск ответов, форма обращения и раздел «Мои обращения» в общем личном кабинете. На странице обращения сохраняются переписка, вложения и действия, доступные клиенту в текущем состоянии.

Установите тему Slate для Helpdesk и укажите её в маршруте приложения. В настройках самого Helpdesk выберите публичный режим и источник формы обращения. Авторизация домена должна быть привязана к приложению с публичными страницами, например «Сайт»; иначе закрытые страницы могут открыть служебную форму входа.

В панели темы «Приложения и плагины → Поддержка» меняются заголовок и вводный текст главной базы знаний, подпись кнопки обращения, заголовок и пояснение пустой базы. Пустое текстовое поле скрывает пояснение; пустой заголовок возвращает стандартный. Эти настройки общие для конфигураций. Если приложение перенаправляет главную базы сразу в категорию, заголовок категории берётся из Helpdesk.

Поля формы, CAPTCHA, согласие, источники, клиентские состояния, уведомления и правила обработки заявок настраиваются в Helpdesk. Тема сохраняет выбранное в конструкторе скрытие подписей и оформляет ошибки полей. Кнопка обращения появляется только при доступном источнике публичной формы; текст настройки не включает её сам по себе. Посетителю пустой базы не показывается инструкция входа в административную часть.

Встроенные формы Helpdesk на страницах других приложений получают то же оформление. Для них и для кабинета оставьте настройку «Библиотека jQuery» в режиме «На всех страницах» или «Магазин, вход, кабинет и страницы с плагинами»: обработчики форм принадлежат ядру приложения и требуют этой библиотеки.

Сообщество и обсуждения

Для приложения «Хаб» (Hub, сообщество) предусмотрены главная сообщества, категории, поиск, теги, страницы участников и темы всех штатных типов: обсуждения, вопросы, отзывы и статьи. В личном кабинете участник видит свои темы, ответы и подписки. Подписки другого участника остаются закрытыми.

Установите дочернюю тему Slate для Hub и выберите её в маршруте приложения. Сообщества, категории, типы тем, права участников, архивирование, уведомления и правила выбора решения настраиваются в Hub. Создание статей посетителями по умолчанию запрещено; оно появляется только при соответствующем разрешении в настройках типа.

В панели «Приложения и плагины → Хаб» задаются заголовок и вводный текст главной, подпись кнопки добавления темы, заголовки и пояснения пустой ленты и пустого поиска. Эти семь полей общие для конфигураций. Пустое пояснение скрывается, пустой заголовок возвращает стандартный.

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

Для визуального редактора оставьте «Библиотека jQuery» в режиме «На всех страницах» или «Магазин, вход, кабинет и страницы с плагинами». В режиме «Не подключать» остаётся обычное текстовое поле; тема продолжает отправлять комментарии и выполнять собственные действия без jQuery. Установленные сторонние плагины могут требовать библиотеку независимо от темы.

Документация: приложение «Код»

Для приложения «Код» у Slate есть своя тема: главная документации со списком проектов и фильтром «Темы / Приложения / Плагины», страница проекта, статья с меню проекта слева и оглавлением справа, поиск и страница «не найдено». На телефоне меню проекта открывается выезжающей панелью; у блоков кода есть кнопка копирования, широкие таблицы прокручиваются внутри статьи.

Установите тему Slate для «Кода» и выберите её в маршруте приложения. Проекты, главы, статьи, их порядок, публикация и SEO редактируются в самом приложении. В панели темы «Приложения и плагины → База знаний» меняются подписи: заголовок и вводный текст главной, названия фильтров, тексты поиска, меню, оглавления, кнопок «Назад» и «Далее», копирования кода и пустых состояний. Пустые заголовок и вступление главной берутся из настроек документации в приложении.

Рассылки и подписка

С приложением «Рассылки» (Mailer) работают два места. Первое — форма подписки на новости в подвале: она включается в «Подвал → Подписка → Выводить форму», там же задаются заголовок, описание, текст согласия на обработку данных и расположение — в подвале или отдельной полосой перед ним. Ссылку на свою страницу политики впишите прямо в текст согласия. Форма появляется только при установленном приложении «Рассылки», у которого настроен адрес подписки на сайте.

Второе — раздел «Подписки» в общем личном кабинете. Для него установите тему Slate для «Рассылок» и выберите её в маршруте приложения. Подписчик отмечает нужные рассылки и сохраняет выбор, может отписаться от всех рассылок сразу и подписаться снова. Списки рассылок, письма и подтверждение подписки настраиваются в самом приложении.

Плагины и библиотека jQuery

Сама тема jQuery не использует, но эта библиотека нужна формам входа и оформления заказа, формам «Поддержки» и многим плагинам. Режим подключения выбирается в «Прочее → Скорость загрузки → Библиотека jQuery»:

• «На всех страницах» — библиотека есть везде, плагины работают как обычно;
• «Магазин, вход, кабинет и страницы с плагинами» — библиотека подключается на страницах магазина, входа и кабинета и там, где приложение или плагин добавили свой скрипт; остальные страницы загружаются быстрее;
• «Не подключать» — библиотеки нет нигде. Плагины, написанные на jQuery, в этом режиме перестают работать: не открываются их окна, не срабатывают кнопки и формы.

Выбрав «Магазин, вход, кабинет и страницы с плагинами» или «Не подключать», откройте страницы с плагинами и формами и проверьте их действия. Собственные возможности темы — добавление в корзину, избранное и сравнение, фильтры каталога, сворачивание строк «Групп товаров», просмотр фотографий — работают в любом режиме. Окно выбора города «SEO-регионов» открывает скрипт самого плагина на jQuery, поэтому в режиме «Не подключать» оно не работает. Подробнее о настройке — в статье о служебных настройках.

Другие плагины и собственное оформление

Slate сохраняет штатные места вывода расширений Webasyst: в шапке и подвале, на страницах категории и товара, в корзине, кабинете, записях блога и фотогалерее. Плагин, который подключается через эти события, может вывести своё содержимое без отдельного переключателя Slate. Это не означает, что произвольный плагин автоматически получит специальное оформление темы.

При замене шаблона страницы сохраните вызовы вывода расширений. Иначе кнопки или блоки плагина могут исчезнуть. Для собственных стилей и шаблонов используйте места для пользовательского кода; служебные классы и атрибуты плагина сохраняйте.