Contribute to this guideReport an issue

guide配置

CKFinder 3 附带两个配置文件

  • ckfinder.yml - 服务器端配置文件,本文将对此进行说明。
  • config.js - 一个可选的客户端配置文件,在 API 文档文章中解释了关于 设置 JavaScript 配置

默认情况下,CKFinder 3 for Java 连接器会在应用程序的资源目录中搜索名为 ckfinder.yml 的文件。
此配置文件的模板可在 此处 找到。

如果您想从任何其他位置加载配置,请参考 从自定义位置加载配置 教程。

以下选项可以在 ckfinder.yml 文件中设置

选项名称 类型 描述
accessControl sequence 访问控制列表 (ACL) 用于根据用户角色授予用户对 CKFinder 文件夹和文件进行不同操作的权限。
backends sequence 后端配置,其中必须定义 CKFinder 应支持的所有类型的存储(例如,本地文件系统上的目标路径;Amazon S3 帐户凭据)。
cache mapping 配置各种 CKFinder 组件的缓存生命周期。
checkSizeAfterScaling boolean 是否在缩放图像以满足最大允许尺寸之前或之后检查图像文件大小。
csrfProtection boolean 在连接器中启用 CSRF 保护。
extraHeaders mapping 要添加到每个连接器响应的 HTTP 标头。
images mapping 图像配置,如最大允许宽度和高度。
licenseKey string CKFinder 许可证密钥。如果无效,CKFinder 将以演示模式运行。
licenseName string CKFinder 许可证名称。如果无效,CKFinder 将以演示模式运行。
privateDir mapping 私有目录位置和设置。
resourceTypes sequence CKFinder 中处理的资源类型。每个资源类型在 CKFinder 中表示为一个“根”文件夹(例如,**文件** 和 **图像**),并指向配置后端中的特定文件夹。
roleSessionAttribute string CKFinder 必须用来检索当前用户的“角色”的会话变量名称。
secureImageUploads boolean 是否在上传图像文件时执行额外的检查。
serveStaticResources boolean CKFinder 的 servlet 是否应提供 CKFinder 前端使用的静态资源(JavaScript 和 HTML 文件、CSS 样式等)。
thumbnails mapping 内部缩略图配置。

# 配置选项

# accessControl

访问控制列表 (ACL) 是一项功能,它允许您的用户获得不同的权限来使用 CKFinder 文件夹和文件。config.php 文件中放置的默认设置授予所有用户所有选项的完全权限。

# 访问控制列表语法

accessControl:
  - role: '*'
    resourceType: '*'
    folder: /

    FOLDER_VIEW: true
    FOLDER_CREATE: true
    FOLDER_RENAME: true
    FOLDER_DELETE: true

    FILE_VIEW: true
    FILE_CREATE: true
    FILE_RENAME: true
    FILE_DELETE: true

    IMAGE_RESIZE: true
    IMAGE_RESIZE_CUSTOM: true

访问控制列表条目使用以下值定义

选项名称 类型 描述
role string 为其提供 ACL 设置的用户角色(请参阅 roleSessionAttribute)。默认情况下它设置为 *(星号),表示“所有人”。
resourceType string 资源类型的名称(请参阅 resourceTypes)。默认情况下它设置为 *(星号),表示“所有资源类型”。
folder string 将使用限制的文件夹。默认情况下它设置为 /(斜杠),表示“资源类型的根文件夹”。
FOLDER_VIEW boolean 用户是否可以查看文件列表。
FOLDER_CREATE boolean 用户是否可以创建文件夹。
FOLDER_RENAME boolean 用户是否可以重命名文件夹。
FOLDER_DELETE boolean 用户是否可以删除文件夹。
FILE_VIEW boolean 用户是否可以查看文件内容。
FILE_CREATE boolean 用户是否可以创建(例如,上传)文件。
FILE_RENAME boolean 用户是否可以重命名文件。
FILE_DELETE boolean 用户是否可以删除文件。
IMAGE_RESIZE boolean 在选择图像时,用户是否可以将其调整为配置文件中预定义的尺寸。
IMAGE_RESIZE_CUSTOM boolean 在选择图像时,用户是否可以将其调整为任何尺寸。

