README

上传和裁剪实体图标和封面图的接口

功能

上传、处理和裁剪实体图标和封面图的通用API
管理员设置以启用所有实体类型的图标/封面
允许裁剪文件缩略图
允许裁剪用户和群组头像及封面图片
可选在正方形、圆形和圆形实体图标之间切换
可选用SVG替换默认实体图标
可选用SVG替换默认文件类型图标
响应式图标/封面裁剪

屏幕截图

说明

默认实体类型图标

要替换默认实体图标/封面，只需将一个图像放置在views/default/<icon_type>/<entity_type>/<entity_subtype>.<ext>，其中

ext可以是svg、png、gif或jpg。
icon_type可以是cover或icon

将裁剪器作为表单输入添加

// in your form
echo elgg_view('input/cropper', array(
	'src' => 'http://example.com/uri/image.jpg',
	'ratio' => 16/9,
	'name' => 'crop_coords',
));

// in your action
$coords = get_input('crop_coords');

将裁剪器添加到文件输入

这将允许用户在将图像上传到服务器之前对其进行裁剪。

// in your form
echo elgg_view('input/file', array(
    'name' => 'avatar',
    'use_cropper' => true,
));

// in your action
$coords = get_input('crop_coords');

您还可以传递预设坐标和图像源。

// in your form
echo elgg_view('input/file', array(
	'name' => 'cover',
	'use_cropper' => array(
		'name' => 'cover_crop_coords',
		'ratio' => 16/9,
		'src' => '/uri/image.jpg', // previously uploaded file
		'x1' => 100,
		'y1' => 100,
		'x2' => 260,
		'y2' => 190,
	),
));

// in your action
$coords = get_input('cover_crop_coords');

在您的操作中，请确保使用相同的图像源进行裁剪。如果您已将主图像源传递给文件输入，则需要实现新文件上传和主图像的逻辑，因为裁剪坐标可能会更改，即使没有新文件上传。

显示封面图像

echo elgg_view('output/cover', [
   'entity' => $entity,
]);

在布局标题中添加封面图像

echo elgg_view_layout('one_sidebar', [
   'entity' => $entity,
   'show_cover' => true,
   'title' => 'Page with cover',
   'content' => 'Page content',
]);

hypejunction / hypeicons

维护者

详细信息