═══════════════════════════════════════════════════════════════
   منوی دیجیتال ام کافه — نسخه PHP (سازگار با هاست cPanel)
   بدون نیاز به Node.js — دقیقاً مثل وردپرس: PHP + MySQL
═══════════════════════════════════════════════════════════════

نیازمندی هاست:
  • PHP نسخه ۷.۴ یا بالاتر (روی همه هاست‌های cPanel موجود است)
  • MySQL یا SQLite (هر دو پشتیبانی می‌شود)

───────────────────────────────────────────────
راهنمای نصب در cPanel (۵ دقیقه)
───────────────────────────────────────────────

قدم ۱ — ساخت دیتابیس MySQL
  ۱. وارد cPanel شوید.
  ۲. روی «MySQL Databases» کلیک کنید.
  ۳. در بخش «Create New Database» یک دیتابیس بسازید؛
     مثلاً: mcafe  (نام کامل می‌شود: username_mcafe)
  ۴. پایین همان صفحه، یک «MySQL User» بسازید؛
     مثلاً: mcafeadmin و یک رمز قوی برایش بگذارید.
  ۵. در بخش «Add User To Database»، کاربر را به دیتابیس اضافه کنید
     و تیک «ALL PRIVILEGES» را بزنید و Save کنید.

قدم ۲ — آپلود و باز کردن فایل‌ها
  ۱. در cPanel روی «File Manager» کلیک کنید.
  ۲. وارد پوشه «public_html» شوید.
  ۳. فایل m-cafe-php.zip را آپلود کنید (دکمه Upload).
  ۴. روی فایل zip راست‌کلیک → «Extract» → پوشه m-cafe ساخته می‌شود.

  ▶ اگر می‌خواهید منو مستقیم روی دامنه اصلی باز شود
    (یعنی yourdomain.com به‌جای yourdomain.com/m-cafe):
    وارد پوشه m-cafe شوید، همه فایل‌ها را انتخاب کنید (Select All)
    و با «Move» به public_html منتقل کنید.
    ⚠ اگر در public_html از قبل فایل index.php یا index.html دارید
    (مثلاً وردپرس)، این کار را نکنید؛ منو در مسیر /m-cafe بماند.

قدم ۳ — تنظیم config.php
  ۱. در File Manager روی فایل config.php راست‌کلیک → Edit.
  ۲. این چهار خط را با اطلاعات قدم ۱ پر کنید:
       define('DB_NAME', 'username_mcafe');
       define('DB_USER', 'username_mcafeadmin');
       define('DB_PASS', 'رمزی که ساختید');
       define('DB_HOST', 'localhost');   // معمولاً همین بماند
  ۳. رمز مدیریت را عوض کنید:
       define('ADMIN_PIN', '1234');   ← به رمز دلخواه شما
  ۴. Save کنید.

قدم ۴ — نصب خودکار
  ۱. در مرورگر باز کنید:  yourdomain.com/install.php
     (یا اگر در پوشه است:  yourdomain.com/m-cafe/install.php)
  ۲. دکمه «شروع نصب» را بزنید.
  ۳. پیام «نصب با موفقیت انجام شد» را می‌بینید؛ همه جدول‌ها و
     منوی کامل (۵ دسته و ۲۵ آیتم) به‌صورت خودکار ساخته می‌شود.

قدم ۵ — حذف install.php  (مهم!)
  بعد از نصب، فایل install.php را از هاست حذف کنید تا کسی
  نتواند دیتابیس را بازنشانی کند.

───────────────────────────────────────────────
آدرس‌ها
───────────────────────────────────────────────
  منوی مهمان‌ها :  yourdomain.com/index.php
  پنل مدیریت    :  yourdomain.com/admin.php
  رمز مدیریت    :  همان ADMIN_PIN در config.php (پیش‌فرض: 1234)

───────────────────────────────────────────────
امکانات پنل مدیریت
───────────────────────────────────────────────
  ✔ افزودن آیتم جدید به هر دسته (نام، نام انگلیسی، قیمت، قیمت دوم، یادداشت)
  ✔ ویرایش و تغییر قیمت آیتم‌ها
  ✔ حذف آیتم
  ✔ موجود / ناموجود کردن هر آیتم (آیتم ناموجود در منوی عمومی کدر می‌شود)
  ✔ تغییرات بلافاصله در منوی عمومی اعمال می‌شود

───────────────────────────────────────────────
اگر هاست شما MySQL ندارد؟
───────────────────────────────────────────────
  در config.php فقط یک خط را عوض کنید:
       define('DB_DRIVER', 'sqlite');
  در این حالت هیچ دیتابیسی لازم نیست و داده‌ها در فایل
  data/menu.sqlite ذخیره می‌شود (پوشه data خودکار ساخته می‌شود).

───────────────────────────────────────────────
رفع اشکال
───────────────────────────────────────────────
  ▶ صفحه «Error establishing a database connection» یا خطای اتصال:
    مقادیر DB_NAME / DB_USER / DB_PASS در config.php را با بخش
    MySQL Databases در cPanel تطبیق دهید. نام دیتابیس و کاربر در
    cPanel همیشه با نام کاربری هاست شروع می‌شود (مثل username_mcafe).

  ▶ صفحه سفید یا خطای 500:
    در File Manager → Settings تیک «Show Hidden Files» را بزنید،
    فایل .htaccess را باز کنید و موقتاً دو خط
    «Require all denied» را با «#» غیرفعال کنید.
    اگر حل شد یعنی هاست شما از Apache قدیمی استفاده می‌کند؛
    به‌جای «Require all denied» از «Deny from all» استفاده کنید.

  ▶ عکس‌ها نشان داده نمی‌شوند:
    مطمئن شوید پوشه assets با زیرپوشه‌های images و fonts کامل
    آپلود شده است.

  ▶ کد QR: به‌صورت خودکار به آدرسی که منو در آن نصب شده اشاره
    می‌کند؛ کافیست با گوشی صفحه را باز کنید.

  ▶ امنیت: بعد از نصب حتماً
      ۱) ADMIN_PIN را عوض کنید
      ۲) install.php را حذف کنید
      ۳) اگر می‌توانید SSL (https) را روی دامنه فعال کنید

═══════════════════════════════════════════════════════════════
                              با آرزوی پر بودن همیشه میزهای ام کافه ☕
═══════════════════════════════════════════════════════════════