Menus
Menu Manager dependency for Laravel Enso
This package works exclusively within the Enso ecosystem.
The front end assets that utilize this api are present in the ui package.
For live examples and demos, you may visit laravel-enso.com
click on the photo to view a short demo in compatible browsers
Installation
Comes pre-installed in Enso.
Features
- allow for the easy management of the main (sidebar) menus of the application
- permits the creation, update, delete, ordering of the menus
Usage
Please note that because we want to keep the compiled size down, throughout the enso ecosystem, icons are imported selectively.
What this means for the menu editor, is that when adding/changing a menu, you should also make sure you import the required icons. The proper place to include the new icons is:
resources/js/app.js
Under the Hood
- a menu element may have several roles attached and is rendered only for the users with the respective roles
- menu element attributes:
parent_id
: the id of its parent menu, if he has a parent, or nullname
: the label that is translated and visible in the UIicon
: the icon classes, visible in the UIorder_index
: used for ordering the elements of the menu in the desired sequencelink
: is the link that's going to be accessed when clicking on the menuhas_children
: is a flag telling us if a menu element has children and is used when rendering the menu
- for the menu changes to take effect, a page refresh or a re-login is needed
Publishes
php artisan vendor:publish --tag=menus-factory
- the factory for theMenu
modelphp artisan vendor:publish --tag=enso-factories
- a common alias for when wanting to update the factories, once a newer version is released, usually used with the--force
flag
Contributions
are welcome. Pull requests are great, but issues are good too.
License
This package is released under the MIT license.