Managing Pages within WCM
You are reading the AEM 5.6
version of Managing Pages within WCM
This documentation is also available for the following versions:
This section describes how to create a page within AEM WCM and then create content on that page.
This page deals with the classic UI.
The touch-optimized UI has been introduced in AEM and can be used for basic handling, such as creating, opening, copying, moving and deleting a page.
Editing a page (to add content using paragraphs) is still done with the classic UI.
Your account needs the appropriate access rights to create or edit pages.
Unless all pages have been created for you in advance, before you can start creating content, you must create a page:
From the Websites console, select the level at which you want to create a new page.
In the following example, you are creating a page under the level English - shown in the left pane; the right pane shows pages that already exist at the level under English.
In the New... menu (click the arrow next to New...), select New Page.... The Create Page window opens.
Clicking New... itself also acts as a shortcut to the New Page... option.
The Create Page dialog allows you to:
- Provide a Title; this is displayed to the user.
- Provide a Name; this is used to generate the URI.
- Click the template you want to use to create the new page.
The template is used as the basis for the new page; for example, to determine the basic layout of a content page.
If you would like to use unicode characters in the URLs, set the sling:alias property (Page properties).
Click Create to create the page. You return to the Websites console where you can see an entry for the new page.
This provides information about the page (for example when it was last edited and by whom) which is updated as necessary.
After the page has been created, you can edit its content:
When you first create a page, the page includes only the text and elements from the template. You add content by double-clicking or dragging and dropping components onto the page.
Having a page open for editing also gives you access to other actions via the sidekick; these include Page, Versioning and Workflow related actions.
You can open the page to be edited by one of several methods:
- From Websites console, you can double-click the page title to open it for editing.
- From Websites console, you can right-click the page item, then select Open from the menu.
- After you have opened a page, you can navigate to other pages within the site to edit them by clicking hyperlinks.
Inserting a New Paragraph
After you open the page, you can start to add content. You do this by adding paragraphs (also called components).
To insert a new paragraph:
There are several methods of selecting the type of paragraph you want to insert:
- Double-click the area labeled Drag components or assets here... - the Insert New Component toolbar opens. Drag a component from here.
- Drag a component from the floating toolbar (called sidekick) to insert a new paragraph.
- Right-click an existing paragraph and select New... - the Insert New Component toolbar opens. Drag the required component from here.
In both the sidekick and the Insert New Component toolbar you see a list of the available paragraph types. These may be split into various sections (for example, General, Columns, etc.), which can be expanded as required.
Depending on your production environment, these choices may differ. For complete details on components, see Default Components.
Insert the component that you want on the page. Then double-click the paragraph, a window opens that allows you to configure your paragraph and add content.
To edit an existing paragraph, do one of the following:
- Double-click the paragraph to open it. You see the same window as when you created the paragraph with the existing content. Make your changes and click OK.
- Right-click the paragraph and click Edit.
- Click twice on the paragraph (a slow double-click) to enter the Inplace Editing mode. You will be able to directly edit the text on the page, instead of inside a dialog window. In this mode, you will be provided with a toolbar at the top of the page. Just make your changes and they will be automatically saved.
Drag the paragraph to the new location - AEM WCM indicates where paragraphs can be moved to with a green checkmark. Drop it in your desired location.
Select the paragraph and right-click:
Select Delete from the menu. AEM WCM requests confirmation that you want to delete the paragraph as this action cannot be undone.
Undoing and Redoing Page Edits
Use keyboard shortcuts to undo and redo changes that you make to paragraphs while in Edit mode. Use the following keyboard shortcuts while the content frame of the page has focus:
- Undo: Ctrl-z (Windows) or command-z (Mac)
- Redo: Ctrl-y (Windows) or command-y (Mac)
If an element on the content page is selected, the undo and redo command applies to the selected item, such as a text component.
The behavior of the undo and redo commands is similar to that in other software programs. Use the commands to restore the recent state of your web page as you make decisions about content. For example, if you move a text paragraph to a different location on the page, you can use the undo command to move the paragraph back. If you then decide again to move the paragraph, use the redo command.
When you undo or redo the removal, addition, or relocation of one or more paragraphs, flashing highlights indicate the affected paragraphs. (Your administrator can change this default behavior.)
AEM stores a history of actions that you perform and the sequence in which you performed them. So, you undo several actions in the order that you performed them. Then, you can use redo to re-apply one or more of the actions. By default, you can undo a maximum of 20 edit actions. (Your administrator can change this default value.)
You can redo actions as long as you have not made a page edit since you used undo.
You can use undo and redo for the following types of page changes:
- Adding, editing, removing, and moving paragraphs
- In-place editing of paragraph content
- Adding, removing, and changing files and images
- Adding, removing, and changing annotations and sketches
- Copying, cutting, and pasting items within a page or across pages
- Changes to Scaffold
- Adding and removing references
- Changing property values in component dialog boxes.
Form fields that form components render are not meant to have values specified while authoring pages. Therefore, the undo and redo commands do not affect changes that you make to the values of those types of components. For example, you cannot undo the selecting of a value in a drop-down list.
Special permissions are required to undo and redo changes to files and images. Also, undo history for changes to files and images lasts for at least 10 hours. Beyond this time, the undo of the changes is not guaranteed. (Your administrator can provide permissions and change the default time of 10 hours.)
A Find & Replace menu option allows you to search for, and replace multiple instances of a string, within a section of the website.
Select the root page, or folder, where you want the find and replace action to take place.
Select Tools then Find & Replace:
The Find & Replace dialog does the following:
- confirms the root path where the find action should start
- defines the term to be found
- defines the term that should replace it
- indicates whether the search should be case-sensitive
- indicates whether only whole words should be found (otherwise substrings are also found)
Clicking Preview lists where the term has been found. You can select/clear specific instances to be replaced:
Click Replace to actually replace all instances. You will be asked to confirm the action.
The default scope for the find and replace servlet covers the following properties:
The scope can be changed using the Apache Felix Web Management Console (for example, at http://localhost:4502/system/console/configMgr). Select CQ WCM Find Replace Servlet (com.day.cq.wcm.core.impl.servlets.FindReplaceServlet) and configure the scope as required.
In a standard AEM installation Find and Replace uses Lucene for the search functionality.
Lucene indexes string properties of up to 16k in length. Strings in excess of this will not be searched.
When copying, you can copy either:
- a single page
- a page together with all subpages
From the Websites console, select the page you want to copy.
At this stage, it is irrelevant whether you want to copy a single page or the underlying subpages.
Navigate to the new location and click:
- Paste - to paste the page together with all subpages
- Shift + Paste - to paste the selected page only
The page(s) are pasted at the new location.
The page name might be automatically adjusted if an existing page already has the same name.
The procedure to move or rename a page is the same. You do not need to do both: you can rename a page without moving it or vice versa.
AEM offers you the functionality to update internal links to the page being renamed or moved. This can be done on a page-by-page basis to provide full flexibility.
To move or rename a page:
From the Websites console, click to select the page, then select Move.... Alternatively, you can also select the page item, then right-click and select Move....
The Move window opens; here you can either specify a new location, a new name for the page, or both.
The page also lists any pages that reference the page being moved. Depending on the status of the referencing page, you may be able to adjust those links on and/or republish the pages.
Fill in the following fields, as appropriate:
Specify the page to be moved - this is usually filled in by default, depending on how and where you started the move action.
Use the sitemap (available via the drop-down selector) to select the location where the page should be moved to.
If you are only renaming the page, ignore this field.
The current page label displays by default. Specify the new page label, if required.
Update the links on the page listed that point to the moved page: for example, if page A has links to page B, AEM adjusts the links in page A in case you move page B.
This can be selected/deselected for each individual referencing page.
Republish the referencing page; again this can be selected for each individual page.
Click Move. AEM WCM confirms that you want to move or rename the current page. Click OK to confirm.
You can delete a page from various locations:
- Within the Websites console, click to select the page, then right-click and select Delete from the resulting menu.
- Within the Websites console, click to select the page, then select Delete from the toolbar menu.
- Within sidekick use the Page tab to select Delete - this deletes the page that is currently open.
After you have selected to delete a page you must confirm the request - as the action cannot be undone.
After deletion, if the page has been published you can restore the latest (or a specific) version, but this may not have exactly the same content as your last version if further modifications had been made. See How To Restore Pages for further details.
Creating, Comparing and Restoring Page Versions
Versioning creates a "snapshot" of a page at a specific point in time. With versioning, you can perform the following actions:
- Create a version of the page.
- Compare the current version of the page with a previous version: texts, titles and images that have been added or deleted are marked with a specific style.
- Restore the page to a previous version; for example, to undo a change that you made to a page.
To create a new version of a page:
In your browser, open the page for which you want to create a new version.
In the Sidekick, select the Versioning tab, then the Create Version sub tab.
Enter a Comment (optional).
To set a label to the version (optional), click the More >> button and set the Label to name the version. If the label is not set, the version is an automatically incremented number.
Click Create Version. A greyed message is displayed on the page; for example:
Version 1.2 created for: Shirts.
A version is automatically created when the page is activated.
Comparing with a Previous Version
To compare the current version of the page with a previous version:
In your browser, open the page for which you want to compare with a previous version.
In the Sidekick, select the Versioning tab, then the Restore Version sub tab.
Check the version for which you want to compare and click the Diff button.
The differences between the current version and the selected version are displayed as follows:
- a text that has been deleted is red and strikedthrough.
- a text that has been added is green and highlighted.
- an image that has been added or deleted is green-framed.
In the Sidekick, select the Restore Version sub tab and click the <<Back button to display the current version.
This feature is available for the text, the image, the text-image and the title components.
Restoring to a Previous Version
To restore the page to a previous version:
- In your browser, open the page for which you want to restore to a previous version.
- In the Sidekick, select the Versioning tab, then the Restore Version sub tab.
- Check the version for which you want to restore and click Restore.
Timewarp is a feature designed to simulate the published state of a page at specific times in the past.
The purpose is to allow you to track the published website at the selected point in time. This uses the page activations to determine the state of the publish environment.
To do this:
- The system looks for the page version that was active at the selected time.
- This means the version shown was created/activated before the point in time selected in Timewarp.
- When navigating to a page that has been deleted this will also be rendered - as long as the old versions of the page are still available in the repository.
- If no published version is found, then Timewarp will revert to the current state of the page on the author environment (this is to prevent an error/404 page, which would mean that you cannot browse anymore).
If versions are removed from the repository then Timewarp cannot show the correct view. Also, if elements (such as code, css, images, etc) for rendering the website have changed, the view will differ from what it originally was, as those items are not versioned in the repository.
Using the Timewarp Calendar
Timewarp is available from the sidekick.
The calendar version is used if you have a specific day to be viewed:
Open the Versioning tab and then click Timewarp (near the bottom of the sidekick). The following dialog will be shown:
Using the date and time selectors specify the date/time you want and click Go.
Timewarp will display the page as it was in its published state before/on the date you have chosen.
Timewarp will only work fully if you have previously published the page. If not, timewarp will show the current page on the author environment.
If you navigate to a page that has been removed/deleted from the repository it will be rendered properly if old versions of the page are still available in the repository.
You cannot edit the old version of the page. It is only available for viewing. If you want to restore the older version you will have to do that manually using restore.
When you have finished viewing the page, click:
- Exit Timewarp to exit and return to the current author page.
- Show Timeline to view the timeline.
Using the Timewarp Timeline
The timeline version is used if you want to see an overview of the publishing activities on the page.
If you want to view the timeline of the document:
To show the Timeline you can either:
- Open the Versioning tab and then click Timewarp (near the bottom of the sidekick).
- Use the sidekick dialog shown after using the Timewarp Calendar.
Click on Show Timeline - the document's timeline will appear; for example:
Select and move (hold and drag) the timeline to move through the document's timeline.
- All lines indicate published versions.
When a page is activated, a new line starts. Every time the document is edited a new color appears.
In the example below, the red line indicates that the page was edited during the timeframe of the initial green version and the yellow line indicates that the page was edited sometime during the red version etc.
- Go to show the content of the published page at the selected point of time.
- Exit Timewarp to exit and return to the current author page.
Page Properties define the various properties of the page, such as titles, when they appear on the website and others.
Open the page you want to edit.
In the sidekick open the Page tab then select Page Properties... - a dialog with multiple tabs opens.
Make the changes you require (see below) then click OK to save.
The page title - as appears in the Websites tab list.
Here you can add, or remove tags from the page by updating the list in the selection box:
- A completely new tag can be entered by typing the name in an empty space in the selection box.
- With the drop-down functionality you can select from existing tags.
- An x appears when you mouse-over a tag entry in the selection box; this can be used to remove that tag for this page.
Hide in Navigation
A toggle switch to indicate whether the page is shown or hidden in the page navigation.
More Titles and Description
A title to be used on the page.
A title for the page for use within the navigation map. Often shorter than the full title.
A subtitle for use on the page.
A description of the page to be used as you require.
The date and time at which the published page will be activated. When published this page will be kept dormant until the specified time. Leave these fields empty for pages you want to publish immediately (the normal scenario).
The time at which the published page will be deactivated. Again leave these fields empty for pages you want to publish immediately.
Allows you to enter a vanity URL for this page. That allows you to have a shorter and more expressive URL.
For example, if the Vanity URL is set to welcome to the page identified by the path /v1.0/startpage for the website http://example.com, then http://example.com/welcome would be the vanity URL of http://example.com/content/v1.0/startpage.
Vanity URL must be unique so you should take care that the value is not already used by another page.
Redirect Vanity URL
Indicates whether you want the page to use the vanity URL.
Indicate the page to which this page should automatically redirect.
Indicate the design to be used for this page.
Specify an alias to be used with this page.
The page to be used for login.
Groups eligible for login to the CUG.
Here you can assign or remove this page from predefined segments.
Specify an export configuration.
Use this tab to load an image that can be used to represent this page.
Define properties for cloud services.
Define properties for a Blueprint page within multi-site management. Controls the circumstances under which modifications will be propagated to the Live Copy.
Define properties for a Live Copy page within multi-site management. Controls the circumstances under which modifications will be propagated from the Blueprint.
AEM lets you view which pages are linked to the page you are currently working on.
To show page references:
In the sidekick, select the Page tab icon.
Select Show References... AEM opens the References window and displays which pages refer to the selected page, including their paths.