How to add breadcrumbs: Difference between revisions
From Joomla! Documentation
Remove 1.6 and 1.7 tags |
Add JSplit Tag |
||
| Line 1: | Line 1: | ||
{{version/tutor|1.5,2.5}} | {{version/tutor|1.5,2.5}}{{JSplit}} | ||
Breadcrumbs are nice way to display the connection from the root. It gives you a hierarchical representation with click able links so that user can visit upper links easily. Breadcrumbs can be added in templates by using the object returned by $mainframe->getPathWay(). The member function addItem() allows to add a breadcrumb with the title of choice. | Breadcrumbs are nice way to display the connection from the root. It gives you a hierarchical representation with click able links so that user can visit upper links easily. Breadcrumbs can be added in templates by using the object returned by $mainframe->getPathWay(). The member function addItem() allows to add a breadcrumb with the title of choice. | ||
Revision as of 12:40, 28 May 2013
It has been suggested that this article or section be split into specific version Namespaces. (Discuss). If version split is not obvious, please allow split request to remain for 1 week pending discussions. Proposed since 13 years ago.
Breadcrumbs are nice way to display the connection from the root. It gives you a hierarchical representation with click able links so that user can visit upper links easily. Breadcrumbs can be added in templates by using the object returned by $mainframe->getPathWay(). The member function addItem() allows to add a breadcrumb with the title of choice.
There are two parameters used for breadcrumbs creation process, and the first parameter is the title for the breadcrumb and the second parameter is the URL. If we do not need the breadcrumb to work like a link then we need to simply pass a blank string and then it will not work like a click able URL. This term is useful for hierarchical components where we have subcategories: we can generate a link to each and then end with the title of the current record or category.
The JPathway is currently used by the breadcrumbs module. If you are adding a new component and have already configured breadcrumbs, you may need to go into the breadcrumbs configuration and add the menu item for you component to the selection on the menu selelist.
Example
A view's view.php could look something like this.
class exampleViewdefault extends JView {
function display($tpl = null) {
$mainframe = &JFactory::getApplication();
$document = &JFactory::getDocument();
$pathway =& $mainframe->getPathway();
JHTML::_('behavior.modal');
$model =& $this->getModel();
$data = $model->getData();
$this->assignRef( 'events', $data);
$document->setTitle( $this->events['name'] );
$pathway->addItem($this->events['name'], '');
parent::display($tpl);
}
}
The display function from a view's view.php for joomla 2.5 could look something like this.
public function display($tpl = null)
{
$app = JFactory::getApplication();
$pathway = $app->getPathway();
$pathway->addItem('My Added Breadcrumb Link', 'http://www.yourdomain.tld');
parent::display($tpl);
}