Pages de relation
Les activer
Activez-les sur la ressource, pour tous les relation managers, ou seulement sur les relation managers de votre choix :
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;
class OrdersRelationManager extends RelationManager
{
use InteractsWithRelationPage;
}| Configuration | Relations avec une page |
|---|---|
HasRelationPages sur la ressource | toutes, sauf celles exclues |
InteractsWithRelationPage sur un manager | seulement les managers qui l'utilisent |
| Une classe de page écrite par vous (plus bas) | toutes, sauf celles exclues |
Pour exclure certaines relations :
// 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} :
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 :
public static function canAccessRelationPage(Model $record, string $slug): bool
{
return $slug !== 'audit-logs' || auth()->user()->isAdmin();
}