ویرایش گروهی محصولات ووکامرس

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

راهنمای انگلیسی در پایین همین صفحه آمده است · English documentation is available below.

---

✨ امکانات

جستجو و فیلتر

• جستجو در نام محصول یا SKU
• فیلتر بر اساس وضعیت انتشار (منتشرشده، پیش‌نویس، در انتظار، خصوصی)
• فیلتر بر اساس نوع محصول (ساده، متغیر، گروهی، خارجی، فقط واریانت)
• فیلتر بر اساس دسته‌بندی
• نمایش/مخفی‌کردن واریانت‌ها در کنار محصولات والد
• صفحه‌بندی با اندازه‌ی دلخواه (۲۵ / ۵۰ / ۱۰۰ / ۲۰۰ / همه)

ویرایش سریع داخل جدول

هر ردیف را مستقیم در جدول ویرایش کنید:

• نام، SKU
• قیمت عادی و قیمت فروش (حراج)
• مدیریت موجودی، تعداد موجودی، وضعیت انبار
• وضعیت انتشار، نمایش در کاتالوگ، محصول ویژه

پنل جزئیات هر محصول

برای هر محصول یک پنل کامل باز می‌شود که اجازه‌ی ویرایش این موارد را می‌دهد:

• رسانه: عکس شاخص و گالری تصاویر (با انتخابگر رسانه‌ی وردپرس)
• متن: توضیح کوتاه، توضیح کامل / توضیح واریانت، یادداشت خرید
• طبقه‌بندی: دسته‌ها، برچسب‌ها، ترتیب منو
• حمل‌ونقل و مالیات: وزن، طول، عرض، ارتفاع، وضعیت مالیات، کلاس مالیات، کلاس حمل‌ونقل
• تنظیمات فروش: محصول مجازی، دانلودی، فروش تکی، پیش‌سفارش، آستانه‌ی کمبود موجودی، لینک و متن دکمه‌ی محصول خارجی
• ویژگی‌ها: ویژگی‌های محصول و ویژگی‌های واریانت‌ها

عملیات گروهی

روی محصولات انتخاب‌شده به‌صورت یکجا اعمال کنید:

• تغییر وضعیت انتشار
• قیمت عادی / قیمت فروش
• موجودی، مدیریت موجودی، وضعیت انبار
• نمایش در کاتالوگ، محصول ویژه
• دکمه‌ی میان‌بر Unpublish برای پیش‌نویس کردن گروهی

ساخت خودکار واریانت‌ها

• ساخت تمام حالت‌های ممکن واریانت از روی ویژگی‌هایی که variation=1 دارند
• واریانت‌های تکراری دوباره ساخته نمی‌شوند
• امکان ساخت گروهی برای چند محصول متغیر انتخاب‌شده

نکات فنی

• رابط کاربری کاملاً فارسی و راست‌چین
• پشتیبانی از اعداد فارسی و عربی در ورودی‌های عددی (به‌صورت خودکار به اعداد لاتین تبدیل می‌شوند)
• ذخیره‌ی فقط ردیف‌های تغییرکرده و فقط فیلدهای واقعاً عوض‌شده — سریع و امن
• تمام درخواست‌ها با AJAX، nonce و بررسی دسترسی (manage_woocommerce) محافظت شده‌اند

---

📋 پیش‌نیازها

نیازمندی	حداقل نسخه
وردپرس	5.6
ووکامرس	4.0
PHP	7.2

---

🚀 نصب

روش ۱ — دستی

1. این مخزن را دانلود یا کلون کنید.
2. پوشه را داخل wp-content/plugins/ کپی کنید.
3. از پیشخوان وردپرس به افزونه‌ها بروید و «ویرایش گروهی محصولات ووکامرس» را فعال کنید.

روش ۲ — آپلود فایل ZIP

1. از پوشه‌ی افزونه یک فایل ZIP بسازید.
2. در پیشخوان وردپرس: افزونه‌ها ← افزودن ← بارگذاری افزونه.
3. فایل ZIP را آپلود و افزونه را فعال کنید.

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

---

📖 نحوه‌ی استفاده

1. وارد ووکامرس ← ویرایش گروهی محصولات شوید.
2. با فیلترها و جستجو محصولات موردنظر را پیدا کنید و روی بارگذاری بزنید.
3. مقادیر را مستقیم در جدول یا از طریق دکمه‌ی جزئیات ویرایش کنید. ردیف‌های تغییرکرده مشخص می‌شوند.
4. برای ذخیره روی ذخیره ردیف‌های تغییرکرده بزنید.
5. برای اعمال یکجا روی چند محصول، آن‌ها را تیک بزنید، مقدار موردنظر را در نوار عملیات گروهی وارد کنید و اعمال روی انتخاب‌شده‌ها را بزنید.

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

