README

Yii2 评论模块

带有小部件的 Yii2 树状评论系统。模块的功能允许您通过预审或自动批准为注册用户管理用户评论。

此模块是 Butterfly.СMS 内容管理系统的一个组成部分，但也可以作为一个独立的扩展使用。

版权所有 (c) 2019-2023 W.D.M.Group, 乌克兰

要求

• PHP 5.6 或更高版本
• Yii2 v.2.0.40 和最新版本
• Yii2 Base 模块（必需）
• Yii2 SelectInput 小部件
• Yii2 Users 模块（可选）

安装

要安装模块，请在控制台中运行以下命令

$ composer require "wdmg/yii2-comments"

配置数据库连接后，在控制台中运行以下命令

$ php yii comments/init

然后选择要执行的操作

1. 应用所有模块迁移
2. 撤销所有模块迁移

迁移

在任何情况下，您都可以在控制台中运行以下命令以执行迁移并创建初始数据

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

配置

要将模块添加到项目中，请将以下数据添加到您的配置文件中

'modules' => [
    ...
    'comments' => [
        'class' => 'wdmg\comments\Module',
        'routePrefix' => "admin",
        'defaultController' => "admin/comments/default",
        'baseRoute' => "/comments",
        'defaultListView' => "@vendor/wdmg/yii2-comments/widgets/views/_list",
        'defaultFormView' => "@vendor/wdmg/yii2-comments/widgets/views/_form",
        'editCommentTimeout' => 300,
        'deleteCommentTimeout' => 3600,
        'newCommentsModeration' => true,
        'approveFromRegistered' => true
    ],
    ...
],

用例

使用 CommentsWidget::widget() 通过上下文和目标渲染评论列表。

<?php
    echo \wdmg\comments\widgets\CommentsWidget::widget([
        'context' => 'page-comments',
        'target' => 'site/index'
    ]);
?>

路由

使用模块的 Module::dashboardNavItems() 方法生成用于 NavBar 的导航项目列表，如下所示

<?php
    echo Nav::widget([
    'options' => ['class' => 'navbar-nav navbar-right'],
        'label' => 'Modules',
        'items' => [
            Yii::$app->getModule('comments')->dashboardNavItems(),
            ...
        ]
    ]);
?>

状态和版本 [准备就绪]

• v.2.0.0 - 更新版权，修复导航菜单
• v.1.0.3 - 添加计数器统计方法
• v.1.0.2 - 修复 >= MySQL 5.7 的 mysql 语法错误: 1055
• v.1.0.1 - 更新 README.md