ultimatepos/Modules/Superadmin/LOCALIZATION_IRAN.md

59 lines
2.6 KiB
Markdown

# راهنمای بومی‌سازی برای ایران
این فایل راهنمای بومی‌سازی ماژول Superadmin برای استفاده در ایران است.
## تغییرات اعمال شده
### 1. ترجمه فارسی
- تمام متن‌های ماژول به فارسی ترجمه شده‌اند
- فایل زبان فارسی در `Resources/lang/fa/lang.php` به‌روزرسانی شده است
- متن‌های هاردکد شده در ویوها به سیستم ترجمه منتقل شده‌اند
### 2. تنظیمات پیشنهادی برای ایران
#### واحد پول
برای تنظیم واحد پول به ریال ایران (IRR) یا تومان:
1. وارد پنل مدیریت شوید
2. به بخش "Super Admin Settings" بروید
3. در قسمت "Application Settings"، واحد پول را به "Iranian Rial (IRR)" یا "Iranian Toman" تغییر دهید
**نکته:** اگر واحد پول ایران در لیست موجود نیست، باید ابتدا آن را به جدول `currencies` در دیتابیس اضافه کنید:
```sql
INSERT INTO currencies (country, currency, code, symbol, thousand_separator, decimal_separator, exchange_rate, created_at, updated_at)
VALUES ('Iran', 'Iranian Rial', 'IRR', 'ریال', ',', '.', 1.00, NOW(), NOW());
-- یا برای تومان:
INSERT INTO currencies (country, currency, code, symbol, thousand_separator, decimal_separator, exchange_rate, created_at, updated_at)
VALUES ('Iran', 'Iranian Toman', 'IRT', 'تومان', ',', '.', 1.00, NOW(), NOW());
```
#### زبان پیش‌فرض
برای تنظیم زبان پیش‌فرض به فارسی:
1. وارد پنل مدیریت شوید
2. به بخش "Super Admin Settings" بروید
3. در قسمت "Application Settings"، "App Default Language" را به "fa" (فارسی) تغییر دهید
#### منطقه زمانی
برای تنظیم منطقه زمانی به ایران:
در فایل `.env` پروژه، منطقه زمانی را به `Asia/Tehran` تنظیم کنید:
```
APP_TIMEZONE=Asia/Tehran
```
#### فرمت تاریخ
اگر سیستم از تقویم شمسی پشتیبانی می‌کند، می‌توانید از پکیج‌های Laravel مانند `morilog/jalali` استفاده کنید.
## استفاده
پس از اعمال تغییرات، تمام رابط کاربری به فارسی نمایش داده می‌شود و تنظیمات برای استفاده در ایران بهینه شده‌اند.
## پشتیبانی
در صورت بروز مشکل، لطفاً با تیم پشتیبانی تماس بگیرید.