DocumentationAEM 6.4Authoring Guide

Selecting your UI selecting-your-ui

Last update: Wed May 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

Understanding the UIs

The author environment allows for:

Two graphical user interfaces are provided to achieve this. These are accessible through any modern browser.

  1. Touch-Enabled UI

    • This is the modern, default AEM UI.

    • It is predominantly grey, with a clean, flat interface.

    • Designed for use on both touch and desktop devices, the look and feel is the same on all devices, though viewing and selecting your resources differs slightly (taps versus clicks).

      • Desktop:

    screen_shot_2018-03-23at115248

    • Tablet devices (or desktop less than 1024 pixels wide):

    screen_shot_2018-03-23at115505

  2. Classic UI

    • This is the legacy UI and has been available in AEM for many years.
    • It is predominantly green.
    • It was designed for use on desktop devices.
    • The following documentation focuses on the modern UI. For information about authoring in the classic UI, see the Authoring documentation for the Classic UI.

    chlimage_1-232

Switching UIs

Although the touch-enabled UI is now the standard UI and feature parity has been nearly reached with the administration and editing of sites, there may be times when the user wishes to switch to the classic UI. There are several options for doing this.

NOTE
For details on the status of feature parity with the classic UI, see the Touch UI Feature Parity document.

There are various locations where you can define which UI is to be used:

CAUTION
Various options for switching to the classic UI are not immediately available out-of-the-box, they must be specifically configured for your instance.
See Enabling Access to Classic UI for more information.
NOTE
Instances upgraded from a previous version will retain the classic UI for page authoring.
After upgrade, page authoring will not be automatically switched to the touch-enabled UI, but you can configure this using the OSGi configuration of the WCM Authoring UI Mode Service ( AuthoringUIMode service). See UI Overrides for the Editor.

Configuring the Default UI for Your Instance configuring-the-default-ui-for-your-instance

A system administrator can configure the UI that is seen at startup and login by using Root Mapping.

This can be overridden by user defaults or session settings.

Setting Classic UI Authoring for Your Account setting-classic-ui-authoring-for-your-account

Each user can access his/her user preferences to define if he/she wishes to use the classic UI for page authoring (instead of the default UI).

This can be overridden by session settings.

Switching to Classic UI for the Current Session switching-to-classic-ui-for-the-current-session

When using the touch-enabled UI desktop users might want to revert to the classic (desktop only) UI. There are several methods to switch to the classic UI for the current session:

  • Navigation Links

    note caution
    CAUTION
    This option for switching to the classic UI is not immediately available out-of-the-box, it must be specifically configured for your instance.
    See Enabling Access to Classic UI for more information.

    If this is enabled, whenever you mouseover an applicable console, an icon appears (symbol of a monitor), tapping/clicking this will open the appropriate location in the classic UI.

    For examples, the links from Sites to siteadmin:

    screen_shot_2018-03-23at111924

  • URL

    The classic UI can be accessed using the URL for the welcome screen at welcome.html. For example:

    http://localhost:4502/welcome.html

    note note
    NOTE
    The touch-enabled UI can be accessed via sites.html. For example:
    http://localhost:4502/sites.html

Switching to Classic UI when Editing a Page switching-to-classic-ui-when-editing-a-page

CAUTION
This option for switching to the classic UI is not immediately available out-of-the-box, it must be specifically configured for your instance.
See Enabling Access to Classic UI for more information.

If enabled, Open the Classic UI is available from the Page Information dialog:

chlimage_1-49

UI Overrides for the Editor ui-overrides-for-the-editor

The settings defined by a user or system administrator can be overriden by the system in the case of page authoring.

  • When authoring pages:

    • Use of the classic editor is forced when accessing the page using cf# in the URL. For example:

      http://localhost:4502/cf#/content/geometrixx/en/products/triangle.html

    • Use of the touch-enabled editor is forced when using /editor.html in the URL or when using a touch device. For example:

      http://localhost:4502/editor.html/content/geometrixx/en/products/triangle.html

  • Any forcing is temporary and only valid for the browser session

    • A cookie set will be set dependent on whether touch-enabled ( editor.html) or classic ( cf#) is used.

  • When opening pages through siteadmin, checks will be made for the existence of:

    • The cookie
    • A user preference
    • If neither exist, it will default to the definitions set in the OSGi configuration of the WCM Authoring UI Mode Service ( AuthoringUIMode service).
NOTE
If a user has already defined a preference for page authoring, that will not be overridden by changing the OSGi property.
CAUTION
Due to the use of cookies, as already described, it is not recommended to either:
  • Manually edit the URL - A non-standard URL could result in an unknown situation and lack of functionality.
  • Have both editors open at the same time - For example, in separate windows.
recommendation-more-help
5f6f1f67-8db1-40cb-84e9-024e65b9fc4c