fedornabilkin/yii2-binds

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

Связывание сущностей

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

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

Установка

Установите расширение с помощью composer., _(*3)

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

или добавьте в секцию require в файл composer.json., _(*4)

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

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

php yii migrate --migrationPath=@fedornabilkin/binds/migrations, _(*5)

Управление каталогом /binds/catalog, _(*6)

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

Модель, _(*7)

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']);
    }
}

Форма заполнения данными, _(*8)

    
    

        


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

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

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

            

                = Html::submitButton('Save', ['class' => 'btn btn-success']) ?>
            

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

        

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

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

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

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

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

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

'components' => [
    ...

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

'modules' => [

    ...

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

Инструкция и обсуждение, _(*13)