webadmin87/rzwebsys7

RzWebSys7 - CMS powered by Yii Framework 2

RzWebSys7 - CMS на основе Yii2

Предствляет собой платформу для быстрого развертывания интерент проекта. Содержит набор наиболее востребованных модулей., _(*1)

Страница проекта: http://webadmin87.github.io/rzwebsys7/, _(*2)

Структура системы

1) app - web приложение, _(*3)

2) console - консольное приложение, _(*4)

3) common - ядро системы, _(*5)

4) vendor - сторонние компоненты, _(*6)

5) environments - настройки окружений, _(*7)

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

1) PHP 5.4, _(*8)

2) Веб сервер Apache 2.2, _(*9)

3) PostgreSql 9.3, _(*10)

4) Composer, _(*11)

Установка

Предполагается что composer находится в путях поиска вашей командной оболочки. Например, его можно разместить в /usr/local/bin, _(*12)

Apache настроен таким образом, что DOCUMENT_ROOT для виртуального хоста указывает на папку app/web, _(*13)

Для начала неоходимо установть плагин fxp/composer-asset-plugin:1.0.0 для composer. Для этого выполняем следующую комаду:, _(*14)

composer.phar global require "fxp/composer-asset-plugin:1.0.0", _(*15)

После этого можно приступит к установки самой системы:, _(*16)

1) В файлах environments/dev/common/config/main-local.php и environments/prod/common/config/main-local.php прописываем настройки соединения с базой данных для окружения разработки и продакшена соответственно., _(*17)

2) Устанавливаем зависимости через composer. В корне системы выполняем команду composer.phar install, _(*18)

3) Запускаем скрипт ./init и выбираем нужное окружение для установки, _(*19)

4) Запускаем ./yii install, _(*20)

5) Наслаждаемся ), _(*21)

Административный раздел находится по адресу /admin/. Для входа используйте пароль пользователя root указанный при установке., _(*22)

Модули входящие в состав системы

Главный модуль

Предоставляет следующий функционал:, _(*23)

1. Текстовые странички с возможностью создание иерархических структур и управлением мета - тегами. Возможность создания дружественных SEO url - адресов произвольной вложенности. Например: /articles/php/yii2/, _(*24)

2. Меню. Возможность создания любого количества меню, произвольной вложенности., _(*25)

3. Комментарии. Возможность добавления комментариев к любой сущности системы., _(*26)

4. Включаемые области. Текстовые включаемые области с возможностью подключения php сценариев., _(*27)

5. Группы включаемых областей. Объединение включаемых областей в группы с возможностью задания правил отображения на страницах сайта., _(*28)

6. Управление пользователями и правами доступа к сущностям. Возможность разграничить доступ к сущностям в админке для разных групп пользователей., _(*29)

7. Управление подключением шаблонов сайта в зависимости от условий (по url адресу, php выражению и т.п.), _(*30)

8. Генератор карты сайта в html и xml форматах., _(*31)

9. Форма обратной связи с отправкой сообщений на email., _(*32)

Модуль новостей

Создание новостных и статейных разделов. Иерархический рубрикатор записей., _(*33)

Баннерный модуль

Добавление баннеров и их вывод в зависимости от баннерного места. Поддерживаются следующие форматы: jpg, gif, png, swf., _(*34)

Каталог

Каталог товаров с иерархической рубрикацией. Возможность интеграции с модулем магазина., _(*35)

Модуль магазина.

Компоненты корзины реализованы с помощью ajax и работают без перезагрузки страницы. Возможность создания вариантов доставки и оплаты, настройка статусов заказа. Содержимое заказа сохраняется в админке, а также отправляется администратору сайта на email., _(*36)

Гео модуль

Содержит данные и компоненты для организации гео - справочника., _(*37)

Фотогалерея

Создание фотогалерей с загрузкой файлов через HTML 5, _(*38)

Модуль импорта

Позволяет ипортировать данные из CSV файлы. Есть возможность ручной настройки сопоставления полей файла и импортируемых моделей., _(*39)

Создание модулей

Генерация каркаса нового модуля

Осуществляется с помощью системного генератора App module generator, _(*40)

Подключение модуля к системе

Для покдлючения модуля к системе необходимо прописать идентификатор модуля в параметре enabledModules в файле:, _(*41)

common/config/params.php

Создание таблиц сущностей новых модулей.

Осуществляется с помощью миграций. Миграции создаются на базе системных шаблонов., _(*42)

Примеры (таблица простой сущности, таблица древовидной сущности):, _(*43)

./yii migrate/create --migrationPath=@webapp/modules/module_name/migrations --templateFile=@console/views/migrations/table.php migration_name

./yii migrate/create --migrationPath=@webapp/modules/module_name/migrations --templateFile=@console/views/migrations/table-tree.php migration_name

где module_name - имя модуля для которого создается миграция, migration_name - имя миграции, _(*44)

Пример применения миграций для конкретного модуля:, _(*45)

./yii migrate/up --applyPath=@webapp/modules/module_name/migrations

Без параметра applyPath применение миграций происходит для всех модулей сразу, _(*46)

Создание моделей

Модели системы должны быть унаследованы от \common\db\ActiveRecord или \common\db\TActiveRecord (обычные и древовидные соответственно)., _(*47)

Для каждой модели должен быть создан класс, унаследованный от \common\db\MetaFields. В нем должен быть реализован метод возвращающий конфигурацию объектов полей модели. Поле модели - дополнительная абстракция над атрибутом модели. Класс поля должен быть унаследован от \common\db\fields\Field. Данная абстракция необходима для автоматической генерации интерфейса администрирования., _(*48)

Примеры кода можно найти в модуле main., _(*49)

Генерация CRUD сущностей

Осуществляется с помощью модуля Gii на основе системных шаблонов. Шаблоны App CRUD и App tree CRUD для обычных и древовидных сущностей соответственно. Базовый класс для контроллеров админки common\controllers\Admin., _(*50)

Рекомендации

Модули ресурсов (AssetBundle) необходимо наследовать от \common\components\AssetBundle, _(*51)

Генерация документации

Для генерации документации воспользуйтесь следующими командами, _(*52)

vendor/bin/apidoc api app ./docs/app

vendor/bin/apidoc api common ./docs/common

vendor/bin/apidoc api console ./docs/console

Тестирование

Пример генерации фикстур сущностей по шаблону:, _(*53)

./yii fixture/generate-all --templatePath='@tests/codeception/common/templates/fixtures' --fixtureDataPath='@tests/codeception/common/fixtures/data'