Customizing the Welcome Console (Classic UI)

The Welcome console provides a list of links to the various consoles and functionality within AEM.

It is possible to configure the links that are visible. This can be defined for specific users and/or groups. The actions to be taken are dependent on the target type (which correlates to the section of the console they are in):

• Main Consoles - Links in the main console (left pane)
• Resources, Documentation and Reference, Features - Links in the sidebar (right pane)

This lists the main consoles of AEM.

Node level permissions determine whether the link can be seen or not. The nodes in question are:

• Websites
  /libs/wcm/core/content/siteadmin
• Digital Assets
  /libs/wcm/core/content/damadmin
• Community
  /libs/collab/core/content/admin
• Campaigns
  /libs/mcm/content/admin
• Inbox
  /libs/cq/workflow/content/inbox
• Users
  /libs/cq/security/content/admin
• Tools
  /libs/wcm/core/content/misc
• Tagging
  /libs/cq/tagging/content/tagadmin

For example:

• To restrict access to Tools, remove read access from
      /libs/wcm/core/content/misc
  

See the Security section for more information on how to set the desired permissions.

These links are based on the existence of and read access to nodes under the following path:

/libs/cq/core/content/welcome

There are three sections (spaced slightly apart) provided by default:

It is possible to hide a link from specific users or groups by removing read access to the nodes that represent the link.

• Resources - remove access to:
      /libs/cq/core/content/welcome/resources/<link-target>
• Docs - remove access to:
      /libs/cq/core/content/welcome/docs/<link-target>
• Features - remove access to:
      /libs/cq/core/content/welcome/features/<link-target>

For example:

• To remove the link to Reports, remove read access from
      /libs/cq/core/content/welcome/resources/reports
  
• To remove the link to Packages, remove read access from
      /libs/cq/core/content/welcome/features/packages

See the Security section for more information on how to set the desired permissions.

In /libs/cq/core/components/welcome/welcome.jsp use is made of ConsoleUtil, which executes a query on nodes that have the property:

• jcr:mixinTypes with the value: cq:Console  

When a user or group does not have read permission on a node with the mixin cq:Console, that node is not retrieved by the ConsoleUtil search, hence it is not listed on the console.

The link selection mechanism can be used to add your own custom item to the list of links.

Add your custom item to the list by adding the cq:Console mixin to your widget or resource. This is done by defining the property:

• jcr:mixinTypes with the value: cq:Console