پرستاشاپ · رایگان

خوراک محصولات اسنپ‌پی برای پرستاشاپ

ماژول رایگان خوراک JSON محصولات برای اسنپ‌پی در پرستاشاپ ۸ و ۹: نام، قیمت به ریال، موجودی، رنگ و سایز، دسته‌بندی و تصویر هر محصول در یک آدرس، با صفحه‌بندی، توکن دسترسی اختیاری و مصرف حافظه‌ای که با بزرگ شدن کاتالوگ بالا نمی‌رود.

خوراک محصولات اسنپ‌پی برای پرستاشاپ

امکانات

آدرس کوتاه خوراک

کل فهرست در /feeds/products و هر محصول در /feeds/products/{id}. محصولی که نیست یا دیده نمی‌شود خطای ۴۰۴ می‌گیرد.

قیمت همیشه به ریال

قیمت فروش و قیمت پیش از تخفیف به ریال فرستاده می‌شود. اگر قیمت‌های فروشگاه تومان باشد، در ۱۰ ضرب می‌شود. پیش‌فرض واحد قیمت از ارز فروشگاه حدس زده می‌شود و شما تأییدش می‌کنید.

رنگ و سایز

هر محصول یک رکورد است و رنگ‌ها و سایزهای ترکیب‌هایش داخل همان رکورد می‌آیند. محصول تا وقتی یکی از ترکیب‌هایش موجود باشد موجود حساب می‌شود و قیمتش ارزان‌ترین ترکیب موجود است.

دسته‌بندی و برند

مسیر کامل دسته‌بندی هر محصول فرستاده می‌شود و می‌توانید یک پیشوند جلوی همه بگذارید. برای محصول بدون برند، برند پیش‌فرض قابل تنظیم است.

حافظه‌ی ثابت برای کاتالوگ بزرگ

خوراک رکورد به رکورد فرستاده می‌شود، نه اینکه کل فهرست اول در حافظه ساخته شود. کش هر ۲۰۰ محصول خالی می‌شود، پس فروشگاه چند ده هزار محصولی هم به سقف حافظه‌ی هاست نمی‌خورد.

صفحه‌بندی

با page و size هر بار حداکثر ۱۰۰۰ محصول. تعداد کل محصولات و صفحه‌ها در هدرهای X-Total-Count و X-Total-Pages می‌آید.

توکن دسترسی اختیاری

بدون توکن، خوراک عمومی است. با توکن، فقط کسی که آن را دارد می‌خواند: در هدر X-Api-Key، به شکل Authorization: Bearer، یا با ?token= در آدرس. خوراک محافظت‌شده هیچ‌وقت در کش عمومی یا CDN نمی‌ماند.

اندازه‌ی تصویر

پیش‌فرض بزرگ‌ترین اندازه‌ی تصویر پرستاشاپ فرستاده می‌شود. می‌توانید هر اندازه‌ی دیگری را انتخاب کنید.

فقط محصولات قابل‌دیدن

محصولات غیرفعال و محصولاتی که نمایانی‌شان «هیچ‌جا» است هیچ‌وقت در خوراک نمی‌آیند.

نمونه‌ی رکورد در پنل

برگه‌ی خوراک اولین محصول را دقیقا همان‌طور که به اسنپ‌پی می‌رسد نشان می‌دهد، همراه تعداد محصولات خوراک و آدرس‌ها با دکمه‌ی کپی.

انتقال از rahkarfeed

تنظیمات ماژول قدیمی rahkarfeed موقع نصب منتقل می‌شود و آدرس خوراک عوض نمی‌شود.

اسنپ‌پی برای نشان دادن محصولات فروشگاه در جست‌وجوی خودش یک آدرس می‌خواهد که فهرست محصولات را به شکل JSON بدهد. این ماژول همان آدرس را در پرستاشاپ می‌سازد: /feeds/products برای کل فهرست و /feeds/products/{id} برای یک محصول. آدرس را برای اسنپ‌پی می‌فرستید و از آن به بعد اسنپ‌پی خودش قیمت و موجودی را به‌روز می‌خواند.

