vladski / laravel-nova-xtra
A Laravel Nova tool for extra features out of the box - theme, modal, tooltips, internal pages, navigation.
Installs: 249
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 0
Forks: 0
Open Issues: 0
Language:JavaScript
Requires
- php: >=7.3.0
Requires (Dev)
- laravel/framework: ^7.21
- laravel/nova: ^3.8
README
Laravel Nova Xtra
A Laravel Nova tool for extra features out of the box:
- custom theme
- custom navigation
- custom pages within Nova
- tooltips
- modal window
This is an early stage of the package development. Not ready for production yet.
Install
composer require vladski/laravel-nova-xtra
Publish theme_default.css and theme_xtra.css theme css files in /rsources/css/nova-xtra/ directory
php artisan vendor:publish --provider="Vladski\NovaXtra\ToolServiceProvider"
Usage
Register in app/Providers/NovaServiceProvider.php
public function tools() { return [ (new \Vladski\NovaXtra\NovaXtra) // optionally turn on a theme ->theme('xtra') // build navigation ->addNavigationGroup( 'Xtra Menu', '<svg fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24" stroke="currentColor"><path d="M13 10V3L4 14h7v7l9-11h-7z"></path></svg>', true ) ->addNavigationIntroPage('About Xtra', 'intro') ->addNavigationLink('Refresh Page', 'javascript: Nxtra.reloadCurrent();', true, [ 'icon' => '<svg fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24" stroke="currentColor"><path d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15"></path></svg>', ]) ->addNavigationLink('Alert Hello', "javascript: alert('Hello');", true, [ 'icon' => '<svg fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24" stroke="currentColor"><path d="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4"></path></svg>', ]) ->addNavigationPage('Internal Page', 'example', 'App\Http\Controllers\NotExistingPageController@index', true, [ 'icon' => '<svg fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24" stroke="currentColor"><path d="M7 21h10a2 2 0 002-2V9.414a1 1 0 00-.293-.707l-5.414-5.414A1 1 0 0012.586 3H7a2 2 0 00-2 2v14a2 2 0 002 2z"></path></svg>', ]) ->addNavigationGroup( 'Nova Routes', '<svg fill="none" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" viewBox="0 0 24 24" stroke="currentColor"><path d="M16 12a4 4 0 10-8 0 4 4 0 008 0zm0 0v1.5a2.5 2.5 0 005 0V12a9 9 0 10-9 9m4.5-1.206a8.959 8.959 0 01-4.5 1.207"></path></svg>', true ) ->addNavigationRoute('Dashboard', 'dashboard.custom', $routeParams = ['name' => 'main']) ->addNavigationRoute('Users', 'index', $routeParams = ['resourceName' => 'users']) , // .... ]; }
TODO:
Custom Theme
Based on and credits to https://github.com/gregoriohc/laravel-nova-theme-classify
File theme_default.css has no styling just lists all available css selectors you can use to override Nova standard styling. Use this if you want start from scratch. The theme_xtra.css file is a fully working theme.
Make copy of a theme file, name it like theme_mytheme.css and modify it. Switch to it in NovaServiceProvider.php by setting:
(new \Vladski\NovaXtra\NovaXtra) ->theme('xtra') .....
Custom Navigation
Custom Internal Pages
Nxtra JavaScript Object
Tooltips
Built-in https://atomiks.github.io/tippyjs/
Modal
Developmewnt
To use local package register it in composer.json:
.... "repositories": [ { "type": "path", "url": "/Users/scl/Projects/_vladski/laravel-nova-xtra", "options": { "symlink": true } }, ....
Then run
composer update vladski/laravel-nova-xtra