✨ Main Features

• 🔄 Menu Import/Reset: One-click import of system default menus or reset menu configuration
• 📝 Visual Editing: Intuitive menu add, edit, and delete operations
• 🎨 Drag & Drop Sorting: Support for drag-and-drop menu reordering
• 🔐 Permission Control: Role-based menu access permission management
• 🌍 Multi-language Support: Complete localization for 11 languages
• 📱 Responsive Design: Support for mobile menu hiding settings
• 🎯 Smart Activation: Route-based menu activation state control

🛠️ Technical Features

• Smart Route Recognition: Automatic synchronization of route names and URLs
• Auto Permission Creation: Automatic creation of corresponding permissions when importing menus
• Cache Optimization: Smart cache management for performance
• Hierarchy Management: Support for unlimited menu hierarchy levels

🚀 Quick Start

1. Accessing Menu Manager

1. Log in to BeikShop admin panel
2. Navigate to System Settings > Menu Manager
3. Enter the menu management interface

2. First-time Usage Recommendations

Recommended workflow:

1. Click "Import Default Menus" button to import system preset menus
2. Adjust menu order as needed (drag & drop sorting)
3. Edit menu permission settings
4. Test menu display effects

📥 Menu Import & Reset

Import Default Menus

Description: One-click import of BeikShop system's default menu structure, including all core functional modules.

Steps:

1. Click the "Import Default Menus" button at the top of the page
2. Click "Confirm" in the confirmation dialog
3. The system will automatically create the following menus:
   • Home
   • Order Management (with submenus)
   • Product Management (with submenus)
   • Customer Management (with submenus)
   • Content Management (with submenus)
   • Reports (with submenus)
   • Design Management (with submenus)
   • Plugin Management (with submenus)
   • System Settings (with submenus)
   • Help Center

Auto-created content:

• ✅ Menu items and hierarchy structure
• ✅ Multi-language translations
• ✅ Corresponding permission records
• ✅ Route configurations
• ✅ Icon settings

Reset Menus

Description: Clear all custom menus and restore to system default state.

⚠️ Important Warning: This operation will delete all custom menus, please use with caution!

Steps:

1. Click the "Reset Menus" button
2. Click "Confirm" in the confirmation dialog
3. The system will:
   • Delete all existing menus
   • Re-import default menus
   • Reset permission configurations

➕ Menu Management

Adding New Menu

Steps:

1. Click the "Add Menu" button
2. Fill in menu basic information
3. Configure menu parameters
4. Click "Save" to complete creation

Editing Existing Menu

Steps:

1. Find the menu to edit in the menu list
2. Click the "Edit" button
3. Modify menu configuration
4. Click "Save" to save changes

Deleting Menu

Steps:

1. Find the menu to delete in the menu list
2. Click the "Delete" button
3. Click "Confirm" in the confirmation dialog

Notes:

• Deleting a parent menu will also delete all its submenus
• Delete operations cannot be undone, please operate with caution

Menu Sorting

Drag & Drop Sorting:

1. Hover mouse over menu item
2. Hold left mouse button and drag menu to target position
3. Release mouse to complete sorting
4. System automatically saves new order

📋 Parameter Details

Basic Information

Menu Name (name)

• Description: Unique identifier for the menu, used for internal system identification
• Format: English letters, numbers, underscores
• Examples: products, order_list, customer_groups
• Note: Cannot be duplicated, recommend using meaningful English names

Menu Title (title)

• Description: Text title displayed in the menu
• Support: Multi-language translation
• Examples:
  • Chinese: 商品管理
  • English: Product Management
• Note: Supports HTML entity encoding

Parent Menu (parent_id)

• Description: Specify the parent menu to create hierarchy structure
• Options:
  • Top Level: Display as main menu
  • Select Parent Menu: Display as submenu
• Hierarchy: Supports unlimited level nesting

Route Configuration

Route Name (route)

• Description: Laravel route name, used to generate menu links
• Format: Laravel standard route name
• Examples:
  • admin.products.index
  • admin.orders.show
  • admin.customers.create
• Features:
  • 🔄 Auto-sync URL address
  • 🔄 Auto-generate permission identifier
  • 🎯 Smart menu activation

Route Selector:

