seppzzz / silverstripe-image-cropper-field
为图片添加一个新字段,允许裁剪图片。这将提供保存为新图片或覆盖当前图片的能力。
Requires
- silverstripe/framework: ~4.4
This package is auto-updated.
Last update: 2024-09-21 13:05:48 UTC
README
Image Cropper Field 这是一个从 https://github.com/webbuilders-group/silverstripe-image-cropper-field 分支出来的项目
在 SilverStripe 文件部分中添加了裁剪图片的能力。
要求
- SilverStripe 4.4.x
安装
仅通过 composer 支持安装
composer require seppzzz/silverstripe-image-cropper-field
- 运行
dev/build?flush=all
以重新生成清单
设置
无需配置。安装并运行 dev/build?flush=all
后,您可以直接在 CMS 的文件部分开始裁剪图片。
功能和概述
Image Cropper Field 提供了多种工具,可帮助任何 CMS 管理员裁剪图片,并减少使用外部工具(如 Photoshop)的需求。
工具
- 裁剪尺寸工具
- 移动工具
- 裁剪工具
- 缩放工具
- 图像旋转工具
- 重置工具
- 纵横比设置工具
Image Cropper Field 不会覆盖当前图片,而是创建一个新的图片。新图片的文件名由当前图片的文件名决定。新图片将保存在 Cropped
子文件夹中。您可以在点击 裁剪图片
按钮之前更改新图片的名称。
创建新图片后,将显示一个绿色警告,并带有指向您新图片的链接;但是,当您使用此字段从 文件插入表单
时,此链接将不会显示。
点击链接后,您将进入您的新图片。
版本 2 将提供更多功能/工具
- 图像翻转工具
- 在点击
裁剪图片
按钮之前下载您裁剪的新图片的能力。
报告问题
在报告问题时,请确保您指定您使用的 SilverStripe 版本,例如 4.4.4。此外,请确保包含您收到的任何 JavaScript 或 PHP 错误。
对于 PHP 错误,请确保您包含完整的堆栈跟踪。此外,请包括您的实现代码以及您如何产生问题的方法。您还可能被要求提供一些类以帮助重现问题。坚持问题,记住,是您看到了问题,而不是模块的维护者,所以可能需要很多问题才能找到解决方案或答案。
常见问题解答
问题:我在 文件插入表单
中创建图片后找不到我的图片。我的新图片在哪里?
答案:您的新图片将保存在名为 Cropped
的子文件夹中。您目前需要刷新页面并再次打开插入图片窗口才能在从 文件插入表单
裁剪时显示图片。
问题:我如何更改图片保存到的文件夹?
答案:在当前版本中,您无法更改图片的保存位置。我们将在未来的版本中尝试添加此功能。
问题:您一直提到 文件插入表单
,这个表单在哪里?我需要使用它吗?
A: 当您与 文件
弹出窗口进行交互时,可以找到 文件插入表单
,这可以通过在 WYSIWYG 编辑器中点击 从文件插入
按钮,或者在上传字段上点击 浏览
按钮/链接来实现。下方的图片就是所提到的 文件插入表单
。
Q: 我可以在页面或数据对象上使用这个字段吗?
A: 目前这个字段仅设计用于 CMS 文件系统及 文件插入表单
。计划允许此字段在页面/数据对象上使用,这可能在第 2 版中实现。