### 🎯 **چرا این افزونه منحصر به فرد است؟**

این افزونه با توجه به نیازهای خاص بازار ایران و زبان فارسی طراحی شده است. برخلاف افزونه‌های خارجی که عمدتاً برای زبان انگلیسی بهینه‌سازی شده‌اند، چت بات وب یار تولز از ابتدا با پشتیبانی کامل از زبان فارسی و راست به چپ (RTL) توسعه یافته است. این ویژگی باعث می‌شود که کاربران ایرانی بتوانند بدون هیچ مشکلی از این افزونه استفاده کنند.

🔄 برای دانلود نسخه به روز افزونه کلیک کنید

🔄 پنل API  وب یار تولز

## ��️ **معماری و ساختار فنی**

### **ساختار فایل‌ها و پوشه‌ها**

افزونه با معماری ماژولار و قابل توسعه طراحی شده است که شامل بخش‌های زیر می‌باشد:

```
webyar-chatbot/
├── webyar-chatbot.php          # فایل اصلی افزونه
├── admin/                      # پنل مدیریت
│   ├── admin-page.php         # صفحه تنظیمات اصلی
│   ├── stats-page.php         # آمار و گزارش‌ها
│   └── help-page.php          # راهنمای استفاده
├── assets/                     # فایل‌های استاتیک
│   ├── css/
│   │   ├── chatbot.css        # استایل‌های چت بات
│   │   └── admin.css          # استایل‌های پنل ادمین
│   └── js/
│       ├── chatbot.js         # عملکرد چت بات
│       └── admin.js           # عملکرد پنل ادمین
├── includes/                   # کلاس‌های پشتیبان
│   ├── class-admin-settings.php
│   ├── class-api-handler.php
│   ├── class-chat-interface.php
│   ├── class-security.php
│   └── class-utils.php
└── languages/                  # فایل‌های ترجمه
   └── webyar-chatbot.pot
```

### **کلاس‌های اصلی و مسئولیت‌های آن‌ها**

**1. کلاس اصلی WebYarChatbot:**
- مدیریت کلی افزونه
- راه‌اندازی hooks و actions
- هماهنگی بین کلاس‌های مختلف
- مدیریت session ها و امنیت

**2. کلاس WebYarChatbot_Admin_Settings:**
- مدیریت تنظیمات ادمین
- اعتبارسنجی ورودی‌ها
- ذخیره و بازیابی تنظیمات
- مدیریت فیلدهای فرم

**3. کلاس WebYarChatbot_API_Handler:**
- ارتباط با API وب یار تولز
- مدیریت درخواست‌ها و پاسخ‌ها
- لاگ‌گیری و آمارگیری
- مدیریت خطاها

**4. کلاس WebYarChatbot_Chat_Interface:**
- رندر رابط کاربری چت
- مدیریت شورت کدها
- تنظیمات ظاهری
- پیام‌های پیشنهادی

**5. کلاس WebYarChatbot_Security:**
- محافظت از اسپم
- محدودیت نرخ درخواست
- رمزگذاری داده‌های حساس
- لاگ‌گیری فعالیت‌های مشکوک

## �� **رابط کاربری و تجربه کاربری**

### **طراحی مدرن و ریسپانسیو**

رابط کاربری چت بات با الهام از بهترین نمونه‌های جهانی مانند Tidio و Intercom طراحی شده است. این طراحی شامل:

**ویژگی‌های بصری:**
- انیمیشن‌های نرم و جذاب
- رنگ‌بندی قابل تنظیم
- آیکون‌های متنوع و قابل تغییر
- فونت‌های مختلف برای پشتیبانی از زبان‌های مختلف

**تجربه کاربری:**
- باز و بسته شدن نرم چت
- نمایش وضعیت تایپ کردن
- ذخیره خودکار تاریخچه گفتگو
- نوتیفیکیشن‌های هوشمند

### **پشتیبانی کامل از RTL**

یکی از ویژگی‌های منحصر به فرد این افزونه، پشتیبانی کامل از راست به چپ است:

- تنظیم خودکار جهت متن
- چیدمان صحیح عناصر در حالت RTL
- پشتیبانی از فونت‌های فارسی
- تنظیم صحیح فاصله‌ها و حاشیه‌ها

## ⚙️ **تنظیمات و پیکربندی**

### **تنظیمات اصلی**

**1. تنظیمات API:**
- وارد کردن API Key از وب یار تولز
- انتخاب مدل هوش مصنوعی
- تنظیم دما (Temperature) برای کنترل خلاقیت
- تعیین حداکثر تعداد توکن

