رفتن به محتوای اصلی

افزونه وردپرس · کافه و کافی‌شاپ

کافه‌یار؛ کافه‌تان را از منو تا صندوق، روی ووکامرس اداره کنید

منوی دیجیتال روی گوشی مشتری، سفارش سر میز با QR، تابلوی آشپزخانه، رزرو با تایید خودتان، موجودی یک‌ضربه‌ای و گزارش پایان روز. محصول و پرداخت همان ووکامرسی است که از قبل دارید؛ کافه‌یار فقط کافه‌بودنِ آن را اضافه می‌کند.

  • سبد و پرداخت با ووکامرس
  • فونت و آیکن بدون CDN
  • رابط فارسی و راست‌به‌چپ

داخل افزونه

هرچه برای گرداندن کافه لازم دارید

بخش‌های اختیاری کافه‌یار را در تنظیمات خود افزونه فعال می‌کنید؛ منو و صفحه‌های کافه بدون تغییر قالب اصلی سایت نمایش داده می‌شوند.

منوی دیجیتال با ده قالب

شورت‌کد [cafeyar_menu] با ده قالب آماده (کلاسیک تا اپ) و انتخاب دسته محصولات ووکامرس. سه چیدمان برای دسته‌ها، صفحه‌بندی، جست‌وجو، مینی‌سبد و نمایش سریع محصول؛ همه با رنگ و متن‌های خودتان، بدون دست‌زدن به قالب سایت.

  • قالب «اپ کافه» شبیه اپ موبایل است
  • علاقه‌مندی‌ها در همان مرورگر مشتری

منوی نصب‌شدنی (PWA)

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

QR میز و سفارش سر میز

برای هر میز یک QR چاپی ساخته می‌شود. مشتری با اسکن، منو را باز می‌کند و سفارشش به همان میز می‌چسبد؛ نام میز در نمایشگر آشپزخانه، زنگ داشبورد، فاکتور و کپسول وضعیت مشتری دیده می‌شود.

  • کد میز امضاشده است، نه شماره قابل حدس
  • کد نامعتبر نادیده گرفته می‌شود

صدا زدن گارسون و درخواست صورتحساب

مشتری از سر میز «گارسون» یا «صورتحساب» را صدا می‌زند. درخواست بالای نمایشگر آشپزخانه می‌آید تا کسی «رسیدگی شد» را بزند؛ درخواست تکراری به‌صورت خودکار حذف می‌شود.

نمایشگر و فهرست آشپزخانه

تابلوی تمام‌صفحه با یک ستون برای هر مرحله آماده‌سازی؛ هر کارت شماره سفارش، میز، دقیقه‌های گذشته و اقلام با گزینه‌هایشان. سفارش‌های دیرشده علامت می‌خورند و با یک ضربه به مرحله بعد می‌روند.

  • هر ده ثانیه خودش تازه می‌شود
  • برای سفارش تازه زنگ می‌زند (بعد از یک بار روشن‌کردن صدا)

موجودی با یک ضربه

از همان تابلو، دکمه «موجودی امروز» فهرست محصولات منو را می‌آورد؛ با یک ضربه محصول «تمام شد» می‌شود و منو، سبد و API فوراً همان را نشان می‌دهند. محصولی که ووکامرس موجودی‌اش را با عدد می‌شمارد، فقط تعدادش نشان داده می‌شود.

رزرو آنلاین با تایید کافه

مشتری روز و ساعت و تعداد نفرات را می‌خواهد؛ ساعت‌های پیشنهادی فقط همان‌هایی هستند که واقعاً میز آزاد دارند. درخواست تا تایید شما هیچ میزی را اشغال نمی‌کند و هنگام تایید، دوباره زیر قفل بررسی می‌شود.

  • مشتری با یک پیوند خصوصی وضعیت را می‌بیند
  • تا پیش از شروع می‌تواند لغو کند

منوی زمان‌دار و ساعت خوش

برای هر دسته می‌توانید ساعت بگذارید؛ بیرون آن ساعت، دسته و زیردسته‌هایش از منو، جست‌وجو و API کنار می‌روند و سفارش‌شان ممکن نیست. در ساعت خوش، درصد تخفیف دلخواه روی دسته‌های انتخابی در سبد خرید حساب می‌شود.

  • ساعت‌ها به وقت سایت‌اند، نه مشتری
  • سبدی که بیرون ساعت پر شده، تسویه نمی‌شود

کارت مهر (باشگاه مشتریان)

برای هر قلم از دسته‌های انتخابی در سفارش پرداخت‌شده یک مهر می‌نشیند؛ کارت که پر شد، خودِ ووکامرس یک کوپن می‌سازد: یک قلم رایگان، یک‌بار مصرف، فقط با ایمیل همان مشتری. سفارش لغو یا مسترد، مهرهایش را پس می‌گیرد.

داشبورد و گزارش پایان روز

داشبورد امروزِ کافه را با فروش پس از بازپرداخت، تعداد سفارش، میانگین آماده‌سازی، نمودار فروش سی روز و پرفروش‌ها نشان می‌دهد. گزارش پایان روز یک روز را با تفکیک روش پرداخت، سر میز یا بیرون‌بر، لغو، بازپرداخت و سفارش‌های پرداخت‌نشده قابل چاپ می‌کند.

  • درآمد فقط برای مدیر؛ کارکنان آشپزخانه عدد مالی نمی‌بینند

پیگیری سفارش برای مشتری

