seppzzz/silverstripe-image-cropper-field

为图片添加一个新字段,允许裁剪图片。这将提供保存为新图片或覆盖当前图片的能力。

安装: 5

依赖项: 0

建议者: 0

安全: 0

星标: 0

关注者: 1

分支: 0

语言:JavaScript

类型:silverstripe-vendormodule

dev-master / 2.0.x-dev 2023-09-21 11:09 UTC

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)的需求。

Overview of Image Cropper Field Overview of Image Cropper Field with aspect dropdown shown Overview of Image Cropper Field with dimension editing shown

工具

  • 裁剪尺寸工具

cropper dimensions tool

  • 移动工具

move tool

  • 裁剪工具

cropper tool

  • 缩放工具

zoom in zoom out

  • 图像旋转工具

rotate left rotate right

  • 重置工具

reset tool

  • 纵横比设置工具

reset tool

Image Cropper Field 不会覆盖当前图片,而是创建一个新的图片。新图片的文件名由当前图片的文件名决定。新图片将保存在 Cropped 子文件夹中。您可以在点击 裁剪图片 按钮之前更改新图片的名称。

Crop Preview window

创建新图片后,将显示一个绿色警告,并带有指向您新图片的链接;但是,当您使用此字段从 文件插入表单 时,此链接将不会显示。

Overview of Image Cropper Field

点击链接后,您将进入您的新图片。

Overview of Image Cropper Field

版本 2 将提供更多功能/工具

  • 图像翻转工具
  • 在点击 裁剪图片 按钮之前下载您裁剪的新图片的能力。

报告问题

在报告问题时,请确保您指定您使用的 SilverStripe 版本,例如 4.4.4。此外,请确保包含您收到的任何 JavaScript 或 PHP 错误。

对于 PHP 错误,请确保您包含完整的堆栈跟踪。此外,请包括您的实现代码以及您如何产生问题的方法。您还可能被要求提供一些类以帮助重现问题。坚持问题,记住,是您看到了问题,而不是模块的维护者,所以可能需要很多问题才能找到解决方案或答案。

常见问题解答

问题:我在 文件插入表单 中创建图片后找不到我的图片。我的新图片在哪里?

答案:您的新图片将保存在名为 Cropped 的子文件夹中。您目前需要刷新页面并再次打开插入图片窗口才能在从 文件插入表单 裁剪时显示图片。

问题:我如何更改图片保存到的文件夹?

答案:在当前版本中,您无法更改图片的保存位置。我们将在未来的版本中尝试添加此功能。

问题:您一直提到 文件插入表单,这个表单在哪里?我需要使用它吗?

A: 当您与 文件 弹出窗口进行交互时,可以找到 文件插入表单,这可以通过在 WYSIWYG 编辑器中点击 从文件插入 按钮,或者在上传字段上点击 浏览 按钮/链接来实现。下方的图片就是所提到的 文件插入表单

Overview of Image Cropper Field

Q: 我可以在页面或数据对象上使用这个字段吗?

A: 目前这个字段仅设计用于 CMS 文件系统及 文件插入表单。计划允许此字段在页面/数据对象上使用,这可能在第 2 版中实现。