Tags feature

vstags_url

This property is added to portal_properties->vscore_properties at install time of vsCore. If vsCore is already installed on a site, it has to be uninstalled, vscore_properties has to be deleted manually, and then vsCore has to be reinstalled. All property values will be lost.

vstags_url is set in the vsCore Configlet. It holds the relative URL to the folder of tag-smart-folders. For example, if the folder's URL is mysite/public_home/tagslist, then this property has to be equal to either public_home/tagslist (no URL rewriting) or just tagslist (URL rewriting in place).

vstagsapply

Call it as in http://www.mysite.org/vstagsapply and then click the Apply button. It runs through all the folders of the site and creates the property vs_tags (of type lines) for each document of the site and sets its value equal to the list of all those tag-smart-folders (see Part 1) the IDs of which are part of the document text.

So for example, if there is a tag-smart-folder with ID = Yoga and the word Yoga happens to be part of a given document, then Yoga will be added to the vs_tags property of this document.

portlet_vstags

This portlet comes up once a document with a non-empty vs_tags property is browsed, and displays a list of URLs to the corresponding tag-smart-folders the IDs of which are mentioned by vs_tags.

main_template calling vstagssecollect.py

Captures search requests that come from Google, and gets the keywords that have been searched.

The main_template calls the script vstagssecollect.py once for every request and checks if the request is coming from Google. If such is the case, the property se_tags (of type lines) will be added to the current document (provided it doesn't exist already). All search tokens that are part of the SE-referral-URL will then be added to se_tags.

vstagsse

Call it as in http://www.mysite.org/myfolder/vstagsse. A list of all search tokens that have been added to any document's se_tags property (see Part 4), recursively in myfolder and all subfolders, will be displayed. Edit this list by deleting all tokens that shall NOT become tags. Then click the Apply button. For all remaining tokens, there wil now be created a tag-smart-folder (see Part 1). vstagsapply will have to be run afterwards.

vstagssereset.py

Call it as in http://www.mysite.org/vstagssereset. This will reset the se_tags property for all documents of the site. This is necessary since vstagssecollect (see Part 4) only adds to se_tags, so these properties' values would become unreasonably long over time.

We agreed on the following modifications:

1. tag+URL list in vstagsse: underneath the tags selection
2. delete se-tags after apply has been clicked in vstagsse
3. se_tags values reception not from main_template, but from log files
4. don't save se_tags that are not part of the document