# Unofficial Yektanet WordPress Plugin

افزونه غیررسمی اتصال وردپرس به یکتانت - راه‌حل کامل آنالیتیکس و ریتارگتینگ

## درباره افزونه

این افزونه امکان اتصال سایت وردپرس شما به پلتفرم تبلیغات یکتانت را فراهم می‌کند و به شما امکان ردیابی و ریتارگتینگ محصولات را می‌دهد.

## ویژگی‌ها

### ✅ دو روش اتصال
- **روش اول: استفاده از App ID** (پیشنهادی)
  - ساده و سریع
  - مدیریت خودکار اسکریپت‌ها
  - پشتیبانی کامل از آنالیتیکس
  
- **روش دوم: استفاده از اسکریپت دستی**
  - امکان استفاده از اسکریپت سفارشی
  - پشتیبانی از ریتارگتینگ محصولات

### ✅ ردیابی کامل محصولات
- **مشاهده محصول**: ردیابی بازدید صفحات محصول
- **اضافه به سبد خرید**: ردیابی اضافه کردن محصولات به سبد خرید
- **خرید**: ردیابی کامل سفارشات و خریدها

### ✅ صفحه آمار و آنالیتیکس
- نمایش آمار بازدید محصولات در بازه‌های زمانی مختلف
- چارت‌های تعاملی با Highcharts
- امکان مشاهده محصولات پربازدید در بازه‌های:
  - همه زمان‌ها
  - سه ماه گذشته
  - یک ماه گذشته
  - یک هفته گذشته
  - یک روز گذشته

### ✅ ویژگی‌های پیشرفته
- ردیابی پارامترهای UTM
- ردیابی کوکی‌های یکتانت
- به‌روزرسانی خودکار اطلاعات محصولات
- پاکسازی خودکار داده‌های قدیمی (بیش از 3 ماه)
- پشتیبانی از محصولات متغیر (Variations)
- مدیریت خودکار SKU محصولات

### ✅ سازگاری و امنیت
- سازگار با PHP 8.1+
- سازگار با WordPress 6.0+
- سازگار با WooCommerce
- امنیت بالا با sanitization و nonce verification
- معماری شی‌گرا و کد تمیز

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

### پیش‌نیازها
- WordPress 6.0 یا بالاتر
- PHP 8.1 یا بالاتر
- WooCommerce (برای استفاده از ویژگی‌های محصولات)

### مراحل نصب

1. افزونه را دانلود و در پوشه `wp-content/plugins/` آپلود کنید
2. افزونه را از پنل مدیریت وردپرس فعال کنید
3. به صفحه **یکتانت > تنظیمات** بروید
4. یکی از روش‌های اتصال را انتخاب کنید:
   - **روش اول**: App ID خود را از پنل یکتانت دریافت کرده و وارد کنید (8 کاراکتر)
   - **روش دوم**: کد اسکریپت یکتانت را به صورت دستی وارد کنید
5. تنظیمات را ذخیره کنید

## استفاده

### روش اول: استفاده از App ID
1. App ID خود را از پنل یکتانت دریافت کنید
2. در صفحه تنظیمات، روش اول را انتخاب کنید
3. App ID را وارد کنید (8 کاراکتر)
4. تنظیمات را ذخیره کنید

### روش دوم: استفاده از اسکریپت دستی
1. در صفحه تنظیمات، روش دوم را انتخاب کنید
2. کد اسکریپت یکتانت را در فیلد مربوطه وارد کنید
3. برند محصولات را وارد کنید (اختیاری)
4. تنظیمات را ذخیره کنید

### مشاهده آمار
- برای مشاهده آمار بازدید محصولات، به صفحه **یکتانت > آمار** بروید
- **توجه**: صفحه آمار فقط با روش اول (App ID) کار می‌کند

## پشتیبانی

- **وب‌سایت**: [amalian.ir](https://www.amalian.ir)
- **پنل یکتانت**: [yektanet.com](https://www.yektanet.com)

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

### نسخه 2.0.0
- بازنویسی کامل افزونه
- افزودن مدیریت App ID
- افزودن ردیابی افزودن به سبد خرید
- افزودن ردیابی مشاهده محصول با جدول دیتابیس
- افزودن یکپارچه‌سازی API به‌روزرسانی محصول
- افزودن داشبورد آنالیتیکس با چارت‌ها
- افزودن ردیابی تغییر وضعیت سفارش
- افزودن ردیابی پارامترهای UTM
- افزودن ردیابی کوکی‌ها
- پاکسازی خودکار داده‌های قدیمی
- سازگاری با PHP 8.1+ و WordPress 6.0+
- بهبود امنیت
- سازگاری با متد قدیمی اسکریپت دستی

## مجوز

این افزونه تحت مجوز GPLv3 منتشر شده است.

## کپی‌رایت

تمام حقوق برای [مجتبی عملیان](https://www.amalian.ir) و [یکتانت](https://www.yektanet.com) محفوظ است.