Relationsseiten
Aktivieren
Aktiviere sie auf der Resource, für alle Relation Manager, oder nur an den Relation Managern, die du willst:
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;
class OrdersRelationManager extends RelationManager
{
use InteractsWithRelationPage;
}| Einrichtung | Relationen mit einer Seite |
|---|---|
HasRelationPages auf der Resource | alle, außer den ausgeschlossenen |
InteractsWithRelationPage an einem Manager | nur die Manager, die ihn nutzen |
| Eine eigene Seitenklasse (siehe unten) | alle, außer den ausgeschlossenen |
Um einige Relationen auszuschließen:
// Auf der Resource
public static function hasRelationPage(string $slug): bool
{
return $slug !== 'notes';
}
// An einem Relation Manager, mit InteractsWithRelationPage
protected static bool $hasRelationPage = false;Ein Relation Manager, den zwei Resources teilen, ist für beide aktiv: schließe ihn mit hasRelationPage() der Resource bei einer davon aus.
URLs und Slugs
Eintrag in getRelations() | URL |
|---|---|
'orders' => OrdersRelationManager::class | /customers/1/orders |
SupportTicketsRelationManager::class (ohne Schlüssel) | /customers/1/support-tickets |
RelationGroup::make('Activity', [...]) | /customers/1/activity |
Der eigene Slug eines Relation Managers hat Vorrang (protected static ?string $relationPageSlug = 'tickets';), dann der Schlüssel in getRelations(), dann der Name der Relation in kebab-case (oder das Label der Gruppe: gib Gruppen einen Schlüssel, denn ein übersetztes Label ändert sich mit der Sprache). Slugs, die einem Seitenschlüssel der Resource entsprechen (edit, view...), werden übersprungen, ebenso eine zweite Relation mit einem bereits vergebenen Slug.
Jede Seite ist eine benannte Route, relations.{slug}:
CustomerResource::getUrl('relations.orders', ['record' => $customer]);Berechtigungen und Verhalten
Der Relation Manager bekommt die Ansichtsseite der Resource als $pageClass (die Bearbeitungsseite, wenn es keine Ansichtsseite gibt). Daher verhalten sich isReadOnly(), canViewForRecord(), getBadge() und alle anderen Prüfungen genau wie im Tab. Die Ansichtsseite wird über ihren Schlüssel gefunden (view, edit oder $contextPage in einer eigenen Seitenklasse) oder über ihre Klasse.
Eine Relationsseite braucht, was die Ansichtsseite braucht (ihr canAccess() und die view-Policy des Datensatzes; update, wenn sie für die Bearbeitungsseite steht), und das canViewForRecord() des Managers. Ohne Ansichts- oder Bearbeitungsseite gilt die view-Policy. Eine Policy, die mit „nicht gefunden“ ablehnt, ergibt einen 404, ein unbekannter Slug ebenso. Das Menü, die globale Suche und „Als Seite öffnen“ verlinken nur die Seiten, die der Benutzer öffnen darf.
Relationsseiten führen den eigenen Code der Ansichtsseite nicht aus: Prüfungen in ihrem authorizeAccess() oder ein pro Benutzer gefiltertes getRelationManagers() gelten dort nicht. Leg sie in Policies oder in canViewForRecord() ab, oder sperre eine Relationsseite pro Datensatz auf der Resource:
public static function canAccessRelationPage(Model $record, string $slug): bool
{
return $slug !== 'audit-logs' || auth()->user()->isAdmin();
}