Tag Application

Tag Application

Tag pages with keywords and then navigate your wiki using these keywords. Also get RSS feeds on Tags to be notified when a new page is tagged with a specific keyword.

XWiki's tag feature lets you add keywords to your pages and retrieve all pages to which the keyword is associated. In addition, XWiki supports 2 different kinds of tagging: structured and unstructured tagging.

Unstructured tagging is like Del.icio.us tagging: any user can freely enter tags he considers suitable for a given page, whether those tags have already been used by others or not. Structured tagging requires the definition of a primary set of tags users will be able to choose from when willing to tag a page.

Tagging a page in unstructured mode

This is the tagging mode setup by default in a new XWiki instance. It is quite easy to add a tag to a page or a document. This allows the creation of your own folksonomy on your XWiki through the use of tags.

To add a tag go to the bottom of the page and click on the "+" next to the word "Tags".

A Pop-up will appear inviting you to add the tags, separated by comma. Type in the tags and click "Add".

A list of suggestions may appear while you are typing. This indicates tags you have already used, and may want to use again.

If you want to delete a tag all you have to do is click on "X" next to the tag as follows:

If you are using an XE version prior to 1.9 you will find the Tags field on the side of the page.

Tagging a page in structured mode

To access this feature, it is first necessary to define the set of tags to be used on the wiki. To do so, you need to go to the http://<server>/xwiki/bin/view/XWiki/TagClass page, edit it in class edition mode and enter the tags you want to use in the "Values" field. You can separate the tags using the "|" symbol (recommended), but also with a space or a ",".

Once this is done, you can choose between 2 ways of displaying those tags on a page in edit mode.

Checkbox Display

To setup the Checkbox display, you need to select "checkbox" on the TagClass page. Once this is done, users will be able to assign a tag to a given page by ticking the relevant box.

Select Display

If you would rather use the Select display, you need to choose "select" on the TagClass page. This way, users can select tags by clicking on them, selected tags for a page being shown highlighted in blue.

Accessing Tags

Once you have chosen to use one of the 2 tagging modes, you can get access to the list of tags and subscribe to them through RSS.

Retrieve a tag

Once a set of pages is tagged, you can retrieve them on the Tags Summary page of your wiki (http://<server>/xwiki/bin/view/Main/Tags). The page displays the list of all available tags.

View Pages For a Tag

Once you have selected (clicked on) a tag, you get the list of all pages tagged with the chosen keyword. In addition, you can even choose to get an RSS feed on a tag. Everytime someone adds the given tag to a page or changes a page tagged with the keyword, you will receive a notification. Find out more about RSS Feeds here.