README

静态页面模块使用 Imperavi Redactor 实现CRUD。

安装

通过 composer 安装此扩展是首选方式。

运行以下命令之一：

php composer.phar require --prefer-dist bupy7/yii2-pages "*"

或者

"bupy7/yii2-pages": "*"

将以下内容添加到你的 composer.json 文件的 require 部分中。

安装

在配置文件中添加模块

'bootstrap' => ['pages'],

...

'modules' => [
    ...

    'pages' => 'bupy7\pages\Module',
]

你必须将上述配置添加到控制台配置文件中才能应用迁移。

默认情况下，模块使用表名 '{{%page}}'。如果你的数据库中已存在此表，请更改配置以使用模块的新表名。

'modules' => [
    ...

    'pages' => [
        'class' => 'bupy7\pages\Module',
        'tableName' => '{{%your_table_name}}',
    ],
]

运行迁移

./yii migrate/up --migrationPath=@bupy7/pages/migrations

如果没有在控制台配置文件中添加模块，此命令将抛出异常。

使用方法

模块中有两个控制器：default 和 manager。

manager 用于控制面板外的页面。你需要通过 controllerMap 保护此控制器，或者通过 AccessControl 重写它以添加行为。

示例

'modules' => [
    ...

    'pages' => [
        'class' => 'bupy7\pages\Module',
        
        ...

        'controllerMap' => [
            'manager' => [
                'class' => 'bupy7\pages\controllers\ManagerController',
                'as access' => [
                    'class' => AccessControl::className(),
                    'rules' => [
                        [
                            'allow' => true,
                            'roles' => ['admin'],
                        ],
                    ],
                ],
            ],
        ],
    ],
],

default 用于向网站显示页面。你需要向配置文件中的文件添加 URL 规则，以便通过别名页面获取内容。

示例

'urlManager' => [
    'rules' => [
        ...

        'pages/<page:[\w-]+>' => 'pages/default/index',
    ],
],

如果启用，你可以通过 Imperavi Redactor 上传和添加文件/图片。

'modules' => [
    ...
    
    'pages' => [
        'class' => 'bupy7\pages\Module',
        
        ...

        'pathToImages' => '@webroot/images',
        'urlToImages' => '@web/images',
        'pathToFiles' => '@webroot/files',
        'urlToFiles' => '@web/files',
        'uploadImage' => true,
        'uploadFile' => true,
        'addImage' => true,
        'addFile' => true,
    ],
],

在 Imperavi redactor 中设置自定义语言

'modules' => [
    ...

    'pages' => [
        'class' => 'bupy7\pages\Module',
        'imperaviLanguage' => 'es',
    ],
]

所有语言列表如下： /vendor/vova07/yii2-imperavi-widget/src/assets/lang。

许可证

yii2-pages 在 BSD 3-Clause 许可证下发布。