配置撤消以进行页面编辑 configuring-undo-for-page-editing
OSGi服务 Day CQ WCM撤消配置 ( com.day.cq.wcm.undo.UndoConfigService
)公开了几个属性,这些属性控制用于编辑页面的撤消和重做命令的行为。
默认配置 default-configuration
在标准安装中,默认设置被定义为sling:OsgiConfig
节点上的属性:
/libs/wcm/core/config.author/com.day.cq.wcm.undo.UndoConfig
此节点包含cq.wcm.undo.whitelist
和cq.wcm.undo.blacklist
属性,对于其他属性,将采用默认值。
/libs
路径中的任何内容。/libs
的内容会被覆盖(在应用修补程序或功能包时很可能会被覆盖)。配置撤消和重做 configuring-undo-and-redo
您可以为自己的实例配置这些OSGi服务属性。
下面列出了Web控制台中显示的属性,其后是相应OSGi参数的名称,以及说明和默认值(如果适用):
-
启用
(cq.wcm.undo.enabled
)- 描述:确定页面作者是否可以撤消和重做更改。
- 默认值:
Selected
- 类型:
Boolean
-
路径
(cq.wcm.undo.path
)- 描述:用于保留二进制撤消数据的存储库路径。 当作者更改二进制数据(如图像)时,数据的原始版本将保留在此处。 撤消对二进制数据的更改时,此二进制撤消数据将还原到页面。
- 默认值:
/var/undo
- 类型:
String
note note NOTE 默认情况下,只有管理员才能访问 /var/undo
节点。 只有在授予作者访问二进制撤消数据的权限后,他们才能对二进制内容执行撤消和重做操作。 -
分钟 有效期
(cq.wcm.undo.validity
)- 描述:二进制还原数据的存储时间下限(以小时为单位)。 在此时间段之后,二进制数据可供删除,以节省磁盘空间。
- 默认值:
10
- 类型:
Integer
-
步骤
(cq.wcm.undo.steps
)- 描述:还原历史记录中存储的最大页面操作数。
- 默认值:
20
- 类型:
Integer
-
持久性
(cq.wcm.undo.persistence
)-
描述:保留撤消历史记录的类。 提供了两个持久性类:
CQ.undo.persistence.WindowNamePersistence
:使用window.name属性保留历史记录。CQ.undo.persistence.CookiePersistance
:使用Cookie保留历史记录。
-
默认值:
CQ.undo.persistence.WindowNamePersistence
-
类型:
String
-
-
持久性模式
(cq.wcm.undo.persistence.mode
)-
描述:确定何时保留撤消历史记录。 选择此选项可在每次编辑页面后保留还原历史记录。 清除此选项可仅在发生页面重新加载(例如,用户导航到其他页面)时保留。
保留撤消历史记录会使用Web浏览器资源。 如果用户的浏览器对页面编辑的反应较慢,请尝试在页面重新加载时保留撤消历史记录。
-
默认值:
Selected
-
类型:
Boolean
-
-
标记模式
(cq.wcm.undo.markermode
)-
描述:指定用于指示发生撤消或重做时受影响的段落的可视提示。 以下值有效:
- 闪烁:段落的选择指示器会暂时闪烁。
- 选择:选定段落。
-
默认值:
flash
-
类型:
String
-
-
组件良好
(cq.wcm.undo.whitelist
)-
描述:您希望受撤消和重做命令影响的组件列表。 当组件路径在撤消/重做操作中正常运行时,将其添加到此列表。 附加星号(&;ast;)以指定一组组件:
-
以下值指定基础文本组件:
foundation/components/text
-
以下值指定所有基础组件:
foundation/components/*
-
-
当向不在此列表中的组件发出撤消或重做命令时,将显示一条消息,指示该命令可能不可靠。
-
默认:属性已使用AEM提供的许多组件填充。
-
类型:
String[]
-
-
错误的组件
(cq.wcm.undo.blacklist
)-
描述:不想受撤消命令影响的组件和/或组件操作的列表。 使用undo命令添加行为不正确的组件和组件操作:
- 当您希望撤消历史记录中不包含组件的任何操作(例如,
collab/forum/components/post
)时,添加组件路径 - 如果希望撤消历史记录中省略该特定操作(其他操作运行正常)(例如,
collab/forum/components/post:insertParagraph.
),请在路径后附加一个冒号(:)和一个操作
- 当您希望撤消历史记录中不包含组件的任何操作(例如,
note note NOTE 当操作在此列表上时,它仍会添加到撤消历史记录中。 用户无法撤消撤消历史记录中早于 错误组件 操作的操作。 -
典型操作名称如下:
insertParagraph
:组件已添加到页面。removeParagraph
:组件已删除。moveParagraph
:段落被移动到其他位置。updateParagraph
:段落属性已更改。
-
默认:属性已使用多个组件操作填充。
-
类型:
String[]
-