Страницы связей
Как включить
Включите страницы на ресурсе, для всех relation manager, или только в тех relation manager, где они нужны:
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;
class OrdersRelationManager extends RelationManager
{
use InteractsWithRelationPage;
}| Настройка | Связи со страницей |
|---|---|
HasRelationPages на ресурсе | все, кроме исключённых |
InteractsWithRelationPage в менеджере | только менеджеры с этим трейтом |
| Свой класс страницы (см. ниже) | все, кроме исключённых |
Чтобы исключить некоторые связи:
// На ресурсе
public static function hasRelationPage(string $slug): bool
{
return $slug !== 'notes';
}
// В relation manager, с InteractsWithRelationPage
protected static bool $hasRelationPage = false;Relation manager, общий для двух ресурсов, включается для обоих: чтобы исключить один из них, используйте hasRelationPage() этого ресурса.
URL и слаги
Элемент getRelations() | URL |
|---|---|
'orders' => OrdersRelationManager::class | /customers/1/orders |
SupportTicketsRelationManager::class (без ключа) | /customers/1/support-tickets |
RelationGroup::make('Activity', [...]) | /customers/1/activity |
Приоритет у слага, заданного в самом relation manager (protected static ?string $relationPageSlug = 'tickets';), затем идёт ключ в getRelations(), затем имя связи в kebab-case (или подпись группы: давайте группам ключ, потому что переведённая подпись меняется вместе с языком). Слаги, совпадающие с ключом страницы ресурса (edit, view...), пропускаются, как и вторая связь с уже занятым слагом.
Каждая страница — это именованный маршрут relations.{slug}:
CustomerResource::getUrl('relations.orders', ['record' => $customer]);Права доступа и поведение
Relation manager получает в $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();
}