README

Yii2 用户视图计数

用户视图会计系统。

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

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

要求

• PHP 5.6 或更高版本
• Yii2 v.2.0.35 及最新版本
• Yii2 Base 模块（必需）
• Yii2 Users 模块（可选）

安装

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

$ composer require "wdmg/yii2-views"

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

$ php yii views/init

然后选择您要执行的操作

1. 应用所有模块迁移
2. 回滚所有模块迁移

迁移

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

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

配置

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

'modules' => [
    ...
    'views' => [
        'class' => 'wdmg\views\Module',
        'routePrefix' => 'admin',
        'cacheExpire' => 3600 // hits cache lifetime, `0` - for not use cache
    ],
    ...
],

用法示例

要计算对象的查看次数，请使用组件方法 Yii::$app->views-set() 模块，需要将上下文和标识符传递给它。相同的参数是组件 Yii::$app->views-get() 方法接收查看计数时的唯一选择/过滤条件。

存储和获取查看次数

<?php
    if ($views = Yii::$app->views) {
        $count = $views->set(
            'page-views', // context (string, human-readable description of the section)
            'site/index', // target of object (string|null, by default is resolved route)
            true // flag, true - for return actualy count of views,
            true // flag, true - for register only unique views
        );
        echo $count;
    }
?>

仅获取查看次数

<?php
    if ($views = Yii::$app->views) {
        $count = $views->get(
            'page-views', // context (string, human-readable description of the section)
            'site/index', // target of object (string|null, by default is resolved route)
        );
        echo $count;
    }
?>

路由

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

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

状态和版本 [即可使用]

• v.1.1.0 - 更新版权信息，修复仪表板菜单
• v.1.0.1 - 更新依赖关系，README.md
• v.1.0.0 - 添加用于设置/获取查看计数的组件