Tatter\Menus
Dynamic menus for CodeIgniter 4
Quick Start
- Install with Composer:
> composer require tatter/menus - Create your menus by extending
Tatter\Menus\Menu - Add your menu aliases to
Config\Menus - Apply
MenuFilterto all routes that need menus
Features
Menus provides dynamic menus across your application. Menus organizes and injects the menu content, so you can focus on building.
Installation
Install easily via Composer to take advantage of CodeIgniter 4's autoloading capabilities and always be up-to-date:
> composer require tatter/menus
Or, install manually by downloading the source files and adding the directory to app/Config/Autoload.php.
Configuration (optional)
The library's default behavior can be altered by extending its config file. Copy examples/Menus.php to app/Config/ and follow the instructions in the comments. If no config file is found in app/Config the library will use its own.
Usage
Building
Menus is built on Spatie\Menu with all of its wonderful, dynamic and fluent functionality. Use their documentation to craft your menus as simple or complex as you like:
Create your menus by extending Tatter\Menus\Menu. You will notice in the source code that Menu requires you to provide one method: public function __toString(): string;. You may use the supplied $builder property to access the underlying Spatie\Menu to build your menu, or provide your own HTML code or view() return. Some examples:
class MainMenu extends \Tatter\Menus\Menu
{
public function __toString(): string
{
return $this->builder
->link(site_url('/'), 'Home')
->link(site_url('/about'), 'About')
->html('
')
->link(site_url('/contact'), 'Contact')
->render();
}
}
class FruitMenu extends \Tatter\Menus\Menu
{
public function __toString(): string
{
return view('menus/fruit', ['active' => 'banana']);
}
}
Note: $builder is initialized with "set active" to the current URL. You may call setActive() again to remove or change the active menu item. Due to a limitation in Spatie\Menu with mixing relative and absolute URLs you must supply full URL values (e.g. with site_url()) to your Menu if you want to use this default "active" URL.
Deploying
Since Menu is Stringable it can be used in your view or layout files as is. However, Menus also comes with a Controller Filter that you can use to inject menu content directly into your responses. First you need to create an alias for each Menu class you would like to use. Create app/Config/Menus.php (or start with a copy from the examples folder) and add your menu classes to the $aliases array. For example:
class Menus extends \Tatter\Menus\Config\Menus
{
/**
* Menu class aliases.
*
* @var array
*/
public $aliases = [
'main' => \App\Menus\MainMenu::class,
'fruit' => \ShopModule\FruitMenu::class,
];
}
Once aliases are set up you can pass them as an argument to the MenuFilter for any route:
$routes->add('shop/(:any)', 'ShopModule\ShopController::show/$1', ['filter' => 'menus:fruit']);
Then in your view or layout put the placeholder token with the name of the alias target in double curly braces:
{{main}}
Fruit Shop
{{fruit}}
...
Note that sometimes it is preferable to apply the filter in bulk using app/Config/Filters.php. Unfortunately parameters are not yet supported in Config\Filters, but you can work around this by creating your own parameter-specific Filter:
Packaged Menus
Menus comes with some pre-made menus which can be used immediately or built on to create your own variants. All menus are in the Tatter\Menus\Menus namespace and extend the Menu class so can be used with the Filter or as any other menu you would make.
Breadcrumbs
The BreadcrumbsMenu is a special menu, using horizontal-style navigation links for nested content. This menu comes pre-styled for Bootstrap and defaults to the segments retrieved from the framework's IncomingRequest::$uri, but you may provide your own using the static methods set, get, push, and pop. Additionally, BreadcrumbsMenu::discover() will attempt to create a default menu. All these methods use the Breadcrumb class, a simple wrapper for the URL and display value. For example:
use Tatter\Menus\Breadcrumb;
use Tatter\Menus\Menus\BreadcrumbsMenu;
class Users extends Controller
{
public function show(int $userId)
{
// Get the User
$user = model('UserModel')->find($userId);
// Start with the default breadcrumbs
BreadcrumbsMenu::discover();
// Pop off the numeric last segment
BreadcrumbsMenu::pop();
// Replace it with the user's name
BreadcrumbsMenu::push(new Breadcrumb(current_url(), $user->name));
return view('users/show', ['user' => $user]);
}
}
... if you have the filter in place the rest is handled for you.
3 Oct 11, 2022
13 Dec 8, 2022
0 Oct 20, 2021
3 Nov 17, 2021
4.5k Jan 4, 2023
14 Dec 15, 2022
1 Jan 6, 2022
1.9k Dec 28, 2022
36 Oct 30, 2022
107 Dec 5, 2022
230 Nov 17, 2022
61 Dec 30, 2022
6 Oct 6, 2022
0 Jun 29, 2022
2.6k Dec 30, 2022
1.1k Jan 3, 2023
17.7k Dec 31, 2022
25 Oct 30, 2022
55 Dec 27, 2022