This package adds support for nested resources in Filament.
It provides the base classes and column to provide the nested structure.
It currently is not that configurable and you need to follow naming conventions usually used by Laravel.
Demo:
Screen.Recording.2023-04-07.at.13.14.05.mov
You can install the package via composer:
composer require sevendays-digital/filament-nested-resourcesCurrently you need to do a couple of changes to make this work. But you start of by creating a filament resource (The parent resource should already exist at this point. The resource we are changing is the child one).
Once you have that, you will need to change the Filament/Resources/ChildModelResource.php to the NestedResource.
use SevendaysDigital\FilamentNestedResources\Columns\ChildResourceLink;
use SevendaysDigital\FilamentNestedResources\NestedResource;
class ChildModelResource extends NestedResource
{
public static function getParent(): string
{
return ParentModelResource::class;
}
}Then for each of the resource pages, you need to add the trait:
use SevendaysDigital\FilamentNestedResources\ResourcePages\NestedPage;Finally, on your ParentModelResource you can add the column to provide the links:
public static function table(Table $table): Table
{
return $table
->columns([
ChildResourceLink::make(ChildModelResource::class),
]);
}If you are using a many to many relationship, then you must write the inverse relationship inside your child model, and then a special scope to retrieve it's parent.
Example with MorphToMany relation:
/* Category.php (parent) */
public function products(): MorphToMany
{
$pivot_class = ProductMorph::class;
$pivot = app($pivot_class);
$pivot_table = $pivot->getTable();
$pivot_fields = $pivot->getFillable();
return $this->morphToMany(Product::class, 'model', $pivot_table)
->using($pivot_class)
->withPivot($pivot_fields)
->withTimestamps();
}
/* Product.php (child) */
//inverse relation
public function categories(): MorphToMany
{
$pivot_class = ProductMorph::class;
$pivot = app($pivot_class);
$pivot_table = $pivot->getTable();
$pivot_fields = $pivot->getFillable();
return $this->morphedByMany(Category::class, 'model', $pivot_table)
->using($pivot_class)
->withPivot($pivot_fields)
->withTimestamps();
}
// This scope is very important to retreive the parent model
public function scopeOfCategory($query,$parent)
{
return $query->whereHas('categories', function ($query) use($parent) {
$query->where('categories.id', $parent);
});
}When you need the parent in livewire context such as the form, you can add the second argument to your form method:
public static function form(Form $form, ?Event $parent = null): Form;Where Event is the model that should be the parent.
By default when in a "context" the sidebar will register the menu item for that resource.
So if you are inside a Project which has documents, the sidebar will show documents when you are on a project or deeper level.
If you do not want this, you can set shouldRegisterNavigationWhenInContext to false in the child resource.
Just make sure you set a custom slug for the resources so that it builds unique routes.
https://filamentphp.com/docs/2.x/admin/resources/getting-started#customizing-the-url-slug
There's none :).
composer testPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.