README

一个用于上传、管理、裁剪图片以及按标签分离的Yii2模块/小部件。本版本提供按分类、标签和其他所需选项分离的图片查看窗口。适用于不同分类的大图像集合，并为某些图像分类设置访问权限。

安装

推荐通过 composer 安装此扩展。

• 运行以下命令之一

php composer.phar require "mikasto/yii2-image-manager" "*" 

或添加

"require": {
        ...
	"mikasto/yii2-image-manager": "*"
    },
"repositories": [
        ...
	{
		"type": "vcs",
		"url": "https://github.com/mikasto/yii2-image-manager"
	}
]

到您的应用程序的 composer.json 文件的 require 部分中。

• 运行迁移以创建 ImageManager 表

yii migrate --migrationPath=@mikasto/imagemanager/migrations

• 在您的应用程序配置文件的 components 部分中添加一个新组件，例如

'components' => [
    'imagemanager' => [
		'class' => 'mikasto\imagemanager\components\ImageManagerGetPath',
		//set media path (outside the web folder is possible)
		'mediaPath' => '/path/where/to/store/images/media/imagemanager',
        //path relative web folder. In case of multiple environments (frontend, backend) add more paths 
        'cachePath' =>  ['assets/images', '../../frontend/web/assets/images'],
		//use filename (seo friendly) for resized images else use a hash
		'useFilename' => true,
		//show full url (for example in case of a API)
		'absoluteUrl' => false,
		'databaseComponent' => 'db' // The used database component by the image manager, this defaults to the Yii::$app->db component
	],
],

以及在 modules 部分中，例如

'modules' => [
	'imagemanager' => [
		'class' => 'mikasto\imagemanager\Module',
		//set accces rules ()
		'canUploadImage' => true,
		'canRemoveImage' => function(){
			return true;
		},
		'deleteOriginalAfterEdit' => false, // false: keep original image after edit. true: delete original image after edit
		// Set if blameable behavior is used, if it is, callable function can also be used
		'setBlameableBehavior' => false,
		//add css files (to use in media manage selector iframe)
		'cssFiles' => [
			'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css',
		],
	],
],

使用方法

要访问 imagemanager 模块，请转到

http://www.example.com/imagemanager

或使用过滤器

http://www.example.com/imagemanager?tag=sometag

要加载图片选择器，请参阅以下内容（确保您的表中有一个字段，模块可以存储 ImageManager 表的 'id'）

echo $form->field($model, 'ImageManager_id_avatar')->widget(\mikasto\imagemanager\components\ImageManagerInputWidget::className(), [
	'aspectRatio' => (16/9), //set the aspect ratio
	'cropViewMode' => 1, //crop mode, option info: https://github.com/fengyuanchen/cropper/#viewmode
	'showPreview' => true, //false to hide the preview
	'showDeletePickedImageConfirm' => false, //on true show warning before detach image
	'tag' => 'news', // set filter for display and save uploaded images
]);

如果您想使用一张图片

/*
 * $ImageManager_id (id that is store in the ImageManager table)
 * $width/$height width height of the image
 * $thumbnailMode: "outbound", "inset" or "{horz}:{vert}" where {horz} is one from "left", "center", "right" and {vert} is one from "top", "center", "bottom"
 */
\Yii::$app->imagemanager->getImagePath($ImageManager_id, $width, $height,$thumbnailMode)

支持 CKEditor & TinyMce

要在 CKEditor 中使用文件浏览器，将 filebrowserImageBrowseUrl 添加到 CKEditor 小部件的 clientOptions 中。我仅在 2amigOS 的 CKEditor 上进行了测试，但它需要在其他 CKEditor 小部件上工作。

use dosamigos\ckeditor\CKEditor;

 echo $form->field($model, 'text')->widget(CKEditor::className(), [
	'options' => ['rows' => 6],
	'preset' => 'basic',
	'clientOptions' => [
		'filebrowserImageBrowseUrl' => yii\helpers\Url::to(['imagemanager/manager', 'view-mode'=>'iframe', 'select-type'=>'ckeditor']),
	]
]);

要支持 base64 图片插入，请使用

use dosamigos\ckeditor\CKEditor;

 echo $form->field($model, 'text')->widget(CKEditor::className(), [
	'options' => ['rows' => 6],
	'preset' => 'basic',
	'clientOptions' => [
		'filebrowserImageBrowseUrl' => yii\helpers\Url::to(['imagemanager/manager', 'view-mode'=>'iframe', 'select-type'=>'ckeditorBase64']),
	]
]);

要在 TinyMce 中使用文件浏览器，将 file_browser_callback 添加到 TinyMce 小部件的 clientOptions 中。我仅在 2amigOS 的 TinyMce 上进行了测试，但它需要在其他 TinyMce 小部件上工作。（别忘了将 'image' 添加到您的 'plugins' 数组中）

use dosamigos\tinymce\TinyMce;

echo $form->field($model, 'text')->widget(TinyMce::className(), [
	'options' => ['rows' => 6],
	'language' => 'nl',
	'clientOptions' => [
		'file_browser_callback' => new yii\web\JsExpression("function(field_name, url, type, win) {
			window.open('".yii\helpers\Url::to(['imagemanager/manager', 'view-mode'=>'iframe', 'select-type'=>'tinymce'])."&tag_name='+field_name,'','width=800,height=540 ,toolbar=no,status=no,menubar=no,scrollbars=no,resizable=no');
		}"),
		'plugins' => [
			"advlist autolink lists link charmap print preview anchor",
			"searchreplace visualblocks code fullscreen",
			"insertdatetime media table contextmenu paste image"
		],
		'toolbar' => "undo redo | styleselect | bold italic | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link image"
	]
]);