关联页面
启用
可以在 resource 上为所有 relation manager 启用,也可以只在需要的 relation manager 上启用:
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;
class OrdersRelationManager extends RelationManager
{
use InteractsWithRelationPage;
}| 设置方式 | 拥有页面的关联 |
|---|---|
在 resource 上使用 HasRelationPages | 全部,除了主动排除的 |
在 manager 上使用 InteractsWithRelationPage | 只有启用了它的 manager |
| 你自己编写的页面类(见下文) | 全部,除了主动排除的 |
要排除某些关联:
// 在 resource 上
public static function hasRelationPage(string $slug): bool
{
return $slug !== 'notes';
}
// 在 relation manager 上,配合 InteractsWithRelationPage
protected static bool $hasRelationPage = false;被两个 resource 共用的 relation manager 会在两边都启用:用 resource 的 hasRelationPage() 排除其中一个。
URL 和 slug
getRelations() 条目 | URL |
|---|---|
'orders' => OrdersRelationManager::class | /customers/1/orders |
SupportTicketsRelationManager::class(不带键) | /customers/1/support-tickets |
RelationGroup::make('Activity', [...]) | /customers/1/activity |
relation manager 自己设置的 slug 优先(protected static ?string $relationPageSlug = 'tickets';),其次是 getRelations() 中的键,最后是 kebab-case 形式的关联关系名称(或分组标签:请给分组设置键,因为翻译后的标签会随语言变化)。与 resource 某个页面键(edit、view……)相同的 slug 会被跳过,slug 已被占用的第二个关联也会被跳过。
每个页面都是一个命名路由 relations.{slug}:
CustomerResource::getUrl('relations.orders', ['record' => $customer]);授权与行为
relation manager 接收 resource 的查看页面作为 $pageClass(没有查看页面时为编辑页面),因此 isReadOnly()、canViewForRecord()、getBadge() 以及其他所有检查的行为都与在标签页中完全一致。查看页面通过键(view、edit,或你自己编写的页面类上的 $contextPage)或类来查找。
关联页面需要满足查看页面的要求(它的 canAccess() 以及记录的 view policy;当它代表编辑页面时为 update),以及 manager 的 canViewForRecord()。没有查看页面和编辑页面时,适用 view policy。以“未找到”方式拒绝的 policy 会返回 404,未知的 slug 也一样。菜单、全局搜索和“作为页面打开”只会链接用户能打开的页面。
关联页面不会运行查看页面自己的代码:它的 authorizeAccess() 中的检查,或按用户过滤的 getRelationManagers(),在这里都不生效。请把它们放到 policy 或 canViewForRecord() 中,或者在 resource 上按记录否决某个关联页面:
public static function canAccessRelationPage(Model $record, string $slug): bool
{
return $slug !== 'audit-logs' || auth()->user()->isAdmin();
}