نمای کلی

Pitchbar یک افزونه اختصاصی وردپرس و ووکامرس ارائه می‌دهد که ویجت چت پخش‌جریانی را در هر صفحه عمومی قرار می‌دهد، محتوای سایت را به‌عنوان منبع دانش همگام‌سازی می‌کند و (در صورت فعال بودن ووکامرس) به‌طور عمیق با فروشگاه یکپارچه می‌شود — کارت‌های محصول، اعمال کوپن، جستجوی سفارش، همگام‌سازی مشتریان بالقوه و تعامل مجدد با سبد خرید رها شده.

افزونه در مخزن یکپارچه Pitchbar در wp-plugin/pitchbar/ قرار دارد و به‌عنوان یک فایل زیپ نسخه‌بندی‌شده ارائه می‌شود که می‌توانید آن را از افزونه‌ها ← افزودن جدید ← آپلود افزونه در هر نصب وردپرس ۶.۴+ روی PHP ۷.۴+ نصب کنید.

این افزونه چه کاری انجام می‌دهد

• نصب ویجت — یک تگ <script> ناهمگام در wp_footer در هر صفحه عمومی، محدود به نوع پست‌هایی که انتخاب می‌کنید، تزریق می‌شود. آگاه از RTL. در wp-admin، wp-login، AJAX، REST، XML-RPC و درخواست‌های cron پنهان می‌شود.
• همگام‌سازی محتوا — دریافت انبوه + دلتا از پست‌ها، صفحات، نوع پست‌های سفارشی و محصولات ووکامرس به یک منبع دانش Pitchbar. قابل ازسرگیری در هاست‌های اشتراکی با سقف اجرای ۳۰ ثانیه.
• نمایش محتوای سازندگان صفحه — صفحات Elementor، Divi، Beaver Builder، Oxygen و Bricks از طریق API بومی هر سازنده نمایش داده می‌شوند تا HTML قابل مشاهده آنها واقعاً به فروشگاه RAG برسد (به‌جای post_content خالی).
• زمینه خریدار — wp_user_id + email_hash یک مشتری واردشده ووکامرس (هرگز متن ساده) امضا شده و به جلسه چت ارسال می‌شود تا دستیار فروش بداند با چه کسی صحبت می‌کند.
• جستجوی سفارش — ابزار lookup_order از طریق POST امضا شده HMAC به /wp-json/pitchbar/v1/orders/lookup بازخوانی می‌کند تا دستیار فروش بتواند بدون افشای داده‌های مشتری به "سفارش من کجاست؟" پاسخ دهد.
• انتشار و اعمال کوپن — دستیار فروش کارت‌های <coupon/> را در چت نمایش می‌دهد. دکمه اعمال، کد را در یک داده موقت مرحله‌بندی کرده و در بارگذاری بعدی سبد خرید بازدیدکننده، آن را اعمال می‌کند.
• همگام‌سازی مشتری بالقوه — هر مشتری بالقوه Pitchbar به‌عنوان یک مشتری ووکامرس (یا مشترک وردپرس در صورت عدم وجود ووکامرس) با همبستگی مکالمه در متاداده کاربر، به وردپرس بازگردانده می‌شود.
• محرک سبد خرید رها شده — یک اسکریپت کوچک فرانت‌اند، رویدادهای سبد خرید ووکامرس را در localStorage آینه می‌کند. ویجت زمانی که سبد خرید بیش از آستانه پیکربندی‌شده بیکار می‌ماند، به‌طور فعال درگیر می‌شود.

ماتریس سازگاری

توزیع افزونه (مدیر ارشد)

مدیران ارشد می‌توانند یک فایل .zip آماده نصب از افزونه را از داخل مدیریت Pitchbar بدون دسترسی ssh تولید کنند. /admin/integrations/wordpress را باز کنید:

1. روی ساخت آخرین نسخه کلیک کنید. سرور php artisan pitchbar:build-wp-plugin را در برابر درخت منبع wp-plugin/pitchbar/ بسته‌بندی‌شده اجرا کرده و یک بایگانی نسخه‌بندی‌شده را در storage/app/private/wp-plugin-builds/pitchbar-{version}.zip می‌نویسد.
2. روی دانلود در ردیف حاصل کلیک کنید. بایگانی با Content-Disposition صحیح بازگردانده می‌شود. اندازه آن تقریباً ۴۵ کیلوبایت است و شامل یک دایرکتوری سطح بالا pitchbar/ می‌شود.
3. بایگانی فایل‌های فقط توسعه (.DS_Store، node_modules/، tests/، .git*) را حذف می‌کند، بنابراین آنچه مشتریان شما آپلود می‌کنند دقیقاً چیزی است که وردپرس باید نصب کند.

جایگزین بدون رابط: php artisan pitchbar:build-wp-plugin از خط فرمان کار می‌کند و مسیر حاصل را چاپ می‌کند. پرچم اختیاری --output دایرکتوری مقصد را لغو می‌کند.

مدل امنیت در یک نگاه

افزونه و سرور Pitchbar با دو اعتبارنامه متمایز، در جهت‌های مخالف، یکدیگر را احراز هویت می‌کنند:

