yii2mod/yii2-comments

Comments module for Yii2

Saturday, October 7, 2017
by disem
Repository
23 Watchers
121 Stars
12,178 Installations

PHP
4 Dependents
0 Suggesters
49 Forks
3 Open issues
39 Versions
7 % Grown

The README.md

, _(*1)

Yii2 Comments Extension

This module provides a comments managing system., _(*2)

, _(*3)

Support us

Does your business depend on our contributions? Reach out and support us on Patreon. All pledges will be dedicated to allocating workforce on maintenance and new awesome stuff., _(*4)

Installation

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

Either run, _(*6)

php composer.phar require --prefer-dist yii2mod/yii2-comments "*"

or add, _(*7)

"yii2mod/yii2-comments": "*"

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

Configuration

Database Migrations, _(*9)

Before using Comments Widget, we'll also need to prepare the database., _(*10)

php yii migrate --migrationPath=@vendor/yii2mod/yii2-comments/migrations

Module setup, _(*11)

To access the module, you need to add the following code to your application configuration:, _(*12)

'modules' => [
    'comment' => [
        'class' => 'yii2mod\comments\Module',
    ],
]

NOTE: Module id must be comment and not otherwise. This is because it is referred somewhere in the code with such name. A PR to fix it to use configured module id is welcome., _(*13)

Now you can access to management section through the following URL: http://localhost/path/to/index.php?r=comments/index, _(*14)

By default only users with admin role have access to comments management section. But, you can override accessControlConfig property for ManageController., _(*15)

Notes:, _(*16)

1) Delete button visible only for users with admin role., _(*17)

2) When you delete a comment, all nested comments will be marked as deleted., _(*18)

3) You can override default CommentModel class by changing the property commentModelClass in the Comment Module., _(*19)

4) You can implement your own methods getAvatar and getUsername in the userIdentityClass. Just create this methods in your User model. For example:, _(*20)


public function getAvatar()
{
    // your custom code
}

public function getUsername()
{
    // your custom code
}

Usage

Basic example:, _(*21)

// the model to which are added comments, for example:
$model = Post::find()->where(['title' => 'some post title'])->one();

 $model,
]); ?>

You can use your own template for render comments:, _(*22)

php <?php echo \yii2mod\comments\widgets\Comment::widget([ 'model' => $model, 'commentView' => '@app/views/site/comments/index' // path to your template ]); ?>, _(*23)

Use the following code for multiple widgets on the same page: ```php $model, ]); ?>, _(*24)

$model2, 'formId' => 'comment-form2', 'pjaxContainerId' => 'unique-pjax-container-id' ]); ?> ```, _(*25)

To enable the pagination for comments list use the following code:, _(*26)

 $model,
      'dataProviderConfig' => [
          'pagination' => [
              'pageSize' => 10
          ],
      ]
]); ?>

Advanced example:, _(*27)

<?php echo \yii2mod\comments\widgets\Comment::widget([
      'model' => $model,
      'relatedTo' => 'User ' . \Yii::$app->user->identity->username . ' commented on the page ' . \yii\helpers\Url::current(),
      'maxLevel' => 2,
      'dataProviderConfig' => [
          'pagination' => [
              'pageSize' => 10
          ],
      ],
      'listViewConfig' => [
          'emptyText' => Yii::t('app', 'No comments found.'),
      ],
]); ?>

Using Events

You may use the following events:, _(*28)

'modules' => [
    'comment' => [
        'class' => 'yii2mod\comments\Module',
        'controllerMap' => [
            'default' => [
                'class' => 'yii2mod\comments\controllers\DefaultController',
                'on beforeCreate' => function ($event) {
                    $event->getCommentModel();
                    // your custom code
                },
                'on afterCreate' => function ($event) {
                    $event->getCommentModel();
                    // your custom code
                },
                'on beforeDelete' => function ($event) {
                    $event->getCommentModel();
                    // your custom code
                },
                'on afterDelete' => function ($event) {
                    $event->getCommentModel();
                    // your custom code
                },
            ]
        ]
    ]
]

Using Comment Plugin Events

$(document).on('beforeCreate', '#comment-form', function (e) {
    if (!confirm("Everything is correct. Submit?")) {
        return false;
    }
    return true;
});

Available events are:, _(*29)

beforeCreate
afterCreate
beforeDelete
afterDelete
beforeReply
afterReply

Internationalization

All text and messages introduced in this extension are translatable under category 'yii2mod.comments'. You may use translations provided within this extension, using following application configuration:, _(*30)

return [
    'components' => [
        'i18n' => [
            'translations' => [
                'yii2mod.comments' => [
                    'class' => 'yii\i18n\PhpMessageSource',
                    'basePath' => '@yii2mod/comments/messages',
                ],
                // ...
            ],
        ],
        // ...
    ],
    // ...
];

#### Example comments

Alt text , _(*31)

The Versions

07/10 2017

dev-master

9999999-dev

Comments module for Yii2

yii2-extension yii2-comments

Comments module for Yii2

yii2mod/yii2-comments

The README.md

Yii2 Comments Extension

Support us

Installation

Configuration

Usage

Using Events

Using Comment Plugin Events

Internationalization

#### Example comments

The Versions

dev-master

The Requires

The Development Requires

by Igor Chepurnoy

1.9.9.2

The Requires

The Development Requires

by Igor Chepurnoy

1.9.9.1

The Requires

The Development Requires

by Igor Chepurnoy

1.9.9

The Requires

The Development Requires

by Igor Chepurnoy

1.9.8

The Requires

The Development Requires

by Igor Chepurnoy

dev-update_test_case

The Requires

The Development Requires

by Igor Chepurnoy

1.9.7

The Requires

The Development Requires

by Igor Chepurnoy

1.9.6

The Requires

The Development Requires

by Igor Chepurnoy

1.9.5

The Requires

The Development Requires

by Igor Chepurnoy

1.9.4

The Requires

The Development Requires

by Igor Chepurnoy

1.9.3

The Requires

The Development Requires

by Igor Chepurnoy

1.9.2

The Requires

The Development Requires

by Igor Chepurnoy

1.9.1

The Requires

The Development Requires

by Igor Chepurnoy

1.9

The Requires

The Development Requires

by Igor Chepurnoy

1.8.2

The Requires

The Development Requires

by Igor Chepurnoy

1.8.1

The Requires

The Development Requires

by Igor Chepurnoy

1.8

The Requires