Download the PHP package vynatu/menu without Composer

Find the API documentation here

• Introduction
  • Installation
• Creating a Menu
  • Setup the Service Provider
  • Create the New Menu
  • Add items to the menu
  • Registering the menu
  • Extending a menu
  • Accessing menu items in a menu instance
  • Setting variables to a menu item
• Views
  • Item iteration in views
• Tips

Introduction

This package is yet another menu library. This library is different than the others because:

• It is lazy loaded
• Any menu is extendable
• It is not loaded in a middleware
• Each menu declaration is in it's own class

This structure makes it perfect to modularize and extend your menus through the usage of different module libraries the laravel framework can support.

Installation

Vynatu/Menu only uses a single service provider.

First, install with composer:

Then, add the service provider to app.php:

Vynatu/Menu does not require an alias. You can call the menu manager directly using app('menu').

Creating a Menu

Setup the Service Provider

You can register menus in any service provider you use, but I prefer making a new service provider called MenuServiceProvider.

This allows you to better separate what the AppServiceProvider does and the new MenuServiceProvider that is solely used to register and extend menus.

Create a new service provider (using Artisan):

Don’t forget to register it in the providers!:

Create the New Menu

Vynatu/Menu comes with a console command that lets you create menu classes very easily.

We suggest you put your Menus in a sub-folder (app/Menus).

Or you can make the class yourself:

After creating your menu class, an instance of \Vynatu\Menu\RootMenuItem will automatically be injected in your MenuInstance.

Add items to the menu

You can add items to the menu by using the $this->menu instance.

Registering the menu

In the menu service provider you have previously created, add this to the boot method:

You don't have to use dependency injection. You can use app('menu')->register(...) instead.

Extending a menu

Do the same steps as creating and registering a menu, but instead of using the register method:

Accessing menu items in a menu instance

You can access any menu items in a menu instance this way:

The management variable is created automatically when a new menu item is added. snake_case is used to create the variable name.

This means that if you created an item like $this->menu->add('Management'), a new variable called management will exist and can be accessed by the local menu instance or any menu extender.

If you use _t to create menu names (which means the slug name will always change), you can set the slug name statically:

This allow your other extenders to access the management menu item and, for example, change its icon:

Setting variables to a menu item

There are two ways to do this.

The first one, using a function. It is useful to conserve the fluent API:

The second one, using a direct variable assignment:

Everything can be changed in an extender, including the route and URL.

Views

Item iteration in views

Here is an example using bootstrap navbar:

File Name: menus.main_menu

File Name: menu_elements (Also available under view('menu::bootstrap.default'))

This should achieve a menu looking like the default bootstrap navbar

Tips

• The __construct of your menu class works with dependency injection. Simply type hint the stuff you need in the parameter list and we'll ask Laravel to inject the stuff you need.