To enable tagging of content two properties are available the CMLinkable content type.

Editors can assign taxonomies to content items using CoreMedia Studio and the Blueprint taxonomy property editor. It allows for the following:

Figure 5.6. Taxonomy Property Editor

The user can add taxonomy keywords to the corresponding property link list using the taxonomy property editor. The editor also provides suggestions that are provided by the OpenCalais integration or a simple name matching algorithm. The strategy type can be configured in the preferences dialog of CoreMedia Studio.

Figure 5.7. Taxonomy Studio Settings

How taxonomies are loaded

A Blueprint taxonomy tree is built through content items located in a specific folder of the content repository. The default taxonomy resolver will then look for a "_root" settings document inside these folders and uses the taxonomy documents linked inside the LinkListProperty "roots" as top level nodes. If the "_root" document is not found, the taxonomy resolver checks for empty referrers of all taxonomy documents inside a taxonomy folder, to determine which node is a top level node of the given taxonomy tree. In that case, top level node documents must be placed directly within the root folder. Taxonomies of subsequent levels can also be placed in subfolders. The name of the folder in which the taxonomy tree is placed defines the name of the taxonomy tree and is visible as a root node in the taxonomy administration UI.

The lookup folders for taxonomies and the strategy used to build the tree are configured in the Spring configuration class TaxonomyConfiguration of the shared/taxonomies module. The bean properties

siteConfigPath

and

globalConfigPath

of the strategyResolver bean configure the folders that are used to find taxonomies. TaxonomyResolverImpl implements the TaxonomyResolver interface so that it is possible to implement other taxonomy detection strategies.

Warning

The default taxonomy implementation (DefaultTaxonomy.java) checks the taxonomy folder for write permissions. If these permissions are not granted, the taxonomy won't appear in Studio. Therefore, ensure that taxonomy administrators have Folder rights for taxonomy folders.

How to implement a new taxonomy resolver strategy

The TaxonomyResolverImpl implements the interface TaxonomyResolver and is injected to the TaxonomyResource in the component-taxonomies.xml. For every taxonomy request, the TaxonomyResource instance looks up the corresponding Taxonomy object using the resolver instance. To change the resolver strategy, inject another instance of TaxonomyResolver to the TaxonomyResource.

How to configure the document properties used for semantic strategies

The document properties that are used for a semantic evaluation are configured in the method SemanticTaxonomyConfiguration#semanticDocumentProperties of the shared/taxonomies module. The Spring configuration declares the abstract class AbstractSemanticService that new semantic service can extend from. The default properties used for a semantic suggestion search are:

How to implement a new suggestion/semantic strategy

To add a new semantic strategy to Studio, it is necessary to implement the corresponding strategy for it and add it to CoreMedia Studio.

A new semantic strategy can easily be created by implementing the interface SemanticStrategy. The result of a strategy is a Suggestions instance with several Suggestion instances in it. Each Suggestion instance must have a corresponding content instance in the repository whose content type matches that one used for the taxonomy. Blueprint uses CMTaxonomy documents for keywords of a taxonomy, so suggestions must be fed with these documents. Additionally, a float value weight can be set for each suggestion, describing how exactly the keyword matches from 0 to 1. After implementing the semantic strategy, the implementing class must be added to the Spring configuration, for example:

<customize:append id="semanticStrategyExamplesCustomizer" bean="semanticServiceStrategies" order="1000">
      <list>
      <ref bean="myMatching"/>
      </list>
      </customize:append>

Next the new suggestion strategy has to be added to Studio, so that is selectable in CoreMedia Studio.

How to remove the OpenCalais suggestion strategy

If you want to disable the OpenCalais integration, simple remove the corresponding AddTaggingStrategyPlugin entry from the TaxonomyStudioPlugin.ts configuration section.

How to add a site specific taxonomy

The logic how a site depending taxonomy tree is resolved is implemented in the TaxonomyResolver#getTaxonomy(String siteId, String taxonomyId) method.

To create a new site depending taxonomy proceed as follows:

Once the taxonomy has been set up, additional nodes can be created using the taxonomy manager. If the new taxonomy does not appear as new element in the column on the left, press the reload button. It ensures that the TaxonomyResolver rebuilds the list of available taxonomy trees. The new taxonomy is shown in the root column afterwards, include the site name it is created in.

Creating site specific taxonomies allows you to overwrite existing ones. For example you create a new taxonomy tree called Subject for site X and open an article that is located in a sub folder of site X, the regular Subject taxonomy property editor on the Taxonomies tab in CoreMedia Studio will access the Subject taxonomy of your new site, not the one that is located in the global Settings folders. The suggestions and the chooser dialog will also work in the new taxonomy tree.

How to configure the taxonomy property editor for a taxonomy

CoreMedia Blueprint comes with two types of taxonomies: Subject and Location. The name of the taxonomy matches the folder name they are located in, which is /Settings/Taxonomies. When the taxonomy property editor for a Studio form is configured, these IDs are passed to the property editor, for example

<taxonomy:taxonomyPropertyField propertyName="subjectTaxonomy"
                                                    taxonomyId="Subject"/>
      <taxonomy:taxonomyPropertyField itemId="locTaxonomyItemId"
                                      propertyName="locationTaxonomy"
                                      taxonomyId="Location"/>

As mentioned in the previous section, it is possible to overwrite the existing location or subject taxonomy with a site depending variant. In this case, it is not necessary to change the configuration for the property field. The taxonomy property editor will always try to identify the site depending taxonomy with the same name first. If this one is not found, the global taxonomy with the given id will be looked up and used instead. For custom site-specific taxonomy trees, the attribute value taxonomyId must match the name of the newly created taxonomy folder.

How to configure access to the taxonomy content / taxonomy administration

The taxonomy Studio plugin reads configuration values from global document /Settings/Options/Settings/TaxonomySettings. The configuration document TaxonomySettings contains the name of the user groups that are allowed to administrate taxonomies. Additional configuration files with the same name can be put in the folder Options/Settings (Relative paths will be concatenated with the root folder of the active site.). The entries of the files will be added to the existing configuration. Below the default taxonomy settings are shown.

<Struct xmlns="http://www.coremedia.com/2008/struct" xmlns:xlink="http://www.w3.org/1999/xlink">
      <StringListProperty  Name="administrationGroups">
      <String>global-manager</String>
      </StringListProperty>
      </Struct>

To ensure that the taxonomies are working properly, ensure that the user has the corresponding read and write rights to the settings and taxonomy folders. For taxonomy folders, ensure that also the Folder rights are set.