Actions

Using a custom image in the menu bar title

From Joomla! Documentation

Revision as of 21:15, 6 May 2008 by Maintenance script

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Using a custom image in the Menu Bar title

To use a custom image in the Menu Bar title we need an image (obviously) and a little bit of css.

First off, create the following folders in your administrator component (we're using a ficticious component called com_notes as the example). Then place your image in the images folder and create a new file called default.css in the css folder, like this:

com_notes
|- assets
..|- css
....|- default.css
..|- images
....|- logo.png

The code for the css file looks like this:

/* Toolbar */
 
.icon-48-notes {
    background: url(../images/logo.png) no-repeat left;
}

Next we tell the menubar handler function to use this css by the following invocation of the title method of JMenuBar:

JMenuBar::title( JText::_( 'Notes List' ), 'notes' );

Notice that value of the second argument, notes, marries with the suffix of the css class.

Finally we need to load the component custom css file. Place the following code typically near the top of admin.notes.php:

$document =& JFactory::getDocument();
$document->addStyleSheet('/components/com_notes/assets/css/default.css');

You can, of course, use default.css for more than just the title styling.