Тема

Шорткоды плагина ​

Плагин предоставляет несколько шорткодов для вывода специфичной информации в любом месте вашего сайта (в описании товаров, на страницах корзины, в личном кабинете и т. д.).

Базовая версия плагина ​

[maxpos_integration_kbzhu] — Вывод КБЖУ товара ​

Отображает пищевую ценность (калорийность, белки, жиры, углеводы) для конкретного товара. Данные берутся из iiko.

Атрибуты:

  • id — (обязательный) ID товара WooCommerce.
  • mode — режим расчета. Значения: per_100g (на 100 грамм, по умолчанию) или per_item (на порцию).
  • names — формат названий. Значения: short (Б, Ж, У, Э, по умолчанию) или full (Белки, Жиры, Углеводы, Энергетическая ценность).
  • precision — количество знаков после запятой (по умолчанию 0).
  • delimiter — разделитель между названием и значением (по умолчанию  — , то есть тире).
  • style — подключение базовых CSS стилей таблички. Значения: on (по умолчанию) или off.

Базовый пример использования:

text
[maxpos_integration_kbzhu id="123"]

Пример использования с переопределением значений по умолчанию:

text
[maxpos_integration_kbzhu id="123" mode="per_item" names="full" precision="1" delimiter=" | " style="off"]

[maxpos_integration_allergens] — Вывод аллергенов товара ​

Отображает аллергены блюда одной строкой, например «Аллергены: Клейковина (глютен), Молоко, Яйца». Данные берутся из внешнего меню iiko. Если у товара аллергенов нет, шорткод ничего не выводит.

Названия можно изменить в карточке товара на вкладке Основное. Пустое поле удаляет аллерген из списка. Повторный импорт внешнего меню снова записывает названия из iiko. Выгрузка номенклатуры из iikoOffice аллергены не передаёт.

Атрибуты:

  • id — (обязательный) ID товара WooCommerce.

Пример использования:

text
[maxpos_integration_allergens id="123"]

Вывод на странице товара ​

Те же блоки можно включить без шорткода: WooCommerce → Настройки → MAXPOS Integration → Фронтенд → Страница товара.

  • Показывать КБЖУ — пищевая ценность на 100 г, полные названия, два знака после запятой, разделитель : .
  • Показывать аллергены — строка «Аллергены: …».
  • Расположение — вкладка «Дополнительная информация» или отдельная вкладка. Если вкладки «Дополнительная информация» у товара нет, плагин добавляет её, когда есть что показать.

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

MAXPOS Integration Pro (шорткоды) ​

[maxpos_integration_delivery_zones] — Карта зон доставки ​

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

Атрибуты (принимают значения yes или no для включения и отключения соответственно):

  • disable_geolocation — отключить автоопределение местоположения пользователя.
  • disable_map_scroll_zoom — отключить масштабирование карты колесиком мыши.
  • disable_map_drag — отключить перетаскивание карты.
  • use_city_suggest — использовать подсказки городов.
  • filter_suggest_districts — убирать районы из подсказок адреса.
  • only_map — вывести только карту (без дополнительных полей ввода адреса).
  • collapsed_map — вывести карту в свернутом виде (раскрывается по клику).
  • hide_map_after_ac — скрыть карту после успешного выбора адреса.
  • messages_after_map — выводить служебные сообщения (ошибки зон, минимальной суммы) под картой, а не над ней.

Пример использования:

text
[maxpos_integration_delivery_zones disable_geolocation="no" disable_map_scroll_zoom="yes" disable_map_drag="yes" use_city_suggest="yes" only_map="no" collapsed_map="yes" hide_map_after_ac="no" messages_after_map="yes"]

Страница управления доставкой ​

Шорткод [maxpos_integration_delivery_control] в плагине больше не регистрируется. Интерфейс модуля выводится только шаблоном страницы Delivery Control.

Создайте страницу WordPress и в атрибутах страницы выберите этот шаблон. Страница доступна пользователям с правом manage_woocommerce (например, администратору сайта или менеджеру магазина). Без нужных прав интерфейс не показывается.

На странице можно:

  • включать и отключать доставку целиком;
  • задавать проценты временных наценок за пробки и погоду и включать сами наценки на выбранный срок;
  • управлять зонами доставки;
  • загружать новый файл зон в формате .geojson.

Подробнее: Управление доставкой.

[maxpos_integration_bonuses] — Баланс бонусов iikoCard ​

Выводит текущий баланс бонусных баллов авторизованного пользователя (клиента).

Пример использования:

text
[maxpos_integration_bonuses]

[maxpos_integration_user_cats] — Уровень клиента iikoCard ​

Выводит уровень лояльности текущего авторизованного клиента. Гостю шорткод ничего не показывает. Удобно размещать в личном кабинете WooCommerce.

Атрибуты:

  • title — текст перед названием уровня (по умолчанию: Ваш уровень: ).

Пример использования:

text
[maxpos_integration_user_cats title="Ваш уровень: "]

[maxpos_integration_loyalty_account] — Уровень и бонусы ​

Выводит уровень клиента и баланс бонусов выбранной бонусной программы одним блоком. Данные запрашиваются у iiko одним обращением. Шорткод работает только для авторизованного пользователя.

Если в профиле нет телефона или программа лояльности не ответила, выводится сообщение: «Информация о программе лояльности недоступна. Убедитесь, что в профиле указан номер телефона.»

Удобно размещать в личном кабинете WooCommerce вместо двух отдельных шорткодов [maxpos_integration_user_cats] и [maxpos_integration_bonuses].

Атрибуты: нет.

Пример использования:

text
[maxpos_integration_loyalty_account]

[maxpos_integration_show_chosen_product_mods] — Выбранные модификаторы ​

Служебный шорткод для вывода списка выбранных модификаторов конкретной позиции в корзине. Плагин автоматически использует его для интеграции с популярными плагинами всплывающей корзины (например, WPC Fly Cart).

Атрибуты:

  • cart_item_key — (обязательный) уникальный ключ позиции в корзине WooCommerce.

Пример использования:

php
if ( shortcode_exists( 'maxpos_integration_show_chosen_product_mods' ) ) {
    echo do_shortcode( '[maxpos_integration_show_chosen_product_mods cart_item_key="' . $cart_item['key'] . '"]' );
}

См. также ​