novius / laravel-nova-order-nestedset-field
A Laravel Nova field that make your resources orderable
Installs: 77 850
Dependents: 1
Suggesters: 0
Security: 0
Stars: 24
Watchers: 4
Forks: 12
Open Issues: 4
Requires
- php: >=8.1
- kalnoy/nestedset: ^6.0.0
- laravel/nova: ^4.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.8.0
This package is auto-updated.
Last update: 2024-10-26 11:28:04 UTC
README
A field that make your resources orderable using the laravel nestedset package.
Requirements
- PHP >= 8.1
- Laravel Nova >= 4.0
NOTE: These instructions are for Laravel Nova 4.0. If you are using prior version, please see the previous version's docs.
Installation
composer require novius/laravel-nova-order-nestedset-field
Configuration
Some options that you can override are available.
php artisan vendor:publish --provider="Novius\LaravelNovaOrderNestedsetField\OrderNestedsetFieldServiceProvider" --tag="config"
Usage
Step 1
Use Kalnoy\Nestedset NodeTrait
and Novius\LaravelNovaOrderNestedsetField Orderable
trait on your model.
Example :
use Kalnoy\Nestedset\NodeTrait; use Novius\LaravelNovaOrderNestedsetField\Traits\Orderable; class Foo extends Model { use NodeTrait; use Orderable; public function getLftName() { return 'left'; } public function getRgtName() { return 'right'; } public function getParentIdName() { return 'parent'; } }
Step 2
Add the field to your resource and specify order for your resources.
use Novius\LaravelNovaOrderNestedsetField\OrderNestedsetField; class FooResource extends Resource { public function fields(Request $request) { return [ OrderNestedsetField::make('Order'), ]; } /** * @param \Illuminate\Database\Eloquent\Builder $query * @param array $orderings * @return \Illuminate\Database\Eloquent\Builder */ protected static function applyOrderings($query, array $orderings) { return $query->orderBy('left', 'asc'); } }
Scoping
Imagine you have Menu
model and MenuItems
. There is a one-to-many relationship
set up between these models. MenuItem
has menu_id
attribute for joining models
together. MenuItem
incorporates nested sets. It is obvious that you would want to
process each tree separately based on menu_id
attribute. In order to do so, you
need to specify this attribute as scope attribute:
protected function getScopeAttributes() { return ['menu_id']; }
Retrieve more information about usage on official doc.
Performances
You can enable cache to avoid performance issues in case of large tree.
By default cache is disabled.
To use cache you have to enabled it in config file with :
return [ ... 'cache_enabled' => true, ];
You have to clear cache on every tree updates with an observer on your Model (or directly in boot method).
namespace App\Models; use Illuminate\Database\Eloquent\Model; use Kalnoy\Nestedset\NodeTrait; use Novius\LaravelNovaOrderNestedsetField\Traits\Orderable; class Foo extends Model { use NodeTrait; use Orderable; public static function boot() { parent::boot(); if (config('nova-order-nestedset-field.cache_enabled', false)) { static::created(function (Theme $model) { $model->clearOrderableCache(); }); static::updated(function (Theme $model) { $model->clearOrderableCache(); }); static::deleted(function (Theme $model) { $model->clearOrderableCache(); }); } } }
Override default languages files
Run:
php artisan vendor:publish --provider="Novius\LaravelNovaOrderNestedsetField\OrderNestedsetFieldServiceProvider" --tag="lang"
Lint
Run php-cs with:
composer run-script lint
Contributing
Contributions are welcome! Leave an issue on Github, or create a Pull Request.
Licence
This package is under GNU Affero General Public License v3 or (at your option) any later version.