راهنمای اجرای شاپیوا روی هاست ساب‌دامین
========================================

این زیپ سورس قالب است. روی هاست Node.js آپلود کنید.
هاست وردپرس / PHP به‌تنهایی کافی نیست.

مشخصات لازم
------------
- Node.js نسخه 20 یا بالاتر
- حداقل 1 گیگ RAM (بهتر: 2 گیگ)
- SSL روی ساب‌دامین (https)

قدم‌ها
------
1) زیپ را در پوشه ساب‌دامین استخراج کنید.

2) در همان پوشه، فایل .env.example را کپی کنید و نام آن را بگذارید:
   .env.local

3) داخل .env.local آدرس فروشگاه اصلی ووکامرس را بگذارید
   (بدون اسلش آخر):

   WP_URL=https://example.com
   NEXT_PUBLIC_WP_URL=https://example.com
   WC_CONSUMER_KEY=ck_xxxxx
   WC_CONSUMER_SECRET=cs_xxxxx
   NEXT_PUBLIC_CATALOG_SOURCE=woocommerce
   CATALOG_FALLBACK_JSON=true

   کلید را از پیشخوان وردپرس بسازید:
   ووکامرس → تنظیمات → پیشرفته → REST API
   دسترسی: فقط خواندن

4) در ترمینال هاست (همان پوشه پروژه):

   npm install
   npm run build
   npm start

5) در پنل Node هاست:
   - Startup / Start command: npm start
   - یا Application startup file: node_modules/next/dist/bin/next
   - پورت را همانی بگذارید که پنل می‌دهد (معمولاً Next با متغیر PORT کار می‌کند)

6) تست اتصال:
   https://shop.example.com/api/catalog/status

   اگر ok برابر true بود، قالب به فروشگاه اصلی وصل شده است.

نکته مهم
--------
تا وقتی این تست تمام نشده، دامنه اصلی فروشگاه را تغییر ندهید.
اگر اتصال ووکامرس نباشد، قالب با داده نمونه بالا می‌آید.
