Configure Tag Page URLs

Tag pages are automatically generated pages created from tagged content items. When a user clicks on a tag keyword link, the corresponding tag page is displayed. The tag page usually contains a brief article about or definition of the subject of the tag, followed by teasers and links leading to tagged content items.

Tag page URLs have the following structure by default:

publication-url/tags/tag-structure-name/tag-term

The URL of the tag page for the term bangladesh in the places tag structure, for example, would be:

www.example.com/tags/places/bangladesh

The tag page URLs are generated by a component called TagURLHelper. You can configure this component to generate different tag page URLs by adding a TagURLHelper.properties file to your common configuration layer (/etc/escenic/engine/common/com/escenic/framework/tag/TagURLHelper.properties) and setting the following properties:

path-prefix

This property determines the prefix placed after the publication URL and before the tag structure name. If, for example, you specified path-prefix=tagged-as then the example URL shown above would change to:

www.example.com/tagged-as/places/bangladesh

tagStructurePathPrefix.tag-structure-name

These properties can be used to change the URL string used for specific tag structures. If, for example, you specified tagStructurePathPrefix.places=geographical, then the example URL shown above would change to:

www.example.com/geographical/bangladesh

You can enter several such properties in order to redefine the URL strings for multiple tag structures.

A sample TagURLHelper.properties is included in the Widget Framework distribution (/misc/siteconfig/com/escenic/framework/tag/TagURLHelper.properties).

Including sections in tag page URLs

Prior to version 3, the tag pages generated by the Widget Framework (which were called topic pages) had URLs that included section components (www.example.com/sport/topic/bangladesh, for example). You can force the Widget Framework to continue generating these kinds of URLs by adding a TopicProcessor.properties file in publication's WEB-INF/classes/com/escenic/servlet/plugin-config/com/escenic/framework/topic/TopicProcessor.properties and setting the following property:

sectionSpecificTopicURIEnabled=true

A tag page for bangladesh in the places tag structure will then have a URL something like this:

www.example.com/sport/tags/places/bangladesh