为页面编辑配置撤消

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[]

在此页面上