در صفحه سفارش، مشتری مرحله‌های آشپزخانه و زمان تقریبی را می‌بیند. اگر اعلان را اجازه بدهد، با Web Push حتی پس از بستن صفحه خبر «آماده است» را می‌گیرد؛ روی آیفون فقط وقتی منو به صفحه اصلی افزوده شده باشد.

REST API و فاکتور چاپی

همه‌چیز از مسیر cafeyar/v1 هم در دسترس است: منو، محصول، پیگیری سفارش، تماس از میز، سفارش‌های آشپزخانه، موجودی، آمار و گزارش روز. برای صندوق و صفحه‌های دلخواه، فاکتور چاپی ۵۸ یا ۸۰ میلی‌متری هم هست.

مسیر یک سفارش

از اسکن QR تا گزارش آخر شب

همان جریانی که در کافه اتفاق می‌افتد، بدون کاغذ و بدون صدا زدن مکرر گارسون.

۱

مشتری اسکن می‌کند

QR روی میز باز می‌شود؛ منو با نام همان میز بالا می‌آید و مشتری بدون نصب اپ، از گوشی سفارش می‌دهد.

  • افزودن به سبد روی همان صفحه منو
  • گزینه‌های محصول متغیر داخل شیت پایین صفحه
  • کد میز چهار ساعت در همان مرورگر می‌ماند
۲

آشپزخانه می‌بیند

سفارش پرداخت‌شده با نام میز روی تابلوی آشپزخانه می‌افتد و با یک ضربه جلو می‌رود؛ مشتری همان لحظه مرحله را در صفحه پیگیری می‌بیند.

  • ستون جدا برای هر مرحله، سفارش دیرشده مشخص
  • صدا زدن گارسون بالای تابلوی آشپزخانه
  • زنگ سفارش‌های تازه در داشبورد مدیر
۳

کافه می‌بندد

پایان روز، گزارش همان روز را می‌گیرید؛ موجودی‌ها و رزروهای فردا هم همان‌جا روشن‌اند.

  • گزارش پایان روز قابل چاپ
  • درخواست‌های رزرو در انتظار تایید
  • محصولات ناموجود با یک ضربه برمی‌گردند

کنار چیزهایی که دارید

روی همان ووکامرس و همان قالب می‌نشیند

ووکامرس

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

  • محصول، دسته، قیمت، موجودی، سبد و پرداخت: همه از ووکامرس
  • فونت و آیکن‌های افزونه همراه خودش‌اند؛ برای آن‌ها CDN لازم نیست
  • اتصال به المنتور (نسخه رایگان): هشت ویجت و چند تگ پویا
  • اگر مدیریت موجودی‌اش را با عدد نشمارید، «تمام شد» با یک ضربه کافی است

المنتور (اختیاری)

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

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

صادقانه

چه می‌خواهد و چه چیزی را انجام نمی‌دهد

پیش‌نیازها

  • وردپرس ۶.۵ یا بالاتر
  • ووکامرس (سبد، پرداخت و وضعیت سفارش از خودش می‌آید)
  • نسخه فعلی بسته انکدشده برای PHP 8.1 تا 8.4 و لودر ionCube مناسب همان نسخه
  • HTTPS برای حالت نصب‌شدنی و اعلان‌ها

برای اعلان «آماده است» و حالت نصب‌شدنی، HTTPS و نسخه‌ای از PHP که کتابخانه OpenSSL داشته باشد لازم است.

محدودیت‌هایی که باید بدانید

  • اگر صفحه منو را کش می‌کنید، منوی کش‌شده تا تازه شدن کش تغییر ساعت را نشان نمی‌دهد؛ سبد خرید همیشه ساعت را بررسی می‌کند.
  • اعلان «آماده است» روی آیفون فقط برای منویی کار می‌کند که به صفحه اصلی گوشی افزوده شده باشد.
  • رزرو آنلاین جای میز را تا لحظه تایید نگه نمی‌دارد؛ تایید زیر قفل انجام می‌شود تا دو رزرو روی یک میز نیفتد.
  • این افزونه درگاه پرداخت و سبد جدا نمی‌سازد و چند شعبه‌ای نیست؛ رزرو و سفارش به‌صورت خودکار به شعبه‌ای نسبت داده نمی‌شود.
  • برای چاپ واقعی حرارتی (ESC/POS) و چاپ بدون ناظر، ادعایی نداریم؛ فاکتور HTML قابل چاپ است.

پرسش‌های متداول

چیزهایی که پیش از تصمیم می‌پرسند

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

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

قالب سایت من عوض می‌شود؟

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

مشتری برای سفارش دادن اپ نصب می‌کند؟

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

سفارش‌های کافه با سفارش‌های معمولی فروشگاه قاطی می‌شوند؟

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

اگر سرویس‌دهی اینترنت قطع شود چه می‌شود؟

منو و سفارش روی سرور وردپرس خودتان اجرا می‌شوند؛ برای دریافت صفحه و ثبت سفارش، اتصال به همان سرور لازم است. قابلیت‌های اختیاری مانند Web Push به سرویس اعلان مرورگر وابسته‌اند و پیام اعلان رمزگذاری می‌شود.

برای دیدن فهرست کامل جزئیات کجاست؟

مستندات فارسی API در مخزن پروژه است و فایل readme افزونه همه قابلیت‌ها و محدودیت‌های تأییدشده را ریز به ریز می‌گوید. برای دسترسی، از صفحه تماس پیام بدهید.

اگر می‌خواهید کافه‌یار را روی کافه‌ی خودتان ببینید

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