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