Перейти до основного вмісту
AI-агенти отримують той самий довідник через 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-тем не мають перевизначень сторінок.