# MuchWOW Shabnam Commerce

قالب اختصاصی WordPress + WooCommerce توسعه‌داده‌شده برای SHABNAM.DEV.

- Author: SHABNAM.DEV
- Author URL: https://shcd.ir/
- Project / Plugin URL: https://shabnam.dev/
- Text domain: `shabnam-muchwow`
- Function prefix: `shabnam_`
- Compatibility: WordPress 5.8+ (tested through 7.0.x) / PHP 7.4+ / WooCommerce-ready
- RTL / Persian ready
- WooCommerce support: gallery zoom, lightbox, slider, archive and single product templates
- Blog support: archive, posts index, single post, comments, sidebar

## Templates implemented

- `front-page.php` — نسخه وردپرسی Home One با کلاس‌ها و assets اصلی MuchWOW
- `woocommerce/archive-product.php` — آرشیو فروشگاه با هوک‌های استاندارد ووکامرس
- `woocommerce/single-product.php` — صفحه محصول با هوک‌های استاندارد ووکامرس
- `woocommerce/content-product.php` — کارت محصول اختصاصی با حفظ hook API ووکامرس
- `woocommerce/content-single-product.php` — layout اختصاصی محصول با حفظ hook API ووکامرس
- `archive.php` / `home.php` — آرشیو وبلاگ
- `single.php` — نوشته تکی

## Installation

1. پوشه یا ZIP قالب را از بخش نمایش > پوسته‌ها نصب و فعال کنید.
2. WooCommerce را نصب/فعال کنید.
3. از نمایش > فهرست‌ها، منوی اصلی و فوتر را به locationهای قالب متصل کنید.
4. از نمایش > سفارشی‌سازی > تنظیمات SHABNAM.DEV، CTA و شبکه‌های اجتماعی را تنظیم کنید.
5. برای لوگوی اختصاصی از Site Identity / هویت سایت استفاده کنید.

## Development notes

این پروژه `woocommerce.php` ندارد تا overrideهای اختصاصی `archive-product.php` و `single-product.php` واقعاً استفاده شوند. wrapperهای اصلی WooCommerce با hook جایگزین شده‌اند و hookهای عمومی داخل templateها حذف نشده‌اند؛ بنابراین افزونه‌های WooCommerce می‌توانند به نقاط استاندارد خود متصل بمانند.

© SHABNAM.DEV — proprietary project.

## منبع استانداردهای integration

ساختار WooCommerce بر مبنای templateهای جاری و hook API رسمی پیاده‌سازی شده و `woocommerce.php` عمداً ایجاد نشده است تا overrideهای archive/single اولویت خود را از دست ندهند.


## نسخه 1.0.0

- رفع محدودیت اشتباه حداقل WordPress 6.9 که می‌توانست مانع فعال‌سازی روی سایت‌های WordPress 6.x شود.
- کاهش حداقل PHP به 7.4 و حذف وابستگی `str_contains()` مربوط به PHP 8.
- حفظ سازگاری با ساختار استاندارد WordPress و WooCommerce.

## Elementor — نسخه پایدار صفحه اصلی

- ظاهر پیش‌فرض صفحه اصلی عیناً از همان HTML و کلاس‌های نسخه اصلی MuchWOW استفاده می‌کند؛ بنابراین با نصب Elementor چیدمان اصلی حذف یا جایگزین نمی‌شود.
- اگر Elementor فعال باشد و سایت هنوز صفحه اصلی استاتیک نداشته باشد، قالب فقط یک‌بار برگه «خانه» را می‌سازد، آن را صفحه اصلی می‌کند و همان سکشن‌های MuchWOW را به صورت Widgetهای مستقل Elementor قرار می‌دهد.
- Hero، نوار متحرک، درباره ما، آمار، Tokenomics، نقشه راه و FAQ از پنل **MuchWOW / SHABNAM.DEV** در Elementor قابل ویرایش، جابه‌جایی، Duplicate و حذف هستند.
- یک لینک مستقیم «ویرایش صفحه اصلی با المنتور» در نوار مدیریت وردپرس اضافه می‌شود.
- اگر قبلاً صفحه اصلی استاتیک و دارای محتوا داشته باشید، قالب آن را بازنویسی نمی‌کند.
- فایل Import دستی نیز در `elementor-templates/muchwow-home-elementor.json` قرار دارد.
- نسخه قالب همچنان **1.0.0** است.