• افزونه → Pitchbar: توکن حامل API. در /settings/api-tokens با حوزه wp:integration ایجاد می‌شود. Pitchbar فقط هش SHA-256 متن ساده را ذخیره می‌کند. افزونه متن ساده را در wp_options نگهداری می‌کند (به‌عنوان یک کلید مخفی سطح wp-config.php در نظر بگیرید).
• Pitchbar → افزونه: امضای HMAC-SHA256 با استفاده از shopper_signing_secret به ازای هر توکن. افزونه این کلید مخفی را در پاسخ دست دادن دریافت کرده و به‌صورت محلی ذخیره می‌کند. Pitchbar از آن برای امضای هر بازخوانی (جستجوی سفارش، اعمال کوپن، ارسال مشتری بالقوه) استفاده می‌کند تا نقاط پایانی REST وردپرس بتوانند فراخواننده را بدون اینکه هرگز متن ساده حامل را نگه دارند، تأیید کنند که Pitchbar است.
• محافظت در برابر پخش مجدد: هر دو جهت یک پنجره زمان‌مهر ۵ دقیقه‌ای را بر روی امضای HMAC اعمال می‌کنند.

برای طرح دقیق امضا و مسیر کد تأیید، مرجع REST API را مشاهده کنید.

نسخه فعلی

نسخه افزونه ۲.۰.۵. نکات قابل توجه از نسخه v1.x:

سری وصله ۲.۰.x

• ۲.۰.۵ — چینی ساده‌شده (zh_CN) + مستندات بسته‌بندی‌شده مستقل. بسته زبان zh_CN درخواستی خریدار، هم pitchbar-zh_CN.po (قابل ویرایش) و هم pitchbar-zh_CN.mo (کامپایل‌شده، آنچه وردپرس بارگذاری می‌کند) را ارسال می‌کند. pitchbar/documentation.html اکنون در داخل نصب با مرجع کامل به سبک Mintlify ارسال می‌شود — در هر مرورگری باز کنید، بدون نیاز به اینترنت. php artisan pitchbar:build-wp-plugin هر .po را به .mo قبل از فشرده‌سازی به‌طور خودکار کامپایل می‌کند، بنابراین بسته‌های زبان آینده بدون نیاز به msgfmt GNU روی میزبان ساخت، به‌درستی ارسال می‌شوند.
• ۲.۰.۴ — رفع عرض ستون مدیریت. در لیست محصولات ووکامرس (و سایر جداول لیست شلوغ)، ستون “Pitchbar” به دلیل الگوریتم عرض خودکار وردپرس که پیکسل‌ها را از آن دریغ می‌کرد، یک حرف در هر خط نمایش داده می‌شد. با یک بلوک استایل admin_head به ۱۱۰ پیکسل اجباری شد.
• ۲.۰.۳ — نشان‌های مدیریت “پردازش‌شده” + بازگشت بدنه خالی. لیست‌های پست‌ها، صفحات و محصولات اکنون یک نشان سبز “پردازش‌شده”، نشان زرد “منقضی” یا نشان خاکستری “پردازش نشده” به ازای هر ردیف براساس زمان‌مهر همگام‌سازی + هش محتوایی که افزونه روی هر ارسال ثبت می‌کند، نمایش می‌دهند. پست‌های فقط تصویر شاخص / ساختگی سازنده که the_content آنها به خالی فرو می‌ریزد، از title + excerpt + taxonomy terms در سمت کلاینت ساخته می‌شوند تا همیشه متن قابل پردازش داشته باشند.
• ۲.۰.۲ — پست‌های بدنه خالی + هر نوع محصول. قبل از رفع، یک دسته همگام‌سازی پست با خطای posts.N.content_html field is required در اولین باری که هر پست بدنه خالی داشت، از کار می‌افتاد. قبل از رفع، فیلتر محصولات همگام‌سازی به [simple, variable, grouped, external] محدود می‌شد که به‌طور بی‌صدا اشتراک‌ها، بسته‌ها، عضویت‌ها، رزروها و انواع سفارشی را حذف می‌کرد. هر دو رفع شدند. یک WP_Query بازگشتی، میزبان‌هایی را که زنجیره هوک wc_get_products همه چیز را پنهان می‌کند، پوشش می‌دهد.
• ۲.۰.۱ — تشخیص تست اتصال. پیام عمومی “اتصال ناموفق بود” حذف شد. افزونه اکنون وضعیت HTTP، آدرسی که امتحان کرده، کد cURL / DNS سطح حمل و نقل در صورت خطای شبکه و ۸۰۰ کاراکتر اول بدنه پاسخ بالادستی را نشان می‌دهد. یک کلید “نمایش جزئیات” بلوک تشخیص کامل را نشان می‌دهد. راهنمایی‌های آگاه از وضعیت HTTP (۴۰۱ → توکن را دوباره صادر کنید، ۴۰۳ → حوزه از دست رفته، ۴۰۴ → استقرار نیافته، ۵xx → لاگ سرور).

۲.۰.۰ — انتشار اصلی

• محتوای سازنده صفحه واقعاً به فروشگاه RAG می‌رسد (برای Elementor/Bricks/Oxygen خالی بود).
• مسابقه بارگذاری سفارش ووکامرس رفع شد — هوک‌های وابسته به ووکامرس افزونه اکنون به‌جای اعتماد به class_exists('WooCommerce') در اولویت ۱۰ plugins_loaded، به woocommerce_loaded موکول می‌شوند.
• همگام‌سازی در چندین تیک WP-Cron قابل ازسرگیری است — کاتالوگ‌های بزرگ دیگر به سقف اجرای ۳۰ ثانیه برخورد نمی‌کنند.
• شمارش کوپن از wc_get_coupons() (نه API عمومی) به CPT shop_coupon به‌طور مستقیم تغییر یافت.
• نوع قانون abandoned_cart در مدیریت محرک‌های رفتار دستیار فروش در معرض دید قرار گرفت.
• چیدمان راست‌چین (RTL) و اعلان همگام‌سازی پس‌زمینه مدیریت.

برای تاریخچه کامل انتشار، تاریخچه تغییرات برنامه را مشاهده کنید.