# Filament SEO: الوسوم الوصفية وOpen Graph وJSON-LD وفهرسة Google من لوحة التحكم

> وسوم Meta وOpen Graph وTwitter وJSON-LD مع Google Indexing وSearch Console، تديرها كلها من Filament. كيف تثبّت tomatophp/filament-seo على Filament 5، وما الذي لا يفعله بعد.

*2026-10-12T12:32:32Z*

إذا كان موقعك المبني بـ Laravel يعمل بلوحة تحكم Filament، فغالبًا ما يتوزع عمل الـ SEO على مكانين: وسوم Meta مكتوبة يدويًا داخل Blade، وGoogle Search Console مفتوح في تبويب آخر. الإضافة `tomatophp/filament-seo` تجمع الاثنين داخل اللوحة.

**الإجابة المختصرة:** ثبّت `tomatophp/filament-seo`، وشغّل `php artisan filament-seo:install`، وسجّل `FilamentSeoPlugin` في لوحتك، وأضف `@filamentSeo` داخل `<head>` في التخطيط. تحصل على وسوم Meta وOpen Graph وTwitter وJSON-LD، وإعدادات SEO تعدّلها من Filament، وربط اختياري مع Google Indexing API وSearch Console. الإضافة مجانية بترخيص MIT.

## ماذا تفعل

- تولّد وسوم Meta الأساسية للـ SEO
- تولّد وسوم Open Graph وبطاقات Twitter
- تولّد وسوم JSON-LD
- تفهرس صفحات منشئ المحتوى (CMS) تلقائيًا
- تتكامل مع Google Indexing API وSearch Console API
- تتكامل مع Google Analytics وGoogle Tag Manager
- تتكامل مع Axeptio لموافقة ملفات تعريف الارتباط

## المتطلبات

| الإضافة | Filament | Laravel | PHP |
|--------|----------|---------|-----|
| 5.x | 5.x | 12.x – 13.x | 8.2+ |
| 1.x | 3.x | 10.x – 11.x | 8.1+ |

## التثبيت في أربع خطوات

```bash
composer require tomatophp/filament-seo
php artisan filament-seo:install
```

تُحفظ الإعدادات عبر [Filament Settings Hub](https://tomatophp.com/ar/plugins/filament-settings-hub)، الذي ينشئ جدول `settings`، فلا تحتاج إلى نشر migration الخاص بـ spatie/laravel-settings بنفسك.

ثم سجّل الإضافة في `app/Providers/Filament/AdminPanelProvider.php`:

```php
->plugin(
    \TomatoPHP\FilamentSeo\FilamentSeoPlugin::make()
)
```

## أضف الوسوم إلى التخطيط

ضع الـ directive داخل `<head>` في تخطيط صفحاتك العامة:

```html
@filamentSeo
```

ولوسوم Meta استخدم المكوّن:

```html
<x-filament-meta />
```

والصفحات التي ترث هذا التخطيط تضبط قيمها عبر الأقسام:

```html
@section('title', 'PAGE TITLE')
@section('description', 'PAGE DESCRIPTION')
@section('image', 'PAGE IMAGE')
```

القيم الافتراضية للموقع كله تأتي من صفحة إعدادات SEO في لوحتك، فيغيّرها المحرر دون أي نشر جديد.

## اربط Google

اضبط `GOOGLE_CREDENTIALS` في ملف `.env` على مسار ملف بيانات حساب خدمة (Service Account) في Google:

```dotenv
GOOGLE_CREDENTIALS=
```

يحتاج حساب الخدمة إلى صلاحية [Indexing API](https://developers.google.com/search/apis/indexing-api/v3/quickstart) و[Search Console API](https://developers.google.com/webmaster-tools/about)، ويجب إضافته كمستخدم على خاصية موقعك في Search Console.

## حدود بصراحة

- **لا تدعم Meta Pixel وإعلانات X بعد.** هي في خطة التطوير، وليست في الحزمة حاليًا.
- **الـ Indexing API ليس طريقًا مختصرًا لكل صفحة.** توثّقه Google لصفحات الوظائف والبث المباشر. أما الصفحات العادية فالإشارة الأساسية ما زالت خريطة موقع صحيحة بتواريخ `lastmod` حقيقية.
- **مبنية لـ Blade.** تعمل الـ directives داخل تخطيطات Blade. إن كانت صفحاتك العامة بواجهة Inertia أو SPA، فوسوم كل صفحة تحتاج طريقة أخرى.

## الأسئلة الشائعة

### هل تعمل filament-seo مع Filament 5؟
نعم. الإصدار 5.x يدعم Filament 5 على Laravel 12 و13 مع PHP 8.2 أو أحدث. واستخدم 1.x مع Filament 3.

### هل إضافة Filament SEO مجانية؟
نعم. هي حزمة composer مفتوحة المصدر بترخيص MIT، مثل كل إضافات TomatoPHP.

### هل تولّد بيانات JSON-LD المنظمة؟
نعم. تولّد وسوم JSON-LD مع وسوم Meta وOpen Graph وTwitter.

### هل أحتاج بيانات اعتماد Google لاستخدامها؟
لا. الوسوم والإعدادات تعمل بدونها، وتحتاج حساب الخدمة فقط إن أردت ربط Indexing API وSearch Console.

## الخطوة التالية

- [صفحة الإضافة](https://tomatophp.com/ar/plugins/filament-seo) · [GitHub](https://github.com/tomatophp/filament-seo)
- [كل إضافات TomatoPHP لـ Filament](https://tomatophp.com/ar/plugins)

تريد موقع Laravel أو لوحة Filament جاهزة للـ SEO تُبنى لك؟ أقبل هذا العمل، بما فيه العمل باسم الوكالات (White-Label). اطّلع على [تطوير Laravel بنظام White-Label](https://fadymondy.com/ar/services/white-label-laravel-filament?utm_source=tomatophp&utm_medium=referral&utm_campaign=seo-content-oct26).

---

Source: https://tomatophp.com/ar/blog/filament-seo-plugin-meta-tags-json-ld-google-indexing