sadovojav/yii2-inline-widgets-behavior

该包最新版本(dev-master)没有可用的许可证信息。

将小部件添加到内容中

dev-master 2015-09-26 19:19 UTC

This package is auto-updated.

Last update: 2024-08-29 03:42:00 UTC


README

这是一个分支 howardEagle/yii2-inline-widgets-behavior

安装

Composer

通过 Composer 安装此扩展是首选方法。

运行 php composer.phar require sadovojav/yii2-inline-widgets-behavior ""dev-master"

或向你的 composer.json 文件的 require 部分添加 "sadovojav/yii2-inline-widgets-behavior": ""dev-master"

配置

  1. 在你的配置文件中添加运行时小部件
'params' => [
     // ...
    'runtimeWidgets' => [
        'sadovojav\gallery\widgets\Gallery'
    ]
]
  • runtimeWidgets 必须包含小部件列表
  1. 在你的控制器中添加行为
public function behaviors()
{
    return [
        'InlineWidgetsBehavior' => [
            'class' => sadovojav\iwb\InlineWidgetsBehavior::className(),
            'widgets' => Yii::$app->params['runtimeWidgets'],
        ]
    ];
}
  • string namespace = `` - 默认命名空间
  • string startBlock = [* - 开始内联小部件块
  • string endBlock = *] - 结束内联小部件块
  • string classSuffix = `` - 默认小部件类后缀
  • string cacheDuration = 0 - 默认缓存持续时间
  1. 在视图中添加 decodeWidget
<?= $this->context->decodeWidgets($model->text); ?>

使用方法

在视图中添加 decodeWidget

<?= $this->context->decodeWidgets($model->text); ?>

在内容中插入小部件时,你可以在文本中使用这种格式的字符串

<startBlock><WidgetName>[|<attribute>=<value>[;<attribute>=<value>]]<endBlock>
例如
<h2>Lorem ipsum</h2>

<h2>Gallery 1</h2>
<p>[*Gallery*]</p>

<h2>Gallery (with attr)</h2>
<p>[*Gallery|template=tpl-1*]</p>

<h2>Gallery (with inner caching)</h2>
<p>[*Gallery|template=tpl-1;cache=300*]</p>