|
Working with WCM
You are reading the AEM 5.6 version of Working with WCM.
This documentation is also available for the following versions:
CQ 5.5
CQ 5.4
CQ 5.3
Concept of Authoring in WCM
An author in WCM generates the material which will, at some point, be published to your website.
The author works in what is known as the author environment. This provides an easy to use, graphical user interface for creating the content. It is usually located behind a company's firewall that provides full protection.
Depending on how your instance and your personal access rights are configured you can perform many tasks, including amongst others:
- generate new content on an existing page
- edit existing content
- create new pages using predefined templates
- move, copy or delete pages
- activate (or deactivate) pages
- participate in workflows that control how changes are managed; for example. enforcing a review before publication
When ready the content is published to the publish environment. For a normal internet site, this is located inside the demilitarized zone; in other words, available to the internet, but no longer under the full protection of your internal network.
To optimize performance for visitors to your website, the dispatcher(s) implements load balancing and caching.
On the published website visitors can post comments related to the individual pages. Functionality for posting comments is developed within AEM and assigned to pages, either individually or by using templates.
Throughout WCM you can access the integrated version of this guide by using this icon; as seen below in the Sidekick.
AEM uses a web-based graphical user interface, so you need a web browser to access AEM. The graphical user interface is divided into various web-based consoles. Each of these enable you to access a different area of AEM functionality.
| Websites |
Access all the pages in your website; create, edit, and delete pages; start a workflow; activate and deactivate pages; restore pages; check external links; and access your user inbox. |
| Digital Assets |
Manage digital assets. |
| Campaigns |
Manage Marketing campaigns. |
| Community |
Moderate content from social network |
| Inbox |
Manage workflow inbox index |
| Users |
Manage users and permissions |
| Tools |
Manage packages, designs, importers, workflow templates and scrpits, replication agents and upgrates. |
| Tagging |
Manage your tags and taxonomies |
Although each of the consoles has different options, how you work within AEM is essentially the same:
- Double-click to open items.
- Access items from the tree list. Click + to expand and - to collapse those items.
- Click the icons to access other consoles.
- Available commands are above the items.
- Logging in and out is handled in the upper right corner.
- Collapse the sidebar by clicking the arrow.
- Search for pages using the search box.
As an author you will use the Websites tab to manage your content.
Place the root of your new website directly under the Websites/ node, as with the Geometrixx Demo Site.
Under this a hierarchical structure is developed by nesting the content pages. This will be used for generating the URLs.
Multi-language sites are also easy to construct, with the various languages being managed in parallel.
Tree Expansion when Navigating your Website
The Websites console lists your pages of content in a tree structure (left hand pane). For ease of navigation, sections of the tree structure can be expanded (+) or collapsed (-) as required.
A single click on the page name (in the left pane) will:
- List the child pages in the right pane
- Also expand the structure in the left pane.
For performance reasons this action is dependent on the number of children nodes. With a standard installation this method of expansion works when there are 30 or less child nodes.
A double click on the page name will also expand the tree, though as the page is opened at the same time this effect is not so obvious.
Note
This default value (30) can be changed per console in your application specific configurations of the siteadmin widget:
- On the siteadmin node:
Set the value of the property:
treeAutoExpandMax
on:
/apps/wcm/core/content/siteadmin
- Or globally in the theme:
Set the value of:
TREE_AUTOEXPAND_MAX
in:
/apps/cq/ui/widgets/themes/default/widgets/wcm/SiteAdmin.js
See SiteAdmin in the CQ Widget API for more details.
The Website Console provides a list view with the following information about pages.
| Collum |
Description |
| Title |
The title that appears on the page |
| Name |
The name AEM refers to the page |
| Published |
Indicates whether the page has been published and provides the publication date and time |
| Modified |
Indicates whether the page has been modified and provides the modification date and time. In order to save any modification, you must activate the page. |
| Status |
Indicates the current status of the page, such as whether the page is part of a workflow or whether a page is currently locked. |
| Impressions |
Shows the activity on a page in number of hits. |
| Template |
Indicates the template that a page is based on. |
Each user has an inbox where he receives notifications which he subscribed for.
To subscribe to notifications:
Open the notification inbox: in the Websites console, click the user button in the top right corner and select Notification Inbox.
Note
You can also hit http://<host>:<port>/libs/wcm/core/content/inbox.html in your browser.
Click Configure... in the top left corner to open the configuration dialog.
Select the notification channel:
- Inbox: notifications will be displayed in your AEM inbox.
- Email: notifications will be emailed to the email address defined in your user profile.
Note
A few settings need to be configured in order to be notified by email. It is also possible to customize the email template or to add an email template for a new language. Please refer to Configuring Email Notification to configure email notifications in AEM.
Select the page actions for which to be notified:
- Activated: when a page has been activated.
- Deactivated: when a page has been deactivated.
- Deleted (syndication): when a page has been delete-replicated, i.e. when a delete action performed on a page is replicated.
When a page is deleted or moved, a delete action is automatically replicated: the page is deleted on the source instance where the delete action was performed and on the destination instance defined by the replication agents.
- Modified: when a page has been modified.
- Created: when a page has been created.
- Deleted: when a page has been deleted through the page delete action.
- Rolled out: when a page has been rolled out.
Define the paths of the pages for which you will be notified:
- Click Add to add a new row to the table.
- Click the Path table cell and enter the path, e.g. /content/docs.
- To be notified for all the pages belonging to the sub-tree, set Exact? to No.
To be only notified for actions on the page defined by the path, set Exact? to Yes.
- To allow the rule, set Rule to Allow. If set to Deny, the rule is denied but not removed and can be allowed later.
To remove a definition, select the row by clicking a table cell and click Delete.
Click OK to save the configuration.
If you have chosen to receive notifications in your AEM inbox, your inbox will fill up with notifications. For each notification that you select, you can:
- Approve it by clicking Approve: the value in the Read column is set to true.
- Delete it by clicking Delete.
Each user can set certain properties for themselves. This is available from the following menu in the top right corner of the Websites console:
Selecting Preferences will open a dialog that allows you to set:
Language Select the required language from the available list.
Window Management Select either:
- Multiple Windows (Default)
Pages will be opened in a new window.
- Single Window
Pages will be opened in the current window.
Editing Toolbar Select whether you want to have the global editing toolbar shown:
- Show when needed (Default)
- Always show
- Keep Hidden
This toolbar (shown at the top of the browser window when you are editing a page) gives you Copy, Cut, Paste, Delete buttons for using with the paragraph components on that page.
In AEM, a template specifies a type of page.
It defines the structure of a page; including a thumbnail image, and other properties. For example, you may have a separate templates for product pages, sitemaps, and contact information. Templates are comprised of components.
AEM comes with several templates including a contentpage and home page.
| Title |
Component |
Location |
Purpose |
| Home Page |
homepage |
geometrixx |
The Geometrixx home page template. |
| Content Page |
contentpage |
geometrixx |
The Geometrixx content page template. |
To get a list of all the templates available in the repository, proceed as follows:
- In CRXDE Lite, open the Tools menu and click Query.
- In the Query tab
- As Type, select XPath.
- In the Query input field, enter following string:
//element(*, cq:Template)
- Click Execute. The list is displayed in the result box.
The content page component creates a new page for content according to a template selected by the author.
Title
The title displayed on the resulting web-page.
LabelThe label used when naming the page.
TemplateA list of templates available for use when generating the new page.
The following example illustrates use of the contentpage component:
To access the search panel, click on the Search tab at the top of the left-hand pane in the site administration console.
The search panel lets you search across all your website pages. It contains fields and widgets for the following:
- Fulltext: Search for the specified text
- Last modified: Search only those pages that were changed between the specific dates
- Path: Search within a certain subtree of your site
- Template: Search only those pages based on the specified template
- Tags: Search only those pages with the specified tags
Execute the search by clicking Search at the bottom of the pane. Click Reset to clear the search criteria.
The row of icons at the bottom of the Sidekick are used to switch
modes for working with the pages:
The Sidekick minimizes in certain modes - namely Design and
Preview. By clicking on the arrow you can maximize the Sidekick and
return to Edit Mode:
This is the default mode and allows you to edit the page, adding or deleting components and making other changes.
In this mode, the sidekick is minimized and you have the possibility to edit the design of the page:
For example, if you click Edit on the Paragraph system you can add, or remove what components are available:
Click the arrow on the sidekick to return to Edit mode.
This mode allows you to preview the page as if it were appearing on your website in its final form. Again the sidekick is minimized.
As in Design mode, click the arrow on the sidekick to return to Edit Mode.
AEM WCM comes with a variety of out-of-the-box components that provide comprehensive functionality for website authors. These components and their usage within the installed "Geometrixx" website are a reference on how to implement and use components.
The following section includes an overview of all default components as well as a description of each component item and examples of what the components look like in AEM.
When working with any components, you can add them either by double-clicking Drag components or assets here or dragging and dropping the component from the sidekick onto the page. Some default components are hidden from view and are usually only added by a developer. The procedure for adding these components is described in Developing Components.
List of available Components
The following components are included in the basic installation within the Geometrixx website. The table lists all components that are available from within the sidekick, when inserting a new component, all the components that are available in Design mode and other components that become available dependent on author. By default, every component available in the sidekick is also available in Design mode (Design of par).
The column Available indicates whether the component is available in:
- Sidekick by default on a Geometrixx Content Page
- Design mode; either with a dialog for configuration or in the (de)activation list Design of par
- the functionality of another component
Note
If someone enables or adds a component, then additional components may become available in the sidekick. For those components, the "Section" column indicates where the components appear in the sidekick once activated.
| Title |
Section |
Purpose |
Availability |
Equivalent in CQ4 |
| Carousel |
General |
Displays area cycling through different content elements. |
Sidekick |
|
| Chart |
General |
Dynamic bar, line or pie chart created from raw data. |
Sidekick |
|
Column Control
2 Columns
3 Columns
|
Geometrixx Outdoors
|
Mechanism for controlling and formatting columns.
2 and 3 Columns are the same component, but default to 2 and 3 columns respectively.
|
Sidekick |
columncontrol |
| Checked Password Field |
Profiles |
Requests password and confirmation of password. |
Sidekick |
|
| Comments |
Collaboration |
List of visitor comments. |
Sidekick |
|
| Download |
General |
Makes a file available for download by the website visitor. |
Sidekick |
download |
| External |
General |
Enables you to embed external applications into your AEM page. |
Sidekick |
|
| Flash |
General |
Allows you to enter a flash movie. |
Sidekick |
|
| Form |
Form |
The start and end components required for a form definition. |
Sidekick |
|
Account Name
|
Form |
Allows you to enter an account name. |
Sidekick |
|
Address Field
|
Form |
A complex field allowing the input of an international address. |
Sidekick |
|
Captcha
|
Form |
A field consisting of an alphanumeric word that refreshes automatically. The captcha component protects websites against bots. |
Sidekick |
|
| Checkbox Group |
Form |
Multiple items organized into a list and preceded by check boxes. Users can select multiple check boxes. |
Sidekick |
|
| Dropdown List |
Form |
Multiple items organized into a drop-down list. The Multi Selectable switch specifies if several elements can be selected from the list. |
Sidekick |
|
| End |
General |
Ends the form. |
Design Mode
|
|
| File Upload |
Form |
An upload element that allows the user to upload a file to the server. |
Sidekick |
|
| Hidden Field |
Form |
This field is not displayed to the user. It can be used to transport a value to the client and back to the server. This field should have no constraints. |
Sidekick |
|
| Image Button |
Form |
An additional submit button for the form that is rendered as an image. |
Sidekick |
|
| Image Upload |
Form |
An upload element that allows the user to upload an image to the server. |
Sidekick |
|
| Link Field |
Form |
Allows entry of a link. |
Sidekick |
|
| Password Field |
Form |
Same as text field but only a single line is allowed and the text input from the user is not visible in the field. |
Sidekick |
|
| Password Reset |
Form |
Input for a password to be reset. |
Sidekick |
|
| Radio Group |
Form |
Multiple items organized into a list preceded by a radio button. Users must select only one radio button. |
Sidekick |
|
| Submit Button |
Form |
An additional submit button for the form where the title is displayed as text on the button. |
Sidekick |
|
| Tags Field |
Form |
Field for tag selection. |
Sidekick |
|
| Text Field |
Form |
Text field that allows users to enter information. |
Sidekick |
|
| Forum |
Other |
Provides the functionality for a forum. |
Sidekick |
|
| Forum Search |
Other |
Search through a forum. |
Sidekick |
|
| New Forum Action |
|
Create a new topic within the forum. |
Forum Component
|
|
| Forum Topic |
|
An individual forum topic. |
Forum Component
|
|
| Forum Post |
|
An individual post entry. |
Forum Component
|
|
| Image |
General |
Displays an image, with a (short) description displayed below. |
Sidekick |
image |
| Inheritance Paragraph System (iparsys) |
N/A |
Is a paragraph system that also allows you to inherit the created paragraphs from the parent. |
Design Mode
|
|
| List |
General |
Displays a configurable list of searched items. |
Sidekick |
generic list |
| Logo |
N/A |
Is a clickable image that points to another part of the site. |
Design Mode
|
|
| Paragraph System (parsys) |
N/A |
Is a compound component that lets authors add components of different types to a page and contains all other paragraph components. |
Design Mode
|
|
| parbase |
N/A |
Is a key component as it allows components to inherit attributes from other components, similar to subclasses in object oriented languages. Users do not need access to this component. |
Design Mode
|
|
| Product List |
General |
Grid-oriented table that allows for input that can be imported and exported (such as in a catalog). |
Sidekick |
|
| Profile Avatar Photo |
Profiles |
Allows input of an Avatar Photo. |
Sidekick |
|
| Profile Detailed Name |
Profiles |
Input of name details, including elements such as title, middle name and suffix if required. |
Sidekick |
|
| Profile Display Name |
Profiles |
Name to be displayed. |
Sidekick |
|
| Profile E-mail |
Profiles |
Input of an e-mail address. |
Sidekick |
|
| Profile Gender |
Profiles |
Allows input of the gender. |
Sidekick |
|
| Profile General Text property |
Profiles |
Profile properties. |
Sidekick |
|
| Profile Primary Phonenumber |
Profiles |
Allows input of a telephone number. |
Sidekick |
|
| Profile Primary URL |
Profiles |
Allows input of a URL. |
Sidekick |
|
| Ratings |
Collaboration |
Visitor ratings. |
Sidekick |
|
| Reference |
General |
A reference to content on another page.
This allows reuse of content without redundant copies of that content.
Reference is linked to the original content so that changes to the original are automatically reflected.
|
Sidekick |
|
| Search |
General |
A search dialog with related search functionality. |
Sidekick |
search |
| Sitemap |
General |
A sitemap listing all pages. |
Sidekick |
|
| Slideshow |
General |
Dynamic slideshow that rotates through a set of selected images. |
Sidekick |
|
| Table |
General |
A table, with various formatting options. |
Sidekick |
table |
| Tag Cloud |
General |
A selection of tags from within your website is shown graphically, based on the volume of user visits to the appropriate web pages. |
Sidekick |
|
| Teaser |
Other |
A piece of content (usually an image) displayed on a main page to "tease" users into accessing the underlying content. |
Sidekick |
|
| Text |
General |
A text item. |
Sidekick |
richtexteditor |
| Text Image |
General |
Text with an accompanying image displayed to either the left or right. |
Sidekick |
textimagejcr |
| Title |
General |
Small text item used for titles or subtitles ( default value is the page title). |
Sidekick |
|
| Toolbar |
N/A |
Appears at the bottom of the page and is a navigational tool. |
Design Mode
|
|
| Topnav (Top navigation bar) |
N/A |
Appears at the top of the page and helps users navigate to the different content sections. |
Design Mode
|
|
| Trail (Breadcrumb) |
N/A |
Appears at the top of the page and shows users the path they have taken down through the hierarchy. |
Design Mode
|
|
| User State Toggle Button |
Collaboration |
Button to allow a user to change the state of a specific property in their profile. |
Sidekick |
|
| Video |
General |
Placing a video element on the page. |
Sidekick |
|
Annotating Components in Edit Mode
Adding content to your website is often subject to discussions prior to it actually being published. To aid this, many components directly related to content (as opposed, for example, to layout) can be annotated.
A basic annotation places a colored sticky-note on the page, in this a user can leave comments and/or questions for other authors. In addition to text, annotations also have a sketch feature that allows you to add simple line graphics; these can be useful for highlighting an area of the page, or starting to illustrate a scenario in connection with the annotation text.
Note
The definition of an individual component determines whether annotation is possible, or not, on instances of that component.
Note
Annotations are only visible in Edit mode of the author environment.
They are not visible on a publish environment, nor in the Preview or Design modes on an author environment.
Depending on the paragraph design, annotation is either available as an option on the context menu (usually the right-hand mouse button when over the required paragraph), or as a button on the paragraph edit bar.
In either case select Annotate. A colored sticky-note annotation will be applied to the paragraph, you are immediately in edit mode, allowing you to add text directly:
You can move the annotation to a new position on the page. Click on the top border area, then hold and simultaneously drag the annotation to the new position. This can be anywhere on the page, though it is usually meaningful to keep it connected to the paragraph in some way.
Annotations (including related sketches) are also included in any copy, cut or delete actions carried out on the paragraph to which they are attached; for copy or cut actions, the position of the annotation (and related sketches) retain their position in relation to the originating paragraph.
The size of the annotation can also be increased, or decreased, by dragging the bottom right corner.
For tracking purposes the footer line will indicate the user who created the annotation and the date. Subsequent authors can edit the same annotation (footer will be updated), or create a new annotation for the same paragraph.
Confirmation will be requested when you select to delete the annotation (deleting an annotation also deletes any sketches attached to that annotation).
Caution
Deleting a paragraph deletes all the annotations and sketches attached to that paragraph (irrespective of their position on the page as a whole).
Note
Depending on your requirements you can also develop a workflow to send notifications when annotations are added, updated or deleted.
The three icons at top left allow you to minimize the annotation (together with any related sketches), change the color and add sketches.
Note
Sketches are not available in Internet Explorer so:
- the icon will not be shown.
- existing sketches, created in another browser, will not be shown.
Sketches are a feature of annotations that allow you to create simple line graphics anywhere on the browser window (visible portion):

