NAME
    RTx::Tags - Tag Cloud support for RT with simple-searchable custom
    fields.

DESCRIPTION
    This module uses portions of HTML::TagCloud to provide a tag cloud on
    Search/Simple.html The cloud consists of the values (split on commas,
    semi-colons and whitespace) for all objects with the `Tags' custom
    field.

    In addition to the cloud, this module provides support for Simple
    Searchable Custom Fields witha Local overlay. An explanation of this
    feature is also shown on Search/Simple.html

INSTALL
    #   Install HTML::TagCloud

    #   Install this module i.e; extract to local/plugins/RTx-Tags & amend
        RT_SiteConfig.pm to include *RTx::Tags* to `@Plugins'.

        These first steps may be accomplished via CPAN(PLUS) with
        auto-dependencies.

    #   No patching necessary! If you've previously applied
        SearchCustomField from the wiki or email list, or installed version
        0.021 of this module, it is recomended that you revert the patch. No
        harm will come from not doing so, but it's best to keep RT core
        files vanilla where possible.

    #   Create a custom field named `Tags'. The recommended type is *Enter
        one value* with *Applies to Tickets*. The recommended Description is
        *Freeform annotation for ready searching*.

    #   Apply the Custom Field to the desired queue(s).

    #   Optionally add *TagCloud* to `$HomepageComponents' in
        RT_SiteConfig.pm if you would like users to have the ability to
        display a Tag Cloud on the front page, and not just the Simple
        Search page.

CAVEATS
    *   Due to limitations in the available callbacks, the CF search blurb
        and tags cloud are output before the core search mechanism blurbs on
        Simple Search; postform is ugly.

    *   Due to limitations in the available callbacks, every page links to
        cloud.css, which has also been hard-coded to 26 levels.

    *   Due to the mechanism used to implement the CF search, the presence
        of another Search/Googleish_Local.pm will likely not result in
        behavior you desire. Should you wish to make further local
        customizations, either modify this module's code, or use
        Googleish_Vendor.pm

LICENSE
    The same terms as perl itself.