Перейти к основному содержанию
ИИ-агенты получают тот же справочник из MCP тем: инструмент get_reference (тема app_blocks) и ресурс papelship://reference/app-blocks. Редактор кода, validate и save_draft предупреждают о неизвестных блоках, неизвестных или неверно типизированных аргументах и блоках, которые данный вид темы не поддерживает. Блоки платформы ({% app_block %} / data-app-block): аргументы, поведение, поддержка по видам тем; заблокированные блоки страниц.
да*: работает, с примечанием ниже. В секциях кода и выделенных двойниках блоки корзины используют выдвижную панель корзины платформы, а не собственную панель React-темы; значок корзины темы остается синхронизированным.

add_to_cart

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

buy_now

Кнопка покупки в один клик для одного товара. mode: 'page' (по умолчанию) ведет на оформление заказа платформы только с этим товаром (корзина сохраняется). mode: 'embed' открывает всплывающее окно оформления поверх страницы (iframe платформы; данные карты никогда не попадают в тему) и переходит на страницу, если виджет не удается загрузить.

cart_count

Кнопка корзины с количеством товаров (“Cart <n>”); ваша собственная разметка сохраняет свой вид, а дочерний элемент [data-ps-count] получает число. Нажатие открывает выдвижную панель корзины. Аргументов нет.

cart_drawer

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

checkout_button

Кнопка оформления заказа для всей корзины (неактивна, пока корзина пуста). mode: 'page' (по умолчанию) ведет на <store>/checkout; mode: 'embed' открывает всплывающее окно оформления; после оплаты корзина очищается.

currency_selector

Выбор валюты отображения (скрыт, если валют меньше двух). Сохраняет валюту отображения (оплата всегда списывается в валюте магазина) и генерирует событие papelship:currency-change. В секциях кода и двойниках передавайте currencies: эти страницы знают только валюту магазина.

language_selector

Выбор языка магазина (скрыт, если у магазина один язык). Устанавливает cookie языка и перезагружает страницу. Аргумент: label.

newsletter_form

Подписка на рассылку с явным флажком согласия. Отправляет данные на эндпоинт лидов платформы; в предпросмотре подписка никогда не оформляется. Аргументы: label, placeholder, button, consent_text.

powered_by

Подпись “Powered by PapelShip” (скрыта на тарифах, которые позволяют ее скрывать). Только для тем Liquid: страницы дизайнов и подвалы React-тем получают подпись от платформы автоматически.

quick_view

Кнопка быстрого просмотра одного товара: открывает диалог с изображениями, ценой, вариантами и кнопкой добавления в корзину. Аргументы: product_id (обязательный, псевдоним product), label.

recently_viewed

Недавно просмотренные посетителем товары (из этого браузера); ничего не отрисовывает, если список пуст. Товары записываются на страницах товаров Liquid (страницы товаров React-тем просмотры не записывают). Аргументы: limit (по умолчанию 4, от 1 до 20), heading.

reviews_widget

Опубликованные отзывы: о товаре на страницах товаров, иначе о магазине. Не поддерживается в секциях кода и двойниках (на этих страницах нет данных отзывов; используйте секцию отзывов React-темы). Аргументы: heading, limit (по умолчанию 5, от 1 до 50), write (по умолчанию true; false скрывает ссылку «написать отзыв»).

variant_picker

Выбор варианта (группы переключателей) для одного товара. add_to_cart / buy_now того же товара в ближайшем общем контейнере (или элементе data-ps-scope) используют выбранный вариант; тексты data-ps price / compare-price / stock следуют за ним. Аргумент: product_id (обязательный, псевдоним product).

wishlist_button

Переключатель избранного для одного товара (кнопка в виде сердца с aria-pressed). Сохраняется в браузере и синхронизируется с аккаунтом клиента после входа. Аргумент: product_id (числовой id; хеш-ID не сохраняются в аккаунте).

Заблокированные блоки страниц

Каждый из них работает только один раз, в своем собственном файле переопределения. В пакетах кода React-тем переопределений страниц нет.