Páginas de relación
Activarlas
Actívalas en el recurso, para todos los relation managers, o solo en los relation managers que quieras:
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;
class OrdersRelationManager extends RelationManager
{
use InteractsWithRelationPage;
}| Configuración | Relaciones con página |
|---|---|
HasRelationPages en el recurso | todas, menos las excluidas |
InteractsWithRelationPage en un manager | solo los managers que lo usan |
| Una clase de página escrita por ti (abajo) | todas, menos las excluidas |
Para dejar fuera algunas relaciones:
// En el recurso
public static function hasRelationPage(string $slug): bool
{
return $slug !== 'notes';
}
// En un relation manager, con InteractsWithRelationPage
protected static bool $hasRelationPage = false;Un relation manager compartido por dos recursos se activa en ambos: usa hasRelationPage() del recurso para dejar fuera uno de ellos.
URL y slugs
Entrada de getRelations() | URL |
|---|---|
'orders' => OrdersRelationManager::class | /customers/1/orders |
SupportTicketsRelationManager::class (sin clave) | /customers/1/support-tickets |
RelationGroup::make('Activity', [...]) | /customers/1/activity |
Gana el slug propio del relation manager (protected static ?string $relationPageSlug = 'tickets';), después la clave en getRelations(), después el nombre de la relación en kebab-case (o la etiqueta del grupo: dale una clave a los grupos, porque una etiqueta traducida cambia con el idioma). Los slugs iguales a una de las claves de página del recurso (edit, view...) se omiten, y también una segunda relación con un slug ya ocupado.
Cada página es una ruta con nombre, relations.{slug}:
CustomerResource::getUrl('relations.orders', ['record' => $customer]);Permisos y comportamiento
El relation manager recibe como $pageClass la página de vista del recurso (la de edición si no hay página de vista), así que isReadOnly(), canViewForRecord(), getBadge() y todas las demás comprobaciones funcionan exactamente igual que en la pestaña. La página de vista se encuentra por su clave (view, edit, o $contextPage en una clase de página escrita por ti) o por su clase.
Una página de relación necesita lo mismo que la página de vista (su canAccess() y la policy view del registro; update cuando representa la página de edición) y el canViewForRecord() del manager. Sin página de vista ni de edición, se aplica la policy view. Una policy que deniega «como no encontrado» da un 404, igual que un slug desconocido. El menú, la búsqueda global y «Abrir como página» solo enlazan las páginas que el usuario puede abrir.
Las páginas de relación no ejecutan el código propio de la página de vista: las comprobaciones de su authorizeAccess() o un getRelationManagers() filtrado por usuario no se aplican ahí. Ponlas en las policies, en canViewForRecord(), o veta una página de relación por registro en el recurso:
public static function canAccessRelationPage(Model $record, string $slug): bool
{
return $slug !== 'audit-logs' || auth()->user()->isAdmin();
}