=== پیامک پاپوس ===
Contributors: pappus
Tags: sms, woocommerce, پیامک, ووکامرس, اطلاع رسانی
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
WC requires at least: 6.0
WC tested up to: 9.6
Stable tag: 1.2.15
License: GPLv2 or later

اتصال وردپرس و ووکامرس به سامانه پیامک پاپوس از طریق وب‌سرویس REST.

== Description ==

* کارت پیشخوان: موجودی حساب (و تعداد تقریبی پیامک قابل ارسال)، آمار امروز و ماه، نرخ تحویل، پیام‌های جدید، نمودار ۷ روز اخیر و هشدار کمبود موجودی.
* ارسال پیامک به شماره‌های دلخواه (با ورود از فایل)، کاربران بر اساس نقش و خریداران فروشگاه؛ شخصی‌سازی با {first_name}، محاسبه هزینه پیش از ارسال و ارسال زمان‌بندی شده.
* صندوق پیام‌های دریافتی با همگام‌سازی خودکار هر ۵ دقیقه، پاسخ مستقیم از همان خط و علامت‌گذاری خوانده شده (در وردپرس و پنل).
* گزارش ارسال با وضعیت تحویل به‌روز (رسیده، نرسیده، لیست سیاه...) و هزینه هر پیام.
* ووکامرس: پیامک جداگانه مشتری و مدیر برای هر وضعیت سفارش (شامل وضعیت‌های سفارشی)، یادداشت‌های مشتری، هشدار موجودی کم / اتمام موجودی، گزینه رضایت دریافت پیامک در تسویه حساب (کلاسیک و بلوکی)، متاباکس ارسال پیامک و تاریخچه در صفحه سفارش، ثبت نتیجه ارسال در یادداشت‌های سفارش، ارسال در پس‌زمینه با Action Scheduler و سازگاری با HPOS.
* دفترچه تلفن مشتریان: شماره و نام خریداران (و مشتریان عضو) خودکار در یک گروه دفترچه تلفن پنل ریخته می‌شود؛ انتقال یک‌جای مشتریان قبلی، دو فیلد دلخواه (شهر، تعداد سفارش، مجموع خرید ...) و احترام به رضایت دریافت پیامک.
* نمایش موجودی و پیام‌های جدید در نوار مدیریت و ایمیل روزانه هنگام کمبود موجودی.
* پیامک ووکامرس (ووکامرس فارسی): درگاه «پاپوس» در لیست وبسرویس‌های آن، بدون وارد کردن دوباره کلید.
* پینوا: درگاه «پاپوس» در لیست وبسرویس‌های پیامکی افزونه ورود پینوا؛ ارسال کد ورود با متن یا الگوی پنل، بدون وارد کردن دوباره کلید و با ثبت در گزارش ارسال.

== Installation ==

1. پوشه `pappus-sms` را در `wp-content/plugins` قرار دهید یا فایل zip را از «افزونه‌ها › افزودن» بارگذاری کنید و افزونه را فعال کنید.
2. در پنل پیامک از منوی «وب‌سرویس» کلید API بسازید.
3. در «پیامک › تنظیمات» آدرس پنل و کلید را وارد کنید، «آزمایش و دریافت خطوط» را بزنید، خط پیش‌فرض را انتخاب و ذخیره کنید.
4. در «پیامک › تنظیمات › تنظیمات عمومی» شماره موبایل مدیران را وارد کنید و در «پیامک › ووکامرس» متن‌ها را تنظیم کنید.

اگر WP-Cron سایت غیرفعال است (`DISABLE_WP_CRON`)، یک cron واقعی سرور برای `wp-cron.php` تعریف کنید تا پیام‌های دریافتی و وضعیت تحویل همگام شوند.

== برای توسعه‌دهندگان ==

ارسال از کد:

    pappus_sms_send( '09121234567', 'متن پیام', array( 'type' => 2 ) );

هوک‌ها:

* `pappus_sms_before_send` (فیلتر): تغییر یا لغو پیام‌ها پیش از ارسال.
* `pappus_sms_sent` (اکشن): پس از هر ارسال با نتیجه سامانه.
* `pappus_sms_inbound_received` (اکشن): پیام‌های دریافتی جدید پس از همگام‌سازی.
* `pappus_sms_order_vars` (فیلتر): افزودن متغیر به متن پیامک‌های سفارش.
* `pappus_sms_customer_wants_sms`، `pappus_sms_order_phone`، `pappus_sms_use_async`، `pappus_sms_capability`، `pappus_sms_http_timeout`.

== وب‌سرویس مورد استفاده ==

`GET account`، `GET senders`، `GET stats`، `GET jobs`، `GET templates`، `POST send` (متن یا الگو + پارامترها)، `POST estimate`، `GET status`، `POST cancel/{jobId}`، `GET inbound`، `POST inbound/read` (همه زیر `/api/v1` با هدر `x-api-key`).

== Changelog ==

