Визард «Магазин»

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

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

Где найти визард

Админка → «Сайт» → вкладка «Сценарии» → «Создать сценарий»: открывается галерея «Что создаём?», в ней карточка «Магазин». Установка идёт в текущий проект; первый прогон удобнее делать на отдельном проекте, чтобы спокойно посмотреть на результат.

Требования

• Роль владельца или админа в проекте: раздел «Сайт» открыт только им.
• Публичный адрес витрине даёт аддон «Сайт» (хостинг сайта на поддомене или своём домене), он работает с любым тарифом. Без аддона установка пройдёт и магазин появится в проекте, но покупатель страницу не откроет.
• Тариф определяет лимиты API. На Free в час приходится 25 записей, и эту квоту делят корзина и оформление заказа; для магазина с потоком покупателей нужен Starter или выше.

Форма из семи шагов

Поля без звёздочки имеют значения по умолчанию. Каждое поле визард проверяет на месте: без названия дальше не пустит, ключ из букв не примет.

Корень сайта визард не занимает: пока вы не сделали под него свою страницу, адрес без пути ведёт в магазин. Такой старт удобен, когда магазин запускается первым разделом, а лендинг появляется позже.

Что создаёт визард

Перед запуском визард показывает план «Что будет создано»: список из пятидесяти операций, последней строкой чек-лист владельца. По кнопке «Применить» в проекте появляются:

Как это работает

Каталог и карточка. Витрина читает товары из типа «Товары»: в каталог попадают только опубликованные записи, новые идут первыми. Правите запись, и через пару секунд витрина показывает обновление: платформа сбрасывает кэш страниц сама. Карта сайта по адресу /sitemap.xml обновляется тоже сама.

Корзина. Корзина живёт на сервере: у гостя это запись в «Корзинах» и метка в куке на 30 дней, суммы считает платформа из актуальных цен. При входе гостевая корзина переезжает покупателю: позиции складываются, при дубле остаётся большее количество. Оформление очищает корзину.

Оплата. Цепочка та же, на которой работает пресет «Приём оплаты через ЮKassa»: заказ создаётся с проверкой остатка, платёж уходит в ЮKassa, покупатель возвращается на страницу заказа. Уведомление об оплате витрина принимает на адрес с вашей меткой, сверяет заказ по идентификатору платежа и сумме и переспрашивает сервер ЮKassa, прежде чем поставить статус «оплачен». Секретный ключ лежит в Секретах проекта под именем yookassa_basic и не фигурирует ни в текстах сценариев, ни в журнале операций.

Кабинет. Покупатель регистрируется по почте и паролю, аккаунт создаётся сразу. Без настроенной почты регистрация всё равно работает: письмо о создании аккаунта просто не уходит, а ноду a_mail в сценарии register можно удалить. В кабинете видны последние двадцать заказов со статусами.

Чек-лист владельца

Последняя строка плана установки показывает четыре дела, которые визард сделать за вас не может:

• скопировать адрес уведомлений и вставить его в кабинет ЮKassa, готовый URL лежит прямо в чек-листе; до вставки платежи проходят, но заказы остаются «новыми»;
• загрузить фото товаров в Медиатеку и привязать к товарам;
• не переименовывать метку входа, она связывает корзину с покупателем;
• вписать свой почтовый сервер в сценарий регистрации или удалить шаг письма.

Если секретный ключ ЮKassa перевыпущен, переустановка не нужна: откройте раздел «Сайт», вкладку «Секреты», и сохраните новое значение поверх записи yookassa_basic. Следующий платёж уйдёт уже с новым ключом.

Повторный прогон на том же проекте существующие записи не трогает: второй прогон нужен для чистого проекта.

Частые вопросы

См. также: Пресеты сценариев · Визард «Приём оплаты через ЮKassa» · Маршруты · Пресет «Вход»