## فریم‌ورک شبنم (SHCD)

پنل اختصاصی **شبنم** از منوی اصلی مدیریت وردپرس با عنوان «شبنم» در دسترس است.

- Slug پنل: `shcd-muchwow-theme`
- Slug پوشه قالب: `shcd-muchwow-theme`
- REST namespace: `shcd-shabnam/v1`
- تنظیم لوگو و Site Icon
- تغییر رنگ‌های اصلی قالب و پس‌زمینه
- تنظیم CTA هدر، هدر چسبان، سبد خرید، بازگشت به بالا و اعلان حریم خصوصی
- تنظیم عنوان فوتر و شبکه‌های اجتماعی
- تنظیم Breadcrumb و تعداد ستون‌های فروشگاه
- رابط SPA بدون وابستگی به کتابخانه خارجی و بدون رفرش بین بخش‌ها

تنظیمات سمت سرور با whitelist و sanitize ذخیره می‌شوند، REST endpoint به capability `edit_theme_options` و nonce معتبر محدود است و در این فریم‌ورک هیچ Query خام SQL اجرا نمی‌شود.

**توسعه‌دهنده:** توسعه ارتباطات شبنم — `shabnam.dev`

## فریم‌ورک شبنم

از منوی «شبنم» در پیشخوان می‌توانید هویت بصری، رنگ‌های اصلی، تایپوگرافی، هدر، فوتر، وبلاگ و فروشگاه را مدیریت کنید. پنل به‌صورت SPA کار می‌کند و ذخیره تنظیمات از مسیر امن WordPress REST API، با بررسی سطح دسترسی و Nonce انجام می‌شود.

برای فونت شبنم یا هر فونت فارسی سفارشی، فایل WOFF/WOFF2 را در بخش «تایپوگرافی» انتخاب کنید. فونت انتخاب‌شده هم در قالب و هم در رابط فریم‌ورک قابل استفاده است.

صفحه اصلی پیش‌فرض قالب اکنون سکشن «محصولات منتخب» و «از مجله بخوانید» دارد. هر دو سکشن را می‌توان از تنظیمات خاموش/روشن کرد و عنوان، توضیح و تعداد آیتم‌هایشان را تغییر داد. دو ویجت مستقل «فروشگاه MuchWOW» و «وبلاگ MuchWOW» نیز به دسته ویجت‌های Elementor قالب اضافه شده‌اند.

صفحات آرشیو وبلاگ (`home.php` و `archive.php`) و صفحه تکی نوشته (`single.php`) از نوشته‌های استاندارد وردپرس، تصویر شاخص، خلاصه، نویسنده، تاریخ، برچسب، دیدگاه، صفحه‌بندی و سایدبار پشتیبانی می‌کنند. نمایش هرکدام از این اجزا از فریم‌ورک شبنم قابل کنترل است.

## دموها و برگه‌های بسته اصلی MuchWOW

این نسخه سه فایل `home-one.html`، `home-two.html` و `home-three.html` موجود در بسته اصلی را به سه برگه مستقل وردپرس تبدیل می‌کند. انتخاب دمو از مسیر «شبنم ← طرح‌های صفحه اصلی» انجام می‌شود و هر دمو داده Elementor مستقل خود را دارد. رنگ‌بندی اصلی هر دمو به‌صورت پیش‌فرض حفظ می‌شود؛ در صورت نیاز می‌توان جایگزینی رنگ‌های فریم‌ورک را از همان بخش فعال کرد.

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

سکشن وبلاگ ابتدا از `WP_Query` استاندارد و ایزوله استفاده می‌کند و در صورت تداخل افزونه‌های ثالث، یک مسیر سازگاری محدود و whitelist شده برای خواندن نوشته‌های `publish` دارد تا نوشته‌های منتشرشده صفحه اصلی بی‌دلیل حذف نشوند.