注意:IMAGE_RESIZEIMAGE_RESIZE_CUSTOM 选项对应于选择调整大小功能,该功能会自动创建所选图像的调整大小版本。它们不会影响在 CKFinder 的图像编辑器中修改的图像的大小调整(编辑功能)。

可以定义多个 ACL 条目。所有属性都是可选的。子文件夹会从其父级定义继承其默认设置。

# 关于 folder 选项

了解 folder 条目的含义很重要。在 ACL 定义中,folder 是相对于资源类型位置的路径。这不是服务器上文件夹的绝对路径。

示例

如果 Files 资源类型指向 /home/joe/www/example.com/userfiles/files/,则为 Files 资源类型中的文件夹 /documents 定义的 ACL 将应用于 /home/joe/www/example.com/userfiles/files/documents/

# 访问控制列表示例

查看以下示例,这些示例介绍了各种权限配置,以便您了解如何在 CKFinder 中使用访问控制列表。

示例 1

Images 资源类型中的 /Logos 文件夹中禁止文件操作。

要限制在 Images 资源类型中的 /Logos 文件夹中上传、重命名或删除文件,请使用以下 ACL 设置

accessControl:
  - role: '*'
    resourceType: 'Images'
    folder: '/Logos'

    FOLDER_VIEW: true
    FOLDER_CREATE: true
    FOLDER_RENAME: true
    FOLDER_DELETE: true

    FILE_VIEW: true
    FILE_CREATE: false
    FILE_RENAME: false
    FILE_DELETE: false

    IMAGE_RESIZE: true
    IMAGE_RESIZE_CUSTOM: true

注意:此示例仅涉及 /Logos 文件夹中的文件操作。它不会限制对文件夹的操作,因此用户仍然可以删除或重命名它。为了限制用户修改文件夹本身(而不是其内容)的能力,您也应该更改文件夹权限。

示例 2

使 /Logos 文件夹对所有资源类型完全只读。

要限制在所有资源类型(*)中的 /Logos 文件夹(包括 /Logos 文件夹本身)中上传、重命名或删除文件以及创建、重命名和删除文件夹,请使用以下 ACL 设置

accessControl:
  - role: '*'
    resourceType: '*'
    folder: '/Logos'

    FOLDER_VIEW: true
    FOLDER_CREATE: false
    FOLDER_RENAME: false
    FOLDER_DELETE: false

    FILE_VIEW: true
    FILE_CREATE: false
    FILE_RENAME: false
    FILE_DELETE: false

    IMAGE_RESIZE: false
    IMAGE_RESIZE_CUSTOM: false

有了这样的权限,用户甚至没有权利使用选择调整大小功能创建现有图像的调整大小版本。

示例 3

由于权限由子文件夹继承,因此定义将进一步修改的权限就足够了。
CKFinder 中的默认设置允许所有人执行所有操作

accessControl:
  - role: '*'
    resourceType: '*'
    folder: '/'

    FOLDER_VIEW: true
    FOLDER_CREATE: true
    FOLDER_RENAME: true
    FOLDER_DELETE: true

    FILE_VIEW: true
    FILE_CREATE: true
    FILE_RENAME: true
    FILE_DELETE: true

    IMAGE_RESIZE: true
    IMAGE_RESIZE_CUSTOM: true

这意味着要禁止任何文件夹操作(除了查看之外),您可以设置

accessControl:
  - role: '*'
    resourceType: '*'
    folder: '/'

    FOLDER_CREATE: false
    FOLDER_RENAME: false
    FOLDER_DELETE: false

而无需重复所有设置为 true 的条目。

# backends

后端用于 资源类型定义,作为文件应位于其中的存储的定义。尽管后端和资源类型严格相关,但它们是单独定义的,以简化配置,例如,当同一个 S3 帐户用于定义四个不同的资源类型时,唯一的区别是 S3 存储桶上的子文件夹的名称。

示例

定义为 default 的后端与两个资源类型之间的连接示例

backends:
  - name: 'default'
    adapter: 'local'
    baseUrl: 'http://example.com/userfiles'
    root: '/path/to/userfiles'
    disallowUnsafeCharacters: true
    forceAscii: false
    hideFolders: ['.*', 'CVS', '__thumbs']
    hideFiles: ['.*']
    htmlExtensions: ['html', 'htm', 'xml', 'js']
    overwriteOnUpload: false
    useProxyCommand: false

