راهکارنتماژول ترب پرستاشاپ
ماژول رایگان اتصال پرستاشاپ ۸ و ۹ به ترب از راه API رسمی: ترب محصولات، قیمت و موجودی را از API محصولات نسخه‌ی ۳ می‌خواند، تغییرها با وب‌هوک همان لحظه به ترب می‌رسد، و وضعیت فروشگاه در ترب و گزارش‌های قیمت کاربران داخل پنل پرستاشاپ دیده می‌شود.
امکانات
API محصولات ترب (نسخه‌ی ۳)
نشانی‌ای که ترب محصولات، قیمت و موجودی را از آن می‌خواند. هر چهار شکل درخواست v3 پشتیبانی می‌شود و هر صفحه دقیقا ۱۰۰ محصول دارد، همان‌طور که مستند ترب خواسته. با نشانی‌های دوستانه، نشانی کوتاه /torob_api/v3/products را می‌گیرید.
بررسی توکن با کلید عمومی ترب
هر درخواست باید توکن ترب را در سرآیند X-Torob-Token داشته باشد که با کلید عمومی خود ترب بررسی می‌شود. درخواست بدون توکن معتبر خطای ۴۰۱ می‌گیرد و فهرست محصولات و قیمت‌ها به دست رقبا نمی‌افتد.
به‌روزرسانی آنی با وب‌هوک
وقتی قیمت، موجودی، ترکیب‌ها یا تصویر محصولی عوض شود، یا محصول غیرفعال و حذف شود، همان لحظه به ترب خبر داده می‌شود و ترب آن محصول را دوباره می‌خواند. لازم نیست منتظر سر زدن بعدی‌اش بمانید.
وب‌هوکی که پنل را کند نمی‌کند
تغییرها در صف می‌روند و بعد از تحویل صفحه فرستاده می‌شوند، صد صفحه در هر ارسال و حداکثر ۱۸ ارسال در دقیقه، زیر سقف ۲۰ ارسال ترب. اگر ترب جواب ندهد، ارسال خودکار پنج دقیقه صبر می‌کند تا ذخیره‌ی محصول کند نشود.
تغییرهایی که پرستاشاپ ثبت نمی‌کند
پرستاشاپ وقتی فقط موجودی یا قیمت ویژه عوض شود تاریخ تغییر محصول را جلو نمی‌برد. ماژول این تغییرها را خودش ثبت می‌کند تا ترب در مرتب‌سازی «تازه‌تغییرکرده‌ها» آن‌ها را هم ببیند.
هر ترکیب یک محصول جدا
هر سایز یا رنگ در ترب قیمت، موجودی و صفحه‌ی خودش را دارد و زیر همان محصول گروه می‌شود. یا اگر بخواهید: هر محصول یک ردیف، با قیمت ترکیب پیش‌فرض.
ریال یا تومان
ترب فقط تومان می‌پذیرد. اگر قیمت‌های فروشگاه ریال باشد، پیش از ارسال تقسیم بر ۱۰ می‌شود. پیش‌فرض از ارز فروشگاه حدس زده می‌شود و شما تأییدش می‌کنید.
تصویر بزرگ برای ترب
ترب تصویر ۹۰۰×۹۰۰ یا بزرگ‌تر می‌خواهد و بیشتر اندازه‌های ساخته‌شده‌ی پرستاشاپ کوچک‌ترند. پیش‌فرض تصویر اصلی بارگذاری‌شده فرستاده می‌شود و اگر ترکیب تصویر خودش را داشته باشد، همان.
چه چیزی فرستاده شود
دسته‌ها یا محصولاتی را که نمی‌خواهید در ترب باشند کنار بگذارید. محصولات غیرفعال و محصولاتی که نمایانی‌شان «هیچ‌جا» است هیچ‌وقت فرستاده نمی‌شوند. مقدار ویژگی گارانتی هم می‌تواند به‌عنوان گارانتی برود.
وضعیت فروشگاه در ترب
با توکن Shop API، برگه‌ی وضعیت نشان می‌دهد فروشگاه در ترب فعال است یا نه و چرا، چند محصول در ترب دیده می‌شود و دلیل خارج از دسترس بودن صفحه‌ها چیست.
محصولات در ترب
فهرست محصولات شما همان‌طور که ترب می‌بیند، با مشکلی که ترب برای هرکدام پیدا کرده: قیمت نامعتبر، تصویر ردشده، دسته‌بندی در انتظار تأیید و بقیه. فعال و غیرفعال کردن گروهی محصولات در ترب از همین‌جا.
جواب به گزارش‌های قیمت
گزارش‌هایی که کاربران ترب درباره‌ی قیمت و موجودی شما داده‌اند، با قیمت آن موقع و الان. جواب «اصلاح کردم» یا «گزارش اشتباه است» را از پنل پرستاشاپ می‌دهید و ترب محصول را دوباره می‌خواند.
پیش‌نمایش
دقیقا همان پاسخی که ترب می‌گیرد، برای یک صفحه از فهرست، محصولات مشخص یا نشانی یک صفحه. محصول بدون تصویر یا موجود با قیمت صفر هشدار می‌گیرد، چون ترب اولی را نشان نمی‌دهد و دومی را رایگان نشان می‌دهد.
گزارش رویدادها
هر چیزی که به ترب فرستاده شده و هر درخواست ردشده، با صافی روی بخش و فقط خطاها. پیش‌فرض ۳۰ روز نگه داشته می‌شود.
بی‌اثر روی فروشگاه
ماژول هیچ چیزی به صفحه‌های فروشگاه اضافه نمی‌کند. توکن‌های ذخیره‌شده هیچ‌وقت به مرورگر برنمی‌گردند و هوک‌هایی که داخل ذخیره‌ی محصول و ثبت سفارش اجرا می‌شوند خطای خودشان را می‌گیرند.
ترب معمولا قیمت و موجودی فروشگاه را با خزیدن صفحه‌های محصول می‌خواند. این یعنی تغییر قیمت دیر به ترب می‌رسد و هر تغییری در قالب سایت می‌تواند خواندنش را خراب کند. ترب برای همین API رسمی دارد و این ماژول آن را برای پرستاشاپ پیاده می‌کند: ترب محصولات را مستقیم از فروشگاه می‌گیرد، تغییرها همان لحظه به آن خبر داده می‌شود و هرچه ترب درباره‌ی فروشگاه شما می‌داند، داخل پنل پرستاشاپ می‌آید.
مهم‌ترین تنظیم، واحد قیمت است. ترب فقط تومان می‌پذیرد. خیلی از فروشگاه‌های ایرانی ارز IRR دارند ولی مبلغ‌ها را به تومان وارد کرده‌اند. ماژول از روی ارز پیش‌فرض حدس می‌زند، ولی پیش از معرفی فروشگاه به ترب، در برگه‌ی پیش‌نمایش قیمت یک محصول را با قیمت سایت مقایسه کنید.
پیش‌نیاز
- پرستاشاپ ۸٫۰ تا ۹٫x.
- PHP ۷٫۴ یا بالاتر با افزونه‌های
sodiumوcurl، که در بیشتر هاست‌ها فعال‌اند. اگر نباشند، نصب با پیامی متوقف می‌شود که نام افزونه‌ی لازم را می‌گوید. - به ماژول دیگری نیاز ندارد.
راه‌اندازی
- ماژول را از «ماژول‌ها ← مدیریت ماژول‌ها» با دکمه‌ی بارگذاری یک ماژول نصب کن. در منوی کناری، زیر بخش «پیکربندی»، گزینه‌ی ترب اضافه می‌شود.
- در برگه‌ی تنظیمات واحد قیمت فروشگاه (ریال یا تومان) را درست انتخاب کن و با برگه‌ی پیش‌نمایش بسنج.
- نشانی API را از برگه‌ی وضعیت کپی کن و برای پشتیبانی ترب بفرست تا فروشگاه را روی API ببرند. از آن به بعد همان برگه زمان آخرین درخواست ترب را نشان می‌دهد.
- اختیاری: توکن وب‌هوک را از پشتیبانی ترب بگیر، در تنظیمات وارد کن و وب‌هوک را روشن کن.
- اختیاری: در پنل ترب از صفحه‌ی «دسترسی API» توکن Shop API بساز و در تنظیمات وارد کن.
- اختیاری: نشانی کرون‌جاب برگه‌ی وضعیت را هر یکی دو دقیقه از کرون‌جاب هاست صدا بزن.
قیمتی که به ترب می‌رود
همان قیمتی که مهمان (بدون ورود) در سایت می‌بیند: با مالیات، با همه‌ی تخفیف‌های جاری و به ارز پیش‌فرض. قیمت قبل از تخفیف فقط وقتی فرستاده می‌شود که تخفیفی باشد. محصول ناموجود، طبق مستند ترب، با قیمت صفر فرستاده می‌شود. موجود یعنی موجودی بیشتر از صفر، یا اجازه‌ی سفارش در حالت ناموجود.
حذف ماژول
با حذف ماژول جدول‌ها و تنظیماتش پاک می‌شوند. پیش از حذف، از پشتیبانی ترب بخواهید فروشگاه را به خزیدن صفحه‌ها برگرداند؛ وگرنه ترب از نشانی API خطا می‌گیرد.
این ماژول با کمک Claude (دستیار هوش مصنوعی Anthropic) نوشته و مستندسازی شده است.
سؤالات متداول
رایگان است؟
بله، کاملا رایگان و با مجوز Academic Free License 3.0. لایسنس و ثبت‌نام ندارد.
به ماژول راهکار پرستاشاپ نیاز دارد؟
نه. مستقل است و فقط پرستاشاپ ۸ یا ۹ و PHP ۷.۴ با افزونه‌های sodium و curl می‌خواهد.
بعد از نصب ترب خودش از API استفاده می‌کند؟
نه. نشانی API را از برگه‌ی وضعیت کپی کنید و برای پشتیبانی ترب بفرستید تا فروشگاه را روی API ببرند. تا آن موقع ترب مثل قبل صفحه‌های محصول را می‌خزد و برگه‌ی وضعیت «هنوز درخواستی از ترب نیامده» نشان می‌دهد.
قیمت‌های فروشگاه من ریال است یا تومان؟
ارز پیش‌فرض گاهی گمراه می‌کند، چون خیلی از فروشگاه‌ها ارز IRR دارند ولی قیمت را تومان وارد کرده‌اند. قیمت یک محصول را در برگه‌ی پیش‌نمایش با سایت مقایسه کنید: قیمت ۱٬۵۰۰٬۰۰۰ در سایت، اگر تومان باشد در ترب هم ۱٬۵۰۰٬۰۰۰ است و اگر ریال باشد ۱۵۰٬۰۰۰.
وب‌هوک و Shop API لازم‌اند؟
نه، هر دو اختیاری‌اند. بدون وب‌هوک ترب تغییرها را در خواندن بعدی‌اش می‌بیند. بدون Shop API ماژول کار می‌کند ولی برگه‌های محصولات در ترب و گزارش‌های قیمت خالی می‌مانند.
سایت را کند می‌کند؟
نه. چیزی به صفحه‌های فروشگاه اضافه نمی‌شود و وب‌هوک بعد از تحویل صفحه فرستاده می‌شود. اگر ترب جواب ندهد، ارسال پنج دقیقه صبر می‌کند تا ذخیره‌ی محصول در پنل کند نشود.
محصولات ترکیبی (رنگ و سایز) چطور فرستاده می‌شوند؟
پیش‌فرض هر ترکیب یک محصول جدا با قیمت و موجودی خودش است که زیر همان محصول گروه می‌شود. اگر ترجیح بدهید، هر محصول یک ردیف با قیمت ترکیب پیش‌فرض می‌شود. با عوض کردن این گزینه شناسه‌ها عوض می‌شوند و ترب در خواندن کامل بعدی قدیمی‌ها را حذف و جدیدها را اضافه می‌کند.
سازگاری
نظرات
ایمیل شما نمایش داده نمی‌شود. نظرها پس از تأیید تیم منتشر می‌شوند.
هنوز نظری ثبت نشده. اولین نفر باش.
نظر خودت را بنویس