lowbase/yii2-lowbase

Yii 2 CMS

lowBase - низкоуровневая Yii2 CMS для программистов

lowBase - низкоуровневая CMS, включающая в себя готовую универсальную систему администрирования сайта и Yii2 основу для самостоятельной разработки клиентского приложения. По организации контента похожа на CMS ModX, _(*1)

Составлена на основе независимых модулей:, _(*2)

Модуль пользователей, _(*3)

Модуль документов, _(*4)

Каждый из модулей может быть заменен в CMS на собственный. Взаимодействия друг с другом минимальны., _(*5)

Демо панели администрирования, _(*6)

Сайт-источник, _(*7)

Доступ к админ. панели по адресу /admin, _(*8)

, _(*9)

Установка lowBase

• composer create-project lowbase/yii2-cms project-name dev-master
• Создаем пустую базу данных и настраиваем соединение с базой в файле config/db.php

'db' => [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=имя_базы_данных',
    'username' => 'пользватель',
    'password' => 'пароль',
    'charset' => 'utf8',
],

• Запускаем миграции коммандой php yii migrate
• Для работы EAUTH-авторизации необходимо зарегитсрировать приложение/сайт в соответствующих социальных сетях. В файле config/web.php прописываем полученные ключи и id приложения:

  'authClientCollection' => [
            'class' => 'yii\authclient\Collection',
            'clients' => [
                'vkontakte' => [
                    // https://vk.com/editapp?act=create
                    'class' => 'lowbase\user\components\oauth\VKontakte',
                    'clientId' => '?',
                    'clientSecret' => '?',
                    'scope' => 'email'
                ],
                ...
            ]
        ]

Основы проектирования сайта на lowBase

Разработка сайта ведется по принципу "Программирование от содержимого". Т.е. создаем структуру на основе документов в панели администрирования, а затем переходим к Frontend части, делая самостоятельно вывод и пользовательский ввод, используя готовые модели. Либо производим эти действия параллельно: программист или верстальщик занимается пользовательским интерфейсом, а контент-менеджеры заполняют содержимое документов., _(*10)

Документ - универсальная сущность. Основа всего содержания

Документ - это: * новость * статья * отзыв * категория * товар * заказ магазина * характеристка товара * список со способами оплаты или доставки магазина * сам способ оплаты или доставки * тег для новости или статьи * фотогалерея (основная страница вывода) * альбом фотогалереи * меню сайта * пункт меню сайта * ..., _(*11)

Дополнительные поля

К каждому документу с помощью шаблона можно прикрепить дополнительные поля (различных типов). Допускаются мультизначения дополнительных полей с заданием минимального и максимального количества возможных значений. Например: * Цена товара (число) * Сумма заказа (число) * Рейтинг отзыва (список или число) * Вариант ответа опроса (список) * Фотография альбома (файл с сервера) * Теги (строка (мультиполе)) * ..., _(*12)

Как работать с CMS lowBase

В административной части формируется структура сайта на основе документов (меню, разделы, категории, статьи, различные списки) в древовидной иерархии., _(*13)

Основные модели, с которыми придется взаимодействовать в клиентской части сайта: пользователи app/models/User и документыapp/models/Document через контроллеры app/contollers/UserController и app/controllers/DocumentController, которые являются пустыми заготовками, унаследованные от соответствующих классов модулей системы., _(*14)

Как альтернативный вариант можно создать модульную структуру, унаследовав ваши модули от соответствующих модулей \lowbase\document\Module и \lowbase\user\Module. Возможности модулей и вызов виджетов смотрите в документации модулей., _(*15)

Работа с документами и с дополнительными полями

Значения дополнительных полей документа хранятся в массиве $document->fields, _(*16)

После получения самого документа массив не заполняется:, _(*17)

$document = app\models\Document::findOne($id);
print_r($document->fields);     //Array() - массив пуст

Для заполнения дополнительных полей документа используйте метод fillFields(), _(*18)

$document = app\models\Document::findOne($id);
$document->fillFields();
print_r($document->fields);     //Array([1] => ['name' => 'Теги', 'type' => 4, 'param' => '', 'min' => 0, 'max' => 2, 'data' => [[1] => ['value' => 'Тег_1', 'position' => ''], [2] => ...]], [2] => ...)

    /**
     * Значения дополнительных полей
     * Массив имеет следующую структуру:
     *
     * [$field_id] => [
     *                  'name' => 'Название дополнительного поля',
     *                  'type' => 'Тип дополнительного поля',
     *                  'param' => 'Параметр дополнительного поля',
     *                  'min' => 'Минимум значений',
     *                  'max' => 'Максимум значений',
     *                  'data' => [ $data_id => [
     *                                            'value' => 'Значение дополнительного поля'
     *                                            'position' => 'Позиция дополнительного поля'
     *                                             ],
     *                                           ...
     *                          ]
     *              ],
     * ...
     *
     * $field_id - ID дополнительного поля из БД, $data_id - ID записи значения дополнительного поля из БД
     * Если необходимо прикрепить новое значение 'data' к документу, то в качестве ключа используем 'new_'.$i, где
     * $i - идентификатор нового значения
     */

После сохранения документа, _(*19)

$document->save();

значения дополнительных полей будут сохранены в соответствующие таблицы., _(*20)

Можно также получить значения дополнительных полей запросами к соответствующим таблицам (в зависимости от типа поля) БД напрямую, _(*21)

$data_values = \lowbase\document\models\ValueString::find()->where(['field_id' => $field_id, 'document_id' => $document_id])->all() // Получение значений дополнительного поля $field_id строкового типа
$data_values = \lowbase\document\models\ValueNumeric::find()->where(['field_id' => $field_id, 'document_id' => $document_id])->all() // Получение значений дополнительного поля $field_id числового типа
$data_values = \lowbase\document\models\ValueText::find()->where(['field_id' => $field_id, 'document_id' => $document_id])->all() // Получение значений дополнительного поля $field_id типа Текст
$data_values = \lowbase\document\models\ValueDate::find()->where(['field_id' => $field_id, 'document_id' => $document_id])->all() // Получение значений дополнительного поля $field_id типа Дата