Skip to content
Cette page est une traduction : en cas de différence, la documentation en anglais fait foi. La lire en anglais

Pages de relation ​

Les activer ​

Activez-les sur la ressource, pour tous les relation managers, ou seulement sur les relation managers de votre choix :

php
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;

class OrdersRelationManager extends RelationManager
{
    use InteractsWithRelationPage;
}
ConfigurationRelations avec une page
HasRelationPages sur la ressourcetoutes, sauf celles exclues
InteractsWithRelationPage sur un managerseulement les managers qui l'utilisent
Une classe de page écrite par vous (plus bas)toutes, sauf celles exclues

Pour exclure certaines relations :

php
// Sur la ressource
public static function hasRelationPage(string $slug): bool
{
    return $slug !== 'notes';
}

// Sur un relation manager, avec InteractsWithRelationPage
protected static bool $hasRelationPage = false;

Un relation manager partagé par deux ressources s'active pour les deux : utilisez hasRelationPage() de la ressource pour exclure l'une d'elles.

URL et slugs ​

Entrée de getRelations()URL
'orders' => OrdersRelationManager::class/customers/1/orders
SupportTicketsRelationManager::class (sans clé)/customers/1/support-tickets
RelationGroup::make('Activity', [...])/customers/1/activity

Le slug propre au relation manager passe en premier (protected static ?string $relationPageSlug = 'tickets';), puis la clé dans getRelations(), puis le nom de la relation en kebab-case (ou le libellé du groupe : donnez une clé aux groupes, car un libellé traduit change avec la langue). Les slugs égaux à l'une des clés de page de la ressource (edit, view...) sont ignorés, tout comme une seconde relation dont le slug est déjà pris.

Chaque page est une route nommée, relations.{slug} :

php
CustomerResource::getUrl('relations.orders', ['record' => $customer]);

Autorisations et comportement ​

Le relation manager reçoit la page d'affichage de la ressource comme $pageClass (la page de modification s'il n'y a pas de page d'affichage), donc isReadOnly(), canViewForRecord(), getBadge() et tous les autres contrôles se comportent exactement comme dans l'onglet. La page d'affichage est trouvée par sa clé (view, edit, ou $contextPage sur une classe de page écrite par vous) ou par sa classe.

Une page de relation exige ce qu'exige la page d'affichage (son canAccess() et la policy view de l'enregistrement ; update quand elle tient lieu de page de modification) ainsi que le canViewForRecord() du manager. Sans page d'affichage ni de modification, c'est la policy view qui s'applique. Une policy qui refuse « comme introuvable » donne une 404, tout comme un slug inconnu. Le menu, la recherche globale et « Ouvrir comme page » ne lient que les pages que l'utilisateur peut ouvrir.

Les pages de relation n'exécutent pas le code propre à la page d'affichage : les contrôles de son authorizeAccess() ou un getRelationManagers() filtré par utilisateur ne s'y appliquent pas. Placez-les dans les policies, dans canViewForRecord(), ou interdisez une page de relation par enregistrement sur la ressource :

php
public static function canAccessRelationPage(Model $record, string $slug): bool
{
    return $slug !== 'audit-logs' || auth()->user()->isAdmin();
}

Version 1.8.1, publiée le 2026-11-15 · Licence MIT.