Configuring Undo for Page Editing configuring-undo-for-page-editing

Enable
( cq.wcm.undo.enabled)

• Description: Determines whether page authors can undo and redo changes.
• Default: Selected
• Type: Boolean

Path
( cq.wcm.undo.path)

• Description: The repository path for persisting binary undo data. When authors change binary data such as images, the original version of the data is persisted here. When changes to binary data is undone, this binary undo data is restored to the page.
• Default: /var/undo
• Type: String

Min. validity
( cq.wcm.undo.validity)

• Description: The minimum amount of time that binary undo data is stored, in hours. After this time period, the binary data is available for deletion, to conserve disk space.
• Default: 10
• Type: Integer

Steps
( cq.wcm.undo.steps)

• Description: The maximum number of page actions that are stored in the undo history.
• Default: 20
• Type: Integer

Persistence
( cq.wcm.undo.persistence)

• Description: The class that persists undo history. Two persistence classes are provided:

  • CQ.undo.persistence.WindowNamePersistence: Persists history using the window.name property.
  • CQ.undo.persistence.CookiePersistance: Persists history using cookies.

• Default: CQ.undo.persistence.WindowNamePersistence

• Type: String

Persistence mode
( cq.wcm.undo.persistence.mode)

• Description: Determines when undo history is persisted. Select this option to persist undo history after each page edit. Clear this option to persist only when a page reload occurs (for example, the user navigates to a different page).

  Persisting undo history uses web browser resources. If your users’ browser reacts slowly to page edits, try persisting the undo history on page reloads.

• Default: Selected

• Type: Boolean

Marker mode
( cq.wcm.undo.markermode)

• Description: Specifies the visual cue to use for indicating which paragraphs are affected when an undo or redo occurs. The following values are valid:

  • flash: The selection indicator of the paragraphs flash temporarily.
  • select: The paragraph is selected.

• Default: flash

• Type: String

Good components
( cq.wcm.undo.whitelist)

• Description: A list of components that you want to be affected by undo and redo commands. Add component paths to this list when they function correctly with undo/redo. Append an asterisk (*) to specify a group of components:

  • The following value specifies the foundation text component:

    foundation/components/text

  • The following value specifies all foundation components:

    foundation/components/*

• When undo or redo is issued to a component that is not in this list, a message appears that indicates that the command can be unreliable.

• Default: The property is populated with many components that AEM provides.

• Type: String[]

Bad components
( cq.wcm.undo.blacklist)

• Description: A list of components and/or component operations that you do not want to be affected by the undo command. Add components and component operations that do not behave correctly with the undo command:

  • Add a component path when you want none of the component’s operations in the undo history, for example, collab/forum/components/post
  • Append a colon (:) and an operation to the path when you want that specific operation to be omitted from the undo history (other operations function correctly), for example, collab/forum/components/post:insertParagraph.

• Typical operation names are as follows:

  • insertParagraph: The component is added to the page.
  • removeParagraph: The component is deleted.
  • moveParagraph: The paragraph is moved to a different location.
  • updateParagraph: The paragraph properties are changed.

• Default: The property is populated with several component operations.

• Type: String[]