= 1.2.15 =
* زمان ارسال پیامک مشتری برای هر وضعیت: «بلافاصله» یا «با تاخیر» (پس از n دقیقه، با دکمه‌های آماده)، با شرط هنگام ارسال (هنوز در همین وضعیت / هنوز پرداخت نشده / بدون شرط) و یادداشت سفارش برای زمان‌بندی، ارسال یا دلیل ارسال نشدن. سفارش تازه «در انتظار پرداخت» هم زمان‌بندی می‌شود (مثلا یادآوری پرداخت ۸۰ دقیقه بعد).
* کد تخفیف یکبارمصرف خودکار برای مشتری در پیامک وضعیت (درصد یا مبلغ ثابت، با مدت اعتبار) و متغیرهای {coupon}، {coupon_amount}، {coupon_expiry} و {pay_url}.
* «دفترچه مشتریان» صفحه جدا در منوی پیامک پاپوس (زیر ووکامرس) شد؛ سوییچ‌ها و تیک‌ها خودکار ذخیره می‌شوند و با رفرش صفحه از بین نمی‌روند.
* گزینه «عضویت در سایت»: کاربر تازه عضو (یا کاربری که موبایل حسابش را ثبت/عوض کند) خودکار اضافه می‌شود؛ موبایل از فیلدهای رایج افزونه‌های ورود با پیامک یا نام کاربری هم خوانده می‌شود.
* هر کاربر عضو فقط یک مخاطب دارد: با عوض شدن شماره، همان مخاطب در پنل جابه‌جا می‌شود و تکراری ساخته نمی‌شود.
* سفارشی که هنگام رسیدن به وضعیت هنوز شماره نداشت، به محض ثبت شماره اضافه می‌شود.
* رفع بازنویسی تنظیمات با نسخه قدیمی توسط ارسال‌های همزمان پس‌زمینه.

= 1.2.14 =
* صفحه ویرایش سفارش: جعبه «ارتباط با مشتری» با کارت مشتری، دکمه‌های تماس، واتساپ و کپی شماره، متن‌های آماده به شکل دکمه، درج متغیر، پیش‌نمایش متن نهایی و شمارش بخش واقعی، ارسال با Ctrl+Enter، لینک افزایش اعتبار هنگام کمبود موجودی و گفتگو به شکل پیام‌رسان (پیامک‌های سفارش و پاسخ‌های مشتری از صندوق دریافت).
* دفترچه تلفن مشتریان در پنل («پیامک پاپوس › ووکامرس»): خریداران با رسیدن سفارش به وضعیت‌های انتخابی و مشتریان عضو دارای موبایل، خودکار به گروه انتخابی دفترچه تلفن پنل اضافه می‌شوند (تکراری اضافه نمی‌شود، اطلاعات به‌روز می‌شود). دکمه «انتقال مشتریان قبلی» با نوار پیشرفت، فیلد ۱ و ۲ مخاطب (شهر، استان، ایمیل، تعداد سفارش، مجموع خرید ...)، حذف از دفترچه وقتی مشتری رضایت پیامک را برمی‌دارد. نیازمند نسخه جدید پنل (وب‌سرویس groups و contacts).

= 1.2.13 =
* بررسی نسخه جدید بدون کش: باز کردن صفحه «پیامک پاپوس › بروزرسانی» یا «پیشخوان › بروزرسانی‌ها»ی وردپرس و زدن «بررسی دوباره» همیشه همان لحظه از سایت پاپوس بررسی می‌کند.
* «پیامک ووکامرس»: با انتخاب پاپوس، فیلدهای نام کاربری، کلمه عبور و شماره ارسال کننده حذف و به‌جای آن وضعیت اتصال نشان داده می‌شود؛ کلید و خط ارسال فقط از تنظیمات پیامک پاپوس خوانده می‌شوند (مقادیر مانده از وبسرویس قبلی دیگر باعث خطا نمی‌شوند).

= 1.2.12 =
* اتصال به افزونه «پیامک ووکامرس» (ووکامرس فارسی): «Pappus.ir - پاپوس» در لیست «وبسرویس پیامک» آن؛ همه پیامک‌های سفارش، مدیر کل و مدیر محصول، موجودی، خبرنامه، متاباکس‌ها، کد رهگیری و ارسال دستی آن از پاپوس ارسال و در گزارش همین افزونه هم ثبت می‌شوند. کلید از تنظیمات پیامک پاپوس (یا فیلد نام کاربری وبسرویس آن افزونه)، الگو با pattern:کد.
* نام منو به «پیامک پاپوس» تغییر کرد.

= 1.2.11 =
* اتصال به افزونه پینوا: درگاه «پاپوس» در «پینوا › تنظیمات › پیامک» برای ارسال کد ورود (متن یا الگو با pattern:کد) با کلید و خطوط همین افزونه و ثبت در گزارش ارسال.
* دکمه «بررسی دوباره» در صفحه بروزرسانی‌های وردپرس نسخه جدید پاپوس را هم فوراً می‌بیند؛ کش بررسی نسخه از ۱۲ به ۳ ساعت کاهش یافت.

= 1.2.0 =
* منوی «بروزرسانی»: بررسی نسخه جدید از سایت پاپوس و نصب آن با یک کلیک بدون از دست رفتن تنظیمات؛ پشتیبان خودکار تنظیمات پیش از هر بروزرسانی و امکان بازیابی.
* نمایش همه خطوط قابل استفاده در لیست «خط ارسال پیش‌فرض» تنظیمات.

= 1.1.0 =
* ارسال پیامک‌های وضعیت سفارش با الگوهای (متن‌های آماده) پنل و پارامترهای آن‌ها.

= 1.0.0 =
* نسخه اول.
