Taxonomy Plugin Configuration

Installation

The Taxonomy plugin can be added to your project using the setup application.

Prerequisites:

Instructions:

  1. Using Essentialsadd Taxonomy to your project.
  2. Rebuild and  restart your project.

Configuration

  1. In Essentials, navigate to Installed features.
  2. Find Taxonomy and click on the Configure button.
  3. To create a new, empty taxonomy, enter a name and choose the locales to include.
  4. Click on the Create new taxonomy button.

At this point, the configuration tool will show the option to add the taxonomy to your document types. Continue only if you are using version 15.2.

If you are using version 15.3 or newer, skip this step and use the Document Type Editor to add a taxonomy field to your document type(s) as explained in the following paragraph.

Add Taxonomy to Document Type (Taxonomy Field Type)

This feature is available since Bloomreach Experience Manager 15.3.0.

If you are using version 15.3 or newer, leave Essentials setup application and log in to the CMS as admin.

  1. Navigate to the Content application and select Document types in the dropdown in the top left.
  2. Browse to the document type to which you'd like to add a taxonomy field and open it in the editor.
  3. Under Primitive Field, select Taxonomy to add a taxonomy field to the document type.
  4. In the taxonomy field's configuration properties, enter the URL name of the taxonomy in taxonomy.name.
  5. Click on Done, then Type actions, Commit.

Add Taxonomy to Document Type (Legacy Taxonomy Mixin)

As of Bloomreach Experience Manager 15.3.0, the legacy mixin-based taxonomy field has been superseded by the taxonomy field type. However it is still supported through backward-compatibility.

If you are using version 15.2 or older, continue in the Essentials Taxonomy configuration tool:

  1. Select the document types to add taxonomy to, and choose the taxonomy to use.
  2. Click on the Add taxonomy to documents button.
  3. Use the BeanWriter tool to regenerate the content bean(s) for the document type(s) you added taxonomy to.

Manage Taxonomy

The taxonomy can now be managed in the Content application in the newly added Taxonomies section.

When editing documents that use a taxonomy, you can select categories from the taxonomy dialog.

To access the taxonomy from the delivery tier see Taxonomy Plugin Delivery Tier Configuration.

 

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?