README

Extension to easily create M2M widgets within the Amos framework.

How do I get set up?

The preferred way to install this extension is through composer.

Either run:

composer require elitedivision/amos-m2m

or add this row:

"elitedivision/amos-m2m": "dev-master"

to the require section of your composer.json file.

Add module configuration

Add the module to your modules-amos config like this (customize the class parameter if you extend the base class from AmosM2m). Note: a secretKey is required.

'modules' => [
    'm2m' => [
        'class' => 'elitedivision\amos\m2m\AmosM2m',
        'secretKey' => '230fbEl3i7tcGy5iw68F'
    ],
],

Add behavior to the model

public function behaviors()
    {
        return ArrayHelper::merge(parent::behaviors(), [
            'm2mBehavior' => [
                'class' => elitedivision\amos\m2m\behaviors\M2mBehavior::className()
            ]
        ]);
    }

Configure one or more m2mWidgets in your view

For the widget to work, you will need to pass the following parameters as the widget configuration:

Columns Setup

amos-m2m offers great flexibility and power due to its very customizable colum setup. The Array passed to columnsModelTo and columnsModelMm can be set up as follows:

Example:

\elitedivision\amos\m2m\widgets\base\M2MWidget::widget([
    'idWidget' => 'my-id-widget-m2m',
    'model' => $model,
    'modelTo' => \elitedivision\amos\core\user\User::className(),
    'modelMm' => \elitedivision\amos\projectmanagement\models\ProjectsUserMm::className(),
    'permissionDelete' => 'PROJECTS_DELETE',
    'permissionAssociate' => 'PROJECTS_UPDATE',
    'permissionModifyAttributes' => 'PROJECTS_UPDATE',
    'dataProviderModelTo' => $dataProvider,
    'dataProviderModelMm' => $dataProviderMm,
    'attributeSearchGridTo' => ['Nome' => 'userProfile.nome', 'Cognome' => 'userProfile.cognome'],
    'attributeSearchGridMm' => ['status', 'name'],
    'from_id' => [
        'id' => ['projects_id'],
    ],
    'to_id' => [
        'id' => ['user_id'],
    ],
    'columnsModelTo' => [
        'userProfile.nomeCognome',
        'email',
    ],
    'columnsModelMm' => [
        'user.userProfile.nome',
        'user.userProfile.cognome',
        [
            'attribute' => 'projects_role_id',
            'type' => 'select2',
            'data' => [
                'data' => \yii\helpers\ArrayHelper::map(\elitedivision\amos\projectmanagement\models\ProjectsRoles::find()->all(), 'id', 'name'),
                'options' => ['placeholder' => 'Select ...']
            ],
        ],
       [
            'label' =>  'Funzione 1+1',
            'value' => function(){
                return (1+1);
            }
        ],
        [
            'attribute' => 'organization_id',
            'type' => 'select2',
            'data' => [
                'data' => \yii\helpers\ArrayHelper::map(\openinnovation\organizations\models\Organizations::find()->all(), 'id', 'name'),
                'options' => ['placeholder' => 'Select ...']
            ],
        ],
        [
            'attribute' => 'status',
              'data' => [
                  'readonly' => true
        ]
        ],
        [
            'class' => \elitedivision\amos\core\views\grid\ActionColumn::className(),
            'template' => '{update}{delete}',
            'buttons' => [
                'update' => function($url, $model){
                    if(\Yii::$app->user->can('PROJECTS_UPDATE')) {
                        return Html::a(\elitedivision\amos\core\icons\AmosIcons::show('edit'), ['modify-user-roles', 'id' => $model->id], [
                            'class' => 'btn btn-tools-secondary',
                        ]);
                    }
                },
            ]
        ]
    ],
]);