resourceTypes:
  - name: 'Files'
    backend: 'default'
    directory: '/files'   # = /path/to/userfiles/files
    allowedExtensions: pdf,zip,doc,xls,mp3,txt,jpg,png,bmp,gif
    deniedExtensions: ~
    maxSize: 0

  - name: 'Images'
    backend: 'default'
    directory: '/images'  # = /path/to/userfiles/images
    allowedExtensions: bmp,jpeg,jpg,png
    deniedExtensions: ~
    maxSize: 0

# 常见配置选项

以下列出的选项集可与任何后端类型一起使用。

选项名称 类型 描述
name string 后端的唯一名称。
adapter string 此后端使用的适配器类型 - local 用于本地文件系统。
root string 包含 CKFinder 用户文件的目录的文件系统路径。此目录必须存在于服务器上。
baseUrl
optional
string 用于直接访问 CKFinder 文件的基 URL。此 URL 必须对应于存储 CKFinder 用户文件的目录。
useProxyCommand
optional
boolean 是否应将存储在此后端上的文件的链接指向 Proxy 命令。
forceAscii
optional
boolean 强制为文件和文件夹使用 ASCII 名称。如果启用,带有重音符号的字符(如 åäöćčđš)将自动转换为其 ASCII 对应项。
overwriteOnUpload
optional
boolean 更改 CKFinder 在上传与文件夹中已存在的文件同名文件时的默认行为。如果启用,则不会自动重命名文件,而是会覆盖现有文件。
checkDoubleExtension
optional
boolean 是否允许双文件扩展名的文件。由于 Apache 模块的安全性问题,建议保持 checkDoubleExtension 启用状态。如果启用 checkDoubleExtension,则会检查文件名中点号后的每个部分,而不仅仅是最后一部分。如果扩展名被禁止,则点号 (.) 将被替换为下划线 (_)。例如,如果允许 rar 扩展名,禁止 php 扩展名,则上传的 foo.php.rar 文件将被重命名为 foo_php.rar
disallowUnsafeCharacters
optional
boolean 禁止创建名称包含在 Windows 环境中不安全的字符的文件夹和文件。
hideFolders
optional
sequence 无论其位置如何,都不应在 CKFinder 中显示的文件夹。
hideFiles
optional
sequence 不应在 CKFinder 中显示的文件。
htmlExtensions
optional
sequence 可能允许其前 1kB 数据中包含 HTML 代码的文件类型。CKFinder 仅当文件扩展名在 htmlExtensions 中指定时才会上传包含 HTML 代码的文件。
fileSystemOptions
optional
mapping 特定于文件系统的配置选项(例如,访问凭据)。
# useProxyCommand

useProxyCommand 配置是一个强大的选项,允许提供 CKFinder 中存储的任何文件。在某些情况下,为您的网页创建指向文件的链接可能很困难,甚至是不可能的(例如,当文件存储在私有 FTP 服务器上,或者不在 Web 服务器根文件夹中时)。为后端启用此选项告诉 CKFinder 使用 Proxy 命令创建指向文件的链接。

以这种方式提供文件具有以下优势

  • 文件不需要通过直接链接公开访问。您不需要更改存储配置以使文件对匿名用户可访问。
  • 更好地控制对文件的访问权限。您可以使用 CKFinder ACL 选项来定义对文件的更严格的访问权限(请参见 accessControl 配置选项)。
  • 更轻松地控制客户端缓存规则。使用 cache 配置选项,您可以定义由 Proxy 命令提供的文件在浏览器中缓存的时间长度。

这种方法的缺点是,所有指向文件的链接都将依赖于 CKFinder 连接器,因此,如果您决定有一天删除 CKFinder,这些链接将停止工作。

# hideFolders

对于给定的后端,不应在 CKFinder 中显示的文件夹。不接受任何路径,只接受文件夹名称。

接受 *(星号)和 ?(问号)通配符。* 匹配任意数量的字符,? 匹配正好一个字符。

示例

隐藏所有以点字符开头的文件夹以及两个额外的文件夹:CVS__thumbs

backends:
  - name: 'default'
    adapter: 'local'
    baseUrl: 'http://example.com/userfiles'
    root: '/path/to/userfiles'
    hideFolders: ['.*', 'CVS', '__thumbs']
# hideFiles

对于给定的后端,不应在 CKFinder 中显示的文件。不接受任何路径,只接受文件名,包括扩展名。

