Skip to content
このページは翻訳です。内容に違いがある場合は、英語のドキュメントが正となります。 英語版を読む

リレーションページ ​

有効にする ​

リソースで有効にしてすべてのリレーションマネージャーに適用するか、必要なリレーションマネージャーだけで有効にします。

php
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;

class OrdersRelationManager extends RelationManager
{
    use InteractsWithRelationPage;
}
設定方法ページを持つリレーション
リソースに HasRelationPagesすべて(除外したものを除く)
マネージャーに InteractsWithRelationPage有効にしたマネージャーのみ
自分で書いたページクラス(後述)すべて(除外したものを除く)

一部のリレーションを除外するには:

php
// リソース側
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} です。

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

認可と動作 ​

リレーションマネージャーは $pageClass としてリソースの詳細ページ(詳細ページがない場合は編集ページ)を受け取ります。そのため isReadOnly()、canViewForRecord()、getBadge() などのチェックは、タブの場合とまったく同じように動作します。詳細ページはキー(view、edit、または自分で書いたページクラスの $contextPage)か、クラスで見つけます。

リレーションページを開くには、詳細ページと同じ条件(その canAccess() とレコードの view ポリシー。編集ページの代わりになる場合は update)と、マネージャーの canViewForRecord() が必要です。詳細ページも編集ページもない場合は view ポリシーが適用されます。「見つからない」として拒否するポリシーは 404 になり、不明なスラッグも同様です。メニュー、グローバル検索、「ページとして開く」は、ユーザーが開けるページだけにリンクします。

リレーションページでは、詳細ページ自身のコードは実行されません。その authorizeAccess() 内のチェックや、ユーザーごとに絞り込んだ getRelationManagers() は適用されません。ポリシーや canViewForRecord() に書くか、リソースでレコードごとにリレーションページを拒否してください。

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

バージョン 1.8.1(2026-11-15 リリース)· MIT ライセンス。