Vira Woo Price Range

نمایش بازهٔ قیمت (رنج قیمت) برای محصولات متغیر ووکامرس، به‌جای نمایش تکی قیمت. خروجی به شکل «از X تا Y» نشان داده می‌شود و با قالب‌هایی که قیمت را با CSS مخفی می‌کنند (مثل وودمارت / Woodmart) کاملاً سازگار است.

برای مشاهدهٔ توضیحات انگلیسی، به بخش English پایین صفحه بروید.

✨ ویژگی‌ها

• 🔢 نمایش بازهٔ قیمت به شکل «از کمترین قیمت تا بیشترین قیمت» برای محصولات متغیر
• 🛍️ کار در صفحهٔ فروشگاه، صفحهٔ تکی محصول و کارت‌های محصول المنتور
• 🎯 سازگار با قالب‌هایی که قیمت را با visibility:hidden پنهان می‌کنند (به‌ویژه وودمارت / Woodmart)
• ⚙️ بدون هیچ تنظیماتی — کافی است نصب و فعال کنید
• 🪶 سبک، تک‌فایلی و بدون وابستگی اضافه
• 🌐 آمادهٔ ترجمه (Text Domain اختصاصی)

📋 پیش‌نیازها

• وردپرس
• افزونهٔ ووکامرس (WooCommerce) — فعال

اگر ووکامرس فعال نباشد، افزونه به‌صورت خودکار غیرفعال می‌ماند و در پیشخوان هشدار نمایش می‌دهد.

🚀 نصب

روش اول — از طریق پیشخوان وردپرس

1. این مخزن را به‌صورت ZIP دانلود کنید (Code → Download ZIP).
2. در پیشخوان وردپرس به افزونه‌ها → افزودن → بارگذاری افزونه بروید.
3. فایل ZIP را بارگذاری و افزونه را فعال کنید.

روش دوم — دستی (FTP / SSH)

# داخل پوشهٔ افزونه‌های وردپرس
cd wp-content/plugins
git clone https://github.com/sepehrfathi/vira-woo-price-range.git

سپس از پیشخوان وردپرس افزونه را فعال کنید.

پس از فعال‌سازی، بازهٔ قیمت به‌صورت خودکار روی همهٔ محصولات متغیر اعمال می‌شود؛ هیچ تنظیم دیگری لازم نیست.

🔍 چطور کار می‌کند؟

افزونه روی فیلترهای قیمت ووکامرس با اولویت بسیار بالا (9999) می‌نشیند تا خروجی نهایی همیشه بازهٔ قیمت باشد:

• woocommerce_variable_price_html
• woocommerce_variable_sale_price_html

برای هر محصول متغیر، کمترین و بیشترین قیمت واریشن‌ها گرفته می‌شود و اگر متفاوت باشند، خروجی زیر ساخته می‌شود:

<span class="vira-price-range">
  <span class="vira-price-part vira-price-from">از ...</span>
  تا
  <span class="vira-price-part vira-price-to">... </span>
</span>

همچنین یک CSS کوچک تزریق می‌شود تا اگر قالب سعی کند بخشی از قیمت را با visibility:hidden پنهان کند، بازهٔ قیمت همیشه کامل دیده شود.

🎨 کلاس‌های CSS برای سفارشی‌سازی

می‌توانید ظاهر بازهٔ قیمت را با این کلاس‌ها در استایل قالب خود تغییر دهید:

🗺️ نقشهٔ راه (ایده‌ها)

• [ ] افزودن تنظیمات برای سفارشی‌سازی متن «از / تا»
• [ ] گزینهٔ نمایش/عدم نمایش بازه در صفحهٔ فروشگاه به‌صورت جداگانه
• [ ] پشتیبانی رسمی چند زبانه

👤 توسعه‌دهنده

سپهر فتحی — ویرا وب آریا

📄 مجوز

این افزونه تحت مجوز GPL v2 یا بالاتر منتشر شده است. برای جزئیات فایل LICENSE را ببینید.

English

Vira Woo Price Range is a lightweight WooCommerce plugin that displays a price range (from X to Y) for variable products instead of a single price — on the shop page, single product page, and Elementor product cards.

Features

• Shows a min–max price range for variable products
• Works on shop, single product, and Elementor product cards
• Compatible with themes that hide the price via CSS (especially Woodmart)
• Zero configuration — just install and activate
• Single-file, dependency-free, translation-ready

Requirements

• WordPress
• WooCommerce (active)

Installation

Download as ZIP and upload via Plugins → Add New → Upload Plugin, or clone into wp-content/plugins/ and activate.

How it works

Hooks into woocommerce_variable_price_html and woocommerce_variable_sale_price_html at priority 9999, computes the lowest and highest variation prices, and renders them as a range. A small inline CSS guarantees the range stays visible even when a theme tries to hide the price.

Author & License

Built by Sepehr Fathi — Vira Web Aria. Licensed under GPL v2 or later.