۱۰ چیدمان
از شبکه و masonry تا گالری و split-screen؛ پیشنمایش در پیشخوان و انتخاب پیشفرض یا override با پارامتر layout.
Cataloug — کاتالوگ محصولات
افزونهٔ وردپرس + ووکامرس برای نمایش محصولات بهصورت کاتالوگ با ۱۰ چیدمان مدرن، فیلتر و جستجو، تم فارسی و راستبهچپ، فونت وزیر و ارقام فارسی — مناسب فروشگاههای فارسیزبان.
توسعهدهنده
هزینه استفاده
رایگان (GPL)
پیشنیاز فروشگاه
WooCommerce
زبان رابط
فارسی (RTL)
معرفی و پیشنیاز
Cataloug (مخزن: woocommerce-dynamic-product-catalog) محصولات ووکامرس شما را بهصورت کاتالوگ با UI قابل تنظیم نشان میدهد؛ دادهٔ محصول همان محصولات استاندارد ووکامرس است و افزونه بیشتر روی نمایش، فیلتر و تجربهٔ کاربری تمرکز دارد.
- نسخه: پس از نصب و فعالسازی افزونه، نسخه در پیشخوان وردپرس (افزونهها) قابل مشاهده است.
- وردپرس: ۵٫۸ به بالا؛ PHP: ۷٫۴ به بالا.
- WooCommerce: الزامی — محصولات منتشرشده برای نمایش در کاتالوگ لازم است.
یادداشت: پیشخوان افزونه با برچسبهای فارسی (عمومی، چیدمان، فیلترها، استایل، امکانات) سازماندهی شده و برای فروشگاههای فارسی بهینه است؛ دادهٔ محصول و ووکامرس وابسته به زبان فروشگاه شماست.
چیدمانهای نمایش (۱۰ نوع)
در تنظیمات افزونه میتوانید نوع نمایش پیشفرض را انتخاب کنید؛ در شورتکد نیز با پارامتر layout قابل override است.
| کلید | نام | توضیح کوتاه |
|---|---|---|
grid | Grid Classic | شبکه کلاسیک؛ ستونهای ۲ تا ۶ |
masonry | Masonry | ارتفاع متغیر شبیه Pinterest |
slider | Slider / Carousel | اسلایدر با ناوبری و پخش خودکار |
list | List View | لیست با جزئیات بیشتر |
flip-cards | Flip Cards | کارت سهبعدی برگشتپذیر |
magazine | Magazine | سبک مجله / محتوای ویژه |
timeline | Timeline | زمانبندی خطی |
parallax | Parallax | عمق و پسزمینه پارالاکس |
split-screen | Split Screen | دو پنل کنار هم |
gallery | Interactive Gallery | گالری تمامعرض با لایتباکس |
جریان نمایش در فروشگاه
همان الگوی بصری مستندات «چت سازمانی»؛ داده از ووکامرس میآید، افزونه چیدمان و تعامل را اضافه میکند و خروجی در برگه یا قالب تم با شورتکد رندر میشود.
ورودی اصلی
WC
محصولات منتشرشده
کاتالوگ روی Query استاندارد محصولات سوار است؛ دسته، قیمت و متا همان دادهٔ فروشگاه شماست.
فیلتر و مرتبسازی
دسته، جستجو، اسلایدر قیمت، مرتبسازی و فیلترهای پیشرفته اختیاری؛ بلوک فیلتر جدا با [cataloug_filters].
تعامل روی کارت
Quick View، لایتباکس، wishlist و compare در مرورگر، اشتراکگذاری و در صورت نیاز PDF — همگی از تب امکانات قابل روشن/خاموش هستند.
شورتکد در برگه
[cataloug] یا با پارامترها در ویرایشگر بلوک/کلاسیک؛ برای المنتور معمولاً ویجت شورتکد کافی است.
قالب تم
echo do_shortcode( '[cataloug]' ); در فایل PHP تم؛ override ظاهر با پوشهٔ cataloug/ در قالب.
فیلتر و جستجو
- هسته: دستهبندی، جستجوی زنده، محدوده قیمت، مرتبسازی (جدیدترین، قیمت، محبوبیت، امتیاز).
- پیشرفته (اختیاری): برند، فقط موجود، تخفیف، تازهترینها، پرفروشها.
- برای بلوک فیلتر جدا از شورتکد اصلی میتوانید از
[cataloug_filters]استفاده کنید (جزئیات در پایین صفحه).
امکانات تعاملی
از بخش تنظیمات → امکانات میتوان موارد زیر را فعال یا غیرفعال کرد:
- Quick View: پیشنمایش سریع محصول در مودال.
- Lightbox: تصویر بزرگ روی صفحه.
- Lazy loading: بارگذاری تصاویر بهصورت تنبل.
- PDF: خروجی PDF کاتالوگ (در صورت فعالسازی).
- Wishlist / Compare / Share: لیست علاقهمندی و مقایسه (تا ۴ محصول) در
localStorage؛ اشتراکگذاری در شبکههای اجتماعی.
متادیتای اختیاری روی کارتها: SKU، موجودی، ابعاد، وزن، برچسبها.
بومیسازی فارسی و RTL
- برچسبهای پیشخوان و تبها به فارسی.
- فایل استایل RTL و فونت وزیر از CDN (مثلاً jsDelivr).
- تبدیل ارقام به فارسی در PHP و JavaScript (مثلاً قیمت، شمارندهها، صفحهبندی).
جدول سازگاری (طبق README افزونه)
| مورد | وضعیت |
|---|---|
| WooCommerce | الزامی — منبع محصولات |
| Elementor / WPBakery | استفاده معمول با شورتکد |
| WPML | چندزبانه (محتوای محصول طبق تنظیم فروشگاه) |
| تمهای استاندارد و RTL | پشتیبانی عمومی؛ در صورت تداخل، کش و اسکریپت تم را بررسی کنید |
| افزونههای کش | معمولاً سازگار؛ پس از تغییر استایل، کش را خالی کنید |
سفارشیسازی ظاهر
- متغیرهای CSS: مثلاً
--cataloug-primaryو--cataloug-secondaryبرای رنگهای اصلی و فرعی. - Override قالب: کپی فایلها از
wp-content/plugins/…/templates/بهyour-theme/cataloug/.
نصب و راهاندازی
- پوشهٔ افزونه را در
wp-content/plugins/قرار دهید یا ZIP را از افزونهها → افزودن → بارگذاری نصب کنید. - افزونهٔ Cataloug - Product Catalog Showcase را فعال کنید (نام دقیق ممکن است با نسخهٔ شما کمی متفاوت باشد).
- ووکامرس باید فعال و محصولات منتشر شده داشته باشید.
- از منوی پیشخوان کاتالوگ / Cataloug تنظیمات را باز کنید؛ در صورت طراحی افزونه، ممکن است پس از فعالسازی یک برگهٔ پیشفرض ساخته شود.
پارامترهای شورتکد اصلی
شورتکد پایه: [cataloug]
| پارامتر | مقادیر / توضیح |
|---|---|
layout |
grid، masonry، slider، list، flip-cards، magazine، timeline، parallax، split-screen، gallery |
products_per_page |
عدد صحیح |
category |
اسلاگ دستهٔ محصولات |
columns |
۲ تا ۶ (برای چیدمانهای شبکهای) |
مثال: [cataloug layout="masonry" products_per_page="12" category="clothing" columns="4"]
کپی سریع شورتکد
یکی از نمونهها را در محتوای برگه یا ویجت قرار دهید؛ در صورت استفاده از Elementor یا WPBakery معمولاً همان الگوی شورتکد استاندارد وردپرس جواب میدهد.
[cataloug]
[cataloug layout="grid" products_per_page="12" columns="4"]
[cataloug_filters show_search="yes" show_category="yes" show_price="yes"]
در قالب PHP تم
میتوانید با echo do_shortcode( '[cataloug]' ); خروجی را در فایل قالب چاپ کنید.
سازگاری
طبق README افزونه با Elementor، WPBakery، WPML و تمهای استاندارد سازگار است.
عیبیابی
| مشکل | اقدام پیشنهادی |
|---|---|
| محصولی دیده نمیشود | فعال بودن ووکامرس، وجود محصول منتشرشده، پاک کردن کش |
| استایلها ناقص است | تنظیمات → پیوندهای یکتا → ذخیره؛ خالی کردن کش افزونه/سرور |
| فیلترها کار نمیکند | فعال بودن JavaScript؛ بررسی تداخل با اسکریپتهای تم یا افزونهٔ دیگر |
| فونت وزیر بارگذاری نمیشود | دسترسی به اینترنت/CDN؛ فایروال یا ad-blocker |