HandyCafe Docs
owner

مدیریت منو

تب Menu در بخش کافه‌تریا جایی است که کاتالوگی را می‌سازید که مشتری‌ها در handy.cafe/{slug} می‌بینند. منوها از دسته‌بندی‌ها و محصولات تشکیل می‌شوند. محصولات می‌توانند گروه‌های واریانت برای انتخاب‌هایی مثل Size یا Toppings داشته باشند.

ساختار

سطح کاربرد
Category بخشی از منو؛ برای مثال "Hot Drinks" یا "Burgers". هر دسته یک آیکون و یک ترتیب نمایش دارد.
Product یک آیتم قابل سفارش داخل یک دسته. شامل نام، توضیح، عکس، قیمت، نرخ VAT و زمان آماده‌سازی است.
Variant Group اختیاری. یک مجموعه انتخاب متصل به محصول؛ برای مثال "Size: Small, Medium, Large". هر واریانت یک اختلاف قیمت دارد.

دسته‌بندی‌ها

هر دسته‌بندی فیلدهای زیر را دارد:

فیلد معنی
Name به‌عنوان سربرگ بخش در منوی مشتری نمایش داده می‌شود.
Icon نام یک آیکون MDI (Material Design Icons). آن را از picker آیکون انتخاب کنید.
Sort Order عدد صحیح. عددهای پایین‌تر اول نمایش داده می‌شوند. با drag یا دکمه‌های move-up و move-down قابل تنظیم است.
Active وقتی خاموش باشد، آن دسته و همه محصولاتش از منوی مشتری پنهان می‌شوند اما حذف نمی‌شوند.

افزودن یک دسته‌بندی

  1. کافه‌تریا > Menu را باز کنید.
  2. روی Add Category کلیک کنید.
  3. یک نام وارد کنید.
  4. روی باکس آیکون کلیک کنید و یک آیکون MDI انتخاب کنید. picker یک فهرست قابل جست‌وجو باز می‌کند. می‌توانید واژه‌هایی مثل "coffee"، "burger" یا "pizza" را امتحان کنید.
  5. ذخیره کنید. دسته در ویرایشگر منو ظاهر می‌شود.

مرتب‌سازی دسته‌بندی‌ها

دسته را با drag روی دستگیره ردیف آن جابه‌جا کنید. موقعیت جدید به‌محض رها کردن ذخیره می‌شود. همچنین می‌توانید برای جای‌گذاری دقیق از فلش‌های move-up و move-down استفاده کنید.

حذف نرم

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

محصولات

هر محصول فیلدهای زیر را دارد:

فیلد معنی
Category دسته والد.
Name برای مشتری قابل مشاهده است.
Description از مارک‌داون پشتیبانی می‌کند. وقتی مشتری آیتم را لمس می‌کند در برگه جزئیات محصول نمایش داده می‌شود.
Ingredients خط کوتاهی زیر توضیح. برای آلرژن‌ها یا برجسته‌کردن مواد تشکیل‌دهنده استفاده کنید.
Base Price قیمت قبل از واریانت‌ها. در واحدهای خرد ذخیره می‌شود (برای مثال سنت) اما با واحد کامل ارز وارد می‌شود.
VAT Rate درصد. هنگام نمایش جمع‌ها روی رسید مشتری اعمال می‌شود.
Unit برچسب اختیاری مثل "ml" یا "g". کنار قیمت نمایش داده می‌شود.
Photo تصویر محصول. هر فرمتی پذیرفته می‌شود. WebP تا ۲ مگابایت برای سریع‌تر شدن بارگذاری منو پیشنهاد می‌شود.
Track Stock وقتی روشن باشد، محصول یک مقدار موجودی دارد که با هر سفارش کم می‌شود.
In Stock تعداد فعلی موجودی. وقتی موجودی به صفر برسد، سفارش مشتری ناموفق می‌شود و محصول به‌طور خودکار پنهان می‌شود.
Active وقتی خاموش باشد، محصول از منوی مشتری پنهان می‌شود.
Sort Order موقعیت در داخل دسته.
Preparation Time تخمین ثابتِ پشتیبان بر حسب دقیقه. بخش Dynamic Preparation Time را ببینید.

بارگذاری عکس

  1. محصول را باز کنید.
  2. روی ناحیه عکس کلیک کنید.
  3. یک تصویر از کامپیوتر خود انتخاب کنید. endpoint بارگذاری هر فرمتی را می‌پذیرد.
  4. سرور فایل را پردازش می‌کند، یک شناسه asset، نوع MIME و checksum ذخیره می‌کند و یک URL برمی‌گرداند.
  5. عکس بلافاصله در ویرایشگر و ظرف چند ثانیه در منوی مشتری ظاهر می‌شود.

برای جایگزین کردن عکس، روی تصویر موجود کلیک کنید و فایل جدید را بارگذاری کنید. فایل قبلی supersede می‌شود.

مارک‌داون در توضیحات

