README

来自 https://github.com/zxbodya/yii2-gallery-manager 的分支

（前端部分基本未修改，但后端几乎完全重写）

警告：预览版本

功能

1. AJAX图像上传
2. 可选为每张图像添加名称和描述
3. 在画廊中排列图像的可能性
4. 为每张图像生成具有不同配置的几个版本的能力
5. 拖放

依赖项

1. Yii2
2. Twitter Bootstrap资产（版本3）
3. Imagine库
4. JQuery UI（包含在Yii中）

安装

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

运行以下命令：

php composer.phar require --prefer-dist kfos/yii2-gallery-manager "dev-master"

或添加

"kfos/yii2-gallery-manager": "dev-master"

到您的 composer.json 文件的 require 部分。

使用方法

添加迁移以创建图像表

class m150318_154933_gallery_ext
    extends kfos\yii2\galleryManager\migrations\m140930_003227_gallery_manager
{

}

或者更好的是 - 将迁移复制到您的应用程序中。

将 GalleryBehavior 添加到您的模型中，并配置它，为上传的文件创建文件夹。

public function behaviors()
{
    return [
         'galleryBehavior' => [
             'class' => GalleryBehavior::className(),
             'type' => 'product',
             'extension' => 'jpg',
             'directory' => Yii::getAlias('@webroot') . '/images/product/gallery',
             'url' => Yii::getAlias('@web') . '/images/product/gallery',
             'versions' => [
                 'small' => function ($img) {
                     /** @var \Imagine\Image\ImageInterface $img */
                     return $img
                         ->copy()
                         ->thumbnail(new \Imagine\Image\Box(200, 200));
                 },
                 'medium' => function ($img) {
                     /** @var Imagine\Image\ImageInterface $img */
                     $dstSize = $img->getSize();
                     $maxWidth = 800;
                     if ($dstSize->getWidth() > $maxWidth) {
                         $dstSize = $dstSize->widen($maxWidth);
                     }
                     return $img
                         ->copy()
                         ->resize($dstSize);
                 },
             ]
         ]
    ];
}

在您的应用程序的控制器中添加 GalleryManagerAction。在此步骤中，您还可以为该操作添加一些安全检查。

public function actions()
{
    return [
       'galleryApi' => [
           'class' => GalleryManagerAction::className(),
           // mappings between type names and model classes (should be the same as in behaviour)
           'types' => [
               'product' => Product::className()
           ]
       ],
    ];
}

在您的应用程序的某处添加 ImageAttachmentWidget，例如在编辑表单中。

if ($model->isNewRecord) {
    echo 'Can not upload images for new record';
} else {
    echo GalleryManager::widget(
        [
            'model' => $model,
            'behaviorName' => 'galleryBehavior',
            'apiRoute' => 'product/galleryApi'
        ]
    );
}

完成！

现在，您可以使用以下方式使用上传的画廊图像：

foreach($model->getBehavior('galleryBehavior')->getImages() as $image) {
    echo Html::img($image->getUrl('medium'));
}

选项

使用非默认的画廊图像表名（默认为 {{%gallery_image}}）

1. 添加创建所需表的迁移
2. 在行为配置中更改 tableName 属性