- Результат курса
- Для какой версии этот курс
- Что подготовить перед курсом
- Этап 1. Установить MODX и настроить проект
- Этап 2. Подключить шаблон и общие настройки
- Этап 3. Настроить miniShop2 и создать каталог
- Уроки по каталогу и карточкам
- Этап 4. Добавить опции и изображения товаров
- Этап 5. Настроить корзину и оформление заказа
- Письма заказа
- Этап 6. Проверить магазин перед запуском
- Дополнительные возможности
- Импорт и управление каталогом
- Поиск, фильтры и варианты товаров
- Дополнительные блоки
- Совместимость и границы курса
- Карта уроков по miniShop2
Эта карта объединяет уроки по созданию интернет-магазина на MODX 2 и miniShop2. Пройдем путь от установки и настройки до каталога, корзины, заказа и проверки работы магазина.
В этой ветке используем MODX 2 и miniShop2. Уроки не являются инструкцией по установке MiniShop3 на MODX 3: это отдельный компонент с собственными требованиями и документацией.
Не обязательно изучать все дополнительные материалы подряд. Сначала соберите работающий каталог и заказ, затем подключайте поиск, варианты товаров, импорт и другие функции по требованиям проекта.
Результат курса
В результате у вас будет учебный магазин на MODX 2 с miniShop2:
- категории и подкатегории;
- карточки товаров и изображения;
- опции и варианты товара;
- корзина и оформление заказа;
- настроенные способы доставки и оплаты;
- проверенные письма покупателю и администратору.
По мере необходимости магазин можно дополнить фильтрами, поиском, импортом товаров, личным кабинетом и другими функциями. Эти задачи вынесены в дополнительные этапы, чтобы не усложнять первый рабочий результат.
Для какой версии этот курс
Основной маршрут использует MODX 2 и miniShop2. miniShop2 работает именно в ветке MODX 2, в его документации указана зависимость от pdoTools 2. PHP 7.4 обозначен как рекомендуемый, а стабильность работы на PHP 8.x не гарантируется. Перед установкой сверяйте требования текущих выпусков CMS, miniShop2 и дополнений.
MiniShop3 предназначен для MODX 3 и не является просто обновленной версией miniShop2 с теми же настройками. Этот курс не обещает автоматически переносить данные и код miniShop2 в MiniShop3.
Если вы только осваиваете систему, сначала пройдите карту основ MODX 2. Она знакомит с ресурсами, шаблонами, чанками, сниппетами, TV и стандартными тегами.
Что подготовить перед курсом
- Рабочую установку MODX 2 на тестовом домене или локальном сервере.
- Резервную копию файлов и базы перед изменениями.
- Подходящий HTML-шаблон магазина или подготовленную верстку.
- Тестовые изображения и описания товаров.
- Доступ к настройкам хостинга и почтового транспорта.
Не начинайте практику с действующего магазина. Сначала отработайте действия на копии или отдельной установке.
Этап 1. Установить MODX и настроить проект
- Установите MODX на хостинг или подготовьте локальную установку для разработки.
- Настройте MODX: проверьте системные параметры и создайте резервную копию.
- Проверьте базовую безопасность и доступ к служебным каталогам.
- Подключите поставщика дополнений и установите совместимые выпуски pdoTools и miniShop2.
Перед установкой магазина проверьте версию PHP, MODX, miniShop2 и pdoTools. Не подменяйте один выпуск другим только потому, что он новее по номеру.
Результат этапа: открывается админка, сохранена резервная копия, менеджер пакетов показывает установленные компоненты без ошибок.
Этап 2. Подключить шаблон и общие настройки
- Подготовьте HTML-шаблон магазина и проверьте его отдельно от MODX.
- Подключите стили, скрипты, изображения и шрифты, сохранив структуру выбранной верстки.
- Подготовьте шаблоны страниц для каталога, категории, товара, контактов и служебных страниц.
- Настройте источник файлов, если редакторам нужно выбирать изображения или другие файлы из менеджера.
- Вынесите общие контакты в ClientConfig, если телефон, адрес и другие значения должны меняться из админки.
Если используете файловые элементы и Fenom, рассматривайте это как отдельный вариант организации разработки. Не смешивайте в одном шаге инструкции для файловых чанков и элементов, созданных только в админке: зафиксируйте выбранную структуру проекта.
Результат этапа: сайт открывается с выбранным оформлением, общие контакты задаются в одном месте, шаблоны основных страниц готовы к наполнению.
Этап 3. Настроить miniShop2 и создать каталог
- Проверьте настройки miniShop2 по руководству по настройкам.
- Создайте дерево категорий и подкатегорий.
- Добавьте несколько тестовых товаров с названием, описанием, ценой и изображениями.
- Настройте отображение списка товаров в категории.
- Откройте карточку товара и проверьте вывод данных.
Для первого теста достаточно нескольких товаров и одной-двух категорий. Не импортируйте сразу весь каталог и не подключайте сложные фильтры, пока не работает базовый вывод.
Результат этапа: посетитель видит категории, список товаров и страницу отдельного товара.
Уроки по каталогу и карточкам
- Быстрый старт с miniShop2 — первичная настройка шаблонов, категорий, товаров и корзины.
- msProducts — параметры вывода списка товаров.
- Шаблон категории товаров — сетка и оформление списка.
- Шаблон товара — оформление карточки товара на Fenom.
Этап 4. Добавить опции и изображения товаров
- Создайте и выведите опции товаров, если покупателю нужно выбрать размер, цвет или другой вариант.
- Настройте источник файлов и галерею товара.
- Проверьте создание миниатюр, сортировку фотографий и отображение главного изображения.
Опции нужны не каждому товару. Если у проекта нет размеров, цветов или иных вариантов, этот этап можно пропустить.
Для загрузки и обработки изображений используйте инструкцию по источникам и галерее miniShop2. Автоматическую замену и массовое удаление изображений сначала проверяйте на копии.
Результат этапа: у товаров отображаются нужные фотографии и варианты, а редактор может менять их через менеджер.
Этап 5. Настроить корзину и оформление заказа
После проверки каталога переходите к покупке. Проверьте сценарий целиком: добавление товара, изменение количества, удаление позиции, расчет суммы и отправка заказа.
- Настройте страницу корзины и блок миникорзины.
- Настройте форму заказа и обязательные поля.
- Определите доступные способы доставки и оплаты.
- Проверьте письмо администратору и уведомление покупателю.
- Сделайте тестовый заказ в безопасном режиме, не используя реальные платежные данные.
Платежную систему подключайте только после того, как корректно работают корзина, заказ и тестовое уведомление. Для интеграции оплаты используйте отдельную инструкцию и тестовый режим провайдера.
Результат этапа: тестовый покупатель может пройти от карточки товара до созданного заказа, а администратор видит заказ в панели управления.
Письма заказа
После настройки заказа при необходимости измените шаблон письма miniShop2: редактирование письма заказа.
Проверьте тему, отправителя, состав позиций и данные покупателя. Не вставляйте в публичный шаблон письма пароли, API-токены и другие секреты.
Этап 6. Проверить магазин перед запуском
- Проверьте каталог, категории, карточки и изображения на компьютере и телефоне.
- Проведите тестовый заказ от начала до конца.
- Проверьте письма, статусы заказов, доставку и оплату.
- Настройте понятные адреса, HTTPS и страницы ошибок.
- Сохраните резервную копию файлов и базы.
- Проверьте доступы к админке, служебным каталогам и сохраненным заказам.
- Проверьте, что на сайте не осталось демонстрационных цен, адресов и тестовых товаров.
Если сайт разрабатывался на локальном сервере, после переноса на хостинг повторите тестовую покупку и проверку писем уже на рабочем окружении.
Дополнительные возможности
Подключайте их только тогда, когда базовый каталог и оформление заказа уже работают.
Импорт и управление каталогом
- Импорт и экспорт товаров через msImportExport — для массовой загрузки или обновления каталога.
- Таблица товаров в категории — если менеджеру удобнее редактировать позиции списком.
- Массовое удаление изображений — только после резервной копии и теста на копии.
Поиск, фильтры и варианты товаров
- msOptionsPrice2 — для связанных вариантов товара и изменения цены.
- Примеры выборок для miniShop2 — дополнительные сценарии каталога.
- Для поиска и фильтрации можно рассмотреть mSearch2 и дополнительные компоненты. Их совместимость и актуальные версии нужно проверять отдельно.
Дополнительные блоки
- Избранные товары.
- Блок «Вы смотрели».
- Всплывающее окно после добавления в корзину.
- Слайдеры через MIGX, если они нужны дизайну магазина.
Совместимость и границы курса
Основная последовательность этого курса относится к MODX 2 и miniShop2. Не обновляйте систему до MODX 3 только ради прохождения магазинных уроков.
MiniShop3 предназначен для MODX 3 и является отдельным компонентом. Перенос магазина с miniShop2 на MiniShop3 требует отдельной проверки товаров, опций, заказов, платежей и дополнений. Это не простое обновление ядра.
Если вы рассматриваете другой стек, сначала сделайте отдельную тестовую копию магазина, проверьте совместимость компонентов и только потом принимайте решение о переносе.
Карта уроков по miniShop2
Основной путь курса:
- Установка MODX 2 и подготовка тестовой копии.
- Первичная настройка системы и miniShop2.
- Категории, товары и шаблоны каталога.
- Изображения и опции товаров.
- Корзина и оформление заказа.
- Доставка, оплата, письма и проверка тестового заказа.
- Проверка безопасности и резервная копия перед запуском.
После этого выбирайте дополнительные уроки по реальным задачам: импорт, фильтрация, личный кабинет, избранное или блок просмотренных товаров. Не нужно устанавливать все дополнения из списка одновременно.











