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-тем переопределений страниц нет.