Páginas das relações
Como ativar
Ative no resource, para todos os relation managers, ou só nos relation managers que você quiser:
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;
class OrdersRelationManager extends RelationManager
{
use InteractsWithRelationPage;
}| Configuração | Relações com uma página |
|---|---|
HasRelationPages no resource | todas, menos as excluídas |
InteractsWithRelationPage em um manager | só os managers que usam o trait |
| Uma classe de página sua (veja abaixo) | todas, menos as excluídas |
Para deixar algumas relações de fora:
// No resource
public static function hasRelationPage(string $slug): bool
{
return $slug !== 'notes';
}
// Em um relation manager, com InteractsWithRelationPage
protected static bool $hasRelationPage = false;Um relation manager compartilhado por dois resources é ativado nos dois: use o hasRelationPage() do resource para deixar um deles de fora.
URLs e slugs
Item de getRelations() | URL |
|---|---|
'orders' => OrdersRelationManager::class | /customers/1/orders |
SupportTicketsRelationManager::class (sem chave) | /customers/1/support-tickets |
RelationGroup::make('Activity', [...]) | /customers/1/activity |
Vale primeiro o slug do próprio relation manager (protected static ?string $relationPageSlug = 'tickets';), depois a chave em getRelations(), depois o nome da relação em kebab-case (ou o rótulo do grupo: dê uma chave aos grupos, já que um rótulo traduzido muda com o idioma). Slugs iguais a uma das chaves de página do resource (edit, view...) são ignorados, assim como uma segunda relação com um slug já usado.
Cada página é uma rota nomeada, relations.{slug}:
CustomerResource::getUrl('relations.orders', ['record' => $customer]);Autorização e comportamento
O relation manager recebe a página de visualização do resource como $pageClass (a página de edição, quando não há página de visualização), então isReadOnly(), canViewForRecord(), getBadge() e todas as outras verificações funcionam exatamente como na aba. A página de visualização é encontrada pela chave (view, edit, ou $contextPage em uma classe de página sua) ou pela classe.
Uma página de relação exige o mesmo que a página de visualização (o canAccess() dela e a policy view do registro; update quando ela representa a página de edição) e o canViewForRecord() do manager. Sem página de visualização ou de edição, vale a policy view. Uma policy que nega como não encontrado dá 404, assim como um slug desconhecido. O menu, a pesquisa global e "Abrir como página" só linkam as páginas que o usuário pode abrir.
As páginas das relações não executam o código da própria página de visualização: verificações no authorizeAccess() dela ou um getRelationManagers() filtrado por usuário não valem ali. Coloque-as nas policies, em canViewForRecord(), ou vete uma página de relação por registro no resource:
public static function canAccessRelationPage(Model $record, string $slug): bool
{
return $slug !== 'audit-logs' || auth()->user()->isAdmin();
}