=== پیامک بیت‌سند ===
Contributors: bitsend
Tags: sms, woocommerce, contact form 7, otp, پیامک
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.2
WC requires at least: 6.0
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

پیامک با الگوهای تأییدشدهٔ بیت‌سند برای ووکامرس، EDD، Contact Form 7، Gravity Forms، WPForms، Elementor Forms، Digits و WP SMS.

== Description ==

با این افزونه، هر تغییر وضعیت سفارش در ووکامرس (ثبت، پرداخت، در حال انجام، ارسال، تکمیل، لغو، بازپرداخت و وضعیت‌های سفارشی) یا Easy Digital Downloads (تکمیل، بازپرداخت، ناموفق، لغو و ...) می‌تواند یک پیامک به مشتری و/یا مدیران فروشگاه بفرستد. اگر هر دو فعال باشند، پیامک‌های هر کدام جداگانه تنظیم می‌شوند.

* ارسال با الگوهای تأییدشدهٔ بیت‌سند
* پیامک جداگانه برای مشتری و مدیر، برای هر وضعیت سفارش
* برچسب‌های آماده: شمارهٔ سفارش، مبلغ، نام مشتری، محصولات، کد رهگیری مرسوله، روش ارسال و ...
* ارسال در پس‌زمینه با زمان‌بند ووکامرس (Action Scheduler) و تلاش دوباره هنگام خطای موقت
* گزارش کامل ارسال با وضعیت تحویل، به‌روزرسانی خودکار هر ساعت
* جعبهٔ «پیامک بیت‌سند» در صفحهٔ سفارش: ثبت کد رهگیری، ارسال دستی و تاریخچهٔ پیامک‌ها
* Easy Digital Downloads: فیلد «شماره موبایل» در صفحهٔ پرداخت (اجباری/اختیاری، سازگار با پرداخت بلوکی و کلاسیک) که برای خریدهای بعدی کاربر ذخیره می‌شود
* فرم‌ها: Contact Form 7، Gravity Forms، WPForms (Lite و Pro) و Elementor Pro Forms - پیامک به فرستندهٔ فرم (فیلد موبایل انتخابی) و مدیران، با فیلدهای فرم در متغیرهای الگو
* Digits: ارسال کد ورود/ثبت‌نام از درگاه «Custom» به نشانی امن سایت، با محدودیت ارسال برای هر شماره
* WP SMS: «بیت‌سند» در فهرست درگاه‌های WP SMS؛ پیام‌ها با قالب «متن|شناسهٔ الگو» و متغیرهای خود WP SMS
* کدهای یکبارمصرف در گزارش ارسال پوشانده می‌شوند
* نمایش اعتبار پیامکی و موجودی کیف پول
* سازگار با HPOS (ذخیره‌سازی سفارش با کارایی بالا) و پرداخت بلوکی

== Installation ==

1. افزونه را از «افزونه‌ها ← افزودن ← بارگذاری افزونه» نصب و فعال کنید.
2. در پنل بیت‌سند (توسعه‌دهندگان) یک کلید API بسازید.
3. در منوی «پیامک بیت‌سند» پیشخوان وردپرس کلید را وارد کنید.
4. (Easy Digital Downloads) در تنظیمات افزونه مشخص کنید فیلد موبایل در صفحهٔ پرداخت اجباری باشد یا اختیاری.
5. در پنل بیت‌سند برای هر پیامک یک الگو بسازید و پس از تأیید، شناسهٔ آن (pat_...) را در زبانهٔ «پیامک سفارش‌ها» برای وضعیت دلخواه وارد کنید.

== Frequently Asked Questions ==

= چرا متن پیامک را اینجا نمی‌نویسم؟ =
در بیت‌سند متن هر پیامک یک «الگو» است که یک بار بررسی و تأیید می‌شود. افزونه فقط شناسهٔ الگو و مقدار متغیرهای آن را می‌فرستد و متن نهایی را بیت‌سند می‌سازد.

= مقدار متغیرها چه محدودیتی دارد؟ =
هر مقدار حداکثر ۴۰ کاراکتر است، یک خط است و نباید لینک داشته باشد. افزونه مقدارهای طولانی را کوتاه می‌کند و به‌جای مقدار خالی «-» می‌فرستد.

= برای توسعه‌دهندگان =
فیلترها: `bitsend_sms_tokens`، `bitsend_sms_token_value`، `bitsend_sms_order_params`، `bitsend_sms_form_params`، `bitsend_sms_should_send`. اکشن: `bitsend_sms_sent`.
نشانی درگاه کد یکبارمصرف: `/wp-json/bitsend-sms/v1/otp?key=…` (GET یا POST؛ پارامترهای to و code یا message).

== Changelog ==

= 1.2.0 =
* فرم‌ها: Contact Form 7، Gravity Forms، WPForms و Elementor Forms.
* ورود با پیامک: درگاه Digits (و هر افزونهٔ دارای درگاه سفارشی HTTP) و درگاه WP SMS.
* الگوی کد یکبارمصرف، با پوشاندن کدها در گزارش.
* افزونه بدون ووکامرس/EDD هم کار می‌کند.

= 1.1.0 =
* پشتیبانی از Easy Digital Downloads نسخهٔ ۳ به بعد: پیامک وضعیت سفارش، فیلد موبایل صفحهٔ پرداخت، جعبهٔ پیامک در جزئیات سفارش.
* منوی مستقل «پیامک بیت‌سند» با لوگو در پیشخوان.
* رفع اشکال: متغیرهایی که با «+ افزودن متغیر» اضافه می‌شدند ذخیره نمی‌شدند.

= 1.0.0 =
* نسخهٔ نخست.
