Тема

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

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

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

[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 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] — Страница управления доставкой ​

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

Шорткод подходит для размещения на отдельной служебной странице WordPress, где нужно быстро:

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

Обычно этот шорткод размещают на отдельной странице, например «Управление доставкой».

Атрибуты:

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

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

text
[maxpos_integration_delivery_control]

ПОДСКАЗКА

Вместо шорткода можно использовать шаблон страницы Delivery Control, если вам удобнее назначать модуль через шаблон WordPress-страницы.

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

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

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

text
[maxpos_integration_bonuses]

[maxpos_integration_user_cats] — Категории пользователя iikoCard ​

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

Атрибуты:

  • title — заголовок перед списком категорий (по умолчанию: User categories: ).

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

text
[maxpos_integration_user_cats title="Ваши категории: "]

[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'] . '"]' );
}

См. также ​