README

特性

用于处理图像文件和实体头像的通用API
对所有图像文件的标准缩略图处理

API

elgg_imges_create_from_upload() - 从上传创建图像文件
elgg_images_create_from_resource() - 从文件资源创建图像文件
elgg_images_crop() - 裁剪源图像
elgg_images_is_image() - 检查实体是否是图像
elgg_images_create_thumbs() - 为图像创建缩略图
elgg_images_get_thumbs() - 返回缩略图文件对象
elgg_images_clear_thumbs() - 删除所有图像缩略图
elgg_images_create_avatar_from_upload() - 从文件上传为实体创建头像
elgg_images_create_avatar_from_resource() - 从文件资源为实体创建头像
elgg_images_clear_avatars() - 清除实体头像
elgg_images_get_avatar() - 获取实体的头像

钩子

'thumb:sizes',$entity_type - 过滤缩略图大小配置数组
'thumb:directory', $entity_type - 过滤缩略图将保存的文件存储目录中的目录名称
'thumb:filename', $entity_type - 过滤将赋予缩略图的文件名
'options', 'imagine' - 过滤保存裁剪图像时传递给Imagine的选项

缩略图配置

缩略图大小可以作为选项数组的配置

// Add `media` size that will be cropped in an `outbound` mode filling a 640x360 container.
$thumbs['media'] = [
	'w' => 640, // max width
	'h' => 360, // max height
	'square' => false, // crop a square
	'croppable' => true, // allow cropping
	'mode' => 'outbound', // 'inset' or 'outbound'
];

默认情况下，所有方形缩略图将以outbound模式裁剪。master大小将以inset模式裁剪而不裁剪。

注意

此插件区分缩略图和头像。缩略图是ElggFile实体的缩放实例，而头像则是包含在它们所属的实体中的ElggFile实体。头像属于非文件实体，并有缩略图。
如果你覆盖文件插件缩略图，你需要更新文件上传操作以删除生成缩略图的代码。否则，将生成两套缩略图。目前无法非侵入性地覆盖文件插件中的缩略图生成。

hypejunction / images

维护者

详细信息

README

特性

API

钩子

缩略图配置

注意