Sitecore Hackathon 2019

LasVegans Team - Poland

• Tomasz Juranek
• Robert Debowski
• Rafal Dolzynski

Category: Best enhancement to the Sitecore Admin (XP) UI for Content Editors & Marketers

Customizable Content Tagging

LasVegans team would like to present to you Customizable Content Tagging module.

Module allows Content Authors to use buil-in Sitecore Cortex Content Tagging feature with custom tags root item(s) and custom tag items structure. This gives more flexibility, cause by default content tagging applies tags to items in standard _Semantics field and stores the tags in item buckets, which are not easy to manage or reuse.

Module is flexible and works with different tags structure, including custom or SXA.

Youtube Presentation Movie

---

Basic Usage

After the installation you need to configure the module by selecting your custom taxonomy structure in the fields in /sitecore/system/Modules/CustomTaggerSettings item:

Afterwards your content authors can use built-in "Tag Item" command from ribbon. New tags will appear in configured, content tags root item and they will by automatically applied to the selected content item:

Multisite Usage

By default module uses same the configuration defined in /sitecore/system/Modules/CustomTaggerSettings item for all sites.

To define different configurations for mutlisite solutions, where e.g. tags are defined in different root items, add more CustomTaggerSettings items and define site to settings mapping in configuration file:

<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/" xmlns:role="http://www.sitecore.net/xmlconfig/role/">
<sitecore role:require="Standalone or ContentManagement">
    <customTagger type="LV.Foundation.AI.CustomCortexTagger.Settings.Models.CustomTaggerSitesMappingsModel, LV.Foundation.AI.CustomCortexTagger.Settings">
        <sitesMappings hint="raw:AddCustomTaggerSitesMappings">
            <site name="website1" settingsItemPath="/sitecore/system/Modules/CustomTaggerSettings1"/>
            <site name="website2" settingsItemPath="/sitecore/system/Modules/CustomTaggerSettings2"/>
        </sitesMappings>
    </customTagger>
</sitecore>
</configuration>

Sample Configation for SXA

Sitecore SXA has its own Content Tags structure, to configure the module to work with SXA, create CustomTaggerSettings with following settings:

Installation

To use the module you will need to:

• Install Sitecore 9.1 (Initial Release)
• Configure content tagging provider. For example for Open Calais create new config file in {sitecore website root}\App_Config\Environment\Sitecore.ContentTagging.OpenCalais.config with following content:

<?xml version="1.0" encoding="utf-8" ?>
<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/" xmlns:role="http://www.sitecore.net/xmlconfig/role/">
    <sitecore role:require="Standalone or ContentManagement">
        <settings>
            <setting name="Sitecore.ContentTagging.OpenCalais.CalaisAccessToken" value="{your-token-value}" />
        </settings>
    </sitecore>
</configuration>

• Install LV.CustomizableTagger.zip package using Sitecore Installation Wizard.

Manual Installation/Install from Source

• Clone repository.
• Update publishUrl to your Sitecore instance URL in publishsettings.targets file.
• Update path in sourceFolderCustomTagger variable to your local repository folder in zz.LV.Foundation.Serialization.Settings.config file.
• Publish LV.Feature.AI.CustomCortexTagger and LV.Foundation.AI.CustomCortexTagger.Settings projects from Visual Studio.
• Publish LV.Foundation.Serialization project. This project contains Unicorn assemblies and configuration. If you already have Unicorn in your project you can deploy only zz.LV.Foundation.Serialization.Settings.config file.
• Go to http://your-sitecore-instance/unicorn.aspx and sync Foundation.CustomTaggerSettings project.

Test Website Deployment

Source code contains sample website, which can be used to test functionality of the module. To install it:

• Follow the steps for manual installation of the module
• Publish LV.Project.SamplePageTags project form Visual Studio.
• Go to http://your-sitecore-instance/unicorn.aspx and sync Project.SamplePageTags project.
• Test pages are installed under /sitecore/content/SampleTagsHome and /sitecore/content/SampleTagsData items.