README

LinkPreview小部件自动从链接内容检索一些信息。

安装

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

运行以下命令

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

或

"yii2mod/yii2-link-preview": "*"

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

使用方法

1. 执行初始化迁移

php yii migrate/up --migrationPath=@vendor/yii2mod/yii2-link-preview/migrations

1. 在控制器中定义预览动作

public function actions()
{
    return [
        'link-preview' => LinkPreviewAction::className()
    ];
}

1. 按照以下方式将小部件添加到你的页面

echo LinkPreview::widget([
    'selector' => '#your-input-id or .someclass',
    'clientOptions' => [
        'previewActionUrl' => \yii\helpers\Url::to(['link-preview'])
    ],
])

使用ActiveForm和保存页面信息的示例

1. 在视图中创建基本表单

<?php $form = \yii\widgets\ActiveForm::begin() ?>
    <div class="form-group">
        <label for="preview">Preview</label>
        <input name="preview" class="form-control" id="preview" placeholder="Preview">
    </div>
    <?php echo \yii2mod\linkpreview\LinkPreview::widget([
        'selector' => '#preview',
        'clientOptions' => [
            'previewActionUrl' => \yii\helpers\Url::to(['link-preview'])
        ],
    ]) ?>
    <div class="form-group">
        <?= \yii\helpers\Html::submitButton('Save', ['class' => 'btn btn-primary']) ?>
    </div>
<?php \yii\widgets\ActiveForm::end() ?>

1. 将以下代码添加到保存页面信息的动作中

$model = new LinkPreviewModel();
if ($model->load(Yii::$app->request->post()) && $model->validate()) {
    $model->save();
}

// or the short version 

$linkPreviewId = LinkPreviewModel::saveAndGetId(Yii::$app->request->post());

GitHub预览示例

视频链接预览示例