Vigent Documentation · راهنمای گامبهگام
اتصال ووکامرس
نحوهٔ اتصال فروشگاه ووکامرس/وردپرس به ویجنت؛ نصب افزونه، تنظیم webhook و همگامسازی محصولات و سفارشها.
با اتصال ووکامرس به ویجنت، کاتالوگ محصولات و سفارشهای فروشگاه شما بهصورت خودکار با ویجنت همگام میشود. ایجنت میتواند قیمت، موجودی و مشخصات محصولات را از دادههای واقعی فروشگاه بخواند و وقتی سفارش جدید ثبت میشود، بهصورت خودکار روی پروفایل مخاطب مربوطه ظاهر میگردد. راهاندازی این اتصال بسیار ساده شده است: کافی است آدرس سایت خود را وارد کنید تا ویجنت بهصورت خودکار لینک و کلید امنیتی تولید کند.
دو حالت اتصال
ویجنت از دو حالت اتصال پشتیبانی میکند. حالت «فقط webhook» (پیشفرض و سادهترین حالت) که افزونه وردپرس دادهها را بهصورت لحظهای به ویجنت میفرستد و نیازی به کلید REST API ندارد. حالت «همگامسازی کامل» که علاوه بر webhook، ویجنت هر ۳۰ دقیقه یکبار فروشگاه شما را هم کشش (poll) میکند تا تغییراتی که از webhook جا ماندهاند را جبران کند — این حالت به Consumer Key/Secret ووکامرس نیاز دارد.
این اتصال چه میکند؟
- محصولات: ایجاد/ویرایش/حذف هر محصول در ووکامرس، فوراً در کاتالوگ ویجنت منعکس میشود (با re-embedding خودکار برای جستجوی معنایی).
- سفارشها: تغییر وضعیت سفارش (مثلاً به «در حال پردازش» یا «تکمیلشده») یک رکورد StoreOrder میسازد و آن را از روی شماره تماس/ایمیل مشتری به مخاطب مربوطه متصل میکند.
- همگامسازی دستی: هر زمان دکمهٔ «بروزرسانی محصولات» را در صفحهٔ محصولات بزنید، کل محصولات و سفارشهای اخیر دوباره fetch میشوند (در حالت کامل).
پیشنیازها
به وردپرس ۵.۸ به بالا و دسترسی مدیریت وردپرس برای نصب افزونه نیاز دارید. اگر ووکامرس نسخهٔ ۶ به بالا نصب باشد، محصولات و سفارشها هم همگام میشوند؛ در غیر این صورت، فقط محتوای سایت همگام میشود. برای حالت «همگامسازی کامل» به Consumer Key/Secret ووکامرس هم نیاز دارید (از WooCommerce → Settings → Advanced → REST API).
گام ۱ — ساخت اتصال در پنل ویجنت (تولید خودکار لینک و کلید)
به صفحهٔ «محصولات» در داشبورد ویجنت بروید. در بالای صفحه، یک کارت اتصال ووکامرس میبینید. روی دکمهٔ «اتصال ووکامرس» بزنید، آدرس سایت خود را وارد کنید و «ایجاد اتصال» را بزنید. ویجنت بهصورت خودکار یک آدرس webhook و یک کلید امنیتی تصادفی تولید میکند و هر دو را با دکمهٔ کپی به شما نمایش میدهد.
گام ۲ — نصب افزونهٔ وردپرس
- 1فایل افزونه را از پنل ویجنت (صفحهٔ محصولات یا اتصالات) یا از آدرس /downloads/vigent-wordpress.zip دانلود کنید.
- 2در وردپرس به «افزونهها ← افزودن ← بارگذاری افزونه» بروید و فایل vigent-woo.zip را آپلود کنید.
- 3افزونه را فعال کنید. یک منوی اصلی با نام «ویجنت» در نوار کناری مدیریت ظاهر میشود (نه زیر منوی ووکامرس).
- 4به «ویجنت ← تنظیمات» بروید و آدرس webhook و کلید امنیتی که از پنل ویجنت کپی کردید را در فیلدها قرار دهید.
- 5روی «ذخیره تنظیمات» و سپس «تست اتصال» بزنید. افزونه یک پیام نمونه به ویجنت میفرستد تا اتصال را تأیید کند.
گام ۳ — همگامسازی اولیه
پس از تست موفق، به تب «همگامسازی» در افزونه بروید و روی «ارسال همهٔ محصولات» (و سپس سفارشها و محتوا) بزنید تا همهٔ دادههای فعلی یکبار به ویجنت ارسال شوند. این کار برای فروشگاههای بزرگ ممکن است چند دقیقه طول بکشد. پس از آن، هر تغییر محصول/سفارش بهصورت فوری (push) از طریق webhook به ویجنت میرسد.
گام ۴ — تأیید در پنل ویجنت
به صفحهٔ «محصولات» در پنل ویجنت برگردید. باید ببینید وضعیت اتصال به «متصل» تغییر کرده، چکلیست همگامسازی تکمیل میشود، و لیست محصولات بهروز میشود. در صورت بروز خطا، پیام آن در همین کارت نمایش داده میشود. میتوانید با دکمهٔ «بروزرسانی محصولات» یک همگامسازی دستی هم اجرا کنید.
گام ۵ (اختیاری) — فعالسازی همگامسازی کامل
اگر میخواهید ویجنت هر ۳۰ دقیقه فروشگاه را هم poll کند (بهعلاوهٔ webhook)، باید Consumer Key/Secret ووکامرس را در پنل ویجنت وارد کنید. برای ساخت این کلیدها: در وردپرس به WooCommerce ← Settings ← Advanced ← REST API بروید، روی «Add key» بزنید، دسترسی «Read/Write» انتخاب کنید و کلیدها را کپی کنید. سپس در پنل ویجنت (بخش اتصالات) این کلیدها را وارد کنید.
عیبیابی
- خطای Fatal: Call to undefined method ... Order::get_billing() — این خطا در نسخههای قدیمی افزونه رخ میداد. افزونه را به نسخهٔ ۲.۰.۰ یا بالاتر بهروزرسانی کنید.
- خطای ۴۰۱ (woocommerce_rest_cannot_view) در پنل ویجنت؟ این خطا در حالت poll رخ میدهد و بهدلیل اشتباه بودن یا ناقص بودن Consumer Key/Secret است. کلیدها را در ووکامرس دوباره بسازید و در پنل ویجنت بروزرسانی کنید، یا حالت webhook-only را انتخاب کنید که نیازی به این کلیدها ندارد.
- محصولات در ویجنت ظاهر نمیشوند؟ بررسی کنید افزونه فعال است، آدرس webhook و کلید صحیح است، و یک همگامسازی کامل اجرا کردهاید. برای بررسی، یک «تست اتصال» در افزونه بزنید.
- سفارشها به مخاطب متصل نمیشوند؟ شماره تلفن/ایمیل سفارش باید با همان فیلدی که در پروفایل مخاطب ویجنت ذخیره شده مطابقت داشته باشد (نرمالسازی 0 و 98+ پشتیبانی میشود).
- هیچ لاگی در پنل نیست؟ پس از «تست اتصال» در افزونه، یک ردیف لاگ باید فوراً در پنل ویجنت ظاهر شود. اگر نشد، احتمالاً آدرس webhook اشتباه است یا هاست outgoing را بسته است.