RTx::Tags(3p)         User Contributed Perl Documentation        RTx::Tags(3p)



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
       o   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.

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

       o   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

AUTHOR
       Jerrad Pierce <jpierce@cpan.org>

       A customized version of Leon Brocard's HTML::TagCloud is also included.

LICENSE
       The same terms as perl itself.



perl v5.12.2                      2008-12-20                     RTx::Tags(3p)
