リレーションページ
有効にする
リソースで有効にしてすべてのリレーションマネージャーに適用するか、必要なリレーションマネージャーだけで有効にします。
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;
class OrdersRelationManager extends RelationManager
{
use InteractsWithRelationPage;
}| 設定方法 | ページを持つリレーション |
|---|---|
リソースに HasRelationPages | すべて(除外したものを除く) |
マネージャーに InteractsWithRelationPage | 有効にしたマネージャーのみ |
| 自分で書いたページクラス(後述) | すべて(除外したものを除く) |
一部のリレーションを除外するには:
// リソース側
public static function hasRelationPage(string $slug): bool
{
return $slug !== 'notes';
}
// リレーションマネージャー側(InteractsWithRelationPage を使用)
protected static bool $hasRelationPage = false;2 つのリソースで共有しているリレーションマネージャーは、両方で有効になります。片方だけ除外するには、リソースの hasRelationPage() を使ってください。
URL とスラッグ
getRelations() のエントリ | URL |
|---|---|
'orders' => OrdersRelationManager::class | /customers/1/orders |
SupportTicketsRelationManager::class(キーなし) | /customers/1/support-tickets |
RelationGroup::make('Activity', [...]) | /customers/1/activity |
リレーションマネージャー自身のスラッグ(protected static ?string $relationPageSlug = 'tickets';)が最優先で、次に getRelations() のキー、その次にリレーション名をケバブケースにしたもの(グループの場合はラベル。翻訳されたラベルは言語によって変わるので、グループにはキーを付けてください)が使われます。リソースのページキー(edit、view...)と同じスラッグはスキップされ、すでに使われているスラッグを持つ 2 つ目のリレーションもスキップされます。
各ページは名前付きルート relations.{slug} です。
CustomerResource::getUrl('relations.orders', ['record' => $customer]);認可と動作
リレーションマネージャーは $pageClass としてリソースの詳細ページ(詳細ページがない場合は編集ページ)を受け取ります。そのため isReadOnly()、canViewForRecord()、getBadge() などのチェックは、タブの場合とまったく同じように動作します。詳細ページはキー(view、edit、または自分で書いたページクラスの $contextPage)か、クラスで見つけます。
リレーションページを開くには、詳細ページと同じ条件(その canAccess() とレコードの view ポリシー。編集ページの代わりになる場合は update)と、マネージャーの canViewForRecord() が必要です。詳細ページも編集ページもない場合は view ポリシーが適用されます。「見つからない」として拒否するポリシーは 404 になり、不明なスラッグも同様です。メニュー、グローバル検索、「ページとして開く」は、ユーザーが開けるページだけにリンクします。
リレーションページでは、詳細ページ自身のコードは実行されません。その authorizeAccess() 内のチェックや、ユーザーごとに絞り込んだ getRelationManagers() は適用されません。ポリシーや canViewForRecord() に書くか、リソースでレコードごとにリレーションページを拒否してください。
public static function canAccessRelationPage(Model $record, string $slug): bool
{
return $slug !== 'audit-logs' || auth()->user()->isAdmin();
}