HomaCRM — هما برای وردپرس و ووکامرس
پیامک، ورود با موبایل، CRM، انبار و درگاهِ پرداخت — همه با یک توکن
نصب رایگان · دانلود آخرین نسخه · HomaCRM.com
افزونهٔ رسمیِ HomaCRM برای وردپرس و ووکامرس. یک افزونه، یک توکن، همهٔ امکاناتِ هما. نسخهٔ افزونه همیشه برابرِ نسخهٔ زندهٔ هما در لحظهٔ انتشار است.
| |
|---|
| پیش‌نیاز | وردپرس ۵٫۲ به بالا · PHP ۷٫۲ به بالا · ووکامرس اختیاری (HPOS پشتیبانی می‌شود) |
| هزینه | افزونه رایگان است؛ ۱۵ روز آزمایشیِ رایگانِ هما همراهش است. فقط پیامک‌ها از اعتبارِ پیامکِ پرتالِ شما کم می‌شود. |
| مجوز | GPLv2 یا بالاتر · © HomaCRM — فناوران نگین شهر نوین |
شروع سریع (۳ دقیقه)
- نصب: فایلِ
HomaCRM-<نسخه>.zip را از plugin.homacrm.com یا Releases بگیرید و در وردپرس از «افزونه‌ها ← افزودن ← بارگذاری افزونه» نصب و فعال کنید.
- توکن: در منوی HomaCRM ← Connection دکمهٔ «ثبت‌نامِ رایگان و دریافتِ توکن» را بزنید (یا اگر حساب دارید: پنلِ هما ← مدیریتِ کاربران ← «توکن‌ها» ← توکنِ اصلی).
- اتصال: توکن را بچسبانید و «ذخیره» را بزنید؛ با «✓ وصل است» و اعتبارِ پیامک تأیید می‌شود. بعد از Tools & Reports یک پیامکِ آزمایشی بفرستید.
ساختنِ توکنِ تازه توکنِ قبلی را باطل می‌کند. توکن را جایی عمومی (کد، گیت، اسکرین‌شات) نگذارید.
امکانات
| تب | چه می‌کند |
|---|
| About | صفحهٔ پیش‌فرض: نسخه، وضعیتِ اتصال، وردپرس و PHP و ووکامرس؛ تنظیماتِ به‌روزرسانی |
| Connection | «ذخیره و آزمونِ اتصال»؛ اتصال فقط با توکنِ API هما؛ نمایشِ پرتال و اعتبارِ پیامک؛ راهنمای گرفتنِ توکن |
| SMS Login | ورود و ثبت‌نام با کدِ یک‌بارمصرف در wp-login، حسابِ کاربریِ ووکامرس، تسویه‌حساب و [homacrm_login] — کاربرانِ قبلی با همان موبایل وارد می‌شوند |
| WooCommerce | پیامکِ هر وضعیتِ سفارش به مشتری، پیامکِ سفارشِ تازه به مدیران، خریدار ⇒ «مخاطب»، سفارش ⇒ «معامله» |
| Marketing | سبدِ رهاشده (دو پیامک با لینکِ بازگشتِ یک‌لمسی)، تشکرِ اولین خرید با کدِ تخفیفِ خریدِ دوم، پیگیریِ سفارش [homacrm_track]، «موجود شد خبرم کن»، تبریکِ تولد با کدِ تخفیفِ یک‌بارمصرف، کدِ رهگیریِ مرسوله، درخواستِ نظر |
| CRM & Forms | کاربرِ تازه ⇒ مخاطب؛ [homacrm_form] و Contact Form 7 ⇒ سرنخ یا تیکتِ پشتیبانی |
| Tools & Reports | پیامکِ آزمایشی، قیف‌ها و مرحله‌های فروش، خلاصهٔ ۷ روزه (موفق/ناموفقِ هر بخش و اعتبار)، لاگِ آخرین پیامک‌ها با تاریخِ شمسی |
| About | شناسنامهٔ افزونه: نسخه، وضعیتِ اتصال، نسخهٔ وردپرس و PHP؛ تنظیماتِ به‌روزرسانی |
انبار، فاکتور و درگاهِ پرداخت (ووکامرس)
- قیمت و موجودی از انبارِ هما: هر ۱۵ دقیقه، و موجودیِ زنده پیش از پرداخت. کالای ووکامرس با متای
_homa_api_id به کالای هما وصل می‌شود.
- فاکتور: سفارش ⇒ فاکتورِ فروش در هما (با اثرِ انبار و سند)؛ پرداخت ⇒ ثبتِ دریافت در خزانه. پرداختِ تکراریِ یک سفارش دوبار ثبت نمی‌شود.
- درگاهِ پرداختِ هما (
homacrm_pay): سفارش پیش از پرداخت فاکتور می‌شود. بازگشت از درگاه تنهایی «پرداخت شد» حساب نمی‌شود؛ افزونه دریافتِ ثبت‌شده روی همان فاکتور را از API می‌خواند و فقط اگر مبلغ کامل رسیده باشد سفارش را پرداخت‌شده می‌کند. حوالهٔ خروج از انبار هم فقط بعد از پرداخت صادر می‌شود.
- توکنِ جدا برای انبار و فاکتور اختیاری است (وقتی انبار در پرتالِ دیگری است).
پیامک‌های بازاریابی
پیامک‌های تبلیغاتی فقط ۹ صبح تا ۹ شب فرستاده می‌شوند و متنِ پیش‌فرض عبارتِ لغو (لغو11) را دارد. هر کدام جدا روشن/خاموش و قابلِ ویرایش است.
متغیرهای متن
زیرِ هر متن یک کادرِ موبایل و دکمهٔ «ذخیره و ارسالِ آزمایشی» هست: تغییرهای زبانه ذخیره و همان متن با متغیرهای نمونه به آن شماره فرستاده می‌شود.
| کاربرد | متغیرها |
|---|
| پیامکِ سفارش | {name} {order} {total} {status} {site} {mobile} {tracking} {pay} ({pay} لینکِ پرداختِ دوباره) |
| کدِ ورود | {site} {code} |
| سبدِ رهاشده | {site} {product} {link} |
| موجود شد | {product} {site} {link} |
| تولد | {name} {site} {code} {percent} |
| رهگیری | {name} {order} {carrier} {tracking} |
| درخواستِ نظر | {name} {product} {link} |
| تشکرِ اولین خرید | {name} {site} {code} {percent} {days} |
| کدِ پیگیریِ سفارش | {order} {site} {code} |
کدهای کوتاه
| کد | توضیح |
|---|
[homacrm_login redirect="/my-account"] | فرمِ ورود/ثبت‌نام با پیامک |
[homacrm_form title="درخواستِ مشاوره" button="ارسال"] | فرمِ سرنخ/تیکت |
[homacrm_track] | پیگیریِ سفارش با شمارهٔ سفارش و کدِ پیامکی (مهمان هم) |
به‌روزرسانی
نسخه = نسخهٔ هما + شمارهٔ انتشار (مثلاً 3.13.16.1). هر نسخهٔ تازه با یک Release در همین مخزن منتشر می‌شود (برچسبِ vX.Y.Z.N و فایلِ HomaCRM-<نسخه>.zip؛ homacrm.zip هم برای به‌روزرسانِ نصب‌های قدیمی می‌ماند). افزونه هر ۱۲ ساعت آن را می‌بیند:
- در «افزونه‌ها» و «به‌روزرسانی‌ها»ی وردپرس دکمهٔ به‌روزرسانی می‌آید و در پیشخوان اعلان با خلاصهٔ تغییرات نشان داده می‌شود.
- برای هر نسخه یک بار به ایمیلِ مدیرِ سایت خبر می‌دهد؛ پیامک به موبایلِ مدیر هم اختیاری است.
- «به‌روزرسانیِ خودکار» نسخهٔ تازه را بی‌کلیک نصب می‌کند.
تغییراتِ هر نسخه: CHANGELOG.md.
حریمِ خصوصی
برای پشتیبانی و دیدنِ نصب‌های بی‌توکن، افزونه هنگامِ فعال‌شدن، غیرفعال‌شدن، به‌روزرسانی و روزی یک بار یک خبرِ کوتاه به https://plugin.homacrm.com/ping می‌فرستد:
نشانی و نامِ سایت، ایمیلِ مدیرِ سایت، نسخهٔ افزونه/وردپرس/ووکامرس/PHP، زبان، وصل‌بودنِ توکن (فقط بله/خیر، نه خودِ توکن)، کدِ پرتال و یک شناسهٔ تصادفیِ نصب، و رویدادهای ساده‌ی مسیرِ راه‌اندازی («فعال شد»، «تنظیمات باز شد»، «توکن ذخیره شد»). توکن، مشتری‌ها، سفارش‌ها و محتوای سایت هرگز فرستاده نمی‌شود. همین توضیح در تبِ About هم آمده است.
برای توسعه‌دهنده
// ارسالِ پیامک از هر جای سایت
do_action( 'homacrm_send_sms', '09121234567', 'سلام!', 'my-plugin' );
// یا
$res = HomaCRM\Sms::send( '09121234567', 'سلام!' ); // ['ok'=>bool,'error'=>string,'data'=>…]
// هر درخواستی به API بیرونیِ هما با توکنِ ذخیره‌شده
$r = HomaCRM\Api::request( 'GET', '/crm/contacts?search=0912' );
هوک‌ها: homacrm_send_sms (اکشن برای ارسال)، homacrm_sms_message (فیلترِ متن)، homacrm_sms_sent، homacrm_user_registered، homacrm_login_redirect، homacrm_form_submitted.
REST (فقط مدیرِ سایت، با Application Password):
GET /wp-json/homacrm/v1/status
POST /wp-json/homacrm/v1/sms {"mobile":"09…","message":"…"}
POST /wp-json/homacrm/v1/lead {"firstName":"…","mobile":"09…","notes":"…"}
MCP: در وردپرس‌هایی که Abilities API دارند (افزونهٔ MCP Adapter وردپرس)، توانایی‌های homacrm/send-sms، homacrm/credit و homacrm/create-lead ثبت می‌شوند. برای دسترسیِ کامل به همهٔ ابزارهای هما (CRM، پیامک، مالی، کارتابل…) از سرورِ MCPِ هما (homa-mcp-server) با همین توکن (HOMA_API_TOKEN) استفاده کنید.
API کامل: https://homacrm.com/api/v1/external/docs
کوچ از افزونه‌های قبلیِ ورود و پیامک
پس از راه‌اندازی، افزونه‌های قبلیِ پیامک و ورود با موبایل را غیرفعال کنید. کاربرانِ قبلی با همان موبایلِ ثبت‌شده (و billing_phone ووکامرس) وارد می‌شوند و ثبت‌نامِ دوباره لازم نیست.
امنیت
- توکن در گزینهٔ جدا و بدونِ autoload ذخیره می‌شود و هرگز در فرم، لاگ یا خروجی نمایش داده نمی‌شود.
- کدِ ورود فقط به‌صورتِ HMAC و کوتاه‌عمر در transient است؛ ۵ تلاشِ غلط کد را باطل می‌کند.
- هر موبایل هر ۶۰ ثانیه یک کد و حداکثر ۵ کد در ساعت؛ هر IP حداکثر ۱۵ درخواست در ساعت.
- لاگِ پیامک موبایل را پوشانده نشان می‌دهد، متنِ کدِ ورود را ذخیره نمی‌کند و پس از ۳۰ روز پاک می‌شود.
- تأییدِ پرداخت فقط از روی دریافتِ ثبت‌شده در هما است، نه از پارامترهای بازگشت از درگاه.
ساختار
homacrm/
homacrm.php سرآمد و راه‌انداز
includes/class-api.php کلاینتِ API هما (توکن)
includes/class-settings.php پیشخوانِ HomaCRM (تب‌ها)
includes/class-sms.php ارسال + لاگ
includes/class-login.php ورود و ثبت‌نام با پیامک
includes/class-woocommerce.php پیامکِ سفارش‌ها
includes/class-shop.php انبار، قیمت، فاکتور
includes/class-gateway.php درگاهِ پرداختِ هما
includes/class-engage.php سبد رهاشده، تولد، تشکرِ اولین خرید، رهگیری، نظر
includes/class-track.php پیگیریِ سفارش ([homacrm_track])
includes/class-crm-sync.php مخاطبان و معاملات
includes/class-forms.php فرم و CF7
includes/class-abilities.php REST و MCP
includes/class-updater.php به‌روزرسانی از GitHub
includes/class-telemetry.php خبرِ نصب
includes/class-log.php لاگ
landing/ لندینگِ plugin.homacrm.com (انتشار: landing/deploy.sh)
release.sh · set-version.sh انتشارِ نسخه
انتشارِ نسخهٔ تازه (برای تیمِ هما)
./set-version.sh --bump نسخهٔ بعدی را می‌گذارد (نسخهٔ هما + شمارهٔ انتشار) و در homacrm.php و readme.txt می‌نویسد؛ بخشِ همان نسخه را در CHANGELOG.md بنویسید، کامیت کنید، GITHUB_TOKEN=… ./release.sh و بعد landing/deploy.sh را بزنید.
پشتیبانی
ایمیل: [email protected] (نصب، توکن و هر پرسشی) · یا از پنلِ هما تیکت بزنید · https://homacrm.com. پیشنهاد و باگ: بخشِ Issues همین مخزن.