توضیحات محصول از Markdown پشتیبانی می‌کنند. استفاده‌های رایج:

  • برجسته‌سازی با **strong**.
  • line break برای توضیحات چندخطی.
  • فهرست‌های کوتاه برای مواد تشکیل‌دهنده یا ترکیب‌ها.

از headingهای H1 تا H6 در توضیحات محصول استفاده نکنید. منوی مشتری این توضیح را در یک برگه محدود رندر می‌کند و headingها نامناسب به نظر می‌رسند.

گروه‌های واریانت

واریانت‌ها انتخاب‌های مشتری را که قیمت یا پیکربندی را تغییر می‌دهند ثبت می‌کنند. یک محصول می‌تواند چند گروه واریانت داشته باشد؛ برای مثال Size و Toppings روی یک برگر.

هر واریانت این فیلدها را دارد:

فیلد معنی
Name برچسب قابل‌مشاهده برای مشتری؛ برای مثال "Size" یا "Extra Cheese".
Price Delta مقداری که هنگام انتخاب این واریانت به قیمت پایه اضافه می‌شود. می‌تواند صفر یا منفی باشد.
Required وقتی روشن باشد، مشتری باید قبل از افزودن به سبد، حداقل یک واریانت از این گروه انتخاب کند.
Sort Order موقعیت در داخل گروه.

ساختن یک گروه واریانت

  1. محصول را باز کنید.
  2. به بخش Variants بروید.
  3. روی Add Variant کلیک کنید.
  4. نام و Price Delta را وارد کنید. اگر انتخاب اجباری است، Required را روشن کنید.
  5. ذخیره کنید.

برای هر گزینه در گروه این کار را تکرار کنید. یک گروه معمولی Size سه ردیف دارد: Small با delta صفر، Medium با delta +1.00، و Large با delta +2.00.

زمان آماده‌سازی پویا

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

تنظیم اثر
Static Time روی محصول ذخیره می‌شود. وقتی داده تاریخی کافی برای محاسبه مقدار پویا وجود ندارد، از آن استفاده می‌شود.
Dynamic Estimate از ۳۰ روز اخیر تاریخچه سفارش محاسبه می‌شود. میانگین زمان آماده‌سازی هر محصول در یک ضریب شلوغی که از طول صف فعلی به‌دست می‌آید ضرب می‌شود. این ضریب بین 1.0 و 2.0 محدود می‌شود. مقدار نهایی بین 1 تا 120 دقیقه clamp می‌شود.

تنظیم "Show Prep Time on Menu" در پروفایل کسب‌وکار تعیین می‌کند که آیا این چیپ برای مشتری‌ها دیده شود یا نه. کارکنان همیشه این تخمین را در داشبورد Orders می‌بینند.

ردیابی موجودی

برای اینکه آیتم‌های تمام‌شده فروخته نشوند، در سطح هر محصول Track Stock را فعال کنید.

  • وقتی سفارشی ثبت می‌شود، تعداد موجودی به اندازه مقدار سفارش کم می‌شود.
  • وقتی موجودی به صفر برسد، محصول تا زمانی که مقدار را به‌روزرسانی کنید به‌طور خودکار از منوی مشتری پنهان می‌شود.
  • برای شارژ مجدد، محصول را ویرایش کنید و مقدار جدید In Stock را وارد کنید.

محصولاتی که Track Stock ندارند مانند موجودی نامحدود رفتار می‌کنند و هیچ‌وقت به‌صورت خودکار پنهان نمی‌شوند.

مرتب‌سازی مجدد محصولات داخل یک دسته

دستگیره را drag کنید تا یک محصول را بالا یا پایین ببرید. ترتیب جدید هنگام رها کردن ذخیره می‌شود. منوی مشتری بعد از تازه‌سازی بعدی منو این ترتیب جدید را منعکس می‌کند؛ تازه‌سازی‌ای که در هر بار بارگذاری session انجام می‌شود.

نکته‌ها

  • با ۶ تا ۱۰ دسته شروع کنید. دسته‌های خیلی زیاد مرور منوی مشتری را کند می‌کنند.
  • از عکس‌های با کنتراست بالا و روشن استفاده کنید. عکس‌های تاریک یا شلوغ نرخ تبدیل سفارش را پایین می‌آورند.
  • اگر ممکن است توضیحات را زیر ۱۲۰ کاراکتر نگه دارید. توضیحات بلند دکمه Add to Cart را در تلفن‌های همراه از صفحه اول بیرون می‌برند.
  • زمان‌های آماده‌سازی ثابت را واقع‌بینانه تنظیم کنید. سیستم پویا برای یادگیری ۳۰ روز زمان می‌خواهد. تا آن زمان عدد ثابت همان چیزی است که مشتری می‌بیند.
  • برای آیتم‌های پرانتخاب، به‌جای یک فهرست خیلی بزرگ، آنها را بین دو گروه واریانت تقسیم کنید. "Size" به‌علاوه "Milk" تمیزتر از "Size with Milk" است.