README

Yii2 CMS 扩展

本模块提供了内容管理系统（CMS）的 Web 界面，包括以下功能：

• 允许对页面进行 CRUD 操作
• 支持 Markdown 编辑器
• 支持 Froala 编辑器
• 支持评论管理系统
• 与 yii2mod/base 集成

安装

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

运行以下命令

php composer.phar require --prefer-dist yii2mod/yii2-cms "*"

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

"yii2mod/yii2-cms": "*"

配置

数据库迁移

在开始使用此扩展之前，我们还需要准备数据库。

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

模块设置

要访问模块，您需要在您的应用程序配置中配置 modules 数组

'modules' => [
    'cms' => [
        'class' => 'yii2mod\cms\Module',
    ],
],

然后您可以通过以下 URL 访问管理部分

http://localhost/path/to/index.php?r=/cms/manage/index

配置 URL 管理器

您需要配置应用程序配置中的 urlManager 数组

 'components' => [
     'urlManager' => [
         'rules' => [
             ['class' => 'yii2mod\cms\components\PageUrlRule'],
         ]
     ],
 ],

设置页面行为

添加到 SiteController（或通过 urlManager 中的 $route 参数进行配置）

public function actions()
{
    return [
        'page' => [
            'class' => 'yii2mod\cms\actions\PageAction',
        ]
    ];
}

现在您可以使用此模块的所有功能。

功能

1. 默认情况下，此扩展使用 froala editor 来管理 CMS 页面，您可以通过以下代码更改编辑器配置

选项列表：https://www.froala.com/wysiwyg-editor/docs/options

配置示例：https://github.com/froala/yii2-froala-editor#usage

'modules' => [
    'cms' => [
        'class' => 'yii2mod\cms\Module',
        'froalaEditorOptions' => [
            // your custom configuration
            'clientPlugins' => [
            ],
            'clientOptions' => [
            ],
            'excludedPlugins' => [
            ],
        ],
    ],
],

1. Markdown 编辑器支持

'modules' => [
    'cms' => [
        'class' => 'yii2mod\cms\Module',
        'enableMarkdown' => true,
        // List of options: https://github.com/NextStepWebs/simplemde-markdown-editor#configuration
        'markdownEditorOptions' => [
            'showIcons' => ['code', 'table'],
        ],
    ],
],

1. 您可以通过以下步骤在页面上插入自己的小部件

• 创建小部件，例如

namespace app\widgets;

use yii\base\Widget;

class MyWidget extends Widget
{
   /**
    * @inheritdoc
    */
   public function run()
   {
       parent::run();

       echo 'Text from widget';
   }

   /**
    * This function used for render the widget
    *
    * @return string
    */
   public static function show()
   {
       return self::widget();
   }
}

• 当您通过管理面板创建页面时，将以下代码添加到页面内容中

 [[\app\widgets\MyWidget:show]]

1. 您可以在页面内容中使用参数，例如：{siteName}，{homeUrl}。您可以使用 baseTemplateParams 属性解析这些参数

public function actions()
{
    return [
        'page' => [
            'class' => 'yii2mod\cms\actions\PageAction',
            'baseTemplateParams' => [
               'homeUrl' => 'your site home url',
               'siteName' => Yii::$app->name
            ]
        ],
    ];
}

1. 您可以通过以下代码更改评论模块的设置

public function actions()
{
    return [
        'page' => [
            'class' => 'yii2mod\cms\actions\PageAction',
            'commentWidgetParams' => [
                'maxLevel' => 1,
                'dataProviderConfig' => [
                    'pagination' => [
                        'pageSize' => 10
                    ],
                ],
            ]
        ]
    ];
}

有关评论模块的详细信息，请访问以下 页面

支持我们

您的业务依赖于我们的贡献吗？请联系我们并在 Patreon 上支持我们。所有承诺都将用于分配人力资源以维护和新奇的东西。