PHPackages                             cyneek/yii2-comments - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. cyneek/yii2-comments

ActiveYii2-extension[Utility & Helpers](/categories/utility)

cyneek/yii2-comments
====================

Comments module for Yii2

1.0.3(9y ago)51.2k3[1 issues](https://github.com/Patroklo/yii2-comments/issues)MITPHP

Since Oct 15Pushed 9y ago2 watchersCompare

[ Source](https://github.com/Patroklo/yii2-comments)[ Packagist](https://packagist.org/packages/cyneek/yii2-comments)[ RSS](/packages/cyneek-yii2-comments/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (3)Versions (4)Used By (0)

Comments module for Yii2
========================

[](#comments-module-for-yii2)

This module provide a comments managing system for Yii2 application and it's based on the [yii2mod/comments](https://github.com/yii2mod/yii2-comments) package by Igor Chepurnoy.

Installation
============

[](#installation)

#### 1. The preferred way to install this extension is through [composer](http://getcomposer.org/download/).

[](#1-the-preferred-way-to-install-this-extension-is-through-composer)

Either run

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

```

or add to the require section of your composer.json

```
"cyneek/yii2-comments": "*"
```

#### 2. Run migrations:

[](#2-run-migrations)

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

#### 3. Add module data to Yii2 config file:

[](#3-add-module-data-to-yii2-config-file)

```
    'modules' => [
        'comment' => [
            'class' => 'cyneek\comments\Module',
            'userIdentityClass' => 'user\Identity'
        ],
     ...
     ]
```

#### 4. (Optional step) Manage comments in admin panel:

[](#4-optional-step-manage-comments-in-admin-panel)

Add following code to admin module section in main config

```
  'modules' => [
    'comment' => [
        'class' => 'cyneek\comments\Module',
        'userIdentityClass' => 'user\Identity',
          'controllerMap' => [
                'comments' => 'cyneek\comments\controllers\ManageController'
          ]
    ],
 ...
 ]
```

Then you will be able to access the management section through the following URL:

```
  http://localhost/path/to/index.php?r=admin/comments/index

```

Usage
=====

[](#usage)

- Use in view with ActiveRecord model:

```

```

- Use in view with entity and entityId strings

```

```

Parameters
==========

[](#parameters)

### Module parameters:

[](#module-parameters)

Here is a list of the parameters that the module will accept in the application config file:

- **userIdentityClass** (optional, string) The user identity class that Yii2 uses to provide identity information about the users in the App. If not defined, will try to get it from the Yii2 system.
- **controllerNamespace** (optional, string) Defined namespace that module controllers will have.
- **modelMap** (optional, string\[\]) Classes that will be used in the module instead of the default ones. Must have a key => classname format. e.g. `'Comment' => '@app\comments\CommentModel'`. The only valid class keys are: \['Comment', 'CommentQuery', 'CommentSearch'\].
- **useRbac** (optional, boolean) Default: FALSE. If it's set to TRUE, the module will user Rbac security role system to check for permissions when trying to update, create or delete comments.
- **assetMap** (optional, string\[\]) Configuration that the module will use as assets instead of the default ones. In order to be able to work, must have this format:

```
[
    'js' => ['file1'],
    'css' => ['file2'],
    'sourcePath' => 'url',
    'depends' => ['file3', 'file4']
]
```

### Widget parameters:

[](#widget-parameters)

To be able to distinguish between the different types of comments held in your application, the system will add to each one an entity and entityId. This values will be used to filter through all the comments in the system to load only the required ones in each view.

For that you'll have to use one of this options:

- **model** (optional, object) Loaded ActiveRecord object that will be used to extract the entity and entity id of the comment widget.

or

- **entity** (optional, string) String that defines a manual comment entity in case we don't need to use a loaded ActiveRecord object.
- **entityId** (optional, integer)

There's also a list of optional parameters to define the behavior of the comment system:

- **maxLevel** (optional, integer) Default 7. Maximum nesting level of answers allowed in your comment system.
- **entityIdAttribute** (optional, string) Only applicable if we are loading the widgets with the `model` parameter. Will stablish the field name that holds the comment entityId parameter.
- **clientOptions** (optional, array) Array that holds javascript asset parameters. Check the `comment-list.js` asset file to get the full list of possible variables.
- **pjax** (optional, boolean) Default FALSE. If it's TRUE, the comment system will use ajax to send and reload comment data to the server.
- **showDeletedComments** (optional, boolean) Default TRUE. If set as FALSE will hide all the deleted comments. Warning: if the comment system is set as bested and this parameter as TRUE, will also hide all the answers of every deleted comment.
- **nestedBehavior** (optional, boolean) Default TRUE. If set as FALSE will show all comments in the same level instead of nesting the answers of each comment.
- **allowAnonymousComments** (optional, boolean) Default TRUE. Hides the new comment form if set as False when not logged in the application.
- **pagination** (optional, array) Sets the pagination options of the comment listView. For more info about pagination options: [HERE](http://www.yiiframework.com/doc-2.0/yii-data-pagination.html)
- **sort** (optional, array) Sorts the comments in the comment listView. For more info about sorting items in Yii2: [HERE](http://www.yiiframework.com/doc-2.0/yii-data-sort.html)

Extending the module:
---------------------

[](#extending-the-module)

#### Extending Model files

[](#extending-model-files)

Depending on which ones you need, you can set the `modelMap` config property:

```
	// ...
	'modules' => [
		// ...
		'comment' => [
		   'class' => 'cyneek\comments\Module',
		    'modelMap' => [
		        'Comment' => '@app\comments\CommentModel'
		    ]
		]
	],
	// ...
```

Attention: keep in mind that if you are changing the `Comment` model, the new class should always extend the package's original `Comment` class.

#### Attaching behaviors and event handlers

[](#attaching-behaviors-and-event-handlers)

The package allows you to attach behavior or event handler to any model. To do this you can set model map like so:

```
	// ...
	'modules' => [
		// ...
		'comments' => [
		    'class' => 'cyneek\comments\Module',
		    'userIdentityClass' => 'app\models\User',
		    'modelMap' => [
		        'Comment' => [
		            'class' => '@app\comments\CommentModel',
		            'on event' => function(){
		                // code here
		            },
		            'as behavior' =>
		                ['class' => 'Foo'],
		    ]
		]
	],
	// ...
```

#### Extending View files

[](#extending-view-files)

You can extend the view files supplied by this package using the `theme` component in the config file.

```
// app/config/web.php

'components' => [
    'view' => [
        'theme' => [
            'pathMap' => [
                '@vendor/cyneek/comments/widgets/views' => '@app/views/comments', // example: @app/views/comment/_form.php
            ],
        ],
    ],
],
```

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance16

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~126 days

Total

3

Last Release

3609d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ad71f0a9621c210395ea582f554e197f02f26c087e48aa5b3b464266b6efef59?d=identicon)[Patroklo](/maintainers/Patroklo)

---

Top Contributors

[![Patroklo](https://avatars.githubusercontent.com/u/1254017?v=4)](https://github.com/Patroklo "Patroklo (3 commits)")

---

Tags

yii2extension

### Embed Badge

![Health badge](/badges/cyneek-yii2-comments/health.svg)

```
[![Health](https://phpackages.com/badges/cyneek-yii2-comments/health.svg)](https://phpackages.com/packages/cyneek-yii2-comments)
```

###  Alternatives

[dmstr/yii2-cookie-consent

Yii2 Cookie Consent Widget

1452.6k](/packages/dmstr-yii2-cookie-consent)[richardfan1126/yii2-js-register

Yii2 widget to register JS into view

1357.2k7](/packages/richardfan1126-yii2-js-register)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)