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

30 сентября 2022, 07:00

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

miniShop2 поставляется со всеми необходимыми сниппетами и чанками. Для работы вам нужен MODX не ниже 2.3 и PHP не ниже 7.0.

Установка

  • Подключите наш репозиторий
  • Установите pdoTools - это библиотека для быстрой работы с БД и оформлением, необходима для многих компонентов
  • Установите Theme.Bootstrap - а это тем оформления Twitter Bootstrap для MODX, под неё заточены стандартные чанки магазина
  • Установите сам miniShop2

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

Шаблоны

Theme.Bootstrap устанавливает 2 шаблона, которые вы можете менять по своему усмотрению. Вы можете переименовать и использовать их, или создать новые.

Всего нам нужно 3 шаблона.

Общий

Это шаблон для вывода содержимого обычных ресурсов

<!DOCTYPE html>
<html lang="en">
    <head>
        [[$Head]]
    </head>
    <body>
        [[$Navbar]]
        <div class="container">
            <div id="content" class="main">
                [[*content]]
            </div>
            [[$Footer]]
        </div>
    </body>
</html>

Он будет использоваться для главной страницы и корзины.

Категория

Шаблон вывода категории с постраничным выводом товаров

<!DOCTYPE html>
<html lang="en">
    <head>
        [[$Head]]
    </head>
    <body>
        [[$Navbar]]
        <div class="container">
            <div id="content" class="category">
                [[!pdoPage?
                    &element=`msProducts`
                ]]
                [[!+page.nav]]
            </div>
            [[$Footer]]
        </div>
    </body>
</html>

Товар

Шаблон товара, вместо содержимого вызывается чанк из комплекта ms2

<!DOCTYPE html>
<html lang="en">
    <head>
        [[$Head]]
    </head>
    <body>
        [[$Navbar]]
        <div class="container">
            <div id="content" class="product">
                [[$msProduct.content]]
            </div>
            [[$Footer]]
        </div>
    </body>
</html>

Созданные шаблоны можно указать в системных настройках:

  • default_template - здесь указываем наш общий шаблон
  • ms2_template_category_default - шаблон категории
  • ms2_template_product_default - шаблон товара

Разделы

Главная страница у нас уже есть, просто назначаем ей "Общий" шаблон и пишем в контент:

[[!pdoMenu]]

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

Затем создаём категорию товаров и проверяем, чтобы у неё был шаблон "Категория".

После создания категории, добавляем в неё несколько товаров и проверяем их шаблон тоже.

Теперь осталось только создать корзину. Для этого создаём новую страницу с шаблоном "Общий" в корне сайта, и пишем там:

[[!msCart]]

[[!msOrder]]

[[!msGetOrder]]

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

Они сделаны таким образом, чтобы что-то выводить только когда это нужно. Например, msCart и msOrder прячутся, если в адресе страницы есть параметр msorder=id заказа, а вот msGetOrder наоборот, реагирует только на него.

Миникорзина

Всё, первичная настройка магазина окончена и уже можно заказывать товары.

В качестве финального штриха можно еще зайти в чанк Navbar и добавить там вывод миникорзины. Например, вот так:

<div class="navbar-collapse collapse">
    <!-- Это вывод меню, он есть по умолчанию -->
    <ul class="nav navbar-nav">
        [[pdoMenu?
            &startId=`0`
            &level=`1`
            &tplOuter=`@INLINE {$wrapper}`
        ]]
    </ul>
    <!-- А вот здесь добавляем миникорзину -->
    <ul class="nav navbar-nav pull-right" style="padding-top:10px;">
        <li>[[!msMiniCart]]</li>
    </ul>
</div>


Предыдущий документ
Системные требования и зависимости
Следующий раздел
Интерфейс