sateler/yii2-changelog

Yii2 behavior for storing model/table changelogs

Yii2 behaviour for storing model/table changelogs

Installation

The preferred way to install this extension is through composer., _(*1)

Either run, _(*2)

php composer.phar require --prefer-dist sateler/yii2-changelog "^1.0"

or add, _(*3)

"sateler/yii2-changelog": "^1.0"

to the require section of your composer.json file., _(*4)

Once the extension is installed, add namespace to console config and run the required migration:, _(*5)

return [
    'controllerMap' => [
        'migrate' => [
            'class' => 'yii\console\controllers\MigrateController',
            'migrationNamespaces' => [
                'sateler\changelog\migrations',
            ],
        ],
    ],
];

./yii2 migrate, _(*6)

Usage

Once installed, enable changelog for selected models by adding the following config to the model:, _(*7)

public function behaviors()
{
    return [
        [
            'class' => \sateler\changelog\ChangeLogBehavior::className(),
            'ignore' => [], // ignore changes on listed columns
        ],
        ...
    ];
}

You can review the model changelog at http://hostname/changelog/, or you can code your own controller by using sateler\changelog\models\Changelog. If you want to 'see' the changelogs, add the following configuration and go to http://hostname/changelog/:, _(*8)

return [
    'controllerMap' => [
        'changelog' => [
            'class' => 'sateler\changelog\controllers\ChangelogController',
            'viewPath' => '@vendor/sateler/yii2-changelog/views/changelog',
            // Optional: if set, it's used in the views to create the html link for the record.
            'urlCreator' => function ($table_name, $row_id) {
                $table_name = \yii\helpers\Html::encode(str_replace('_', '-', $table_name));
                return yii\helpers\Url::to(["$table_name/view", 'id' => $row_id]);
            },
        ]
    ],
];

Or you can code your own controller by using the sateler\changelog\models\Changelog model., _(*9)