README

Categories

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist oks/yii2-categories "*"

or add

"oks/yii2-categories": "*"

to the require section of your composer.json file.

Usage

Once the extension is installed, simply use it in your code by :

You need to connect a controller or an action to the controller

controller

    'controllerMap' => [ 
        'categories' => 'oks\categories\controllers\CategoriesController'
    ],

action

   public function actions()
       {
           return [ 
               'categories' => [
                   'class' => 'oks\categories\actions\CategoriesAction'
               ] 
           ];
       }

You must have an extension

oks/yii2-langs

You need to connect i18n for translations

 'oks-categories' => [
                    'class' => 'yii\i18n\PhpMessageSource',
                    'basePath' => '@vendor/oks/yii2-categories/src/messages',
                    'sourceLanguage' => 'en',
                    'fileMap' => [
                        'oks-categories'       => 'main.php',
                    ],
                ],

and migrate the database

yii migrate --migrationPath=@vendor/oks/yii2-categories/src/migrations

Параметры

В параметры приложение добавьте параметр:

categories_all_types

Пример

[
        100 => 'Посты',
        200 => 'Страницы',
        300 => 'Кастинги',
        700 => 'Видео',
        800 => 'Фильмы',
        900 => 'Телепроекты',
        1000 => 'Сериалы',
        1100 => 'Персоны',
        1200 => 'Телепередачи', 
]

Update (Active Record) - Single

example with Posts elements

You must connect behavior to your database model (Active Record)

 'category_model'=> [
                        'class' => CategoryModelBehavior::className(),
                        'attribute' => 'categoriesform',
                        'separator' => ',',
                        ],

example

use oks\categories\behaviors\CategoryModelBehavior;

        class Posts extends ActiveRecord
        {
            private $_categoriesform;

            public function behaviors()
            {
                 ...
                        'category_model'=> [
                        'class' => CategoryModelBehavior::className(),
                        'attribute' => 'categoriesform',
                        'separator' => ',',
                        ],
                 ...
            }

            ...

            public function getCategoriesform(){
                return $this->_categoriesform;
            }
            public function setCategoriesform($value){
                return $this->_categoriesform = $value;
            }
        }

Afterwards you need to add your widget form.

oks\categories\widgets\CategoriesWidget::widget

example

echo oks\categories\widgets\CategoriesWidget::widget([
  'selected' => $model->categoriesSelected(),
  'model_db' => $model,'name' => 'Posts[categoriesform]'
  ]);

and of course do not forget to prescribe links for your model

    public function getPostscategories()
    {
        return $this->hasMany(Postscategories::className(), ['post_id' => 'post_id']);
    }


    public function getCategories()
    {
        return $this->hasMany(Categories::className(), ['id' => 'id'])->viaTable('postscategories', ['post_id' => 'post_id']);
    }

It's all!