Administering Tags administering-tags
Tags are a quick and easy method of classifying content within a website. They can be thought of as keywords or labels (metadata) that allow content to be more quickly found as the result of a search.
In Adobe Experience Manager (AEM), a tag can be a property of
-
a content node for a page (see Using Tags)
-
a metadata node for an asset (see Managing Metadata for Digital Assets)
In addition to pages and assets, tags are used for AEM Communities features
-
user generated content (see Tagging UGC)
-
Enablement Resources (see Tagging Enablement Resources)
Tag Features tag-features
Some of the features of tags within AEM include:
-
Tags can be grouped into various namespaces. Such hierarchies allow taxonomies to be built. These taxonomies are global throughout AEM.
-
The main restriction for newly created tags is they must be unique within a specific namespace.
-
A tag’s title should not include tag path separation chars (nor will they be displayed if present)
- colon
:
- delimits the namespace tag - forward slash
/
- delimits sub-tags
- colon
-
Tags can be applied by authors and site visitors. Irrespective of their creator, all forms of tags are made available for selection, both when assigning to a page, or when searching.
-
Tags can be created and their taxonomy modified by members of the “tag-administrators” group and members who have modification rights to
/content/cq:tags
.- A tag that contains child tags is referred to as a container tag
- A tag that is not a container tag is referred to as a leaf tag
- A tag namespace is either a leaf tag or container tag
-
Tags are used by the Search component to facilitate finding content.
-
Tags are used by the Teaser component, which monitors a user’s tag cloud to provide targeted content.
-
If tagging is an important aspect of your content
- make sure to package tags with the pages that use them
- make sure tag permissions enable read access
Tagging Console tagging-console
The Tagging console is used to create and manage tags and their taxonomies. One goal is to avoid having many similar tags relating to basically the same thing : for example, page and pages or footwear and shoes.
Tags are managed by grouping into namespaces, reviewing usage of exiting tags before creating new ones, and re-organizing without disconnecting the tag from currently referenced content.
To access the Tagging console :
-
on author
-
sign in with administrative privileges
-
from global navigation
- select
Tools
- select
General
- select
Tagging
- select
Creating a Namespace creating-a-namespace
To create a namespace, select the Create Namespace
icon.
The namespace is itself a tag, and does not to contain any sub-tags. However, to continue creating a taxonomy, create sub-tags, which in turn may be either leaf tags or container tags.
-
Title
(required) A display title for the namespace. -
Name
(optional) A name for the namespace. If not specified, a valid node name is created from the Title. See TagID. -
Description
(optional) A description of the namespace.
Once the required information is entered
- select Create
Operations on Tags operations-on-tags
Selecting a namespace or other tag makes available the following operations:
When the browser window is not wide enough to display all icons, then the right-most icons are grouped together under a ... More
icon, which will display a drop-down list of the hidden operation icons when selected.
Selecting a Namespace Tag selecting-a-namespace-tag
When first selected, if the namespace does not contain any tags, then the properties are displayed to the right, else the child tags are displayed. Each tag selected will display either the tags it contains or its properties if it does not have child tags.
To select the tag for operations, and to multi-select, only select the icon next to the title. Selecting the title will only display properties or open the tag to display its contents.
Viewing Tag Properties viewing-tag-properties
When a namespace or other tag is selected, selecting the View Properties
icon results in the display of information as to the name
, time of last edit, and number of references. If published, the time it was last published and the id of the publisher are shown. This information will appear in a column to the left of the tag columns.
Showing Tag References showing-tag-references
When a namespace or other tag is selected, selecting the References icon will identify the content to which the tag has been applied.
The initial display is a count of tags applied.
By selecting the arrow to the right of the count, the reference names are listed.
The path to the reference is displayed as a tool tip when hovering over a reference.
Creating Tags creating-tags
When a namespace or other tag is selected (by selecting the icon next to the title), a child tag may be created for the current tag by selecting the Create Tag
icon.
-
Title
*(required) *A display title for the tag. -
Name
*(optional) *A name for the tag. If not specified, a valid node name is created from the Title. See TagID. -
Description
*(optional) *A description of the tag.
Once the required information is entered
- select Create
Editing Tags editing-tags
When a namespace or other tag is selected, it is possible to alter the Title, Description, and provide localizations of the Title by selecting the **Edit
**icon.
After edits are made, select Save.
For details about adding language translations, see the section on Managing Tags in Different Languages.
Moving Tags moving-tags
When a namespace or other tag is selected, selecting the Move
icon will allow Tags Administrators and Developers to clean up the taxonomy by moving the tag to a new location or renaming it. When the selected tag is a container tag, moving the tag will move all child tags as well.
title
, not to move or rename tags.
-
Path
(readonly) The current path to the selected tag. -
Move to
Browse to the new path under which to move the tag. -
Rename to
Initially displays the currentname
of the tag. A newname
may be entered. -
select Save
Merging Tags merging-tags
Merging tags can be used when a taxonomy has duplicates. When tag A is merged into tag B, all the pages tagged with tag A will be tagged with tag B and tag A is no longer available to authors.
When a namespace or other tag is selected, selecting the Merge icon opens a panel where the path to merge into may be selected.
-
Path
(readonly) The path of the tag selected to be merged into another tag. -
Merge into
Browse to select the path of the tag to merge into.
Publishing Tags publishing-tags
When a namespace or other tag is selected, selecting the Publish icon to activate the tag in the publish environment. Similar to page content, only the selected tag is published, regardless of whether it is a container tag or not.
To publish a taxonomy (a namespace and sub-tags), the best practice is to create a package of the namespace (see Taxonomy Root Node). Be sure to apply permissions to the namespace before creating the package.
Unpublishing Tags unpublishing-tags
When a namespace or other tag is selected, selecting the Unpublish icon will deactivate the tag in the author environment and remove it from the publish environment. Similar to the Delete
operation, if the selected tag is a container tag, all of its child tags will be deactivated in the author environment and removed from the publish environment.
Deleting Tags deleting-tags
When a namespace or other tag is selected, selecting the Delete icon will permanently remove the tag from the author environment. If the tag was published, it is also removed from the publish environment. If the selected tag is a container tag, all of its child tags will be removed as well.
Setting Tag Permissions setting-tag-permissions
Tag permissions are ‘secure (by default)’; a best practice for the publish environment that requires read permission to be explicitly allowed for tags. Bascially, this is done by creating a package of the Tag Namespace after permissions have been set on author, and installing the package on all publish instances.
-
on author instance
-
sign in with administrative privileges
-
access the Security Console,
- for example, browse to http://localhost:4502/useradmin
-
in the left pane, select the group (or user) for which read permission is to be granted
-
in the right pane, locate the **Path **to the Tag Namespace
- for example,
/content/cq:tags/mycommunity
- for example,
-
select the
checkbox
in the Read column -
select Save
-
-
ensure all publish instances have same permissions
-
one approach is to create a package of the namespace on author
- on
Advanced
tab, forAC Handling
selectOverwrite
- on
-
replicate the package
- choose
Replicate
from package manager
- choose
-
Managing Tags in Different Languages managing-tags-in-different-languages
The title
property of a tag may be translated into multiple languages. Once translated, the appropriate tag title
may be displayed according to the user language or to the page language.
Defining Tag Titles in Multiple Languages defining-tag-titles-in-multiple-languages
The following describes how to translate the title
of the tag Animals from English into German and French.
Start by selecting the tag under the Stock Photography namespace and selecting the **Edit
**icon (see Editing Tags section).
The Edit Tag panel presents the ability to choose languages into which the tag title is to be localized.
As each language is selected, a text entry box appears into which the translated title may be entered.
Once all translations are entered, select Save to exit edit mode.
In general, the language chosen for the tag is taken from the page language, when available. When the tag
widget is used in other cases (for example, in forms or in dialog boxes), the tag language depends on the context.
Instead of using the page language setting, the Tagging console uses the user language setting. In the Tagging console, for the ‘Animals’ tag, ‘Animaux’ would be displayed for a user who sets the language to French in their user properties.
To add a new language to the dialog, see Adding a New Language to the Edit Tag Dialog.
titles
based on the page language, if available.Resources resources
-
Information about the tagging framework and extending and including tags in custom applications.