# 🌐 Iran Net Optimizer | بهینه‌ساز شبکه ایران

افزونه وردپرس برای مدیریت و بهینه‌سازی درخواست‌های خارجی در شرایط اینترنت محدود (مانند ایران)

---

## 📋 نیازمندی‌ها

- WordPress 5.8 یا بالاتر
- PHP 7.0 یا بالاتر
- دسترسی Administrator به پنل وردپرس

---

## 🚀 راهنمای نصب

### روش ۱: آپلود دستی

1. فایل زیپ افزونه را دانلود کنید
2. وارد پنل وردپرس شوید
3. به **افزونه‌ها > افزودن افزونه** بروید
4. روی **آپلود افزونه** کلیک کنید
5. فایل زیپ را انتخاب و آپلود کنید
6. افزونه را **فعال‌سازی** کنید

### روش ۲: FTP

1. پوشه `iran-net-optimizer` را در `/wp-content/plugins/` آپلود کنید
2. از پنل وردپرس، افزونه را فعال کنید

---

## 🎯 راهنمای استفاده

### مرحله ۱: اسکن سایت
ابتدا به **بهینه‌ساز شبکه > اسکن سایت** بروید و روی **شروع اسکن** کلیک کنید.
افزونه صفحه اصلی شما را بررسی و تمام منابع خارجی را شناسایی می‌کند.

### مرحله ۲: بومی‌سازی فونت‌ها
اگر از Google Fonts استفاده می‌کنید:
1. به **فونت‌ها** بروید
2. لینک CSS فونت را از سایت fonts.google.com کپی کنید
3. در کادر وارد کرده و **دانلود فونت** را بزنید
4. کد HTML نمایش داده‌شده را در سایت خود جایگزین لینک Google Fonts کنید

### مرحله ۳: مسدودسازی خارجی
به **درخواست‌های خارجی** بروید:
- **مسدودسازی** را فعال کنید
- دامنه‌های ضروری (مثل درگاه پرداخت) را در **لیست مجاز** وارد کنید

نمونه دامنه‌های ضروری:
```
zarinpal.com
*.idpay.ir
api.sms.ir
```

### مرحله ۴: تنظیم CSP
به **امنیت مرورگر** بروید:
- برای شروع، سطح **متعادل** را انتخاب کنید
- دامنه‌های فونت و CDN را اضافه کنید
- تنظیمات را ذخیره کنید

---

## 🔐 نکات امنیتی مهم

1. **nonce verification**: تمام درخواست‌های Ajax با nonce تأیید می‌شوند
2. **capability check**: فقط مدیران (`manage_options`) می‌توانند تنظیمات را تغییر دهند
3. **sanitization**: تمام ورودی‌ها قبل از ذخیره پاکسازی می‌شوند
4. **output escaping**: تمام خروجی‌ها escape می‌شوند
5. **domain validation**: دامنه‌های وارد شده اعتبارسنجی می‌شوند

### ⚠️ هشدارهای مهم

- **غیرفعال کردن ایمیل**: این گزینه باعث عدم ارسال ایمیل بازیابی رمز عبور می‌شود. فقط در محیط توسعه استفاده کنید.
- **CSP سخت‌گیرانه**: ممکن است برخی افزونه‌ها را از کار بیندازد. قبل از استفاده در محیط تولید، تست کامل کنید.
- **مسدودسازی خارجی**: درگاه‌های پرداخت و سرویس‌های ضروری را حتماً به whitelist اضافه کنید.

---

## 📁 ساختار فایل‌ها

```
iran-net-optimizer/
├── iran-net-optimizer.php      # فایل اصلی افزونه
├── includes/
│   ├── Core/
│   │   ├── Security.php        # لایه امنیتی
│   │   ├── Settings.php        # مدیریت تنظیمات
│   │   ├── HTTP_Manager.php    # مدیریت درخواست‌های HTTP
│   │   ├── Mail_Manager.php    # مدیریت ایمیل
│   │   ├── CSP_Manager.php     # مدیریت CSP
│   │   ├── Scanner.php         # اسکنر منابع خارجی
│   │   ├── Font_Manager.php    # مدیریت فونت‌ها
│   │   ├── Activator.php       # فعال‌سازی افزونه
│   │   └── Deactivator.php     # غیرفعال‌سازی افزونه
│   └── Admin/
│       ├── Admin_Controller.php # کنترلر پنل ادمین
│       └── Ajax_Handler.php     # مدیریت Ajax
├── admin/
│   └── views/
│       ├── dashboard.php       # صفحه داشبورد
│       ├── http-settings.php   # صفحه HTTP
│       ├── mail-settings.php   # صفحه ایمیل
│       ├── csp-settings.php    # صفحه CSP
│       ├── scan.php            # صفحه اسکن
│       └── fonts.php           # صفحه فونت‌ها
├── assets/
│   ├── css/admin.css           # استایل‌های ادمین
│   └── js/admin.js             # جاوااسکریپت ادمین
└── languages/                  # فایل‌های ترجمه
```

---

## 🔧 توسعه و سفارشی‌سازی

### اضافه کردن فیلتر جدید برای HTTP

```php
// اجازه دادن به یک هاست خاص از طریق کد
add_filter('ino_http_whitelist', function($whitelist) {
    $whitelist[] = 'my-api-server.com';
    return $whitelist;
});
```

### غیرفعال کردن CSP برای یک صفحه خاص

```php
add_action('template_redirect', function() {
    if (is_page('my-special-page')) {
        remove_action('send_headers', [$csp_manager, 'send_csp_headers']);
    }
});
```

---

## 📝 تغییرات نسخه‌ها

### نسخه ۱.۰.۰
- انتشار اولیه
- مدیریت درخواست‌های HTTP خارجی
- مدیریت ایمیل
- Content Security Policy
- اسکنر منابع خارجی
- مدیریت فونت‌های Google

---

## 📄 مجوز

GPL-2.0+
