U bekijkt help-inhoud voor de versie::

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  

In addition to pages and assets, tags are used for AEM Communities 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

  • 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 /etc/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

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
managing tags using the tag asministration console

Creating a Namespace

To create a new namespace, select the Create Namespace icon.  

The namespace is itself a tag, and need not contain any sub-tags.  However, to continue creating a taxonomy, create sub-tags, which in turn may be either leaf tags or container tags.

chlImage_1
creating tags and namespaces
  • 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

Selecting a namespace or other tag makes available the following operations :

chlImage_1

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.

chlImage_1

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.

chlImage_1
chlImage_1

Viewing Tag Properties

chlImage_1

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.

chlImage_1

Showing Tag References

chlImage_1

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.

chlImage_1

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.

chlImage_1

Creating Tags

chlImage_1

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.

chlImage_1
  • 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

chlImage_1

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.

chlImage_1

Moving Tags

chlImage_1

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.

 

Opmerking:

It is recommended that Authors only be allowed to edit the tag's title, not to move or rename tags.

chlImage_1
  • 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 current name of the tag. A new name may be entered.

  • select Save

Merging Tags

chlImage_1

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 will open a panel where the path to merge into may be selected.

chlImage_1
  • 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.

Opmerking:

After the merge, the Path originally selected will (virtually) no longer exist.

When a referenced tag is moved or merged, the tag is not physically deleted such that it is possible to maintain references.

Publishing Tags

chlImage_1

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

chlImage_1

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

chlImage_1

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

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, /etc/tag/mycommunity
    • select the checkbox in the Read column
    • select Save
chlImage_1
  • ensure all publish instances have same permissions
    • one approach is to create a package of the namespace on author
      • on Advanced tab, for AC Handling select Overwrite
    • replicate the package
      • choose Replicate from package manager

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

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.

chlImage_1

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 dialogs), 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.

Opmerking:

The tag cloud and the meta keywords in the standard page component use the localized tag titles based on the page language, if available.

Resources

Dit werk is gelicentieerd onder de Creative Commons Naamsvermelding/Niet-commercieel/Gelijk delen 3.0 Unported-licentie  De voorwaarden van Creative Commons zijn niet van toepassing op Twitter™- en Facebook-berichten.

Juridische kennisgevingen   |   Online privacybeleid