Перейти к основному содержанию
Дизайн это ваш собственный сайт, загруженный в виде ZIP-архива, который PapelShip отдает как витрину вашего магазина. Вы сохраняете полный контроль над разметкой и добавляете торговые функции тремя способами:
  1. Страницы Liquid: pages/*.liquid отрисовываются с данными вашего магазина на сервере.
  2. Атрибуты data-ps: обычный HTML, который PapelShip заполняет данными товаров на сервере.
  3. SDK: window.PapelShip для товаров, корзины и оформления заказа в браузере.

Пакет

Каждая страница из config/design.json получает свой путь в вашем магазине. Шаблоны. pages/product.liquid (или .html) является вашей страницей товара, а pages/shop.liquid списком товаров магазина. Без них PapelShip показывает нейтральную страницу товара или магазина внутри вашего дизайна. Страница не найдена. Добавьте pages/404.html (или .liquid) для собственной страницы «не найдено». Она показывается для неизвестных адресов и неизвестных товаров.

Сканирование и проверка

Каждая загрузка сканируется, прежде чем она может быть опубликована. Код, атакующий клиентов или платформу, блокируется: поля для данных карты, скрытые перенаправления, формы, отправляющие данные на другие сайты, запросы к API PapelShip или другим магазинам, а также вредоносные скрипты. Необычный код сначала отправляется на проверку PapelShip. Исправьте указанные файлы и загрузите снова. Правки сохраняются как черновики; ваш магазин показывает опубликованную версию. Опубликовать сканирует ровно те файлы, которые отправляет в рабочую версию: заблокированный код отменяет публикацию, а находки, требующие проверки, ждут проверки PapelShip (магазин при этом сохраняет текущую версию) и публикуются после одобрения.

Атрибуты data-ps

Пометьте элементы, и PapelShip заполнит их данными товара на сервере:

Значения

Условия

Контейнеры

Страницы Liquid

Страницы .liquid используют те же объекты, фильтры и теги, что и темы Liquid, включая {% app_block %}. См. Темы и Liquid. Статические экспорты, использующие {{ }} для других шаблонизаторов, остаются безопасными: отрисовываются только страницы .liquid.

SDK

SDK загружается только на страницах дизайна, содержащих привязку data-ps или заполнитель data-app-block. Вызывайте его из обработчика DOMContentLoaded. См. Коммерция и оформление заказа.
На этих страницах SDK доступен как window.PapelShip.

Компоненты

Меню Вставить компонент в редакторе кода добавляет готовый редактируемый код: сетку товаров, карточку товара, страницу товара, цену, кнопку покупки, кнопку «В корзину», счетчик корзины, выдвижную панель корзины, встроенное оформление заказа и список коллекций. Нажмите на компонент в предпросмотре, чтобы снова изменить его настройки.

Страницы магазина

Оформление заказа, корзина, вход, аккаунт и отслеживание заказа отрисовываются внутри вашего дизайна с макетом, который вы выбираете в панели. Чтобы оформить их самостоятельно, добавьте pages/checkout.liquid, pages/cart.liquid, pages/login.liquid, pages/account.liquid или pages/track.liquid (или .html) ровно с одним заблокированным блоком, например <div data-app-block="checkout_form"></div>. Блоки перечислены в разделе Страницы платформы.
Клиенты всегда платят на странице оформления заказа PapelShip или во встроенном всплывающем окне. Дизайны не могут заменять оформление заказа или собирать данные карт.