README

这是一个用于在yii2中创建包含区域（类似于bitrix中的区域，但不包含hermitage）的模块。

基于bs4的包含区域管理，因此您必须使用bs4...很抱歉，bs3已经过时（或者您可以分叉这个项目并按自己的意愿修改）。

安装

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

运行以下命令

php composer.phar require --prefer-dist mix8872/included-areas

或者将以下内容添加到您的composer.json文件的require部分。

"mix8872/yii2-included-areas": "dev-master"

使用方法

编辑您的应用程序配置文件中的modules部分。

常规

'modules' => [
	'included-areas' => [
		'class' => 'mix8872\includes\Module',
		'directory' => 'includes',
		'as access' => [
			'class' => 'yii\filters\AccessControl',
			'rules' => [
				[
					'allow' => true,
					'roles' => ['admin'],
                    'matchCallback' => function () {
                        return Yii::$app->id === 'app-backend';
                    }
				],
			]
		],
	],
// next modules config	
],

在配置中，您必须指定directory属性。根据此属性命名的目录将在您的Web文件夹中创建（并且此目录必须在前后端Web文件夹之间共享）。在首次加载包含组件的页面后，包含区域文件将创建在此文件夹中。

您也可以在配置中定义的文件夹中手动创建文件，但请注意，组件将为所有文件追加_inc后缀，因此您必须创建类似awesome_file_inc.php或sometext_inc.php的文件。

重要！您必须为模块指定as access！

然后，您必须以这种方式将组件放置在您的视图文件中

<?php
use mix8872\includes\widgets\IncludedArea;
?>

<?= IncludedArea::widget([
    'name' => 'your_unique_name_of_file', // required
    'directory' => 'subfolder', // not required
]) ?>

其中

name - 文件的唯一名称。组件将为您的文件添加_inc后缀，这样您将得到类似your_unique_name_of_file_inc.php的文件。
directory - 在配置中定义的主要目录中的子目录名称。

加载所有包含区域的页面并创建文件后（或您手动创建文件），您可以打开URL \included-areas\来管理记录。

祝您使用愉快。

mix8872 / yii2-included-areas

维护者

详细信息

README

安装

使用方法