cranky4/change-log-behavior

Simple changelog behavior for yii2 models

Changelog Behavior simplified(v.1.0.0)

Simple behavior for your yii2-models, _(*1)

Installation

1- Install package via composer:, _(*2)

composer require cranky4/change-log-behavior "*"

2- Run migrations:, _(*3)

yii migrate --migrationPath=@vendor/cranky4/change-log-behavior/src/migrations

Usage

1- Add ChangeLogBehavior to any model or active record:, _(*4)

public function behaviors()
{
    return [
        ...
        [
            'class' => ChangeLogBehavior::className(),
            'excludedAttributes' => ['updated_at'],
        ],
        ...
    ];
}

Attention: Behavior watches to "safe" attributes only. Add attributes into excludedAttributes if you don't want to log its changes., _(*5)

2- Add ChangeLogList to view:, _(*6)

 echo ChangeLogList::widget([
     'model' => $model,
 ])

3- Add custom log:, _(*7)

$model->addCustomLog('hello world!', 'hello_type')

Example

Model Post, _(*8)

/**
 * @propertu int id
 * @property int created_at
 * @property int updated_at
 * @property string title
 * @property int rating
 */
class Post extends yii\db\ActiveRecord {

    /**
     *  @inheritdoc
     */
    public function behaviors()
    {
        return [
            [
                'class' => ChangeLogBehavior::class,
                'excludedAttributes' => ['created_at','updated_at'],
            ]
        ];
    }

}

View post/view.php, _(*9)

use cranky4\ChangeLogBahavior\ListWidget as ChangeLogList;
use app\models\Post;

/**
 *  @var Post $model
 */
echo DetailView::widget([
    'model' => $model,
    'attributes' => [
        'id',
        'title',
        'rating',
        'created_at:datetime',
        'updated_at:datetime',
    ],
]);

echo ChangeLogList::widget([
    'model' => $model,
]);