=== Unofficial Yektanet ===
Contributors: amalian
Donate link: https://amalian.ir/plugin/unofficialYektanet/donate
Tags: yektanet,تبلیغات,ریتارگتینگ,ads,یکتانت,analytics,woocommerce,retargeting
Requires at least: 6.0
Tested up to: 6.5
Stable tag: 2.0.0
Requires PHP: 8.1
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.txt

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

== Description ==

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

**ویژگی‌های اصلی:**

* دو روش اتصال: استفاده از App ID یا اسکریپت دستی
* ردیابی کامل محصولات: مشاهده، اضافه به سبد، خرید
* صفحه آمار با چارت‌های تعاملی
* ردیابی پارامترهای UTM و کوکی‌ها
* به‌روزرسانی خودکار اطلاعات محصولات
* پاکسازی خودکار داده‌های قدیمی
* سازگار با WooCommerce

**نحوه استفاده:**

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

**مشاهده آمار:**

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

Connect WordPress to Yektanet.com - Complete Analytics and Retargeting Solution

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/unofficialYektanet` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to "یکتانت > تنظیمات" (Yektanet > Settings) page.
4. Choose your connection method:
   * Method 1: Enter your App ID (8 characters) from Yektanet panel
   * Method 2: Manually enter your Yektanet script code
5. Save settings.

== Frequently Asked Questions ==

= آیا نیاز به WooCommerce دارم؟ =

بله، برای استفاده از ویژگی‌های ردیابی محصولات، نیاز به WooCommerce دارید.

= تفاوت روش اول و دوم چیست؟ =

روش اول (App ID) پیشنهادی است و مدیریت خودکار اسکریپت‌ها و پشتیبانی کامل از آنالیتیکس را دارد. روش دوم (اسکریپت دستی) برای کسانی است که می‌خواهند از اسکریپت سفارشی استفاده کنند.

= صفحه آمار چطور کار می‌کند؟ =

صفحه آمار فقط با روش اول (App ID) کار می‌کند و آمار بازدید محصولات را در بازه‌های زمانی مختلف نمایش می‌دهد.

= آیا افزونه رایگان است؟ =

بله، این افزونه کاملاً رایگان است و تحت مجوز GPLv3 منتشر شده است.

= از کجا App ID خود را دریافت کنم؟ =

App ID خود را از پنل یکتانت دریافت کنید.

== Screenshots ==

1. صفحه تنظیمات - انتخاب روش اتصال
2. صفحه تنظیمات - وارد کردن App ID
3. صفحه تنظیمات - وارد کردن اسکریپت دستی
4. صفحه آمار - نمایش چارت‌های بازدید محصولات

== Changelog ==

= 2.0.0 =
* بازنویسی کامل افزونه با تمام ویژگی‌ها
* افزودن مدیریت App ID (8 کاراکتر)
* افزودن ردیابی اضافه به سبد خرید
* افزودن ردیابی مشاهده محصول با جدول دیتابیس
* افزودن یکپارچه‌سازی API به‌روزرسانی محصول
* افزودن داشبورد آنالیتیکس با چارت‌ها (Highcharts)
* افزودن ردیابی تغییر وضعیت سفارش
* افزودن ردیابی پارامترهای UTM
* افزودن ردیابی کوکی‌ها (_yngt, analytics_session_token, analytics_campaign)
* پاکسازی خودکار داده‌های قدیمی (بیش از 3 ماه)
* سازگاری با PHP 8.1+ و WordPress 6.0+
* بهبود امنیت با sanitization و nonce verification
* سازگاری با متد قدیمی اسکریپت دستی
* بهبود رابط کاربری صفحه آمار
* افزودن Switch برای انتخاب روش اتصال
* بهبود نمایش و مدیریت اسکریپت‌ها

= 1.1.0 =
* به‌روزرسانی برای سازگاری با PHP 8.2
* به‌روزرسانی برای سازگاری با WordPress 6.5
* جایگزینی file_get_contents با wp_remote_get برای یکپارچگی بهتر با وردپرس
* افزودن اعلان نوع برای PHP 8.2
* افزودن بررسی null و مدیریت خطا
* بهبود escaping و sanitization برای امنیت
* رفع باگ‌های متغیرهای تعریف نشده
* افزودن بررسی وابستگی WooCommerce
* بهبود کیفیت کد و بهترین روش‌ها

= 1.0.0 =
* انتشار اولیه

== Upgrade Notice ==

= 2.0.0 =
این نسخه نیاز به PHP 8.1 یا بالاتر و WordPress 6.0 یا بالاتر دارد. تمام ویژگی‌های افزونه yektanet-ecommerce اکنون در این افزونه گنجانده شده است. این یک به‌روزرسانی بزرگ است که شامل بازنویسی کامل افزونه، ویژگی‌های جدید و بهبودهای قابل توجهی می‌شود.

= 1.1.0 =
به‌روزرسانی برای سازگاری با PHP 8.2 و WordPress 6.5. بهبودهای امنیتی و رفع باگ‌ها.

== Support ==

برای پشتیبانی و سوالات، به [وب‌سایت amalian.ir](https://www.amalian.ir) مراجعه کنید.

== Credits ==

ساخته شده با عشق توسط [مجتبی عملیان](https://www.amalian.ir)

== License ==

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

تمام حقوق برای مجتبی عملیان و شرکت یکتانت محفوظ است.
