If you need to learn how to tag a document, the following examples describe this process. There are two ways of tagging documents:
|•||You can add tags to a document either by using the Properties tab of the CMS Desk -> Content -> Edit interface (as described here).|
|•||Or you can use the Fields tab in Site Manager -> Development -> Document types -> Edit () <document_type> (as described here).|
1. Go to CMS Desk, switch to the Edit mode and select the document that you wish to tag from the content tree.
2. Switch to its Properties -> Metadata tab.
3. Choose a tag group using the Page tag group drop-down list. If you check the Inherit check-box, tag group will be inherited from the document's parent.
There needs to be at least one tag group defined for you to be able to tag a document. If there are no tag groups created, you will not be able to tag a document as each tag needs to belong to some tag group. You can learn about creating tag groups in the next chapter.
It is also recommended to select a tag group for the root of the content tree so that it could be inherited by the pages located under it.
4. Enter the tags into the Page tags field. Tags can be entered either manually or can be selected using the Select button. This button displays a list of all tags in the selected tag group. Check the appropriate tags' check-boxes and click OK.
5. Click Save. The entered tags will be saved and attached to the document.
When entering more than one tag into the Page tags field, the tags should be separated with a comma or a blank space. A combination of both in a single entry is also valid. The following examples are all valid entries for adding three tags - tag1, tag2 and tag3:
tag1, tag2, tag3
tag1 tag2 tag3
tag1, tag2 tag3
In case that you are entering a tag consisting of more than one word, you should enclose it within quotation marks. Multiple long tags can also be entered and can be also divided by both blank spaces and commas:
"long tag1", tag, "long tag2"
"long tag1" tag "long tag2"
Quotation marks can also be used for tags containing special characters that couldn't be used otherwise:
"tag@1", "tag#2", "long, strange: tag@#$"
The page tags field has also an insinuation function implemented. This functions offers you tags from the selected tag group while you are writing:
1. Go to Site Manager -> Development -> Document types and choose to Edit () a document type.
2. Switch to the Properties tab, click the New system attribute () icon to create a new system attribute and from the corresponding drop-down lists select the following values:
|•||Group: Document attributes|
|•||Attribute name: DocumentTags|
|•||Field type: Tag selector|
Click OK to save the changes.
If you need to create a custom document type with a tag selector, the tag selector must be bound to a system field.