📦 Cataloug – Persian Product Catalog Showcase for WooCommerce

A powerful WordPress plugin to display your WooCommerce products as a beautiful catalog with 10 modern UI/UX layouts, advanced filters, and rich interactive features — fully optimized for Persian (Farsi) language, RTL, Persian fonts, and Persian digits. 🇮🇷

Language note: This plugin is designed primarily for Persian (Farsi) stores. The admin dashboard, labels, RTL layout, Vazir font, and Persian numerals are tailored for Persian-speaking users. Product data and WooCommerce remain language-agnostic.

---

✨ Overview

Cataloug turns your shop into a flexible product catalog with:

Area	What you get
🧩 Layouts	10 UI types: grid, masonry, slider, list, flip cards, magazine, timeline, parallax, split screen, interactive gallery
🔍 Filters	Categories, live search, price range, sorting, plus advanced filters (brand, stock, sale, new arrivals, best sellers)
💬 Interactive	Quick View, Lightbox, Lazy Loading, PDF download, Wishlist, Compare (up to 4), Share (Facebook, X/Twitter, WhatsApp)
🌐 Persian / RTL	Farsi admin strings, RTL, Vazir font (CDN), Persian digits in PHP & JavaScript
📱 Responsive	Mobile-first, works across devices

---

🔧 Feature Matrix

Category	Capabilities
Layouts (UI/UX)	10 layouts with admin preview grid and “selected” state
Filtering & search	Category, search, price slider, sort; 5 optional advanced filters
Interactive	Quick View, Lightbox, Lazy Loading, PDF, Wishlist, Compare, Share, notifications
Product info	Optional SKU, stock status, dimensions, weight, tags
Localization (FA)	Persian dashboard, RTL stylesheet, Vazir, Persian numerals
Customization	Primary/secondary colors, CSS variables, theme template overrides
Performance	Lazy loading; works with common caching plugins

---

🎨 Layouts (10 Types)

#	Key	Name	Description
1	grid	Grid Classic	Classic grid, 2–6 columns
2	masonry	Masonry	Pinterest-style dynamic heights
3	slider	Slider / Carousel	Slider with navigation & autoplay
4	list	List View	Detailed list layout
5	flip-cards	Flip Cards	3D flip cards
6	magazine	Magazine	Editorial / featured style
7	timeline	Timeline	Chronological timeline
8	parallax	Parallax	Depth / parallax backgrounds
9	split-screen	Split Screen	Dual-panel layout
10	gallery	Interactive Gallery	Full-screen style gallery + lightbox

---

🔍 Filters & Search

• Core: category filter, live search, price range, sorting (newest, price, popularity, rating).
• Advanced (optional): brand, in-stock only, on-sale, new arrivals, best sellers.

---

💬 Interactive Features (Settings → Features)

Feature	Notes
⚡ Quick View	Modal product preview
🖼 Lightbox	Large image overlay
🐌 Lazy Loading	On-demand images
📄 PDF Download	Catalog PDF when enabled
❤️ Wishlist	localStorage, Persian counters, notifications
🔄 Compare	Up to 4 products, localStorage
🔗 Share	Facebook, X/Twitter, WhatsApp

Optional product meta on cards: SKU, stock, dimensions, weight, tags.

---

🌐 Persian Localization & RTL

• Admin: Persian labels for tabs (General, Layout, Filters, Styling, Features), options, and buttons.
• Font: Vazir loaded via CDN (e.g. jsDelivr); weights Regular / Medium / Bold.
• Digits: Helpers in PHP (includes/class-cataloug-helpers.php) and JS (Cataloug.toPersianNumbers) for prices, counts, pagination, meta, notifications.
• RTL: assets/css/rtl.css aligns layout for right-to-left text.

---

📦 Requirements

Requirement	Version
WordPress	5.8+
PHP	7.4+
WooCommerce	Required (products)

---

🚀 Installation

1. Upload the cataloug folder to wp-content/plugins/, or upload the ZIP under Plugins → Add New → Upload.
2. Activate Cataloug - Product Catalog Showcase.
3. On activation, a default catalog page may be created.
4. Open کاتالوگ / Cataloug in the admin menu and configure tabs.

---

📖 Usage

Main shortcode

[cataloug]

With parameters

[cataloug layout="grid" products_per_page="12" category="clothing" columns="4"]

Parameter	Values / notes
layout	grid, masonry, slider, list, flip-cards, magazine, timeline, parallax, split-screen, gallery
products_per_page	Integer
category	Category slug
columns	2–6 (grid-style layouts)

Filters shortcode

[cataloug_filters show_search="yes" show_category="yes" show_price="yes"]

In a theme template

<?php
if ( function_exists( 'do_shortcode' ) ) {
    echo do_shortcode( '[cataloug layout="masonry"]' );
}
?>

---

🎨 Customization

CSS variables (example)

:root {
    --cataloug-primary: #your-color;
    --cataloug-secondary: #your-color;
}

Template overrides

Copy files from:

plugins/cataloug/templates/

to:

your-theme/cataloug/

---

🤝 Compatibility

• ✅ WooCommerce
• ✅ Elementor, WPBakery (typical shortcode usage)
• ✅ WPML (multilingual setups)
• ✅ Standard themes & RTL

---

🐛 Troubleshooting

Issue	What to try
No products	WooCommerce active; published products exist; clear cache
Styles missing	Settings → Permalinks → Save; clear caches
Filters broken	JS enabled; check plugin/theme conflicts
Vazir not loading	Internet/CDN; clear caches
Persian digits wrong	Ensure main.js loads; check console for errors

---

📄 License

GPL v2 or later — see license text.

---

👤 Author

Alireza Aminzadeh — ariacoder.ir

---

Built with ❤️ for Persian WooCommerce catalogs. 🚀