README

Description

Menus manages Enso navigation records and menu ordering.

The package exposes CRUD, organize, table init, table data, and Excel export endpoints for system menus, and integrates with permissions and roles to control navigable routes.

It is intended to back the Enso administration screen that defines menu structure and hierarchy.

Installation

Install the package:

composer require laravel-enso/menus

Run the package migrations:

php artisan migrate

Optional publish:

php artisan vendor:publish --tag=menus-factory

Features

• Menu CRUD endpoints.
• Drag-and-drop style ordering endpoint.
• Table init, table data, and Excel export endpoints.
• Integration with permissions and roles.
• Factories for bootstrapping menu data.

Usage

Main route group:

• system.menus.*

The package also exposes an explicit organize action:

route('system.menus.organize');

API

HTTP routes

• GET api/system/menus/create
• POST api/system/menus
• GET api/system/menus/{menu}/edit
• PATCH api/system/menus/{menu}
• DELETE api/system/menus/{menu}
• PUT api/system/menus/organize
• GET api/system/menus/initTable
• GET api/system/menus/tableData
• GET api/system/menus/exportExcel

Depends On

Required Enso packages:

• laravel-enso/core ↗
• laravel-enso/forms ↗
• laravel-enso/helpers ↗
• laravel-enso/migrator ↗
• laravel-enso/permissions ↗
• laravel-enso/roles ↗
• laravel-enso/tables ↗

Companion frontend package:

• @enso-ui/menus ↗

Contributions

are welcome. Pull requests are great, but issues are good too.

Thank you to all the people who already contributed to Enso!