alnux/nette-breadcrumb

Simple Breadcrumbs navigation generator for Nette Framework

dev-master 2023-09-01 11:44 UTC

Requires

• php: 7.4|8.*
• nette/application: >=3.0

MIT

• Jakub Vitásek

• generator
• breadcrumbs
• nette

README

Simple Nette component creating Breadcrumb navigation.

Installation

The best way to install this component is throught Composer.

$ composer require alnux/nette-breadcrumb:dev-master

Or simply download this package and place it into your vendor directory.

Using

Create component in your presenter (idelly in BasePresenter) and add link to the main page -

protected function createComponentBreadCrumb()
{
	$breadCrumb = new \Alnux\NetteBreadCrumb\BreadCrumb();
	$breadCrumb->addLink('Main page', $this->link('Homepage:'), 'icon-homepage');

	return $breadCrumb;
}

In another presenter, when we want to add another link -

$this['breadCrumb']->addLink('Sub page')

to edit this link on any presenter's action you could use the next

$this['breadCrumb']->editLink('Sub page', $this->link('User:'), fa fa-dashboard)

and to remove

$this['breadCrumb']->removeLink('Sub page')

Calling it from templates

{control breadCrumb}

finally if you have your own template you can call with customTemplate($template) on the presenter class, by example

// on your component declaration (maybe called BasePresenter.php) 
$breadCrumb->customTemplate($this->context->getParameters()['appDir'].'/templates/@BreadCrumb.latte');

// or on your regular presenter
$this['breadCrumb']->customTemplate($this->context->getParameters()['appDir'].'/templates/@BreadCrumb.latte');

by the way context on presenters are deprecated, read this http://forum.nette.org/en/22075-context-on-presenter-is-deprecated?. so please take the necessary measures