# Filament PWA: حوّل لوحة تحكم Laravel لتطبيق يتركّب على الموبايل

> خلّي لوحة Filament 5 تتركّب على الموبايل والكمبيوتر بـ tomatophp/filament-pwa: manifest وأيقونات وشاشات iOS واختصارات، كلها من صفحة إعدادات.

*2026-11-10T05:04:25Z*

فريقك بيفتح لوحة التحكم عشرين مرة في اليوم. على الموبايل ده معناه دوران على bookmark جوه المتصفح. الـ **PWA** بتحل ده: اللوحة يبقى ليها أيقونة على الشاشة الرئيسية، وتفتح فل سكرين، وتحس إنها تطبيق، من غير App Store.

`tomatophp/filament-pwa` بيضيف ده لأي لوحة Filament، وبتظبطه من صفحة إعدادات بدل ما تكتب JSON بإيدك.

## الإضافة بتديك إيه

- **Manifest** متولّد (الاسم، الاسم المختصر، رابط البداية، طريقة العرض، الاتجاه، الألوان، شكل شريط الحالة).
- **أيقونات** من 72×72 لحد 512×512، بترفعها مرة من اللوحة.
- **شاشات splash لـ iOS** من 640×1136 لحد 2048×2732.
- **اختصارات** (أوامر بالضغط الطويل على الأيقونة).
- Blade directive اسمه `@filamentPWA` لو عايز نفس الـ tags في صفحات بره Filament.

## التوافق

| إصدار الإضافة | Filament | Laravel | PHP |
|---|---|---|---|
| 5.x | 5.x | 12.x – 13.x | 8.2+ |
| 4.x | 4.x | | |
| 1.x | 3.x | | |

## التركيب في 4 خطوات

```bash
composer require tomatophp/filament-pwa
php artisan filament-settings-hub:install
php artisan filament-pwa:install
```

إعدادات الـ PWA بتتخزن في [Filament Settings Hub](/ar/plugins/filament-settings-hub)، عشان كده الأمر التاني بيعمل جدول `settings`.

وبعدين سجّل الإضافة في الـ panel provider:

```php
use TomatoPHP\FilamentPWA\FilamentPWAPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // …
        ->plugin(FilamentPWAPlugin::make());
}
```

افتح اللوحة، روح صفحة إعدادات الـ PWA، اكتب اسم التطبيق والألوان، ارفع الأيقونات وشاشات الـ splash، واحفظ.

## الإعدادات

انشر الـ config بـ `php artisan vendor:publish --tag=filament-pwa-config`. الخيارات قليلة:

- `middlewares`: middleware إضافي لـ routes الـ PWA (افتراضيًا `[]`).
- `allow_routes`: تسجيل routes الإضافة (افتراضيًا `true`).
- `upload_disk`: مكان حفظ الأيقونات (`FILAMENT_PWA_UPLOAD_DISK`، افتراضيًا `public`).

وتقدر تنشر الـ views (`filament-pwa-views`) والترجمات (`filament-pwa-lang`). والعربي موجود زي باقي TomatoPHP.

## استخدامها بره اللوحة

لو الموقع واللوحة على نفس الدومين، حط الـ directive قبل `</head>`:

```blade
@filamentPWA
```

## نصايح هتوفّر عليك وجع دماغ

- **لازم HTTPS.** المتصفحات مش بتعرض «تثبيت التطبيق» غير على اتصال آمن (ما عدا localhost).
- **أيقونات PNG مربعة** وفيها مساحة حوالين اللوجو، عشان Android مايقصّش منه.
- **خلّي رابط البداية هو مسار اللوحة** (مثلًا `/admin`).
- **جرّب التركيب على Safari في iOS** (مشاركة ← إضافة للشاشة الرئيسية) وعلى Chrome في Android والكمبيوتر.

## تضيف إيه بعد كده

- [Filament Users](/ar/plugins/filament-users) لإدارة المستخدمين.
- [Filament Language Switcher](/ar/plugins/filament-language-switcher) للعربي والإنجليزي مع RTL.
- [Filament Alerts](/ar/plugins/filament-alerts) للإشعارات.

أو امشي بالترتيب الكامل في [لوحة تحكم Laravel في يوم بـ Filament 5 و TomatoPHP](/ar/blog/laravel-admin-panel-in-a-day-filament-tomatophp).

عايز اللوحة تتبنى وتتبراند وتتسلّم لعميلك؟ [لوحات Laravel + Filament باسمك](https://fadymondy.com/ar/services/white-label-laravel-filament).

---

Source: https://tomatophp.com/ar/blog/filament-pwa-installable-admin-panel
