2. Быстрый старт с демо-проектом

2.1. Локальный запуск демо-проектов

Ты можешь скачать все зависимости и начать тестировать проекты вручную. Если ты хочешь использовать демо как отправную точку для вашего проекта, тогда, вероятнее всего, это лучшее решение.

Заполнение ваших страниц с помощью CMS и добавление продуктов - это скучная работа. Нетерпеливые пользователи могут начать с одного из пяти демо, используя подготовленные данные. Во-первых, убедитесь, что все зависимости инсталлированы в виртуальное окружение как описано в секции Подготовка к инсталляции. Затем вместо ручного добавления страниц и продуктов используйте следующие шаги:

(shoptutorial)$ cd django-shop/example 
(shoptutorial)$ export DJANGO_SHOP_TUTORIAL=commodity 
(shoptutorial)$ ./manage.py initialize_shop_demo 
(shoptutorial)$ ./manage.py compilescss 
(shoptutorial)$ ./manage.py runserver

Затем перейдите на http://localhost:8000/admin/ и авторизуйтесь, введя имя пользователя admin и пароль secret. Это запускает демо для Модель товарного продукта (Commodity Product Model).

Замечание: сначала djangoSHOP рендерит страницу, в которой создаются миниатюры для изображений товаров . Это дорогая операция, которая запускается единожды. Поэтому, пожалуйста, будьте терперливы, когда загружаются товары в первыый раз.

С этой папки вы можете запускать все пять демо-проектов, переконфигурируя переменную окружения DJANGO_SHOP_TUTORIAL. Допустимые значения: commodity, i18n_commodity, smartcard, i18n_smartcard and polymorphic. После смены значения вы должны каждый раз запускать команду ./manage.py initialize_shop_demo.

Замечание: все демки могут быть запущены внезависимости друг от друга, но рекомендуется запускать с примера commodity, а затем переходить к более сложным случаям.

2.1.1. Товарная модель продукта

Демо commodity показывает как запускать одноязычный магазин с общим продуктом, названным Товар. Модель продукта shop.models.defauls.commodity.Commodity - это часть djangoSHOP фреймворка. Это предназначается для тех, кто не хочет настраивать свою модель продукта, и больше предпочитает создава описание продукта, используя основную функциональность CMS.

Модель Товар содержит только следующие атрибуты:

• Название продукта.
• Код продукта (артикул).
• Слаг (часть адреса URLs, который определяет данный продукт).
• Стоимость продукта.
• Одно изображение, которое показывается в списке продуктов.
• Короткое описание, которое показывается в списке продуктов.

Карточка товара для каждого продукта должна быть индивидуально стилизована, используя заполнитель DjangoCMS вместе с системой плагинов djangocms-cascade. Это даёт продавцу всю гибкость для индивидуальной стилизации каждой страницы карточки товара без необходимости создавать специальные HTML шаблоны. В заполнители мы можем добавлять столько текстовых полей, сколько захотим. Дополнительно мы можем использовать галереи изображений, карусели, различные бэкграунды, вкладки и т. д.

Один плагин, который всегда должен присутствовать - это Положить товар в корзину (Add Product to Cart plugin) в интернет-магазин (Shop), в противном случае покупатель не сможет добавить этот товар в корзину и, таким образом, не приобретет ничего.

Использовать модель продукта товара (Commodity product model) имеет смысл только, если торговец не требует специальных атрибутов продукта, и, как правило, подходит только для магазинов с массой статей. В противном случае, создавая повторно шаблон HTML, вероятно, будет требоваться меньше усилий, чем заполнение заполнителя для карточки товара каждого продукта в отдельности.

2.1.2. Интернациональная товарная модель продукта (The Internationalized Commodity Product Model)

Демо i18n_commodity показывает как запустить магазин с общим продуктом как в предыдущем примере, но с возможностью перевода на другие языки следующих атрибутов:

• Название продукта.
• Слаг.
• Название, которое показывается в карточки товара.

Все другие атрибуты нашей модели Товара используются одинакого для всех языков.

Использование интернациональной конфигурации требует установки дополнительного пакета django-parler.

2.1.3. Модель товара карты памяти (The Smart Card Product Model)

Демо smartcard показывает как установить интернет-магазин с модели, которая создаётся с точно описанным типом продукта. Карты памяти имеют множество различных атрибутов, таких как тип карты, производитель, объём памяти и максимальной скорости передачи данных. Вот это ответственность торговца в создании модели базы данных в соответствии с физическими свойствами продукта.

Следовательно, класс myshop.models.smartcard.SmartCard не является частью фреймворка интернет-магазина, а реализован в нашем примере.

Создание пользовательной модели продукта - это всего лишь несколько строк декларативного Python кода. Дополнительно мы можем создать Django шаблон, используя HTML. Однако, это избавляет нас от необходимости создания страницы с помощью плагинов для каждого элемента продукта, который мы хотим предложить. Это также помогает нам структурировать наши продукты, используя атрибуты, а не их описания в свободной форме.

2.1.4. Интернациональная модель товара карты памяти (The Internationalized Smart Card Model)

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

2.1.5. Полиморфная модель продукта (The Polymorphic Product Model)

Демо "polymorphic" - это комбинация из всех примеров выше. Здесь описывается базовый продукт, используя класс myshop.models.polymorphic.Product. Мы также описываем общие доступные поля в различных типах продукта. Эти общие поля используются для создания отображения списка продуктов.

Классы модели для карт памяти, смартфонов и вариационного товара наследуются от базового класса продукта. Эти модели дополнительно объявляют атрибуты требуемые для описания физических свойств каждого типа продукта. Так как они меняются, мы также должны создавать специальные шаблоны Карточка товара для каждого из них. Поскольку смартфоны допускают варианты продукта, мы даже должны переопределить шаблон для добавления продукта в корзину.

2.2. Используйте один из демо-проектов в качестве отправной точки для вашего проекта

В зависимости от нужд вашего интернет-магазина, простой способ начать разработку проекта с djangoSHOP - это использовать демо, которое наиболее подходит под ваши цели. Затем путем копирования примера, создать репозиторий для проекта. Начать от рабочего примера и постепенно изменять его до достижения ваших конечных целей, как правило, это намного проще, чем начинать с нуля. Это также является предпочтительным способом во время быстрой разработки.