# آموزش اتصال ووکامرس به ترب و نمایش مستقل محصولات متغیر
اگر فروشگاه ووکامرسی دارید و محصولات شما دارای تنوعهایی مانند رنگ، سایز، وزن یا مدل هستند، احتمالاً با چالش نمایش این تنوعها در ترب مواجه شدهاید.
در بعضی فروشگاهها، تنها محصول مادر در ترب نمایش داده میشود و مشتری نمیتواند تنوعهای مختلف محصول را بهصورت مستقل مشاهده کند.
در این آموزش، نحوه حل این مشکل با افزونه رایگان **Notran Torob Connect** را بررسی میکنیم.
## مشکل نمایش محصولات متغیر در ترب چیست؟
فرض کنید در فروشگاه خود محصولی با نام «مانتو لینن زنانه» دارید که در سه رنگ مشکی، سفید و کرم عرضه میشود.
در ووکامرس این محصول بهدرستی بهعنوان یک محصول متغیر تعریف شده است؛ اما ممکن است هنگام اتصال به ترب فقط عنوان محصول مادر نمایش داده شود.
در این شرایط برخی فروشگاهها برای هر رنگ، محصولی جداگانه ایجاد میکنند.
این روش چند مشکل دارد:
– افزایش غیرضروری تعداد محصولات فروشگاه
– پیچیدهتر شدن مدیریت موجودی و قیمتها
– دشوار شدن مدیریت ویژگیها و تنوعها
– احتمال ایجاد محتوای تکراری و مشکلات سئو
راهکار مناسب، حفظ ساختار استاندارد محصولات متغیر ووکامرس و معرفی مستقل تنوعها به ترب است.
## معرفی افزونه Notran Torob Connect
افزونه **Notran Torob Connect** برای اتصال فروشگاههای ووکامرسی به Product API v3 ترب توسعه داده شده است.
مهمترین ویژگی آن، امکان معرفی هر تنوع محصول بهعنوان یک آیتم مستقل با عنوان مشخص است؛ بدون نیاز به ساخت محصول تکراری در ووکامرس.
### قابلیتهای اصلی افزونه
– پشتیبانی از محصولات ساده و متغیر ووکامرس
– معرفی مستقل هر تنوع به ترب
– تعریف عنوان اختصاصی برای تنوعها
– تنظیم نحوه نمایش ویژگیهایی مانند رنگ در عنوان
– امکان مستثنا کردن محصولات یا تنوعهای مشخص
– سازگاری با Product API v3 ترب
– پیشنمایش اطلاعات محصولات پیش از دریافت توسط ترب
– پشتیبانی از وبهوک برای اطلاعرسانی تغییرات محصولات
– گزارش وضعیت همگامسازی و احراز هویت
## پیشنیازهای نصب
پیش از شروع، موارد زیر را بررسی کنید:
1. وردپرس و ووکامرس نصب و فعال باشند.
2. محصولات متغیر بهدرستی در ووکامرس تعریف شده باشند.
3. به مدیریت وردپرس و تنظیمات فروشگاه دسترسی داشته باشید.
4. فروشگاه در ترب ثبت شده باشد و امکان هماهنگی با پشتیبانی ترب وجود داشته باشد.
5. ساعت سرور بهدرستی همگامسازی شده باشد.
## مرحله اول: نصب افزونه
ابتدا آخرین نسخه افزونه را از مخزن GitHub دریافت کنید.
سپس:
1. وارد پیشخوان وردپرس شوید.
2. به مسیر «افزونهها ← افزودن افزونه تازه» بروید.
3. گزینه «بارگذاری افزونه» را انتخاب کنید.
4. فایل ZIP را بارگذاری و نصب کنید.
5. افزونه را فعال کنید.
پس از فعالسازی، بخش «اتصال به ترب» در منوی ووکامرس در دسترس قرار میگیرد.
## مرحله دوم: پیکربندی اولیه
از مسیر زیر وارد تنظیمات شوید:
**ووکامرس ← اتصال به ترب ← اتصال و تنظیمات**
در این بخش میتوانید تنظیمات مربوط به اتصال، نحوه تولید اطلاعات محصولات، تنظیمات عنوان تنوعها و قابلیت اطلاعرسانی تغییرات را بررسی کنید.
ابتدا تنظیمات مربوط به خروجی محصولات را متناسب با فروشگاه خود انجام دهید.
در صورت نیاز میتوانید محصولات یا تنوعهای خاصی را از خروجی ترب مستثنا کنید.
## مرحله سوم: تعیین نام دلخواه محصولات متغیر
یکی از مهمترین امکانات افزونه، امکان تعیین عنوان مناسب برای تنوعهای مختلف محصولات است.
فرض کنید محصول شما «مانتو لینن زنانه» نام دارد و شامل سه تنوع زیر است:
| محصول در ووکامرس | عنوان قابل معرفی به ترب |
|—|—|
| مانتو لینن زنانه – مشکی – ۳۸ | مانتو لینن زنانه مشکی سایز ۳۸ |
| مانتو لینن زنانه – سفید – ۴۰ | مانتو لینن زنانه سفید سایز ۴۰ |
| مانتو لینن زنانه – کرم – ۴۲ | مانتو لینن زنانه کرم سایز ۴۲ |
با استفاده از تنظیمات عنوان تنوعها در افزونه، میتوانید عنوانهای موردنظر را تعریف یا نحوه ترکیب ویژگیها با نام محصول را تنظیم کنید.
در نتیجه، هر تنوع میتواند با اطلاعات و شناسه مستقل در خروجی API معرفی شود.
**نکته:** نمایش نهایی محصولات در ترب به دریافت، پردازش و تأیید اطلاعات توسط خود ترب بستگی دارد.
## مرحله چهارم: بررسی پیشنمایش محصولات
پیش از معرفی آدرس API به ترب، بهتر است اطلاعات محصولات را بررسی کنید.
از مسیر زیر استفاده کنید:
**ووکامرس ← اتصال به ترب ← پیشنمایش محصول**
چند محصول ساده و متغیر را انتخاب و اطلاعات خروجی آنها را کنترل کنید.
موارد مهم عبارتاند از:
– عنوان محصول و عنوان هر تنوع
– شناسه مستقل تنوعها
– قیمت و وضعیت موجودی
– آدرس صحیح محصول یا تنوع
– ویژگیهای محصول
در صورت مشاهده عنوان یا اطلاعات نادرست، ابتدا تنظیمات محصول یا افزونه را اصلاح کنید.
## مرحله پنجم: معرفی آدرس Product API v3 به ترب
پس از انجام تنظیمات، باید آدرس API فروشگاه خود را به پشتیبانی ترب معرفی کنید.
ساختار آدرس به این صورت است:
`https://YOUR-DOMAIN.com/wp-json/notran-torob/v3/products`
بهجای `YOUR-DOMAIN.com` آدرس دامنه فروشگاه خود را قرار دهید.
برای نمونه، در یک فروشگاه با دامنه `example.com` آدرس زیر استفاده میشود:
`https://example.com/wp-json/notran-torob/v3/products`
**نکته مهم:** این API برای دریافت درخواستهای POST از سمت ترب طراحی شده است. بنابراین باز کردن مستقیم آدرس در مرورگر، آزمایش معتبر عملکرد فید محسوب نمیشود.
### آیا باید توکن API ترب را وارد کنیم؟
برای خواندن اطلاعات Product API v3، ترب توکن JWT امضاشده را هنگام ارسال درخواست در هدر `X-Torob-Token` قرار میدهد.
بنابراین برای این بخش نیازی به وارد کردن دستی همان توکن در آدرس فید نیست.
پس از معرفی آدرس، از پشتیبانی ترب بخواهید اتصال را بررسی و با یک درخواست معتبر آزمایش کند.
## مرحله ششم: تنظیم وبهوک ترب
افزونه از قابلیت وبهوک برای اطلاعرسانی تغییرات محصولات نیز پشتیبانی میکند.
این قابلیت میتواند برای اطلاعرسانی تغییراتی مانند قیمت یا موجودی به ترب استفاده شود.
**تفاوت مهم توکنها:**
توکن مربوط به احراز هویت درخواستهای Product API v3 با توکن وبهوک یکسان نیست.
در صورت فعالسازی وبهوک، توکن مربوط به آن را از مسیر معرفیشده توسط پشتیبانی ترب دریافت و در تنظیمات افزونه وارد کنید.
اگر فعلاً قصد استفاده از وبهوک ندارید، میتوانید اتصال اصلی API را بهصورت مستقل راهاندازی کنید.
## مرحله هفتم: بررسی دریافت اطلاعات توسط ترب
پس از ثبت آدرس API و انجام تنظیمات:
1. از پشتیبانی ترب درخواست تست اتصال کنید.
2. بخش «وضعیت همگامسازی» افزونه را بررسی کنید.
3. گزارش درخواستها و احراز هویت را کنترل کنید.
4. مطمئن شوید اطلاعات محصولات متغیر بهصورت مستقل دریافت میشود.
5. پس از پردازش دادهها، وضعیت نمایش محصولات را در ترب بررسی کنید.
دریافت موفق اطلاعات توسط API الزاماً به معنی نمایش فوری محصولات در نتایج ترب نیست.
## رفع خطاهای متداول
### خطای `expired` یا نامعتبر بودن زمان توکن
یکی از مهمترین نکاتی که هنگام راهاندازی این افزونه باید رعایت شود، **دقیق بودن ساعت سرور** است.
توکنهای JWT دارای زمان اعتبار مشخص هستند. اگر ساعت سیستم سرور جلوتر یا عقبتر از زمان واقعی باشد، درخواست معتبر ترب نیز ممکن است با خطای احراز هویت مواجه شود.
برای رفع مشکل:
1. ساعت سیستم سرور را بررسی کنید.
2. از مدیر هاست بخواهید همگامسازی NTP را بررسی و اصلاح کند.
3. پس از اصلاح ساعت، درخواست آزمایشی جدیدی از پشتیبانی ترب بخواهید.
تغییر منطقه زمانی وردپرس بهتنهایی جایگزین اصلاح ساعت سیستم سرور نیست.
### فقط محصول مادر نمایش داده میشود
ابتدا از بخش پیشنمایش محصول بررسی کنید که تنوعهای مختلف بهصورت مستقل در خروجی افزونه وجود داشته باشند.
سپس وضعیت دریافت و پردازش تنوعها را با پشتیبانی ترب بررسی کنید.
### تغییر قیمت یا موجودی بهروزرسانی نمیشود
وضعیت وبهوک، توکن مربوط به آن، گزارش همگامسازی و پردازش تغییرات در ترب را بررسی کنید.
### خطای احراز هویت API
گزارش احراز هویت درخواستهای ترب را بررسی کنید. معتبر بودن امضای JWT، زمان سرور و رسیدن هدر احراز هویت به وردپرس اهمیت دارد.
## جمعبندی
افزونه Notran Torob Connect با هدف برطرف کردن یکی از مشکلات متداول فروشگاههای ووکامرسی متصل به ترب توسعه داده شده است.
با استفاده از این افزونه میتوانید ساختار اصلی محصولات متغیر فروشگاه را حفظ کنید و در عین حال اطلاعات هر تنوع را با نام مستقل به ترب معرفی کنید.
این افزونه بهصورت **رایگان و متنباز** منتشر شده و کد منبع آن در GitHub در دسترس است.
**دریافت افزونه:** https://github.com/shahroodi/notran-torob-sync
**معرفی پروژه:** https://shahroodi.com/fa/project/notran-torob-woocommerce/
**توسعهدهنده:** علی شاهرودی
**وبسایت:** shahroodi.com