ampedweb / laravel-backpack-mega-menu
Mega menu builder for Laravel Backpack
Installs: 35
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Language:Vue
Requires
- backpack/crud: ^4.1.0
- illuminate/support: ~7|~8
Requires (Dev)
- orchestra/testbench: ~5|~6
- phpunit/phpunit: ~9.0
This package is auto-updated.
Last update: 2024-10-29 06:12:47 UTC
README
// TODO: customize this description and delete this line
This package provides XXX functionality for projects that use the Backpack for Laravel administration panel.
More exactly, it adds X and Y so that you can easily do Z.
Screenshots
// TODO: add a screenshot and delete these lines; to add a screenshot to a github markdown file, the easiest way is to open an issue, upload the screenshot there with drag&drop, then close the issue; you now have that image hosted on Github's servers; so you can then right-click the image to copy its URL, and use that URL wherever you want (for example... here)
Installation
Via Composer
composer require ampedweb/laravel-backpack-mega-menu
Publish the JS assets
php artisan vendor:publish --provider="AmpedWeb\LaravelBackpackMegaMenu\AddonServiceProvider"
Add a sidebar menu item to the CrudController
php artisan backpack:add-sidebar-content "<li class="nav-item"><a class="nav-link" href="{{ backpack_url('mega-menu') }}"><i class="la la-bars nav-icon"></i> Mega Menus</a></li>"
Usage
// TODO: explain to your users how to use the functionality this package provides; we've provided an example for a Backpack addon that provides a custom field
To use the field this package provides, inside your custom CrudController do:
$this->crud->addField([ 'name' => 'agreed', 'label' => 'I agree to the terms and conditions', 'type' => 'new_field_name', 'view_namespace' => 'ampedweb.laravel-backpack-mega-menu::fields', ]);
Notice the view_namespace
attribute - make sure that is exactly as above, to tell Backpack to load the field from this addon package, instead of assuming it's inside the Backpack\CRUD package.
Overwriting
// TODO: explain to your users how to overwrite the functionality this package provides; we've provided an example for a custom field
If you need to change the field in any way, you can easily publish the file to your app, and modify that file any way you want. But please keep in mind that you will not be getting any updates.
Step 1. Copy-paste the blade file to your directory:
# create the fields directory if it's not already there mkdir -p resources/views/vendor/backpack/crud/fields # copy the blade file inside the folder we created above cp -i vendor/ampedweb/laravel-backpack-mega-menu/src/resources/views/fields/field_name.blade.php resources/views/vendor/backpack/crud/fields/field_name.blade.php
Step 2. Remove the vendor namespace wherever you've used the field:
$this->crud->addField([
'name' => 'agreed',
'type' => 'toggle',
'label' => 'I agree to the terms and conditions',
- 'view_namespace' => 'ampedweb.laravel-backpack-mega-menu::fields'
]);
Step 3. Uninstall this package. Since it only provides one file, and you're no longer using that file, it makes no sense to have the package installed:
composer remove ampedweb/laravel-backpack-mega-menu
Change log
Changes are documented here on Github. Please see the Releases tab.
Testing
composer test
Contributing
Please see contributing.md for a todolist and howtos.
Security
If you discover any security related issues, please email hosting@ampedwebdesign.co.uk instead of using the issue tracker.
Credits
License
This project was released under MIT, so you can install it on top of any Backpack & Laravel project. Please see the license file for more information.
However, please note that you do need Backpack installed, so you need to also abide by its YUMMY License. That means in production you'll need a Backpack license code. You can get a free one for non-commercial use (or a paid one for commercial use) on backpackforlaravel.com.