接受 *(星号)和 ?(问号)通配符。* 匹配任意数量的字符,? 匹配正好一个字符。

示例

隐藏所有以点字符开头的文件。

backends:
  - name: 'default'
    adapter: 'local'
    baseUrl: 'http://example.com/userfiles'
    root: '/path/to/userfiles'
    hideFiles: ['.*']

# 支持的后端

CKFinder 3 for Java 连接器使用 NIO.2 文件系统抽象层 (JSR-203),这允许透明地使用许多不同的文件系统。
以下列出了支持的后端及其配置选项。

# 本地文件系统

这是 CKFinder 中的默认后端,它指向服务器本地文件系统中的文件夹。

示例

本地文件系统后端配置的示例,以及定义为 default 的后端与两个资源类型之间的连接

backends:
  - name: 'default'
    adapter: 'local'
    baseUrl: 'http://example.com/userfiles'
    root: '/path/to/userfiles'
    disallowUnsafeCharacters: true
    forceAscii: false
    hideFolders: ['.*', 'CVS', '__thumbs']
    hideFiles: ['.*']
    htmlExtensions: ['html', 'htm', 'xml', 'js']
    overwriteOnUpload: false
    useProxyCommand: false

resourceTypes:
  - name: 'Files'
    backend: 'default'
    directory: '/files'   # = /path/to/userfiles/files
    allowedExtensions: pdf,zip,doc,xls,mp3,txt,jpg,png,bmp,gif
    deniedExtensions: ~
    maxSize: 0

  - name: 'Images'
    backend: 'default'
    directory: '/images'  # = /path/to/userfiles/images
    allowedExtensions: bmp,jpeg,jpg,png
    deniedExtensions: ~
    maxSize: 0
# Amazon S3

将在 CKFinder for Java 的未来版本中提供。

# cache

配置各种 CKFinder 组件的缓存生命周期

  • imagePreview – 由 ImagePreview 命令返回的图像的缓存生命周期。
  • thumbnails – 缩略图图像的缓存生命周期。
  • proxyCommand – 由 Proxy 命令提供的文件的缓存生命周期。

生命周期定义为一个整数,表示秒数。如果提供的
值不是大于 0 的正数,则组件的缓存将被禁用。

示例

cache:
  imagePreview: 86400  # 24 * 3600 (24h)
  thumbnails: 31536000 # 24 * 3600 * 365 (1 year)
  proxyCommand: 0

# checkSizeAfterScaling

指示上传图像的文件大小是否必须在缩小(如果需要)后,根据 资源类型 配置中定义的 maxSize 设置进行检查。否则,在上传后立即检查大小。

示例

checkSizeAfterScaling: true

# csrfProtection

在连接器中启用 CSRF 保护。默认的 CSRF 保护机制基于 双重提交 Cookie

示例

csrfProtection: true

# extraHeaders

应添加到每个连接器响应的额外 HTTP 标头。

示例

extraHeaders:
  'Access-Control-Allow-Origin': '*'
  'Access-Control-Allow-Credentials': 'true'

# images

CKFinder 的图像配置。

# 配置选项

选项名称 类型 描述
maxWidth 整数 上传图像的最大宽度。如果图像大小大于指定大小,则图像将调整为定义的尺寸。
maxHeight 整数 上传图像的最大高度。如果图像大小大于指定大小,则图像将调整为定义的尺寸。
quality 整数 创建的图像的质量,范围从 1 到 100。质量值越小,调整大小的图像尺寸越小。请注意,可接受的质量值约为 80-90。
sizes mapping 可以轻松地从 CKFinder 中选择并传递到外部应用程序(例如 CKEditor)的预定义图像大小,而无需手动调整图像大小。映射的键被翻译并用作“选择缩略图”上下文菜单中的条目。特定条目的翻译标签取自语言文件,例如 small 将被翻译为 lang.image[‘small’]。如果当前语言没有设置翻译键,则使用英文版本。如果没有找到英文版本,则使用未翻译的字符串(第一个字母设为大写)。

示例

images:
  maxWidth: 1600
  maxHeight: 1200
  quality: 80
  sizes:
    small:
      width: 480
      height: 320
      quality: 80
    medium:
      width: 600
      height: 480
      quality: 80
    large:
      width: 800
      height: 600
      quality: 80

# licenseKey

