{"id":20541628,"url":"https://github.com/adelf/laravel-menu","last_synced_at":"2025-04-14T09:06:34.433Z","repository":{"id":56940658,"uuid":"139747910","full_name":"adelf/laravel-menu","owner":"adelf","description":"Convenient menu component for Laravel","archived":false,"fork":false,"pushed_at":"2018-12-08T12:51:40.000Z","size":26,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-14T02:35:50.051Z","etag":null,"topics":["laravel","laravel-5-package","menu"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adelf.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-07-04T17:00:45.000Z","updated_at":"2020-04-30T14:09:41.000Z","dependencies_parsed_at":"2022-08-21T07:20:10.709Z","dependency_job_id":null,"html_url":"https://github.com/adelf/laravel-menu","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adelf%2Flaravel-menu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adelf%2Flaravel-menu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adelf%2Flaravel-menu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adelf%2Flaravel-menu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adelf","download_url":"https://codeload.github.com/adelf/laravel-menu/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248852161,"owners_count":21171842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","laravel-5-package","menu"],"created_at":"2024-11-16T01:25:00.378Z","updated_at":"2025-04-14T09:06:34.387Z","avatar_url":"https://github.com/adelf.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel Menu\n\n[![Latest Version on Packagist][ico-version]][link-packagist]\n[![Software License][ico-license]](LICENSE)\n[![Scrutinizer][ico-scrutinizer]][link-scrutinizer]\n\nSimple component for creating menus in Laravel. Instead of using controllers or creating huge blade templates suggests only one configuration file.\n\nExample (**resources/menu/default.php**):\n\n```php\n\u003c?php\n\nreturn [\n    //'template' =\u003e 'menu.menu', // custom blade template can be provided here\n\n    'items' =\u003e [\n        [\n            'name' =\u003e 'Home',\n            'link' =\u003e route('dashboard'),\n            'active' =\u003e activeMenuController(\\App\\Http\\Controllers\\DashboardController::class),\n            'icon' =\u003e 'home',\n        ],\n        [\n            'name' =\u003e 'Users',\n            'auth' =\u003e authMenuCan('manageUsers'), // Will be shown if user \"can\" 'manageUsers'.\n            // Gate::check('manageUsers') will be checked\n            'link' =\u003e '/users',\n            'active' =\u003e activeMenuUrlPrefix('users'), // Will be active for all '/users*' URL's\n            'icon' =\u003e 'user',\n        ],\n        [\n            'name' =\u003e trans('complex.auth'),\n            'auth' =\u003e function (){\n                return Gate::check('one') || Gate::check('two');\n            },\n            'link' =\u003e '/complex-auth',\n            'active' =\u003e activeMenuUrlPrefix('complex-auth'),\n            'icon' =\u003e 'complex',\n        ],\n        [\n            'name' =\u003e 'Group',\n            'icon' =\u003e 'group',\n            'items' =\u003e [\n                [\n                    'name' =\u003e 'Orders',\n                    'link' =\u003e '/orders', // route('orders'),\n                    'active' =\u003e activeMenuController(\\App\\Http\\Controllers\\OrdersController::class),\n                    'icon' =\u003e 'orders',\n                ],\n                [\n                    'name' =\u003e 'Bar',\n                    'link' =\u003e '/bar', // route('bar'),\n                    'active' =\u003e activeMenuController(\\App\\Http\\Controllers\\BarController::class),\n                    'icon' =\u003e 'bar',\n                ],\n            ],\n        ],\n    ],\n];\n```\n\nBlade template for one-level menus can be very simple:\n```blade\n\u003c!-- Example of menu template with Bootstrap and FontAwesome icons--\u003e\n\u003cnav class=\"navbar navbar-default\"\u003e\n    \u003cul class=\"nav navbar-nav\"\u003e\n        @foreach($items as $item)\n            \u003cli @if($item['active']) class=\"active\" @endif\u003e\n                \u003ca href=\"{{$item['link']}}\" title=\"{{$item['name']}}\"\u003e\n                    \u003ci class=\"fa fa-{{$item['icon']}}\"\u003e\u003c/i\u003e {{$item['name']}}\n                \u003c/a\u003e\n            \u003c/li\u003e\n        @endforeach\n    \u003c/ul\u003e\n\u003c/nav\u003e\n```\n\nFor two-level menus it's more complicated. Example of it is provided by package.\n\n## Installation\nFirst, require package via composer:\n```\ncomposer require adel/laravel-menu\n```\n\nFor Laravel \u003c 5.5 check [Laravel \u003c 5.5 installation](#laravel--55-installation) section.\n\nThen publish some initial configuration and blade template:\n```\nphp artisan vendor:publish --provider=\"Adelf\\LaravelMenu\\LaravelMenuServiceProvider\"\n```\n**resources/menu/default.php** and **resources/views/menu/menu.blade.php** files will appear. It's just an examples. Provide your own configuration and blade template.\n\n## Using\nThis will render menu's blade template\n```blade\n\u003cheader\u003e\n    {!! LaravelMenu::render() !!}\n\u003c/header\u003e\n```\n\nTitle of active item can be used for title:\n```blade\n\u003ctitle\u003e\n    {{array_get(LaravelMenu::getLastActiveItem(), 'name', 'Default title')}}\n\u003c/title\u003e\n```\n\n## Multiple menus\nAnother menu can be created by defining it in new file on **resources/menu** directory. For example, **resources/menu/admin.php**\n\n```blade\n\u003ctitle\u003e \n    {!! array_get(LaravelMenu::getLastActiveItem('admin'), 'name', 'Default title') !!}\n\u003c/title\u003e\n\u003cheader\u003e\n    {!! LaravelMenu::render('admin') !!}\n\u003c/header\u003e\n```\n\n## Laravel \u003c 5.5 installation\n\nService provider and facade should be registered in **config/app.php**:\n```php\n'providers' =\u003e [\n    ...\n    \n    Adelf\\LaravelMenu\\LaravelMenuServiceProvider::class,\n],\n'aliases' =\u003e [\n    ...,\n\n    'LaravelMenu' =\u003e Adelf\\LaravelMenu\\Facade::class,\n],\n```\n\n[ico-version]: https://img.shields.io/packagist/v/adel/laravel-menu.svg?style=flat-square\n[ico-license]: https://img.shields.io/packagist/l/adel/laravel-menu.svg?style=flat-square\n[ico-scrutinizer]: https://scrutinizer-ci.com/g/adelf/laravel-menu/badges/quality-score.png?b=master\n\n[link-packagist]: https://packagist.org/packages/adel/laravel-menu\n[link-scrutinizer]: https://scrutinizer-ci.com/g/adelf/laravel-menu/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadelf%2Flaravel-menu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadelf%2Flaravel-menu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadelf%2Flaravel-menu/lists"}