Skip to content
هذه الصفحة مترجمة: إذا اختلف شيء، فالتوثيق الإنجليزي هو المرجع. اقرأها بالإنجليزية

صفحات العلاقات ​

التفعيل ​

فعّل الصفحات على الـ resource لكل الـ relation managers، أو فقط على الـ relation managers التي تريدها:

php
use Wit3\FilamentRelationNavigator\Concerns\InteractsWithRelationPage;

class OrdersRelationManager extends RelationManager
{
    use InteractsWithRelationPage;
}
الإعدادالعلاقات التي لها صفحة
HasRelationPages على الـ resourceكلها، ما عدا المستبعدة
InteractsWithRelationPage على relation managerفقط الـ relation managers التي تستخدمه
صنف صفحة كتبته بنفسك (انظر أدناه)كلها، ما عدا المستبعدة

لاستبعاد بعض العلاقات:

php
// على الـ 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}:

php
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:

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

الإصدار 1.8.1، صدر في 2026-11-15 · رخصة MIT.