=== Moaref – کد معرف و کیف پول ===
Tags: referral, wallet, cashback, woocommerce, affiliate
Requires at least: 4.9
Tested up to: 7.2
Requires PHP: 7.0
Stable tag: 4.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Author: ماهان رضائی
Author URI: https://co.shainika.com

سیستم کد معرف، کمیسیون خرید، کش‌بک و کیف پول تومانی برای وردپرس و ووکامرس. رایگان، متن‌باز (GPL) و بدون نیاز به لایسنس.

== Description ==

* کد معرف و لینک دعوت اختصاصی برای هر کاربر (`?ref=CODE`)
* هدیه برای کاربر جدید و پاداش ثابت برای معرف (بلافاصله یا بعد از اولین خرید تکمیل‌شده)
* کمیسیون درصدی از خرید معرفی‌شده‌ها، با سطح‌بندی سه‌مرحله‌ای بر اساس تعداد معرفی
* کش‌بک خرید: تومانی پله‌ای یا درصدی ثابت
* مهلت روزی جداگانه برای معرفی‌کننده و معرفی‌شده
* کیف پول تومانی: پرداخت بخشی از سفارش با کیف پول در تسویه حساب، مدیریت موجودی از پیشخوان، تاریخچه تراکنش‌ها
* برگشت خودکار کمیسیون، کش‌بک و مبلغ کیف پول با لغو یا استرداد سفارش
* تشخیص خودکار واحد پول ووکامرس (ریال، تومان، هزار ریال، هزار تومان)
* اگر TeraWallet نصب باشد، موجودی مستقیماً در آن ثبت می‌شود
* سازگار با ذخیره‌سازی سفارش HPOS ووکامرس
* همه متن‌ها قابل ترجمه هستند (Text Domain: `moaref`، فایل الگو: `languages/moaref.pot`)

همه مبالغ تنظیمات و گزارش‌ها به «تومان» هستند.

== Installation ==

1. از پیشخوان: افزونه‌ها ← افزودن ← بارگذاری افزونه ← فایل `moaref.zip` را انتخاب و نصب کنید.
2. افزونه را فعال کنید.
3. تنظیمات در منوی «کاربران»: «کد معرف»، «کیف پول» و «کش‌بک».
4. پنل کاربر به‌طور خودکار در پیشخوان «حساب کاربری من» ووکامرس نمایش داده می‌شود؛ در هر صفحه دیگر (هر قالب یا صفحه‌ساز) از شورت‌کد `[moaref_panel]` استفاده کنید.

اگر قبلاً نسخه اسنیپت (Code Snippets) را استفاده می‌کردید: اسنیپت را غیرفعال کنید و افزونه را فعال کنید. نام تنظیمات و کلیدهای داده یکی است، پس تنظیمات، کدهای معرف و موجودی کیف پول کاربران بدون تغییر منتقل می‌شوند.

== Frequently Asked Questions ==

= چک‌باکس کیف پول در صفحه تسویه حساب دیده نمی‌شود =

چک‌باکس در تسویه حساب کلاسیک ووکامرس نمایش داده می‌شود. اگر صفحه تسویه حساب با بلوک ووکامرس ساخته شده (پیش‌فرض قالب‌های بلوکی)، محتوای صفحه را با شورت‌کد `[woocommerce_checkout]` جایگزین کنید. بقیه امکانات (کد معرف، کمیسیون، کش‌بک) با تسویه بلوکی هم کار می‌کنند.

= لینک دعوت ثبت نمی‌شود =

اگر افزونه کش (LiteSpeed Cache، WP Rocket و ...) دارید، پارامتر `ref` را از کش مستثنا کنید.

= هدیه کاربر جدید چه زمانی واریز می‌شود؟ =

به‌طور پیش‌فرض بعد از اولین خرید تکمیل‌شده (برای جلوگیری از جمع کردن هدیه با اکانت‌های فیک). از «کاربران ← کد معرف ← زمان واریز هدیه» می‌توانید آن را روی «بلافاصله بعد از ثبت کد معرف» بگذارید.

= با حذف افزونه اطلاعات پاک می‌شود؟ =

خیر. برای جلوگیری از از دست رفتن موجودی کیف پول کاربران، تنظیمات و داده‌ها با حذف افزونه پاک نمی‌شوند.

== Changelog ==

= 4.1.0 =
* تبدیل از اسنیپت به افزونه مستقل و رایگان (GPL)
* سازگاری با وردپرس ۴.۹ به بعد و PHP 7.0 به بعد
* اسکریپت چک‌باکس کیف پول مستقل از jQuery؛ با قالب‌ها و افزونه‌های بهینه‌سازی که اسکریپت‌ها را defer/delay می‌کنند هم کار می‌کند
* اعلام سازگاری با HPOS ووکامرس
* هشدار در صورت فعال بودن هم‌زمان نسخه اسنیپت
* همه متن‌ها قابل ترجمه شدند (زبان پایه فارسی)
* پیش‌فرض «زمان واریز هدیه» برای نصب‌های جدید: بعد از اولین خرید تکمیل‌شده

= 4.0.0 =
* نسخه اسنیپت

== Credits ==

ساخته شده توسط ماهان رضائی - [co.shainika.com](https://co.shainika.com)
