Download the PHP package cyneek/yii2-comments without Composer
On this page you can find all versions of the php package cyneek/yii2-comments. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package yii2-comments
Comments module for Yii2
This module provide a comments managing system for Yii2 application and it's based on the yii2mod/comments package by Igor Chepurnoy.
Installation
1. The preferred way to install this extension is through composer.
Either run
or add to the require section of your composer.json
2. Run migrations:
3. Add module data to Yii2 config file:
4. (Optional step) Manage comments in admin panel:
Add following code to admin module section in main config
Then you will be able to access the management section through the following URL:
Usage
-
Use in view with ActiveRecord model:
- Use in view with entity and entityId strings
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:
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
modelparameter. Will stablish the field name that holds the comment entityId parameter. -
clientOptions (optional, array) Array that holds javascript asset parameters. Check the
comment-list.jsasset 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
- sort (optional, array) Sorts the comments in the comment listView. For more info about sorting items in Yii2: HERE
Extending the module:
Extending Model files
Depending on which ones you need, you can set the modelMap config property:
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
The package allows you to attach behavior or event handler to any model. To do this you can set model map like so:
Extending View files
You can extend the view files supplied by this package using the theme component in the config file.
