SBShop 0.1a - альфа-версия интернет-магазина для MODx

Спешу поделиться с вами очень радостной новостью. Наконец-то разработка электронного магазина для MODx под кодовым названием SBShop приобрела некий ощутимый и рабочий вид. Первая альфа!

Информации очень много, поэтому не буду вдаваться в лирику и перейду к делу. Описывать буду как все устроено, а не «как сделать магазин».

Итак, SBShop представляет собой некое расширение ядра MODx и в том числе содержит в наборе модуль, плагин, сниппет и некий свой API.

Структура магазина

Базовый каталог

Магазин привязывается к некому ресурсу в дереве (например «Магазин (15)»), который становится корнем магазина (условно /magazin.html). Далее каталог имеет набор различных товаров, категорий с неопределенным уровнем вложенности.

ЧПУ строится на основе заданных псевдонимов у категорий/товаров и учитывает вложенность. Псевдонимы генерируются автоматически на основе стандартного плагина MODx.

Режимы работы, блоки

Режимом будем называть некую основную функцию на текущей странице, которую магазин должен для нас сделать. Среди стандартных режимов есть categories (список категорий), product (товар), breadcrumbs (крошки), cart (корзина) и checkout (оформление заказа).

Так как информация нам нужна разных видов на конечной странице (крошки, корзина, список категорий), то нам нужно как-то определять, что мы хотим получить. Есть три варианта использования какого-то режима:

1) Режим заданный по URL (/magazin/checkout.html). Так работает оформление заказа
2) Базовый режим. Выводится прямым вызовом сниппета и зависит от текущего URL. В данный момент так работают вывод категорий и товара
3) Блок. Задается в параметре сниппета &mode (&mode=`breadcrumbs,cart`). Выводится через плейсхолдер. Это у нас крошки, корзина.

Этот список составлен в порядке приоритета и режим, который определился первым, считается основным.

Категории

Тут все просто. Категории имеют разную вложенность и в них вложены товары.

Товары

Здесь уже поинтереснее. В товарах есть несколько стандартных возможностей:

— основные параметры: название, псевдоним, артикул, цена, описание
— изображения, которые автоматически создают нужный набор миниатюр при загрузке (задается конфигом)
— динамический список параметров в виде ключ — значение
— динамический список опций, которые оказывают влияние на стоимость товара

Модуль управления

Имеет собственное дерево категорий/товаров и стандартный набор функций, которые вам известны по дереву ресурсов (создание, редактирование, публикация / отмена публикации, удаление / восстановление).

Показывает список имеющихся заказов.

Шаблоны

Основной шаблон страницы

Разумеется для разных страниц магазина нужны свои шаблоны. Чуть выше было описано как выбирается основной режим. Именно он и определяет какой шаблон (из стандартных в MODx) будет использоваться (определяется конфигом).

Шаблоны категорий, товаров, корзины и т.д.

Разумеется они тоже задаются. Единственный момент, что сейчас они все лежат в специальных .tpl файлах. Вид магазина полностью настраивается.

Технические моменты

Управление параметрами товара

Сейчас все задается в виде текста в специальном поле. Формат в виде примера:

Цвет==зеленый||Ширина==100 см||Высота==250 см

Узнаваемо? Отлично!

Управление опциями

Тоже в виде текста, но формат посложнее:

Размер оперативной памяти#3[16 Гб#1==+1510;32 Гб#2==+2900]||Звук#4[не устанавливать#3==;установить#4==+11740]

Размер оперативной памяти, Звук — названия опций
16 Гб, 32 Гб, не устанавливать, установить — значения опций
#1, #3, #2 — идентификаторы названий опций и значений (добавляются автоматически, писать их не нужно).

API

Ядро магазина автоматически загружается с помощью плагина и доступно на всем сайте через $modx->sbshop. Через него можно например получить:

$modx->sbshop->config — массив конфигурации
$modx->sbshop->lang — языковые данные (Да!)
$modx->sbshop->oOrder — заказ
$modx->sbshop->oCustomer — данные пользователя

К множеству других возможностей можно получить доступ, используя различные классы. Например:

$oProduct = new SBProduct();
// загружаем товар по идентификатору
$oProduct->load(5);
// Выводим стоимость
var_dump($oProduct->getAttribute('price'));

Покопайтесь в коде, там все прокомментировано полностью.

Установка

Модуль

Название: SBShop
Код:

include  MODX_BASE_PATH . 'assets/extends/sbshop/modules/module.inc.php';

Конфигурация:

&doc_start=Документ магазина;string;15

GUID: Включить

Укажите свой «Документ магазина», где у вас будет находиться корень каталога.

Плагин

Название: SBShop
События: OnLoadWebDocument, OnWebPageInit, OnLoadWebPageCache, OnPageNotFound
Код:

include  MODX_BASE_PATH . 'assets/extends/sbshop/plugins/plugin.inc.php';

Сниппет

Название: SBShop
Код:

<?php
include  MODX_BASE_PATH . 'assets/extends/sbshop/snippets/snippet.inc.php';
?>

Создание связи с модулем

Нужно зайти в модуль и добавить зависимости с плагином и модулем. Затем установить параметр «Импортировать общие параметры модуля» у плагина и модуля.

Резюмируем

Что сделано

— отточена концепция и видение магазина (в процессе работы)
— гибкая платформа (есть основное ядро с нужными функциями, есть режимы, которые подключаются динамически и легко добавляются)
— магазин отлично встраивается в MODx и можно писать свои дополнительные сниппеты
— заложены отличные возможности на будущее (в области управления параметрами и опциями)
— работает ЧПУ и настраиваемые шаблоны
— динамические параметры и опции
— предусмотрена мультиязычность
— работа без регистрации
— все данные хранятся в собственных таблицах и не создают большой нагрузки
— легкое управление

Важные недостатки

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

Пара заключительных слов

Работа проделана огромная. Я успел побывать в разных городах за это время, несколько раз передумать концепцию, провести множество ночей за компьютером… И все же я безумно счастлив, что сейчас могу показать вам результат. Да здравствует Open Source!

Скриншот

Бонус

Заодно хочу сразу представить вам первый рабочий магазин, который использует SBShop. 7plusov.ru — Электронный магазин акриловых ванн в Екатеринбурге.

Спасибо ему огромное! Именно благодаря ему удалось проверить и довести SBShop в боевых условиях.

Магазин рабочий, поэтому с заказами аккуратнее. Если очень хочется проверить как работает заказ, то пишите test вместо ФИО.

Жду ваши отзывы, впечатления, пожелания и готовые доработки (а вдруг? ;-) ).

Ссылки

Скачать SBShop 0.1a

Страница проекта на Google Code: code.google.com/p/sbshop/