صفحات العلاقات
التفعيل
فعّل الصفحات على الـ resource لكل الـ relation managers، أو فقط على الـ relation managers التي تريدها:
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;
class OrdersRelationManager extends RelationManager
{
use InteractsWithRelationPage;
}| الإعداد | العلاقات التي لها صفحة |
|---|---|
HasRelationPages على الـ resource | كلها، ما عدا المستبعدة |
InteractsWithRelationPage على relation manager | فقط الـ relation managers التي تستخدمه |
| صنف صفحة كتبته بنفسك (انظر أدناه) | كلها، ما عدا المستبعدة |
لاستبعاد بعض العلاقات:
// على الـ resource
public static function hasRelationPage(string $slug): bool
{
return $slug !== 'notes';
}
// على relation manager، مع InteractsWithRelationPage
protected static bool $hasRelationPage = false;الـ relation manager المشترك بين resource وآخر يُفعَّل في الاثنين: استخدم hasRelationPage() في الـ resource لاستبعاد أحدهما.
عناوين URL والـ slugs
مدخل في getRelations() | URL |
|---|---|
'orders' => OrdersRelationManager::class | /customers/1/orders |
SupportTicketsRelationManager::class (بلا مفتاح) | /customers/1/support-tickets |
RelationGroup::make('Activity', [...]) | /customers/1/activity |
يفوز الـ slug الذي يحدده الـ relation manager نفسه (protected static ?string $relationPageSlug = 'tickets';)، ثم المفتاح في getRelations()، ثم اسم العلاقة بصيغة kebab-case (أو تسمية المجموعة: أعطِ المجموعات مفتاحًا، لأن التسمية المترجمة تتغير مع اللغة). تُتخطى الـ slugs المطابقة لأحد مفاتيح صفحات الـ resource (edit، view...)، وكذلك العلاقة الثانية التي يكون الـ slug الخاص بها مأخوذًا مسبقًا.
كل صفحة مسار مسمى (named route)، relations.{slug}:
CustomerResource::getUrl('relations.orders', ['record' => $customer]);الصلاحيات والسلوك
يتلقى الـ relation manager صفحة العرض الخاصة بالـ resource على أنها $pageClass (أو صفحة التعديل إن لم توجد صفحة عرض)، لذلك تعمل isReadOnly() وcanViewForRecord() وgetBadge() وكل الفحوص الأخرى تمامًا كما في التبويب. يُعثر على صفحة العرض بمفتاحها (view أو edit أو $contextPage في صنف صفحة كتبته بنفسك) أو بصنفها.
تحتاج صفحة العلاقة إلى ما تحتاجه صفحة العرض (دالة canAccess() الخاصة بها وسياسة view للسجل؛ وupdate عندما تقوم مقام صفحة التعديل) وإلى canViewForRecord() الخاصة بالـ relation manager. من دون صفحة عرض أو صفحة تعديل، تُطبَّق سياسة view. السياسة التي ترفض الوصول على أنه «غير موجود» تعطي 404، وكذلك الـ slug غير المعروف. القائمة والبحث العام و«فتح كصفحة» لا تربط إلا بالصفحات التي يستطيع المستخدم فتحها.
لا تنفذ صفحات العلاقات الشيفرة الخاصة بصفحة العرض: الفحوص الموجودة في authorizeAccess() الخاصة بها، أو getRelationManagers() المفلترة حسب المستخدم، لا تُطبَّق هناك. ضعها في السياسات (policies)، أو في canViewForRecord()، أو امنع صفحة علاقة لكل سجل على حدة من الـ resource:
public static function canAccessRelationPage(Model $record, string $slug): bool
{
return $slug !== 'audit-logs' || auth()->user()->isAdmin();
}