Быстрый старт

Это руководство поможет вам быстро настроить MiniShop3 и создать первые товары.

Системные требования

Требование	Версия
MODX Revolution	3.0.0+
PHP	8.1+
MySQL	5.7+ / MariaDB 10.3+
Composer	2.x

Зависимости

• pdoTools 3.x — для работы сниппетов и шаблонизатора Fenom
• VueTools — Vue 3 и PrimeVue для административного интерфейса
• Scheduler (опционально) — для фоновых задач (импорт, уведомления, очистка)

Установка

Через менеджер пакетов MODX

1. Подключите наш репозиторий
2. Перейдите в Пакеты → Установщик
3. Выберите поставщика Modstore.pro, Нажмите Загрузить пакеты
4. Найдите по очереди pdoTools, VueTools, Scheduler, MiniShop3 в каталоге
5. Для каждого Нажмите Скачать и Установить

Подробнее о способах установки — на главной странице документации.

Что происходит при установке

MiniShop3 автоматически:

1. ✅ Создаёт таблицы в базе данных через систему миграций Phinx
2. ✅ Регистрирует сниппеты, плагины и чанки
3. ✅ Устанавливает системные настройки с префиксом ms3_
4. ✅ Создаёт статусы заказов по умолчанию
5. ✅ Создаёт способы доставки и оплаты

Первоначальная настройка

1. Служебные страницы магазина

Создайте следующие страницы:

1. Корзина — разместите сниппет msCart
2. Оформление заказа — разместите сниппет msOrder
3. Заказ оформлен — разместите сниппет msGetOrder
4. Личный кабинет — разместите сниппет msCustomer с сервисом profile
5. Заказы клиента — разместите сниппет msCustomer с сервисом orders
6. Адреса клиента — разместите сниппет msCustomer с сервисом addresses

Примеры реализации шаблонов для каждой из этих страниц подготовлены в каталоге /core/components/minishop3/elements/templates/ Для быстрого старта можете полностью скопировать разметку шаблонов и далее подгонять ее под себя

2. Системные настройки

Перейдите в Системные настройки и найдите настройки с пространством имён minishop3 (можно написать page_id в поиске):

Настройка	Описание
ms3_cart_page_id	ID страницы с корзиной
ms3_order_page_id	ID страницы оформления заказа
ms3_order_success_page_id	ID страницы, на которую перенаправляется клиент после успешной оплаты заказа
ms3_order_redirect_thanks_id	ID страницы «Спасибо за заказ»
ms3_customer_login_page_id	ID страницы авторизации клиента (Обычно равен ID страницы профиля)
ms3_customer_register_page_id	ID страницы регистрацииы клиента (Обычно равен ID страницы профиля)
ms3_customer_profile_page_id	ID страницы профиля клиента
ms3_customer_orders_page_id	ID страницы истории заказов клиента

Полный список настроек — на странице Системные настройки.

3. Создание категорий

1. Перейдите в Ресурсы
2. Создайте новый ресурс с Типом ресурса = Категория товаров 3. Заполните название, выберите нужный шаблон и сохраните

4. Создание товаров

1. В категории нажмите Добавить товар
2. Введите название, выберите подходящий шаблон и сохраните
3. После сохранения Заполните вкладку Свойства товара:
   • Артикул
   • Цена
   • Вес (опционально)
   • Изображение
4. Сохраните товар, не забыл поставить отметку Опубликовано

Шаблоны

Для быстрого старта, и в качестве примера, в комплекте прилагается целый шабор готовых шаблонов, из которых вы можете забрать себе код целиком, а потом подредактировать под свой дизайн. Для вас доступны шаблоны

• core/components/minishop3/elements/templates/catalog.tpl - Каталог
• core/components/minishop3/elements/templates/product.tpl - Информация о товаре
• core/components/minishop3/elements/templates/cart.tpl - Корзина
• core/components/minishop3/elements/templates/order.tpl - Оформление заказа
• core/components/minishop3/elements/templates/thanks.tpl - Спасибо за заказ
• core/components/minishop3/elements/templates/customer.tpl - Личный кабинет клиента

Оформление заказа

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

И напоследок, убедитесь что в существующем способе доставки, указаны обязательные для вашего случая поля. Обычно это телефон, имя, фамилия, иногда Email

Следующие шаги

• Сниппеты — полный справочник по сниппетам
• Интерфейс админки — описание административного интерфейса
• Интерфейс фронтенда — описание интерфейса сайта, шаблонов, чанков
• Возможности JavaScript — как использовать JS на вашем сайте
• REST API — интеграция через API
• События — расширение через плагины