مهم‌ترین تنظیم، واحد قیمت است. اسنپ‌پی قیمت را به ریال می‌گیرد. خیلی از فروشگاه‌ها ارز IRR دارند ولی قیمت‌ها را تومان وارد کرده‌اند. پیش از فرستادن آدرس، در برگه‌ی خوراک قیمت نمونه‌ی رکورد را با قیمت سایت مقایسه کنید.

پیش‌نیاز

  • پرستاشاپ ۸٫۰ تا ۹٫x.
  • PHP ۷٫۴ یا بالاتر.
  • آدرس‌های دوستانه پیشنهاد می‌شود ولی لازم نیست. بدون آن، آدرس خوراک شکل بلند index.php را دارد و همان‌طور کار می‌کند.

راه‌اندازی

  1. ماژول را از «ماژول‌ها ← مدیریت ماژول‌ها» با دکمه‌ی بارگذاری یک ماژول نصب کنید و روی پیکربندی بزنید.
  2. در برگه‌ی تنظیمات واحد قیمت فروشگاه را بررسی کنید. اگر بخواهید فقط اسنپ‌پی خوراک را بخواند، یک توکن دسترسی بگذارید.
  3. در برگه‌ی خوراک نمونه‌ی رکورد را ببینید و آدرس خوراک را با دکمه‌ی کپی بردارید و برای اسنپ‌پی بفرستید، همراه توکن اگر گذاشته‌اید.

آمدن از ماژول rahkarfeed

اگر ماژول قدیمی rahkarfeed نصب دارید، تنظیماتش موقع نصب منتقل می‌شود و آدرس خوراک همان می‌ماند، پس لازم نیست چیزی به اسنپ‌پی خبر بدهید. هر دو ماژول به یک آدرس جواب می‌دهند، برای همین بعد از نصب، ماژول قدیمی را حذف کنید. تا حذف نشود، پنل این ماژول هشدار می‌دهد.

مستندات

سؤالات متداول

رایگان است؟

بله، رایگان است و لایسنس و ثبت‌نام ندارد.

به ماژول راهکار پرستاشاپ نیاز دارد؟

نه. مستقل است و فقط پرستاشاپ ۸ یا ۹ و PHP ۷.۴ می‌خواهد.

توکن بگذارم یا نه؟

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

قیمت‌های فروشگاه من ریال است یا تومان؟

قیمت نمونه‌ی رکورد در برگه‌ی خوراک را با سایت مقایسه کنید. خوراک همیشه ریال است: محصولی که در سایت ۱٬۵۰۰٬۰۰۰ تومان است، در خوراک ۱۵٬۰۰۰٬۰۰۰ می‌شود.

فروشگاه بزرگ را کند نمی‌کند؟

نه. خوراک فقط وقتی ساخته می‌شود که اسنپ‌پی آن را بخواند و رکورد به رکورد فرستاده می‌شود. خوراک عمومی پنج دقیقه کش می‌شود.

ماژول rahkarfeed قبلی را چه کنم؟

بعد از نصب این ماژول حذفش کنید. تنظیماتش منتقل شده و آدرس خوراک همان است.

سازگاری

نسخه۱.۰.۰
پلتفرمماژول پرستاشاپ
سازگاریپرستاشاپ ۸ و ۹
نسخه‌ی PHP۷.۴ به بالا
ماژول لازمندارد
قالب خوراکJSON، صفحه‌بندی تا ۱۰۰۰ محصول
واحد قیمت در خوراکریال
زبان‌هافارسی / انگلیسی
مجوزرایگان

نظرات

ایمیل شما نمایش داده نمی‌شود. نظرها پس از تأیید تیم منتشر می‌شوند.

هنوز نظری ثبت نشده. اولین نفر باش.

نظر خودت را بنویس

۰ / ۱۵۰۰

رایگان
دانلود