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-resources
Currently 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),
]);
}
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.
You cannot use a child resource for multiple parents, however, you can can have multiple resources pointing to the same model.
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 test
Please 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.