Pagine delle relazioni
Attivarle
Attivale sulla resource, per tutti i relation manager, oppure solo sui relation manager che vuoi:
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;
class OrdersRelationManager extends RelationManager
{
use InteractsWithRelationPage;
}| Configurazione | Relazioni con una pagina |
|---|---|
HasRelationPages sulla resource | tutte, tranne quelle escluse |
InteractsWithRelationPage su un manager | solo i manager che lo usano |
| Una classe pagina scritta da te (sotto) | tutte, tranne quelle escluse |
Per escludere qualche relazione:
// Sulla resource
public static function hasRelationPage(string $slug): bool
{
return $slug !== 'notes';
}
// Su un relation manager, con InteractsWithRelationPage
protected static bool $hasRelationPage = false;Un relation manager condiviso da due resource si attiva per entrambe: usa hasRelationPage() della resource per escluderne una.
URL e slug
Voce di getRelations() | URL |
|---|---|
'orders' => OrdersRelationManager::class | /customers/1/orders |
SupportTicketsRelationManager::class (senza chiave) | /customers/1/support-tickets |
RelationGroup::make('Activity', [...]) | /customers/1/activity |
Vince lo slug scelto dal relation manager (protected static ?string $relationPageSlug = 'tickets';), poi la chiave di getRelations(), poi il nome della relazione in kebab-case (o l'etichetta del gruppo: dai una chiave ai gruppi, perché un'etichetta tradotta cambia con la lingua). Gli slug uguali a una chiave di pagina della resource (edit, view...) vengono saltati, e così una seconda relazione con uno slug già preso.
Ogni pagina è una rotta con nome, relations.{slug}:
CustomerResource::getUrl('relations.orders', ['record' => $customer]);Permessi e comportamento
Il relation manager riceve come $pageClass la pagina di visualizzazione della resource (quella di modifica, se non c'è), quindi isReadOnly(), canViewForRecord(), getBadge() e tutti gli altri controlli funzionano esattamente come nella scheda. La pagina di visualizzazione si trova per chiave (view, edit, o $contextPage su una classe pagina scritta da te) o per classe.
Una pagina di relazione richiede quello che richiede la pagina di visualizzazione (il suo canAccess() e la policy view del record; update quando sta per la pagina di modifica) più il canViewForRecord() del manager. Senza pagina di visualizzazione o di modifica vale la policy view. Una policy che nega «come non trovato» dà 404, come uno slug sconosciuto. Menu, ricerca globale e «Apri come pagina» linkano solo le pagine che l'utente può aprire.
Le pagine delle relazioni non eseguono il codice della pagina di visualizzazione: i controlli nel suo authorizeAccess() o un getRelationManagers() filtrato per utente lì non valgono. Mettili nelle policy, in canViewForRecord(), oppure vieta una pagina di relazione per record sulla resource:
public static function canAccessRelationPage(Model $record, string $slug): bool
{
return $slug !== 'audit-logs' || auth()->user()->isAdmin();
}