Laravel Dynamic Menu Tutorial (Best for Admin packages)
Contents
Thanks to this very Laravel topic over at Laravel.io and Josh Benham. I managed to find out how to make my very own dynamic menu. In this tutorial, I will show you exactly how it’s done. Hopefully, you will now be able to make amazing admin packages for Laravel.
For those that just want the package then you can download it the Laravel dynamic navigation package. Otherwise, continue below.
First off, I am doing this in my very own package. My directory structure will look pretty much like anyone else file structure which will be within the src/Package/Admin. Hopefully, you should be able to follow this along just fine. However, if you have any problems or even any suggestions for improvements then feel free to let me know.
Within my Admin folder, I create a new folder called services and create a file called ‘Menu.php’. This is the code you should type within this file…
services/Menu.php
<?php
namespace PackageAdminServices;
use Illuminate\Support\Facades\HTML;
use Illuminate\Support\Facades\Request;
use Illuminate\Support\Facades\URL;
class Menu {
protected $items;
protected $current;
protected $currentKey;
public function __construct() {
$this->current = Request::url();
}
/** Shortcut method for create a menu with a callback.
* This will allow you to do things like fire an even on creation.
* @param callable $callback Callback to use after the menu creation
* @return object
*/
public static function create($callback) {
$menu = new Menu(); $callback($menu);
$menu->sortItems(); return $menu;
}
/** Add a menu item to the item stack
* @param string $key Dot separated hierarchy
* @param string $name Text for the anchor
* @param string $url URL for the anchor
* @param integer $sort Sorting index for the items
* @param string $icon URL to use for the icon
*/
public function add($key, $name, $url, $sort = 0, $icon = null) {
$item = array(
'key' => $key,
'name' => $name,
'url' => $url,
'sort' => $sort,
'icon' => $icon,
'children' => array()
);
$children = str_replace('.', '.children.', $key);
array_set($this->items, $children, $item);
if ($url == $this->current) {
$this->currentKey = $key; }
}
/** Recursive function to loop through items and create a menu
* @param array $items List of items that need to be rendered
* @param boolean $level Which level you are currently rendering
* @return string
*/
public function render($items = null, $level = 1) {
$items = $items ?: $this->items;
$attr = array( 'class' => 1 === $level ? 'menu level-1' : 'level-' . $level );
$menu = '<ul' . HTML::attributes($attr) . '>'; foreach($items as $item) {
$classes = array('menu__item');
$classes[] = $this->getActive($item);
$has_children = sizeof($item['children']);
if ($has_children) {
$classes[] = 'parent';
}
$menu .= '<li' . HTML::attributes(array('class' => implode(' ', $classes))) . '>';
$menu .= $this->createAnchor($item);
$menu .= ($has_children) ? $this->render($item['children'], ++$level) : '';
$menu .= '</li>'; }
$menu .= '</ul>';
return $menu;
}
/** Method to render an anchor
* @param array $item Item that needs to be turned into a link
* @return string
*/
private function createAnchor($item) {
$output = '<a class="menu__item" href="' . $item['url'] . '">';
$output .= $this->createIcon($item);
$output .= $item['name'];
$output .= '</a>';
return $output;
}
/** Method to render an icon
* @param array $item Item that needs to be turned into a icon
* @return string
*/
private function createIcon($item) {
$output = ''; if($item['icon']) {
$output .= sprintf('<i class="glyphicon glyphicon-%s"></i>', $item['icon']);
} return $output;
}
/** Method to sort through the menu items and put them in order
* @return void
*/
private function sortItems() {
usort($this->items, function($a, $b) {
if($a['sort'] == $b['sort']) {
return 0;
}
return ($a['sort'] < $b['sort'] ? -1 : 1);
});
}
/** Method to find the active links
* @param array $item Item that needs to be checked if active
* @return string
*/
private function getActive($item) {
$url = trim($item['url'], '/');
if ($this->current === $url) {
return 'active current';
}
if(strpos($this->currentKey, $item['key']) === 0) {
return 'active';
}
return '';
}
}Get all that?
This code will set you up for all the behind-the-scenes stuff. Hopefully, most of it is pretty self-explanatory (like most of Laravel). The code should be well commented to give you a grasp on what is going on.
Next, we will make our navigation which will be within the views folder. I created an inc folder within my views to keep things tidy called ‘navigation.blade.php’. And my code goes a little like this…
<?php use PackageAdminServicesMenu; ?>
{{ Menu::create(function($menu) {
Event::fire('admin.menu.build', $menu); })
->render(); }}This will display your navigation, but the only trouble is that we haven’t actually built it. Here we have the code to build our dynamic navigation menu. Inside your AdminServiceProvider.php you need to add this line into your public function boot()
include __DIR__ . '/../../events.php';This will tell your package where to find the events page which will build up your navigation. Your events.php needs to be in the same place as your routes and filters. This should be in the src folder…
<?php
Event::listen('admin.menu.build', function($menu){
$menu->add('index', 'Index', URL::route('Admin::index.index'), 1, 'dashboard');
$menu->add('users', 'Users', URL::route('Admin::users.index'), 100, 'users'); });Here we use the event listen method used in Laravel to build our menu. The first part of our add method gives a key which enables a check to see if it’s the current page or not. The second part adds text to your link, URL::route will be the route name which you use in your routes.php. We then have these numbers which says where they should be displayed on the nav and users or dashboard is a font awesome icon.
Phew, that was a lot to take in…
Hopefully, this is enough to get anyone started on a dynamic nav, if you need to use it on more packages then just add the code to the service provider, add another event .php and then create similar code to that above which will build up your navigation even more.
I would also like to thank Josh Benham for his help and support. Check out the discussion at laravel.io.
If you would like to pull in the package I created then take a look at my next post. Laravel dynamic navigation package.
Feel free to add your own feedback in the comments below
If you’d like a weekly email in your inbox, please join the newsletter by entering your email address below.
By subscribing, you agree with Revue’s Terms and Privacy Policy.
Member discussion