RT 4.2.11, ticket#13852
[freeside.git] / rt / docs / customizing / styling_rt.pod
index c5802a8..7e37d00 100644 (file)
@@ -12,18 +12,22 @@ RT versions have a default, and the RT admin can set the system-wide
 theme with the C<$WebDefaultStylesheet> configuration value in the
 F<RT_SiteConfig.pm> file.
 
-RT 4.0 comes with the following themes:
+RT comes with the following themes:
 
 =over
 
-=item web2
+=item rudder
 
-An approximation of the 3.8 style
+The default layout for RT 4.2
 
 =item aileron
 
 The default layout for RT 4.0
 
+=item web2
+
+An approximation of the 3.8 style
+
 =item ballard
 
 Theme which doesn't rely on JavaScript for menuing
@@ -32,14 +36,14 @@ Theme which doesn't rely on JavaScript for menuing
 
 If you have granted the ModifySelf right to users on your system,
 they can pick a different theme for themselves by going to
-Logged in as -> Settings -> Options and selecting a different theme.
+Logged in as -> Settings -> Preferences and selecting a different theme.
 
 
 =head1 RT Theme Editor
 
 RT has some built-in controls to manage the look of the theme you select.
 To use the Theme Editor, log in as a SuperUser (like root), and navigate
-to Tools -> Configuration -> Tools -> Theme.
+to Admin -> Tools -> Theme.
 
 =for html <img alt="RT theme editor, defaults" src="../images/theme_editor_defaults.png">
 
@@ -89,38 +93,18 @@ default CSS styles, via the C<@CSSFiles> configuration option.  To add
 an extra CSS file, for example F<my-site.css>, create the local overlay
 directory:
 
-    $ mkdir -p local/html/NoAuth/css/
+    $ mkdir -p local/static/css/
 
 And place your F<my-site.css> file in it.  Finally, adjust your
 C<@CSSFiles> in your F<RT_SiteConfig.pm>:
 
     Set( @CSSFiles, ('my-site.css') );
 
-This technique is preferred to callbacks (below) because CSS included
-via this way will be minified.  It is also included across all styles,
-unlike the callback technique.
+CSS added this way is included across all themes.
 
 If you are writing an extension, see L<RT/AddStyleSheets> for how to
 simply and programmatically add values to C<@CSSFiles>.
 
-=head2 Callbacks
-
-RT's CSS files are also Mason templates and the main CSS file,
-conveniently called C<main.css>, has a C<Begin> and C<End> callback
-allowing you to inject custom CSS.
-
-To create an End callback, create the callback directory and an
-End file in that directory:
-
-    $ mkdir -p local/html/Callbacks/MyRT/NoAuth/css/aileron/main.css
-    $ touch local/html/Callbacks/MyRT/NoAuth/css/aileron/main.css/End
-
-You can use any name you want for the C<MyRT> directory and the theme
-directory should correspond with the theme you want to change.
-
-RT will now evaluate the contents of that file after it processes all
-of the C<@import> statements in C<main.css>.
-
 
 =head1 Designing Your Own Theme
 
@@ -134,11 +118,11 @@ local modifications to RT. Run the following commands in your
 C</opt/rt4> directory (or wherever your RT is installed) to get
 started:
 
-    $ mkdir -p local/html/NoAuth/css/localstyle
-    $ cp -R share/html/NoAuth/css/aileron/* local/html/NoAuth/css/localstyle/
+    $ mkdir -p local/static/css/localstyle
+    $ cp -R share/static/css/rudder/* local/static/css/localstyle/
 
 You can call your "localstyle" directory whatever you want and you don't
-have to copy the aileron theme to start from, but it's a good place to
+have to copy the rudder theme to start from, but it's a good place to
 start off for RT4.
 
 Now set C<$WebDefaultStylesheet> in RT_SiteConfig.pm to the new directory
@@ -147,7 +131,7 @@ name you selected, for example:
     Set( $WebDefaultStylesheet, 'localstyle' );
 
 If you restart your RT it should look just the same (assuming you copied
-your current default theme), but if you go to your Options page you'll
+your current default theme), but if you go to your Preferences page you'll
 see that the system default theme is now your new "localtheme."
 
 If you look at the CSS being loaded, you'll also see that the main css