Download the PHP package sghazanfari/filament-persian without Composer
On this page you can find all versions of the php package sghazanfari/filament-persian. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sghazanfari/filament-persian
More information about sghazanfari/filament-persian
Files in sghazanfari/filament-persian
Package filament-persian
Short Description Complete Persian (Farsi) localization for Filament v5 — Jalali calendar, RTL, Iranian validations, Persian numbers, and 10 login templates.
License MIT
Homepage https://github.com/ghazanfaris/filament-persian
Informations about the package filament-persian
🇮🇷 Filament Persian
کاملترین پکیج فارسیسازی برای Filament v5 — تقویم جلالی، RTL، اعتبارسنجی ایرانی، اعداد فارسی و ۱۰ قالب صفحه ورود.
✨ چرا این پکیج؟
Filament یک فریمورک فوقالعاده برای پنل ادمین است، ولی برای زبان فارسی چند کمبود اساسی دارد:
- ❌ تقویم میلادی است، نه شمسی
- ❌ راستچین ناقص یا ناموجود است
- ❌ اعداد لاتین نمایش میدهد
- ❌ اعتبارسنجیهای ایرانی ندارد
- ❌ جستجوی فارسی (ی/ک عربی) کار نمیکند
- ❌ صفحه لاگین فارسی حرفهای ندارد
این پکیج همه اینها را حل میکند — یکجا، تمیز، حرفهای.
📋 فهرست مطالب
- ویژگیها
- نصب
- شروع سریع
- مستندات
- مثالهای کاربردی
- پشتیبانی
- لایسنس
🎯 ویژگیها
📅 تقویم جلالی
- کامپوننت
JalaliDatePickerبرای فرمها - ستون
JalaliDateColumnبرای جداول - فیلتر
JalaliDateFilterبرای بازهها - تبدیل خودکار با
AutoJalaliDates - تقویم JS مستقل (بدون وابستگی خارجی)
✅ اعتبارسنجی ایرانی
- کد ملی با checksum
- موبایل با پشتیبانی از
+98,0098,98 - شبا با الگوریتم IBAN
- کد پستی ۱۰ رقمی
- شماره کارت با تشخیص بانک
- شناسه ملی حقوقی
- شماره اقتصادی
- پلاک خودرو ایران
- شماره بیمه تأمین اجتماعی
- کد بورسی
- شماره گذرنامه
🗺️ دادههای آماده ایران
- ۳۱ استان با مرکز و اسلاگ
- ۳۱۵ شهر مهم
- ۳۰ بانک با پیشوند کارت و کد شبا
- ۲۲ منطقه شهرداری تهران
- Select استان/شهر وابسته
⏰ تعطیلات و ساعت کاری
- تعطیلات شمسی ثابت (نوروز، ۲۲ بهمن، ...)
- تعطیلات قمری (۱۴۰۳-۱۴۱۰)
- تعطیلات هفتگی (جمعه)
- ساعت کاری اداری قابل تنظیم
- محاسبه روز کاری بعدی
🔢 اعداد و مبالغ فارسی
PersianTextColumnبرای متنهای عددیPersianMoneyColumnبرای مبالغPersianNumberInputبا فرمت خودکار- تبدیل خودکار ارقام در کل پنل
🎨 ظاهر و UX
- RTL کامل همه کامپوننتها
- فونتهای فارسی (Vazirmatn, Estedad, Sahel, Samim, Shabnam)
- ۲۰ رنگ آماده
- صفحه تنظیمات ظاهری با ۶ تب
- ۱۰ قالب صفحه ورود
🔐 صفحه ورود
- ۱۰ قالب آماده (classic, minimal, split, glass, gradient, dark, neon, corporate, wave, pattern)
- پشتیبانی از 2FA
- ویرایش متنها از پنل
- رنگ و فونت پویا
📊 ویجت و نمودار
PersianStatsWidgetانتزاعیPersianChartWidgetبا محور جلالی- Tooltip فارسی
🔍 جستجو
HasPersianGlobalSearchبا نرمالسازی ی/ک- Command Palette با
Ctrl+K
🖼️ پروفایل کاربر
- ویرایش نام، ایمیل، آواتار
- تغییر رمز عبور
- نمایش آواتار در منو
🚀 نصب
پیشنیازها
- PHP 8.2+
- Laravel 11, 12 یا 13
- Filament 5.x
گام ۱ — نصب پکیج
نکته: اگر در ایران هستی و به Packagist دسترسی نداری:
گام ۲ — اجرای دستور نصب
این دستور:
- فایل config را منتشر میکند
- ترجمههای فارسی را کپی میکند
- Asset های JS/CSS را در
public/vendor/filament-persian/میگذارد - پوشه
storage/app/filament-persian/را میسازد
گام ۳ — تنظیم .env
گام ۴ — ثبت Plugin
فایل app/Providers/Filament/AdminPanelProvider.php:
گام ۵ — درج شهرهای ایران
گام ۶ — بررسی نصب
باید خروجی سبز ببینی.
⚡ شروع سریع
بعد از نصب، این کارها را انجام بده:
- تنظیم ظاهر: پنل → تنظیمات ظاهری → فونت و رنگ را انتخاب کن
- انتخاب قالب ورود: تنظیمات ظاهری → تب صفحه ورود → یکی از ۱۰ قالب
- مشاهده مستندات: پنل → مستندات (۱۳ فایل راهنما)
- مشاهده کامپوننتها: پنل → کامپوننتهای آماده (کد قابل کپی)
📚 مستندات
مستندات کامل بهصورت داخلی در پنل قابل دسترسی است:
پنل → مستندات
۱۳ فایل مستندات:
- معرفی و نصب
- تقویم جلالی
- اعداد فارسی
- اعتبارسنجیها
- کامپوننتها
- ویجتها
- جستجو
- تنظیمات
- تغییرات
- دادههای ایران
- تعطیلات و ساعت کاری
- قالبهای صفحه ورود
💡 مثالهای کاربردی
مثال ۱: فرم سفارش با تاریخ جلالی
مثال ۲: جدول سفارشها
مثال ۳: ویجت آمار
مثال ۴: جستجوی فارسی
مثال ۵: بررسی تعطیلی
مثال ۶: Helper Functions
🎨 پیکربندی
فایل config/filament-persian.php:
همه اینها از تنظیمات ظاهری در پنل هم قابل تغییر هستند.
⌨️ دستورات Artisan
🔐 امنیت
- تمام اعتبارسنجیها با checksum استاندارد
- رعایت OWASP Top 10
- بدون وابستگی خارجی مشکوک
- لایسنس MIT
برای گزارش مشکل امنیتی: ایمیل بزن به [email protected]
🤝 مشارکت
Pull Request ها پذیرفته میشوند. برای تغییرات بزرگ، اول Issue باز کن.
📄 لایسنس
MIT License. LICENSE.md را ببین.
🙏 تشکر
- Filament — فریمورک فوقالعاده
- Vazirmatn — فونت زیبا
- Spatie — پکیجهای بینظیر
- و همه کسانی که باگ گزارش دادند یا مشارکت کردند
🔗 لینکهای مفید
All versions of filament-persian with dependencies
filament/filament Version ^4.0|^5.0
illuminate/support Version ^11.0|^12.0|^13.0
illuminate/database Version ^11.0|^12.0|^13.0