**2. تنظیمات ظاهری:**
- انتخاب موقعیت چت بات (4 موقعیت مختلف)
- تنظیم رنگ اصلی
- انتخاب آیکون یا ایموجی
- انتخاب فونت

**3. تنظیمات پیشرفته:**
- انتخاب صفحات نمایش
- تنظیم دستورالعمل سیستم
- مدیریت session ها
- تنظیمات امنیتی

### **مدل‌های هوش مصنوعی پشتیبانی شده**

افزونه از تمام مدل‌های OpenAI پشتیبانی می‌کند:

**مدل‌های متنی:**
- GPT-3.5 Turbo (پیشنهادی برای شروع)
- GPT-3.5 Turbo 16K (برای متن‌های طولانی)
- GPT-4 (قدرتمندترین مدل)
- GPT-4 Turbo (بهینه‌شده برای سرعت)
- GPT-4o (جدیدترین مدل)
- GPT-4o Mini (اقتصادی و سریع)

**مدل‌های تصویر:**
- DALL-E 2 (تولید تصویر)
- DALL-E 3 (تولید تصویر پیشرفته)

## �� **نحوه نصب و راه‌اندازی**

### **مرحله 1: دریافت API Key**

1. **ثبت‌نام در وب یار تولز:**
  - وارد سایت webyartools.com شوید
  - حساب کاربری ایجاد کنید
  - اطلاعات خود را تکمیل کنید

2. **دریافت API Key:**
  - به بخش "API" بروید
  - روی "درخواست توکن" کلیک کنید
  - توکن ایجاد شده را کپی کنید

### **مرحله 2: نصب افزونه**

1. **آپلود فایل‌ها:**
  - فایل افزونه را در `/wp-content/plugins/` قرار دهید
  - اطمینان حاصل کنید که پوشه `webyar-chatbot` کامل باشد

2. **فعال‌سازی:**
  - وارد پنل ادمین وردپرس شوید
  - به بخش "افزونه‌ها" بروید
  - "چت بات وب یار تولز" را فعال کنید

### **مرحله 3: تنظیمات اولیه**

1. **وارد کردن API Key:**
  - به "چت بات وب یار تولز" بروید
  - API Key خود را وارد کنید
  - روی "بررسی API" کلیک کنید

2. **تنظیمات ظاهری:**
  - موقعیت چت بات را انتخاب کنید
  - رنگ و آیکون مورد نظر را تنظیم کنید
  - فونت مناسب را انتخاب کنید

3. **فعال‌سازی:**
  - چک باکس "فعال/غیرفعال" را تیک بزنید
  - تنظیمات را ذخیره کنید

## �� **آمار و گزارش‌گیری**

### **آمار کلی**

افزونه شامل سیستم آمارگیری جامعی است که شامل:

**آمار کلی:**
- تعداد کل پیام‌های ارسال شده
- تعداد کل توکن‌های استفاده شده
- تعداد session های منحصر به فرد
- میانگین پیام به ازای هر کاربر

**آمار روزانه:**
- نمودار آمار 7 روز گذشته
- تعداد پیام‌ها در هر روز
- مصرف توکن روزانه
- میانگین توکن به ازای هر پیام

### **لاگ‌های تفصیلی**

**اطلاعات ذخیره شده:**
- متن پیام کاربر
- پاسخ ربات
- تعداد توکن استفاده شده
- زمان دقیق ارسال
- شناسه session

**قابلیت‌های لاگ:**
- جستجو در لاگ‌ها
- فیلتر بر اساس تاریخ
- صادرات لاگ‌ها
- پاک کردن لاگ‌های قدیمی

## 🛡️ **امنیت و محافظت**

### **ویژگی‌های امنیتی**

**1. محافظت از اسپم:**
- تشخیص الگوهای اسپم
- فیلتر کردن پیام‌های مشکوک
- محدودیت تعداد پیام در زمان مشخص

**2. محدودیت نرخ درخواست:**
- حداکثر 60 درخواست در دقیقه
- مسدود کردن IP های مشکوک
- سیستم هشدار برای فعالیت‌های غیرعادی

**3. رمزگذاری داده‌ها:**
- رمزگذاری API Key
- محافظت از اطلاعات حساس
- استفاده از nonce برای امنیت

**4. اعتبارسنجی ورودی:**
- پاکسازی تمام ورودی‌ها
- محدودیت طول پیام
- حذف کاراکترهای خطرناک

