fedornabilkin/yii2-binds

Связывает модели и сущности посредством срединной таблицы на основе глобального идентификатора uid

v0.0.1 2018-03-12 20:02 UTC

Requires

• bower-asset/simple-ajax-requests: ~0.1
• kartik-v/yii2-tree-manager: ~1.0.8
• yiisoft/yii2: ~2.0.0

MIT

• fedornabilkin

• catalog
• db
• extension
• seo
• yii2
• binds

README

Связывает модели и сущности посредством промежуточной таблицы на основании глобальнго uid.

Расширение требует php 7.0 и выше. Использует модуль yii2-tree-manager и SAR (simple ajax requests)

Установка

Установите расширение с помощью composer.

php composer.phar require --prefer-dist fedornabilkin/yii2-binds "*"

или добавьте в секцию require в файл composer.json.

"fedornabilkin/yii2-binds": "dev-master"

Выполните миграции

php yii migrate --migrationPath=@fedornabilkin/binds/migrations

Управление каталогом /binds/catalog

Пример использования

Модель

use fedornabilkin\binds\behaviors\BindBehavior;
use fedornabilkin\binds\behaviors\SeoBehavior;
use fedornabilkin\binds\models\base\BindModel;

class Post extends BindModel
{

    public function behaviors()
    {
        return array_merge_recursive(parent::behaviors(), [
            'SeoBehavior' => [
                'class' => SeoBehavior::class,
            ],
            'BindsBehavior' => [
                'class' => BindBehavior::class,
                'tree' => [
                    // никнэймы корневых узлов дерева каталога
                    'nicknames' => [
                        'visible' => [
                            'multiple' => false, // единичный или множественный выбор
                        ],
                        'categories' => [
                            'multiple' => false,
                        ],
                        'tags' => [
                            'multiple' => true,
                            'asDropdown' => false, // развернутое состояние
                        ],
                    ],
                ],
            ],
        ]);
    }

    /**
     * tableName()
     * rules()
     * attributeLabels()
     * ...
     */
     

    /**
     * модели hasOne, указать для удаления дочерней модели
     * если она связана с родительской один-к-одному
     * 
     * Один комментарий может быть привязан только к одной модели Post
     */
    public function getChildModels()
    {
        return array_merge(parent::getChildModels(), [
            Comment::tableName() => Comment::class,
        ]);
    }
    
    /**
     * @return ActiveQuery
     */
    public function getComments()
    {
        return $this->hasOne(Comment::class, ['uid_content' => 'uid']);
    }
}

Форма заполнения данными

<?php
use fedornabilkin\binds\models\Catalog;
use fedornabilkin\binds\models\Uid;
use yii\helpers\Html;
use kartik\tree\TreeViewInput;
use yii\widgets\ActiveForm;

/* @var $this yii\web\View */
/* @var $model frontend\models\Post */

?>

<div class="post-update">

    <?php $form = ActiveForm::begin(); ?>
    <div class="row">
        <div class="col-xs-12 col-sm-8">

            <?= \fedornabilkin\binds\widgets\status\StatusWidget::widget(['model' => $model])?>

            <?= $form->field($model, 'title')->textInput(['maxlength' => true]) ?>

            <?= $form->field($model, 'post')->textarea(['rows' => 6]) ?>

            <div class="form-group">
                <?= Html::submitButton('Save', ['class' => 'btn btn-success']) ?>
            </div>

            <?= \fedornabilkin\binds\widgets\seo\SeoWidget::widget(['model' => $model])?>
        </div>

        <div class="col-xs-12 col-sm-4">
            <?= \fedornabilkin\binds\widgets\binds\BindsWidget::widget(['model' => $model])?>
        </div>
    </div>
    <?php ActiveForm::end(); ?>

</div>

Если к комментарию привязана модель рейтинга, то в Comment::getChildModels() необходимо указать эту модель, чтобы при удалении модели Post удалить все комментарии, которые к ней относятся, а также все рейтинги для каждого удаленного комментария.

Такая схема удаления моделей будет работать только в том случае, если эти модели имеют поле uid с внешним ключом на поле id таблицы bind_uids и привязаны к родительской модели через поле uid_content.

Рекурсивный поиск uid при удалении осуществляется в методе BindModel::_getUids()

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

Чтобы SEO-данные отобразились на странице в metatags, необходимо добавить SeoBehavior в компонент View в конфиграционном файле. Также в адресе необходимо передать $_GET ?alias=adres-stranicy.

'components' => [
    ...
    
    'view' => [
        'as seo' => [
            'class' => \fedornabilkin\binds\behaviors\SeoBehavior::class,
        ],
    ],
],

'modules' => [

    ...

    'binds' => [
        'class' => 'fedornabilkin\binds\Module',
    ],
    'treemanager' => [
        'class' => 'kartik\tree\Module',
        'dataStructure' => [
            'keyAttribute' => 'id',
        ],
    ],
],

Инструкция и обсуждение