CKFinder 许可证密钥。如果无效,CKFinder 将以演示模式运行。

示例

licenseKey: 'ABCD-EFGH-IJKL-MNOP-QRST-UVWX-YZ12'

# licenseName

CKFinder 许可证名称。如果无效,CKFinder 将以演示模式运行。

示例

licenseName: 'example.com'

# privateDir

内部目录配置。

重要:CKFinder 需要频繁访问这些目录,因此建议将此文件夹保留在本地文件系统上。

选项名称 类型 描述
backend string 私有目录应所在的后台。
path string 私有目录的内部后端相对路径。
data
optional
string 用于存储文件元数据的内部文件夹。默认情况下,它位于 cache/data 文件夹中。
thumbs
optional
string 用于内部缩略图(图像预览)的文件夹。默认情况下,它位于 cache/thumbs 文件夹中。

示例

将私有目录位置设置为 default 后端内的 .ckfinder 文件夹。

privateDir:
  backend: 'default'
  path: '.ckfinder/'

# resourceTypes

资源类型只不过是将文件分组到不同路径下的方法,每个路径都有不同的配置设置。资源类型在 CKFinder 中表示为“根文件夹”。每个资源类型可以使用不同的 后端

默认情况下,CKFinder 配置文件预先配置了两种示例资源类型:FilesImages。配置的资源类型数量没有限制。您可以更改或删除默认类型,但请确保至少配置一种资源类型。

# 配置选项

选项名称 类型 描述
name string 资源类型的机器友好名称,用于 CKFinder UI 与服务器连接器之间的通信。
label string 资源类型的人类友好名称,将在 CKFinder UI 中用作“根文件夹”名称。
backend string 指向此资源类型应所在的 后端 的名称。
directory
optional
string 资源类型应指向的后台子文件夹的路径。
maxSize
optional
string 以字节为单位定义的上传文件的最大大小。
allowedExtensions string 您希望允许使用 CKFinder 上传的文件扩展名。NO_EXT 值可用于没有扩展名的文件。
deniedExtensions
optional
string 您不希望使用 CKFinder 上传的文件扩展名。如果 allowedExtensions 保持为空,则应仅设置此值。NO_EXT 值可用于没有扩展名的文件。
lazyLoaded
optional
boolean 如果设置为 true,则 Init 命令不会检查资源类型是否包含子文件夹。此选项对于远程后端特别有用,因为 Init 命令将更快地执行,因此 CKFinder 的启动速度也会更快。建议对远程后端将其设置为 true

重要:建议始终使用 allowedExtensions 设置,而不是使用 deniedExtensions。如果您将 allowedExtensions 保持为空,并将扩展名添加到 deniedExtensions 列表中,例如 pdf,则设置将允许上传除具有 pdf 扩展名的文件以外的所有其他文件(例如 .php.exe 文件)。

示例

一个简单的资源类型定义,其中 label 设置为 Files 的法语等效词。当 将 CKFinder 与 CKEditor 集成 时,可以将 name(机器名称)设置为 Files

resourceTypes:
  - name: 'Files'
    label: 'Fichiers'
    backend: 'default'
    directory: '/files/'
    maxSize: 8388608 # 8 MB
    allowedExtensions: 'doc,gif,jpg,pdf,png,zip'

# roleSessionAttribute

CKFinder 必须使用以检索当前用户的角色的 HttpSession 属性名称。

示例

roleSessionAttribute: 'CKFinder_UserRole'

role 可用于设置 ACL 设置

示例

为所有用户设置只读权限,但允许具有 administrator 角色的用户完全访问

accessControl:
  - role: '*'
    resourceType: '*'
    folder: /

    FOLDER_VIEW: true
    FOLDER_CREATE: false
    FOLDER_RENAME: false
    FOLDER_DELETE: false

    FILE_VIEW: true
    FILE_CREATE: false
    FILE_RENAME: false
    FILE_DELETE: false

    IMAGE_RESIZE: false
    IMAGE_RESIZE_CUSTOM: false

  - role: 'administrator'
    resourceType: '*'
    folder: /

    FOLDER_VIEW: true
    FOLDER_CREATE: true
    FOLDER_RENAME: true
    FOLDER_DELETE: true

    FILE_VIEW: true
    FILE_CREATE: true
    FILE_RENAME: true
    FILE_DELETE: true

    IMAGE_RESIZE: true
    IMAGE_RESIZE_CUSTOM: true