• Supports search filtering
• Shows all available routes
• Click to select and auto-fill

Menu URL (url)

• Description: URL address to navigate to when menu is clicked
• Format: Relative path or absolute path
• Examples:
  • /admin/products
  • /admin/orders/create
  • https://external-site.com
• Auto-sync: Automatically generated after selecting route name

Display Settings

Menu Icon (icon)

• Description: Icon displayed before menu item
• Format: Bootstrap Icons class name
• Examples:
  • bi bi-house (home icon)
  • bi bi-box (product icon)
  • bi bi-people (user icon)
• Tool: Built-in icon selector

Sort Order (sort_order)

• Description: Menu display order, smaller numbers appear first
• Format: Positive integer
• Default: 0
• Recommendation: Use multiples of 10 for easy insertion later

Menu Type & Behavior

Menu Type (type)

• Menu (menu): Standard menu item, supports submenus
• Link (link): Pure link, usually for external links

Link Target (target)

• Current Window (_self): Open link in current window
• New Window (_blank): Open link in new window/tab

Permission Control

Permission Identifier (permission)

• Description: Permission identifier required to access this menu
• Format: module_action
• Examples:
  • orders_index (order list permission)
  • products_create (product creation permission)
  • customers_update (customer update permission)
• Auto-sync: Automatically generated after selecting route
• Leave empty: Visible to all users (except super admin)

Advanced Configuration

Route Prefixes (prefixes)

• Description: List of route prefixes used for menu activation state determination
• Format: Comma-separated route prefixes
• Example: admin/products,admin/categories,admin/brands
• Function: When current page path matches any prefix, menu displays as active

Exclude Routes (excludes)

• Description: List of routes that will not activate this menu
• Format: Comma-separated route paths
• Example: admin/products/create,admin/products/import
• Function: Even if path matches prefix, these routes will not activate menu

Status Control

Visibility Status (visible)

• Visible: Menu displays normally in sidebar
• Hidden: Menu does not display in sidebar (but still accessible via URL)

Enable Status (enabled)

• Enabled: Menu works normally
• Disabled: Menu is completely unavailable

Hide on Mobile (hide_mobile)

• Show: Display this menu on mobile devices
• Hide: Hide this menu on mobile devices

🔧 Advanced Features

Smart Menu Activation

Menu Manager uses smart algorithms to determine currently active menu items:

Activation Rules:

1. Exact Match: Current route exactly matches menu route
2. Prefix Match: Current path matches menu's route prefixes
3. Exclude Rules: Paths in exclude routes will not activate menu
4. Hierarchy Activation: When submenu is active, parent menu is also active

Configuration Example:

Menu: Product Management
Route Prefixes: admin/products,admin/categories,admin/brands
Exclude Routes: admin/products/export

Activation Cases:
✅ /admin/products        → Active
✅ /admin/products/1      → Active
✅ /admin/categories      → Active
❌ /admin/products/export → Not Active (excluded)
❌ /admin/orders          → Not Active
    

❓ FAQ

Q1: Menu not displaying?

Possible Causes:

• Menu status is disabled or hidden
• User lacks access permissions
• Permission identifier is incorrectly set

Solutions:

1. Check menu visibility and enable status
2. Confirm user role has appropriate permissions
3. Verify permission identifier is correct

Q2: Menu activation state incorrect?

Possible Causes:

• Route prefix configuration incorrect
• Exclude routes settings wrong
• Route name doesn't match

Solutions:

1. Check and adjust route prefix configuration
2. Confirm exclude routes settings
3. Verify route name is correct

Q3: Drag & drop sorting not working?

Possible Causes:

• JavaScript errors
• Insufficient permissions
• Network connection issues

Solutions:

1. Check browser console for errors
2. Confirm user has menu management permissions
3. Refresh page and retry

Q4: Import default menus failed?

Possible Causes:

• Database connection issues
• Permission table doesn't exist
• Plugin not properly installed

Solutions:

1. Check database connection
2. Confirm permission system works normally
3. Reinstall plugin

Q5: Multi-language display incorrect?

Possible Causes:

• Language pack missing
• Translation keys don't exist
• Cache issues

Solutions:

1. Confirm language pack is complete
2. Clear translation cache
3. Check translation keys are correct