为页面编辑配置撤消

OSGi服务 Day CQ WCM撤消配置 ( com.day.cq.wcm.undo.UndoConfigService)公开了几个属性,这些属性控制用于编辑页面的撤消和重做命令的行为。

默认配置

在标准安装中,默认设置被定义为 sling:OsgiConfig节点:

/libs/wcm/core/config.author/com.day.cq.wcm.undo.UndoConfig

此节点包含 cq.wcm.undo.whitelistcq.wcm.undo.blacklist 属性,对于其他属性,会采用默认值。

注意

必须 不更改 /libs 路径。

这是因为 /libs 下次升级实例时将被覆盖(在应用修补程序或功能包时很可能会被覆盖)。

配置撤消和重做

您可以为自己的实例配置这些OSGi服务属性。

注意

使用AEM时,可通过多种方法管理此类服务的配置设置;请参阅 配置OSGi 了解更多详细信息和建议的做法。

下面列出了Web控制台中显示的属性,以及相应的OSGi参数的名称、说明和默认值(如果适用):

  • 启用
    (
    cq.wcm.undo.enabled)

    • 描述:确定页面作者是否可以撤消和重做更改。
    • 默认Selected
    • 类型: Boolean
  • 路径
    (
    cq.wcm.undo.path)

    • 描述:用于保留二进制还原数据的存储库路径。 当作者更改二进制数据(如图像)时,数据的原始版本将保留在此处。 在撤消对二进制数据的更改时,此二进制撤消数据将还原到页面。
    • 默认/var/undo
    • 类型: String
    注意

    默认情况下,只有管理员才能访问 /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:段落的选择指示器会暂时闪烁。
      • 选择:段落被选定。
    • 默认flash

    • 类型: String

  • 组件良好
    (
    cq.wcm.undo.whitelist)

    • 描述:您希望受撤消和重做命令影响的组件列表。 当组件路径在撤消/重做操作中正常运行时,请将其添加到此列表。 附加星号(*)以指定一组组件:

      • 以下值指定基础文本组件:

        foundation/components/text

      • 以下值指定所有基础组件:

        foundation/components/*

    • 当撤消或重做操作发出给不在此列表中的组件时,将显示一条消息,指示该命令可能不可靠。

    • 默认:属性由AEM提供的许多组件填充。

    • 类型: String[]

  • 组件损坏
    (
    cq.wcm.undo.blacklist)

    • 描述:您不希望受撤消命令影响的组件和/或组件操作列表。 使用撤消命令添加行为不正确的组件和组件操作:

      • 例如,当您不希望在撤消历史记录中执行任何组件操作时,可添加组件路径 collab/forum/components/post
      • 例如,当您希望撤消历史记录中省略该特定操作时(其他操作运行正常),请将冒号(:)和操作附加到路径中 collab/forum/components/post:insertParagraph.
    注意

    当操作位于此列表上时,它仍会添加到撤消历史记录中。 用户无法撤消早于以下时间的操作: 组件无效 撤消历史记录中的操作。

    • 典型操作名称如下:

      • insertParagraph:将组件添加到页面。
      • removeParagraph:删除组件。
      • moveParagraph:段落被移动到其他位置。
      • updateParagraph:段落属性已更改。
    • 默认:属性中填充了多个组件操作。

    • 类型: String[]

在此页面上