Nova Order Field nestedset
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-fieldConfiguration
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 lintContributing
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.