=== EZ Login | ورود پیامکی، بله، تلگرام و OTP ===
Contributors: codsoft
Tags: login, otp, sms, woocommerce, elementor, captcha, telegram, bale, پیامک, ورود
Requires at least: 5.8
Tested up to: 7.0.0
Requires PHP: 7.0
Stable tag: 1.5.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

ورود بدون رمزعبور با پیامک، بله، تلگرام و گوگل، اعلان سفارشات ووکامرس، ویجت المنتور، کپچا و کنترل امنیتی پیشرفته.

== Description ==

EZ Login یک افزونه ورود و ثبت‌نام OTP برای وردپرس است که امکان ورود با شماره موبایل، پیام‌رسان بله، تلگرام، گوگل و فرم سفارشی را فراهم می‌کند. این افزونه برای سایت‌های فارسی، فروشگاه‌های ووکامرس و سایت‌هایی که به ورود سریع و امن نیاز دارند طراحی شده است.

= قابلیت‌های اصلی =
* ورود و ثبت‌نام با پیامک OTP
* ورود با ربات بله بر پایه OTP
* ورود با ربات تلگرام بر پایه OTP
* ورود با Google OAuth
* صفحه ورود ادمین اختصاصی برای wp-login.php با تب رمزعبور، پیامک، بله و تلگرام
* امکان تغییر لوگوی صفحه ورود وردپرس از کتابخانه رسانه وردپرس
* امکان حذف انتخاب زبان وردپرس از صفحه ورود
* اعلان سفارشات ووکامرس از طریق پیامک، بله و تلگرام
* ویجت اختصاصی Elementor با کنترل‌های استایل و پیش‌نمایش زنده
* پشتیبانی از فیلدهای ثبت‌نام وردپرس، ووکامرس، ACF، Profile Builder و Ultimate Member
* کپچای یکپارچه برای همه روش‌های ورود و ثبت‌نام
* Rate Limit پیشرفته برای شماره موبایل، IP، User-Agent و تلاش‌های اشتباه کد تایید
* پنل تست اتصال‌ها برای پیامک، بله، تلگرام، گوگل، کپچا و Webhookها

= روش‌های ورود =
* پیامک: شماره موبایل → ارسال کد → تایید OTP
* بله: اتصال امن حساب بله → ارسال OTP داخل ربات → ورود
* تلگرام: اتصال امن حساب تلگرام → ارسال OTP داخل ربات → ورود
* گوگل: ورود با حساب Google
* رمزعبور: فرم ورود استاندارد وردپرس در صفحه ادمین، همراه با کپچا و محافظت سمت سرور

= امنیت =
* Webhook Secret اجباری برای بله و تلگرام
* جلوگیری از اتصال شماره تایپی در ربات
* امکان الزام به Share Contact برای دریافت شماره واقعی کاربر در بله و تلگرام
* ذخیره OTP به صورت hash شده
* اعتبار کوتاه‌مدت برای OTP
* Honeypot و timestamp برای فرم‌ها
* Rate Limit جداگانه برای ارسال کد و کدهای اشتباه
* محدودیت جدا برای phone، IP، User-Agent، phone+IP و phone+User-Agent
* کپچای یکپارچه روی پیامک، بله، تلگرام، ثبت‌نام و ورود رمزعبور ادمین

= کپچا =
* Cloudflare Turnstile
* Google reCAPTCHA v2
* hCaptcha
* کپچای ریاضی داخلی
* کپچای سوالی فارسی داخلی

= تلگرام و پروکسی =
برای سایت‌هایی که از ایران یا هاست داخلی به تلگرام دسترسی مستقیم ندارند، چند روش اتصال در تنظیمات تلگرام وجود دارد:
* اتصال مستقیم به api.telegram.org
* Cloudflare Worker / Pages Function
* PHP Bridge روی هاست خارجی
* Reverse Proxy / Bot API Base URL سفارشی
* HTTP/SOCKS Proxy سرور

در صفحه تنظیمات تلگرام، راهنمای آکاردئونی همراه با کد آماده Cloudflare Worker، Nginx Reverse Proxy، PHP Bridge و HTTP/SOCKS Proxy قرار دارد.

= اعلان سفارشات ووکامرس =
* ارسال اعلان به مشتری
* ارسال اعلان به مدیر
* پشتیبانی از پیامک، بله و تلگرام
* قالب پیام جدا برای مشتری و مدیر
* متغیرهای پیام: ORDER_ID، ORDER_TOTAL، ORDER_STATUS، CUSTOMER_NAME، PRODUCT_NAME، SITE_NAME

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

== Shortcodes ==

= فرم ورود =
[ez-login]

پارامترها:
* preset: modern | minimal | glass | dark | aurora | soft
* mode: auto | login | register | tabs
* redirect: 0 | 1
* link: آدرس ریدایرکت بعد از ورود
* google: 0 | 1

نمونه:
[ez-login mode="tabs" preset="modern" redirect="1" link="https://example.com/my-account"]

= اتصال بله =
[ez-bale-link]

پارامترها:
* text: متن دکمه
* show_status: 1 | 0

= اتصال تلگرام =
[ez-telegram-link]

پارامترها:
* text: متن دکمه
* show_status: 1 | 0

== Installation ==

1. فایل افزونه را در مسیر Plugins وردپرس نصب و فعال کنید.
2. وارد منوی EZ-Login شوید.
3. تنظیمات عمومی، پیامک، بله، تلگرام و گوگل را بر اساس نیاز تکمیل کنید.
4. اگر از بله یا تلگرام استفاده می‌کنید، Webhook Secret بسازید و Webhook را از داخل افزونه تنظیم کنید.
5. برای نمایش فرم در صفحه دلخواه از شورت‌کد [ez-login] یا ویجت Elementor استفاده کنید.