- The cursor will change to a crosswire when you are in sketch mode. You can draw multiple distinct lines.
- The sketch line reflects the annotation color and can be either:
- freehand
the default mode; finish by releasing the mouse button.
- straight:
hold down ALT and click the start and end points; finish with a double-click.
- After you have exited sketch modus, you can click on a sketch line to select that sketch.
- Move a sketch by selecting the sketch, then dragging it to the desired position.
- A sketch overlays the content. This means that within the 4 corners of the sketch you cannot click on the underlying paragraph; for example, if you need to edit, or access a link. If this becomes an issue (for example, you have a sketch covering a large area of the page) then minimize the appropriate annotation, as this will also minimize all related sketches, giving you access to the underlying area.
- To delete an individual sketch - select the required sketch, then press the Delete key (fn-backspace on a MAC).
- If you move, or copy, a paragraph then any related annotations and their sketches will also be moved, or copied; their position in relation to the paragraph will remain the same.
- If you delete an annotation all sketches attached to that annotation will be deleted too.
The Content Finder is a quick and easy way to find content within the repository when editing a page.
You can use the content finder to locate:
Or to browse the website by repository structure.
On all options you can search for specific items.
This tab lists any images in the repository.
After you have created an Image paragraph on your page, you can drag an item and drop it into the paragraph.
This tab lists any documents in the repository.
After you have created a Download paragraph on your page, you can drag an item and drop it into the paragraph.
This tab lists any movies (for example, Flash items) in the repository.
After you have created an appropriate paragraph (for example, Flash) on your page, you can drag an item and drop it into the paragraph.
This tab lists any products. After you have created an appropriate paragraph (for example, Product) on your page, you can drag an item and drop it into the paragraph.
This tab shows all pages. Double-click any page to open it for editing.
Referencing Paragraphs from other Pages
This tab allows you to search for another page. All paragraphs from that page will be listed. You can then drag a paragraph to your current page, this will create a reference to the original paragraph.
Using the Full Repository View
This tab shows all the resources in the repository.
Any tags and any resources that match the search pattern are listed:
You can also use wildcards for search. Supported wildcards are:
- *
matches a sequence of zero or more characters.
- ?
matches a single character.
Note
There's a pseudo property "name" which must be used to perform a wildcard search.
For example, if there is an image avaialable with the name:
ad-nmvtis.jpg
the following search patterns will find it (and any other images matching the pattern):
- name:*nmv*
- name:AD*
the character matching is not case sensitive.
- name:ad?nm??is.*
you can use any number of wildcards in a query.
Assets can be accessed from the Websites console, where the asset dialog is provided to manage certain properties of the assets.
To use the asset dialog:
- Open the Websites console.
- Navigate to the required folder under Digital Assets.
- Double-click on the asset to open the Asset Properties dialog. Here you can:
- Edit the asset
- Define a Title.
- Enter a Description
- Define Tags for the asset
- Click OK to save your changes.
Keyboard Shortcuts for Authoring
| Location |
Shortcut *
|
Description |
|---|
| Websites Console |
Shift-Double-Click
(on required page) |
Open page in new window.
Note: this is operational if the User Properties are set to Single Window; if Multiple Windows then this is the default behavior. |
| Content Window (Edit Mode) - Paragraphs |
Shift-Click |
Select multiple paragraphs. |
| |
Ctrl-Click |
Select multiple paragraphs. |
| |
Ctrl-C |
Copy selected paragraph(s). |
| |
Ctrl-X |
Cut selected paragraph(s).Note: The cut paragraph will not disappear until it has been pasted to the new location. |
| |
Ctrl-V |
Paste paragraphs from clipboard. |
| |
Alt-Ctrl-V |
Paste as reference. |
| |
Del |
Delete selected paragraph(s). |
| |
Backspace |
Delete selected paragraph(s). |
| |
Alt-right-click |
Force default (browser) context menu. |
Rich Text Editor
|
Ctrl-B
|
Bold |
| |
Ctrl-I
|
Italic
|
| |
Ctrl-U
|
Underline |
| Page with a teaser component. |
Ctrl-Alt-c |
Shows the client context. |
| Content Finder - Search box |
down-arrow |
Trigger a suggestions list. Needed when too few characters have been entered to trigger the list automatically (this happens when 2 or more characters have been entered). |
| |
right-arrow
(on a suggested path) |
Select item and trigger suggestions for the selected path. |
| |
left-arrow
(on a suggested path) |
Select item and trigger suggestions for its ancestors (as in siblings of parent). |
| |
Enter
(on a suggested path) |
Select item and trigger search. |
| |
Esc |
Close suggestions layer. |
| Drag assets, drop on destination |
Alt+drag |
The drop action produces a new paragraph; instead of replacing the asset in the destination. |
Keyboard Shortcuts for Development
| Location |
Shortcut *
|
Description |
|---|
| Page |
Ctrl-Shift-U
with
?debugClientLibs=true
set in the URL. |
To see timing statistics for page loading. |
Note
Both Ctrl and Command keys work on Mac OS.
|
|
Correct: Moderate content from social network
Changing "contente" to "content"
scott
If you are missing information related to any specific issue you can also ask on our CQ5 forum, which is a prime location for asking questions related to AEM:
http://forums.adobe.com/community/digital_marketing_suite/cq5
Hope that helps.
Note: Customers with DayCare user accounts need to create a new account for use on day.com.