Tags

Features

• Tags are added on the record itself: anyone trusted with content sees a «Tags» field under the text and enters tags separated by commas. Other modules' editors stay untouched.
• Works with any record a module serves as the subject of a page, including modules added later. Up to six tags per record.
• Readers see a list of tag links under the record. If there are no tags and no permission to add them, the block is not rendered at all.
• A tag cloud in the sidebar: more frequent tags are larger (can be switched off), and the number of tags is configurable. The all-tags page is sorted alphabetically.
• A record's title, address and language are stored as a snapshot: a tag page is built with a single query and stays readable even when the owning module is turned off.
• A tag with no records is removed automatically.
• In the admin panel — «Site tags»: search, usage count, renaming, merging duplicates with their links carried over, deletion.

Settings

In the admin panel: «Settings», section «Tags», group «General».

• Tags in the cloud — 5 to 200, default 25.
• Bigger means more — tag size in the cloud follows the number of records; on by default.

Permissions

• Tag records — the «Tags» field on records and the «Site tags» section in the admin panel. Granted to administrators and editors on install.

On the site

• /tags — all site tags.
• /tags/{tag-address} — records with this tag.
• The «Tags» block under a record and the «Tags» cloud block in the sidebar (the cloud is hidden on the home page by default). Both are moved in «Appearance → Home & blocks».

Installation and removal

Creates the tables tags (tags) and taggables (which tag is on which record). Uninstalling the module with its data drops both tables along with all tags; the site's records themselves are not affected.

Left out on purpose

The forum has its own tags, and the shared table does not replace them: the forum installs without other modules and must not depend on them.