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

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

== Description ==

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

این افزونه علاوه بر ورود پیامکی، از اتصال به بله و تلگرام، ورود با Google OAuth، اعلان سفارشات ووکامرس، کپچای یکپارچه، Rate Limit پیشرفته و ویجت اختصاصی Elementor پشتیبانی می‌کند.

= قابلیت‌های اصلی =

* ورود و ثبت‌نام با پیامک 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. فایل افزونه را از بخش افزونه‌های وردپرس نصب و فعال کنید.
2. وارد منوی EZ-Login شوید.
3. تنظیمات عمومی، پیامک، بله، تلگرام و گوگل را بر اساس نیاز تکمیل کنید.
4. اگر از بله یا تلگرام استفاده می‌کنید، Webhook Secret بسازید و Webhook را از داخل افزونه تنظیم کنید.
5. برای نمایش فرم در صفحه دلخواه از شورت‌کد [ez-login] یا ویجت Elementor استفاده کنید.

== Frequently Asked Questions ==

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

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

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

بله، در تنظیمات تلگرام چند روش اتصال و پروکسی وجود دارد. Cloudflare Worker و PHP Bridge معمولاً گزینه‌های ساده‌تری برای سایت‌هایی هستند که به api.telegram.org دسترسی مستقیم ندارند.

= آیا شماره واقعی کاربر در بله و تلگرام قابل دریافت است؟ =

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

= حداقل نسخه PHP چیست؟ =

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

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

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

= آیا برای استفاده از افزونه باید Elementor نصب باشد؟ =

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

== Screenshots ==

1. screenshot-1
2.screenshot-2
3. screenshot-3
4. screenshot-4
5. screenshot-5
6. screenshot-6
7. screenshot-7


== External Services ==

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

= ملی‌پیامک / Melipayamak =

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

سرویس: https://www.melipayamak.com/

= بله API =

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

سرویس: https://developers.bale.ai/

= Telegram Bot API =

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

سرویس: https://core.telegram.org/bots/api

= Cloudflare Turnstile =

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

سرویس: https://www.cloudflare.com/products/turnstile/

= Google reCAPTCHA =

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

سرویس: https://www.google.com/recaptcha/about/

= hCaptcha =

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

سرویس: https://www.hcaptcha.com/

= Google OAuth =

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

سرویس: https://developers.google.com/identity/protocols/oauth2

== 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 اولیه و دکمه غیرفعال‌سازی گوگل.

== Upgrade Notice ==

= 1.5.7 =

این نسخه شامل Rate Limit پیشرفته، صفحه تست اتصال‌ها، اصلاحات امنیتی و بروزرسانی تنظیمات افزونه است. بعد از بروزرسانی، تنظیمات پیامک، بله، تلگرام، کپچا و Webhookها را از صفحه تست اتصال‌ها بررسی کنید.