== Frequently Asked Questions ==

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

= آیا می‌توانم ورود با تلگرام را از ایران استفاده کنم؟ =
بله، در تنظیمات تلگرام چند روش اتصال و پروکسی وجود دارد؛ Cloudflare Worker و PHP Bridge معمولاً ساده‌ترین گزینه‌ها هستند.

= آیا شماره واقعی کاربر در بله و تلگرام قابل دریافت است؟ =
تا جای ممکن بله. افزونه می‌تواند کاربر را مجبور کند Contact واقعی خودش را با ربات Share کند و شماره ارسال‌شده را با شماره سایت مقایسه کند. شماره تایپی در ربات معتبر نیست.

= حداقل نسخه PHP چیست؟ =
با توجه به کد فعلی افزونه، حداقل PHP پشتیبانی‌شده 7.0 است. برای امنیت و کارایی بهتر، PHP 8.1 یا بالاتر پیشنهاد می‌شود.

= آیا داده‌ها بعد از حذف افزونه پاک می‌شوند؟ =
به صورت پیش‌فرض خیر. اگر گزینه حذف داده‌ها هنگام uninstall را فعال کنید، تنظیمات و transientهای افزونه حذف می‌شوند.

== External Services ==

این افزونه برای بخشی از قابلیت‌ها به سرویس‌های خارجی متصل می‌شود:

* ملی‌پیامک / Melipayamak: ارسال OTP و اعلان پیامکی
* بله API: ارسال OTP و اعلان از طریق ربات بله
* Telegram Bot API یا پروکسی تنظیم‌شده: ارسال OTP و اعلان از طریق ربات تلگرام
* Cloudflare Turnstile، Google reCAPTCHA یا hCaptcha: بررسی کپچا
* Google OAuth: ورود با حساب گوگل

اطلاعات ارسال‌شده بسته به قابلیت فعال‌شده شامل شماره موبایل، Chat ID، کد OTP، متن اعلان سفارش، توکن کپچا یا داده‌های OAuth است.

== Changelog ==

= 1.5.7 =
* اضافه شدن Rate Limit پیشرفته عمومی برای همه کانال‌های ورود.
* محدودیت جداگانه برای شماره موبایل، IP، User-Agent، phone+IP و phone+User-Agent.
* محدودیت جداگانه برای ارسال کد تایید و تلاش‌های اشتباه کد تایید.
* اضافه شدن صفحه «تست اتصال‌ها» برای پیامک، بله، تلگرام، گوگل، کپچا و Webhookها.
* نمایش خطاهای واقعی اتصال در پنل تست.
* بروزرسانی ویجت Elementor برای تلگرام و برچسب‌های جدید.
* بروزرسانی readme.txt برای مخزن وردپرس.
* تغییر برند و لینک‌های افزونه به CodeSoft و codsoft.ir.
* بروزرسانی گزینه‌های uninstall برای تنظیمات Rate Limit.

= 1.5.6 =
* اضافه شدن گزینه مستقل PHP Bridge روی هاست خارجی به انتخاب‌گر روش اتصال تلگرام.
* هماهنگ شدن ساخت URL تلگرام با حالت Bridge و placeholderهای {token} و {method}.
* تکمیل توضیحات راهنمای Bridge در بخش پروکسی تلگرام.

= 1.5.5 =
* اضافه شدن گزینه ورود مدیر با شماره تلفن در wp-login.php.
* اصلاح نمایش پرچم ایران با SVG به جای emoji برای جلوگیری از نمایش IR در بعضی سیستم‌ها.
* اصلاح دکمه انتخاب لوگوی wp-login.php و اتصال پایدار به کتابخانه رسانه وردپرس.
* یکپارچه شدن تنظیمات کپچا در بخش عمومی و حذف تنظیمات تکراری از بخش پیامک.
* اعمال کپچای عمومی روی ارسال کد پیامک، بله و تلگرام و ورود رمزعبور ادمین.
* اضافه شدن راهنمای کامل پروکسی تلگرام به صورت آکاردئون بسته با کدهای Cloudflare Worker، Nginx Reverse Proxy، PHP Bridge و HTTP/SOCKS Proxy.
* اضافه شدن گزینه تأیید شماره واقعی بله و تلگرام با Share Contact و مقایسه با شماره حساب سایت.

= 1.5.4 =
* اضافه شدن ورود با تلگرام بر پایه OTP و ربات تلگرام.
* اضافه شدن اعلان سفارشات ووکامرس با تلگرام برای مشتری و مدیر.
* اضافه شدن تنظیمات پروکسی تلگرام.
* اضافه شدن شورت‌کد [ez-telegram-link].
* امکان تغییر لوگوی wp-login.php از تنظیمات افزونه.
* امکان حذف بخش تغییر زبان وردپرس از صفحه لاگین.
* نمایش Webhook Secret بله و تلگرام با دکمه چشم.

= 1.5.1 =
* رفع باگ Webhook بله.
* پشتیبانی از contact/phone_number در Webhook بله.
* سیستم مدیریت مدت زمان سشن.
* سیستم بهینه‌سازی لود asset.
* Lazy-load برای popup.
* بزرگ‌تر شدن باکس لاگین ادمین.

= 1.5 =
* طراحی کامل فرم لاگین.
* خواندن خودکار فیلدها از ACF، Profile Builder و Ultimate Member.
* کپچاهای Turnstile، reCAPTCHA، hCaptcha، ریاضی و سوالی.
* ورود با ربات بله.
* اعلان سفارشات ووکامرس.
* شورت‌کد [ez-bale-link].

= 1.4 =
* بهبود امنیت، المان Elementor، Turnstile اولیه و دکمه غیرفعال‌سازی گوگل.