---

🗒️ تغییرات

1.5.1

• رفع باگ مهم واریانت‌ها: پیش‌تر هنگام تغییر قیمت یک واریانت، ویژگی‌های آن (رنگ/سایز/…) بازنویسی می‌شد و گاهی باعث می‌شد ترکیب ویژگی واریانت‌ها خراب شود (حذف گزینه‌ها از حالت انتخاب یا یکی‌شدن قیمت‌ها). حالا فقط فیلدهای واقعاً تغییرکرده ذخیره می‌شوند و ویژگی‌ها فقط در صورت تغییر واقعی بازنویسی می‌شوند.

1.5.0

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

---

📄 مجوز

این افزونه تحت مجوز GPLv2 یا نسخه‌های بعد منتشر شده است. فایل LICENSE را ببینید.

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

سپهر فتحی

---

WooCommerce Bulk Product Editor

A WordPress plugin for managing, quick-editing, and running bulk operations on WooCommerce products from a single screen. Instead of opening products one by one, search, filter, edit, and save dozens of products at once — including simple, variable, grouped, and external products as well as variations.

راهنمای فارسی در بالای همین صفحه آمده است.

---

✨ Features

Search & Filter

• Search by product name or SKU
• Filter by publish status (published, draft, pending, private)
• Filter by product type (simple, variable, grouped, external, variations only)
• Filter by category
• Show/hide variations alongside their parent products
• Custom pagination size (25 / 50 / 100 / 200 / all)

Inline Quick Edit

Edit each row directly in the table:

• Name, SKU
• Regular price and sale price
• Manage stock, stock quantity, stock status
• Publish status, catalog visibility, featured flag

Per-Product Detail Panel

Each product expands into a full editing panel:

• Media: featured image and gallery (via the WordPress media picker)
• Content: short description, full/variation description, purchase note
• Taxonomy: categories, tags, menu order
• Shipping & Tax: weight, length, width, height, tax status, tax class, shipping class
• Sales settings: virtual, downloadable, sold individually, backorders, low-stock threshold, external product URL and button text
• Attributes: product attributes and variation attributes

Bulk Operations

Apply to all selected products at once:

• Change publish status
• Regular / sale price
• Stock quantity, manage stock, stock status
• Catalog visibility, featured flag
• One-click Unpublish (move to draft) shortcut

Automatic Variation Generation

• Generate every possible variation from attributes marked variation=1
• Existing variations are never duplicated
• Batch generation for multiple selected variable products

Technical Notes

• Fully Persian / RTL interface
• Accepts Persian and Arabic numerals in numeric inputs (auto-converted to Latin digits)
• Saves only changed rows and only the fields that actually changed — fast and safe
• All requests are protected with AJAX nonces and a manage_woocommerce capability check

---

📋 Requirements

Requirement	Minimum version
WordPress	5.6
WooCommerce	4.0
PHP	7.2

---

🚀 Installation

Option 1 — Manual

1. Download or clone this repository.
2. Copy the folder into wp-content/plugins/.
3. In the WordPress dashboard, go to Plugins and activate “WooCommerce Bulk Product Editor.”

Option 2 — ZIP upload

1. Create a ZIP archive of the plugin folder.
2. In the dashboard: Plugins → Add New → Upload Plugin.
3. Upload the ZIP and activate.

After activation, open the tool from WooCommerce → Bulk Product Editor.

---

📖 Usage

1. Go to WooCommerce → Bulk Product Editor.
2. Use the filters/search to find products and click Load.
3. Edit values directly in the table or via the Details button. Changed rows are highlighted.
4. Click Save changed rows to persist your edits.
5. To apply changes to several products at once, select them, set the value(s) in the bulk toolbar, and click Apply to selected.

Note on variable products: a variable product's price is derived from its variations; to change pricing, edit the variation rows themselves.

---

🗒️ Changelog

1.5.1

• Important variation fix: previously, changing a variation's price would rewrite its attributes (color/size/…), which could corrupt the variation's attribute combination (options disappearing from the selector, or prices getting mixed up). Now only fields that actually changed are saved, and attributes are rewritten only when they genuinely change.

1.5.0

• Initial release with search, filtering, pagination, quick edit, detail panel, bulk operations, and automatic variation generation.

---

📄 License

Released under the GPLv2 or later license. See LICENSE.

👤 Author

Sepehr Fathi