### **مدیریت session ها**

**ویژگی‌های session:**
- شناسه منحصر به فرد برای هر کاربر
- ذخیره تاریخچه گفتگو
- مدیریت حافظه و پاکسازی خودکار
- پشتیبانی از چندین session همزمان

## �� **استفاده از شورت کد**

### **شورت کد ساده**

```php
[webyar_chatbot]
```

### **شورت کد با پارامترهای سفارشی**

```php
[webyar_chatbot position="bottom-left" color="#FF5722" icon="💬" font="Arial"]
```

### **پارامترهای موجود**

**position:** موقعیت چت بات
- `bottom-right` (پایین راست) - پیش‌فرض
- `bottom-left` (پایین چپ)
- `top-right` (بالا راست)
- `top-left` (بالا چپ)

**color:** رنگ اصلی
- فرمت هگزادسیمال (مثال: #4CAF50)
- پشتیبانی از تمام رنگ‌ها

**icon:** آیکون یا ایموجی
- مثال: 💬, ��, 📞, 🛍️, 🎧, ��, ��
- پشتیبانی از تمام ایموجی‌ها

**font:** فونت
- Tahoma, Arial, Verdana, Helvetica
- IRANSans, Samim, Shabnam (فونت‌های فارسی)

## �� **ریسپانسیو و موبایل**

### **طراحی ریسپانسیو**

**ویژگی‌های موبایل:**
- تنظیم خودکار اندازه در موبایل
- موقعیت ثابت در گوشه پایین راست
- بهینه‌سازی برای لمس
- پشتیبانی از gesture ها

**Breakpoint ها:**
- موبایل: کمتر از 768px
- تبلت: 768px تا 1024px
- دسکتاپ: بیشتر از 1024px

### **بهینه‌سازی عملکرد**

**تکنیک‌های بهینه‌سازی:**
- بارگذاری تنبل (Lazy Loading)
- فشرده‌سازی فایل‌ها
- کش کردن استایل‌ها و اسکریپت‌ها
- حداقل‌سازی درخواست‌های HTTP

## 🔄 **مدیریت به‌روزرسانی**

### **سیستم به‌روزرسانی**

**به‌روزرسانی خودکار:**
- بررسی خودکار نسخه‌های جدید
- اعلان به‌روزرسانی در پنل ادمین
- نصب یک‌کلیکه به‌روزرسانی

**به‌روزرسانی دستی:**
- دانلود نسخه جدید
- جایگزینی فایل‌ها
- حفظ تنظیمات موجود

### **سازگاری با نسخه‌ها**

**نسخه‌های پشتیبانی شده:**
- وردپرس 5.0 و بالاتر
- PHP 7.4 و بالاتر
- MySQL 5.6 و بالاتر

## 🎨 **مثال‌های کاربردی**

### **چت بات برای فروشگاه**

```php
[webyar_chatbot position="bottom-right" color="#E91E63" icon="🛍️" font="IRANSans"]
```

**ویژگی‌های مناسب:**
- رنگ صورتی جذاب
- آیکون فروشگاه
- فونت فارسی
- موقعیت پایین راست

### **چت بات برای پشتیبانی**

```php
[webyar_chatbot position="bottom-left" color="#2196F3" icon="��" font="Tahoma"]
```

**ویژگی‌های مناسب:**
- رنگ آبی حرفه‌ای
- آیکون پشتیبانی
- فونت خوانا
- موقعیت پایین چپ

### **چت بات برای مشاوره**

```php
[webyar_chatbot position="top-right" color="#4CAF50" icon="💼" font="Arial"]
```

**ویژگی‌های مناسب:**
- رنگ سبز اعتماد
- آیکون مشاوره
- فونت حرفه‌ای
- موقعیت بالا راست

### **چت بات برای آموزش**

```php
[webyar_chatbot position="top-left" color="#FF9800" icon="📚" font="Verdana"]
```

**ویژگی‌های مناسب:**
- رنگ نارنجی انرژی‌بخش
- آیکون آموزش
- فونت مناسب مطالعه
- موقعیت بالا چپ

## ��️ **عیب‌یابی و حل مشکلات**

### **مشکلات رایج و راه‌حل‌ها**

**1. چت بات نمایش داده نمی‌شود:**
- بررسی فعال بودن افزونه
- بررسی صحت API Key
- پاک کردن کش مرورگر
- بررسی تداخل با افزونه‌های دیگر

**2. خطا در ارسال پیام:**
- بررسی اتصال اینترنت
- بررسی اعتبار API Key
- بررسی موجودی توکن
- بررسی لاگ‌های خطا

**3. مشکلات ظاهری:**
- بررسی تداخل CSS
- بررسی بارگذاری فونت‌ها
- بررسی تنظیمات رنگ
- بررسی سازگاری تم

### **لاگ‌گیری و دیباگ**

**اطلاعات لاگ:**
- زمان دقیق خطا
- نوع خطا
- جزئیات درخواست
- پاسخ سرور

**ابزارهای دیباگ:**
- کنسول مرورگر
- لاگ‌های وردپرس
- لاگ‌های افزونه
- ابزارهای توسعه‌دهنده

## �� **بهینه‌سازی عملکرد**

### **تکنیک‌های بهینه‌سازی**

**1. بهینه‌سازی پایگاه داده:**
- ایندکس‌گذاری جداول
- پاکسازی منظم لاگ‌ها
- بهینه‌سازی کوئری‌ها

**2. بهینه‌سازی فایل‌ها:**
- فشرده‌سازی CSS و JS
- بهینه‌سازی تصاویر
- استفاده از CDN

**3. بهینه‌سازی کش:**
- کش کردن تنظیمات
- کش کردن پاسخ‌های API
- کش کردن فایل‌های استاتیک

### **نظارت بر عملکرد**

**معیارهای عملکرد:**
- زمان بارگذاری چت بات
- سرعت پاسخ API
- مصرف حافظه
- تعداد درخواست‌های همزمان

## �� **پشتیبانی چندزبانه**

### **فایل‌های ترجمه**

**زبان‌های پشتیبانی شده:**
- فارسی (پیش‌فرض)
- انگلیسی
- عربی
- ترکی

**نحوه ترجمه:**
- فایل‌های .pot برای مترجمان
- پشتیبانی از WPML
- ترجمه خودکار با Google Translate

### **محلی‌سازی**

**ویژگی‌های محلی‌سازی:**
- تنظیم خودکار جهت متن
- فرمت تاریخ و زمان محلی
- واحدهای پولی محلی
- فرهنگ‌های مختلف

## 🔮 **آینده و توسعه**

### **ویژگی‌های آینده**

**نسخه 1.1:**
- پشتیبانی از voice chat
- ادغام با CRM ها
- هوش مصنوعی پیشرفته‌تر
- پنل مدیریت موبایل

**نسخه 1.2:**
- پشتیبانی از چندین زبان همزمان
- ادغام با سیستم‌های پرداخت
- گزارش‌گیری پیشرفته‌تر
- API برای توسعه‌دهندگان

### **راه‌های مشارکت**

**نحوه مشارکت:**
- گزارش باگ‌ها
- پیشنهاد ویژگی‌های جدید
- مشارکت در ترجمه
- مشارکت در توسعه

## 📞 **پشتیبانی و تماس**

### **کانال‌های پشتیبانی**

**وب‌سایت:** webyartools.com
**ایمیل:** info@webyartools.com
**تلگرام:** @webyartools
**واتساپ:** 09100508033

### **ساعات پشتیبانی**

**پشتیبانی فنی:** 24/7
**پشتیبانی فروش:** 9 صبح تا 6 عصر
**پشتیبانی اضطراری:** 24/7

## �� **نتیجه‌گیری**

افزونه چت بات وب یار تولز یک راه‌حل جامع و حرفه‌ای برای اضافه کردن قابلیت چت هوش مصنوعی به وب‌سایت‌های وردپرس است. این افزونه با ویژگی‌های منحصر به فرد خود، تجربه‌ای بی‌نظیر از تعامل با مشتریان را فراهم می‌کند و به صاحبان وب‌سایت‌ها کمک می‌کند تا ارتباط بهتری با مخاطبان خود برقرار کنند.

با پشتیبانی کامل از زبان فارسی، امنیت بالا، رابط کاربری زیبا و قابلیت‌های پیشرفته، این افزونه انتخاب مناسبی برای هر نوع وب‌سایتی است. از فروشگاه‌های آنلاین گرفته تا سایت‌های شرکتی و آموزشی، همه می‌توانند از این افزونه بهره‌مند شوند.

نصب و راه‌اندازی آسان، تنظیمات کامل، آمارگیری جامع و پشتیبانی 24/7، این افزونه را به یکی از بهترین راه‌حل‌های موجود در بازار تبدیل کرده است.