# secureImageUploads

是否在上传图像文件时执行额外的检查。

有时,用户可能会尝试上传一个不是图像文件但看起来像是图像文件的文件。例如:您有一个名为 document.jpg 的文本文件,您尝试上传它。您可以通过将 secureImageUploads 设置为 true 来启用图像检查功能

示例

secureImageUploads: true

# serveStaticResources

CKFinder servlet 是否应提供静态资源(例如,CKFinder 前端的 JavaScript、CSS、翻译文件)。

示例

serveStaticResources: true

# thumbnails

内部缩略图配置。

注意:更改最小值和最大值将导致 CKFinder UI 的设置面板中的滑块范围不同。

# 配置选项

选项名称 类型 描述
enabled 布尔值 CKFinder 是否应为图像文件显示真实的缩略图。
sizes sequence CKFinder 允许创建的内部缩略图的预定义大小。由于 CKFinder 允许用户使用滑块在应用程序中更改缩略图的大小,因此默认情况下使用了一些预定义的集,以便在用户不需要大图像时使用小尺寸和最有效尺寸(150px),而在用户更喜欢大图像时使用高达 500px 的尺寸。

示例

thumbnails:
  enabled: true
  sizes:
    - width: 150
      height: 150
      quality: 80
    - width: 300
      height: 300
      quality: 80
    - width: 500
      height: 500
      quality: 80

# 配置文件模板

默认情况下,CKFinder 3 for Java 连接器在应用程序的资源目录中查找名为 ckfinder.yml 的文件。
以下列出的 YAML 显示了此配置文件的基本结构。

# ckfinder.yml

licenseName: ''
licenseKey: ''
roleSessionAttribute: 'CKFinder_UserRole'
serveStaticResources: true
checkSizeAfterScaling: true
secureImageUploads: true
csrfProtection: true

backends:
  - name: 'default'
    adapter: 'local'
    baseUrl: 'http://example.com/userfiles'
    root: '/path/to/userfiles'
    disallowUnsafeCharacters: true
    forceAscii: false
    hideFolders: ['.*', 'CVS', '__thumbs']
    hideFiles: ['.*']
    htmlExtensions: ['html', 'htm', 'xml', 'js']
    overwriteOnUpload: false
    useProxyCommand: false

resourceTypes:
  - name: 'Files'
    backend: 'default'
    directory: '/files'
    allowedExtensions: 7z,aiff,asf,avi,bmp,csv,doc,docx,fla,flv,gif,gz,gzip,jpeg,jpg,mid,mov,mp3,mp4,mpc,mpeg,mpg,ods,odt,pdf,png,ppt,pptx,qt,ram,rar,rm,rmi,rmvb,rtf,sdc,swf,sxc,sxw,tar,tgz,tif,tiff,txt,vsd,wav,wma,wmv,xls,xlsx,zip
    deniedExtensions: ~
    maxSize: 0
  - name: 'Images'
    backend: 'default'
    directory: '/images'
    allowedExtensions: bmp,jpeg,jpg,png
    deniedExtensions: ~
    maxSize: 0

privateDir:
  backend: 'default'
  path: '.ckfinder/'

thumbnails:
  enabled: true
  sizes:
    - width: 150
      height: 150
      quality: 80
    - width: 300
      height: 300
      quality: 80
    - width: 500
      height: 500
      quality: 80

images:
  maxWidth: 1600
  maxHeight: 1200
  quality: 80
  sizes:
    small:
      width: 480
      height: 320
      quality: 80
    medium:
      width: 600
      height: 480
      quality: 80
    large:
      width: 800
      height: 600
      quality: 80

cache:
  imagePreview: 86400  # 24 * 3600 (24h)
  thumbnails: 31536000 # 24 * 3600 * 365 (1 year)
  proxyCommand: 0

accessControl:
  - role: '*'
    resourceType: '*'
    folder: /

    FOLDER_VIEW: true
    FOLDER_CREATE: true
    FOLDER_RENAME: true
    FOLDER_DELETE: true

    FILE_VIEW: true
    FILE_CREATE: true
    FILE_RENAME: true
    FILE_DELETE: true

    IMAGE_RESIZE: true
    IMAGE_RESIZE_CUSTOM: true