NAME
RT-Extension-ExampleTheme - Example Theme Extension
DESCRIPTION
RT::Extension::ExampleTheme is a small example of the customizations users can make to change the look and feel of RT. These changes are saved as a theme for others to use.
RT VERSION
Works with RT 4.2, 4.4
INSTALLATION
perl Makefile.PL
make
make install
-
May need root permissions
- Edit your /opt/rt4/etc/RT_SiteConfig.pm Add this line:
-
Plugin('RT::Extension::ExampleTheme');
- Clear your mason cache
-
rm -rf /opt/rt4/var/mason_data/obj
- Restart your webserver
CONFIGURATION
To set this theme as the default RT theme (optional), add the following line to your RT_SiteConfig.pm
Set( $WebDefaultStylesheet, ('example-theme'));
Individual users can also select the theme they want on their preferences page.
EXAMPLE CONTENT
This extension provides some examples of ways to customize the style of RT. You can find more information in the RT Style Documentation.
CSS
To change the appearance of RT, you can modify any CSS files you copy from one of RT's base themes. In addition to copying and modifying the CSS set by RT, you can add your own and even do things like hide parts of the RT UI. See static/css/example-theme.css for an example of hiding the "Priority" field.
Javascript
RT uses jQuery, which provides many tools to modify the RT UI via javascript. To see an example of changing a label with jQuery, see static/js/example-theme.js, which changes "The Basics" on the ticket display page to "Ticket State". The trickiest part is often getting the selector right.
AUTHOR
Best Practical Solutions, LLC <modules@bestpractical.com>
BUGS
All bugs should be reported via email to
L<bug-RT-Extension-ExampleTheme@rt.cpan.org|mailto:bug-RT-Extension-ExampleTheme@rt.cpan.org>
or via the web at
L<rt.cpan.org|http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Extension-ExampleTheme>.
LICENSE AND COPYRIGHT
This extension is Copyright (c) 2017 Best Practical Solutions, LLC.
This is free software, licensed under:
The GNU General Public License, Version 2, June 1991