[cvs] [Wiki] changed: ThemesHowTo

Wiki Guest wiki at wiki.horde.org
Mon Oct 18 03:20:45 PDT 2004


guest [80.117.173.178]  Mon, 18 Oct 2004 03:20:45 -0700

Modified page: http://wiki.horde.org/display.php?page=ThemesHowTo
New Revision:  1.7

@@ -2,18 +2,18 @@
 
 Creating a new theme for Horde is as simple as creating a new directory under {{horde/themes/}} and adding the files {{info.php}} and {{screen.css}}.
 
 The {{info.php}} contains information regarding the stylesheet. For now this is limited to the name of the theme and an optional line to indicate substitution of icons.
-In its simples form this file only needs to contain a single line:
+So, in its simplest form this file only needs to contain a single line:
 
 <code type="php">
 <?php
 $theme_name = _("My Theme Name");
 </code>
 
 This is the theme name as it will appear in the theme list in the users' display options. The internally used theme name that you can use to set a default theme in {{horde/config/prefs.php}} is determined from the directory name you use.
 
-Let's say your new theme is in {{horde/themes/mytheme/}}, then the internal name of this theme would be "mytheme" while the users will see it as "My Theme Name".
+Let's take the example of your new theme is in {{horde/themes/mytheme/}}, then the internal name of this theme would be "mytheme" while the users will see it as "My Theme Name".
 
 If you want to contribute your theme to the Horde Project or make it publically available elsewhere, you should add some comments to the file header to explain where the theme comes from:
 
 <code type="php">
@@ -31,15 +31,15 @@
 ++ Defining theme colors and styles
 
 This alone doesn't make a theme of course, now you want to create you own set of colors and styles for your theme.
 
-The {{screen.css}} file you can then use to override the default Horde styles. It is a regular static css file, so if you know how CSS works and look at some of the existing theme files you could easily find out how to change certain colors, fonts, lines etc. You should //not// start with a copy of the "master" theme file {{themes/horde/screen.css}} but you should instead only define those CSS rules that you want to overwrite. This way you make sure that your theme doesn't miss any important style if the master theme file gets extended at some point in the future.
+You can use the {{screen.css}} file to override the default Horde styles. It is a regular static css file, so if you know how CSS works and look at some of the existing theme files you could easily find out how to change certain colors, fonts, lines etc. You should //not// start with a copy of the "master" theme file {{themes/horde/screen.css}} but you should instead only define those CSS rules that you want to overwrite. This way you make sure that your theme doesn't miss any important style if the master theme file gets extended at some point in the future.
 
 ++ Adding icon sets
 
-If you want to add custom icons to your theme you first need to create a {{graphics/}} folder in your theme's directory, in our example theme this would be {{themes/mytheme/graphics/}}. Then you need to copy **all** existing icons from {{themes/horde/graphics/}} **including** the subdirectories into your theme folder.
+If you want to add custom icons to your theme you first need to create a {{graphics/}} folder in your theme's directory, in our example theme this would be {{horde/themes/mytheme/graphics/}}. Then you need to copy **all** the existing icons from the default theme directory {{horde/themes/horde/graphics/}}, **including** any subdirectories, into your theme folder.
 
-Then extend your theme file with a line so that it looks like:
+Now you need to extend your theme file with a line so that it looks like:
 
 <code type="php">
 <?php
 /**
@@ -54,9 +54,9 @@
 </code>
 
 Now start replacing the icons in your theme folder with your own ones.
 
-If you want to create custom icons for other applications, simply create similar folders in the application's {{themes/}} directory as well, for example {{imp/themes/mytheme/graphics/}}. Then add the application name to the {{$theme_icons}} list, for example:
+The {{$theme_icons}} variable is an array which will indicate to Horde that there are replacement icons available for the listed modules. So if you want to create custom icons for other applications, simply create similar folders in the application's {{themes/}} directory as well, for example {{imp/themes/mytheme/graphics/}}. Then add the application name to the {{$theme_icons}} list, for example:
 
 <code type="php">
 $theme_icons = array('horde', 'imp');
 </code>


More information about the cvs mailing list