Actions

Difference between revisions of "Module Class Suffix"

From Joomla! Documentation

(add glossary link, discuss leading space, and remove example and instead point to full tutorial)
Line 1: Line 1:
Page text taken from here; http://forum.joomla.org/viewtopic.php?f=40&t=70330
+
For a definition of Module Class Suffix, see the [[Glossary#Module_Class_Suffix | Joomla! Glossary]]. You can use The Module Class Suffix parameter to create unique CSS classes that allow you to style one module differently than others.
This page might also need editing!
+
  
 +
If you enter a Module Class Suffix with a leading space, a new CSS class will be created. If your parameter does not have a leading space, the CSS class "moduletable" is modified. The first method is often preferred, since then you don't break any of the existing styling for the module, and you only need to add new CSS code for the new styling.
  
You can use module class suffix to distinguish that module from others with regard to the css classes it uses.
+
If you don't use a leading space, you will need to copy all of the styling code for the "moduletable" class and duplicate it for the new CSS class before making your CSS changes.
  
Open the module that you want to style in your backend: Module->Site Modules->Module Name link. Add a suffix of your choice, say  _mymodulestyle ,  in the module class suffix parameter box, and save.  
+
See the tutorial [[Tutorial:Using_Class_Suffixes_in_Joomla!_1.5|Using Class Suffixes in Joomla! 1.5]] for a detailed example of using Page and Module Class Suffixes.
 
+
Then go to Site->Template Manager->Site Templates. Click the radio box for the template you're using; then click Edit CSS.
+
 
+
Scroll down to your css classes for modules. You'll probably see generic settings like the following:
+
 
+
 
+
table.moduletable {
+
  width            : 167px;
+
  border          : 1px solid #C0C0C0;
+
  margin-bottom    : 10px;
+
  margin-left      :10px;
+
}
+
 
+
table.moduletable th {
+
  font-size        : small; 
+
  font-weight      : bold;
+
  color            : #000; 
+
  background      : #FFF;
+
  text-align      : center;
+
  padding-left    : 3px;
+
  padding-right    : 11px;
+
  letter-spacing  : -1px;
+
  border-bottom    : 1px solid #999999;
+
}
+
 
+
table.moduletable td {
+
  padding          : 2px 4px;
+
  background      : #FFF;
+
  font-size        : x-small;
+
}
+
 
+
 
+
To begin the style for your the module you're working on, you might first duplicate those classes that interest you (leaving the original for modules you're not modifying. Then add to the duplicate(s) your suffix to the classes you want to change.  Say you want to change your module table heading class, you might do something like this:
+
 
+
 
+
table.moduletable_mymodulestyle th {
+
  font-size        : small; 
+
  font-weight      : bold;
+
  color            : #888; 
+
  background      : #FFF;
+
  text-align      : right;
+
  padding-left    : 3px;
+
  padding-right    : 11px;
+
  letter-spacing  : -1px;
+
  border-bottom    : 2px solid #999999;
+
}
+
 
+
 
+
If you use the developer extension in Firefox, it makes experimenting with and modifying css classes much easier: http://forum.joomla.org/index.php/topic,35531.0.html.
+

Revision as of 14:44, 16 January 2009

For a definition of Module Class Suffix, see the Joomla! Glossary. You can use The Module Class Suffix parameter to create unique CSS classes that allow you to style one module differently than others.

If you enter a Module Class Suffix with a leading space, a new CSS class will be created. If your parameter does not have a leading space, the CSS class "moduletable" is modified. The first method is often preferred, since then you don't break any of the existing styling for the module, and you only need to add new CSS code for the new styling.

If you don't use a leading space, you will need to copy all of the styling code for the "moduletable" class and duplicate it for the new CSS class before making your CSS changes.

See the tutorial Using Class Suffixes in Joomla! 1.5 for a detailed example of using Page and Module Class Suffixes.