=== Quick Price Editor for WooCommerce ===
Contributors: hshhiri
Tags: woocommerce, price editor, bulk price edit, csv import, undo
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 3.1.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Requires Plugins: woocommerce

Edit WooCommerce prices safely with filters, previews, bulk adjustments, undo history, CSV import/export, pricing rules and schedules.

== Description ==

**A powerful yet simple price editor for WooCommerce, built for store owners who need to update product prices quickly and safely.**

Quick Price Editor for WooCommerce gives you full control over your store’s pricing. Whether you want to apply a percentage increase to a selected group of products, adjust sale prices only, or round prices to the nearest ten, this plugin makes it easy – with a live preview before you commit any change.

Designed with usability and safety in mind, the plugin shows up to 50 parent products at a time, lets you filter by category, tag, or stock status, and includes a bulk adjustment tool that works on selected rows. All changes are saved only after you confirm, so you never accidentally update the wrong prices.

**Why choose Quick Price Editor?**

- **Safe & secure** – every change requires a confirmation, no automatic updates.
- **Preview before applying** – see the new prices instantly before saving.
- **Bulk adjustment** – increase or decrease prices by percentage on regular, sale, or both prices.
- **Smart rounding** – round up, down, or normally to the nearest 1, 10, 100, or 1000.
- **Works with simple and variable products** – manage variations efficiently.
- **Filter products** by category, tag, and stock status to target exactly the products you need.
- **Select and save** only the rows you want – no need to reload the page.

**New in 3.1**

- **Undo history** – every price change is recorded and can be restored per product or per operation.
- **Percent, fixed amount or exact price** bulk changes, with Persian-friendly price endings (…900, …990, …999) and thousands separators.
- **Sale tools** – set a sale from a discount percentage, schedule start/end dates, remove sales in bulk.
- **More filters** – product type, on sale, price range, SKU, products without price, 25–200 rows per page.
- **Stock, SKU, cost price and quantity tiers** editable in the same table, with live profit margin and a minimum-margin warning.
- **CSV export / import** with a preview before anything is saved.
- **Pricing rules and WP-Cron schedules** – run a rule at a chosen time and optionally undo it automatically later.
- **Currency / gold rate pricing** – base price x rate x markup, manual or from a JSON endpoint you choose.
- **Quantity (wholesale) pricing** applied in the cart.
- **Bale / Telegram summaries** of price operations (optional).
- **Page cache purge** after changes (WP Rocket, LiteSpeed, W3 Total Cache, WP Super Cache, WP Fastest Cache, SG Optimizer, Cache Enabler).
- **REST API** (`/wp-json/qpe/v1/`) and **WP-CLI** (`wp qpe adjust|history|undo`).

**Perfect for:**
- Store owners who need to apply seasonal discounts or price increases.
- Developers who want a reliable tool for bulk price updates.
- Anyone who needs to quickly correct pricing after a tax or exchange rate change.

**Key Features:**

✅ **Safe editing** – no automatic saving; you always confirm changes.
✅ **Live preview** – see the effect of any adjustment before saving.
✅ **Bulk percentage adjustments** – increase or decrease by any percentage (0.01 – 1000%).
✅ **Apply to regular, sale, or both prices** – choose exactly what to adjust.
✅ **Rounding settings** – choose rounding method (ceil/round/floor) and precision (1, 10, 100, 1000).
✅ **Filter products** – by category, tag, and stock status.
✅ **Works with simple and variable products** – supports all product types.
✅ **Lightweight & fast** – optimised for performance.
✅ **Fully compatible with WooCommerce HPOS** (High-Performance Order Storage).

**Why we built this plugin**

Managing prices in a WooCommerce store can be tedious and error‑prone. We created Quick Price Editor to give store owners a professional, intuitive tool that eliminates guesswork and reduces the risk of mistakes. Whether you're running a small shop or a large online store, this plugin helps you stay in control of your pricing strategy.

**Get the most out of your WooCommerce store**

With Quick Price Editor, you can quickly adapt to market changes, run promotions, or correct pricing errors – all from a single, clean interface. It's the ideal companion for any WooCommerce store that needs flexible, on‑the‑fly price management.

**Support and feedback**

We're committed to making this plugin better with each update. If you have ideas, questions, or run into any issues, please contact us at c.hadi.shiri@gmail.com.

**Other plugins by [Hadi Shiri](https://profiles.wordpress.org/hshhiri/)**

* [MasterAI Content Manager for WooCommerce](https://wordpress.org/plugins/masterai-content-manager/) – Generate WooCommerce product content using AI with support for multiple providers (Groq, Google Gemini, OpenAI, DeepSeek, and more).[reference:0]
* [Premium Order Manager for WooCommerce](https://wordpress.org/plugins/premium-order-manager-for-woocommerce/) – View customer & order stats, send bulk SMS/email campaigns, import/export customer lists, convert guests to registered users, and manage user role capabilities.[reference:1]
* [Tinava Product Images for WooCommerce](https://wordpress.org/plugins/tinava-product-images-for-woocommerce/) – Standardize your store’s product photos in bulk, with preview, backup, and full undo history.[reference:2]

Check out all our plugins on [our WordPress.org profile](https://profiles.wordpress.org/hshhiri/).

== Installation ==

1. Go to **Plugins → Add New** in your WordPress admin.
2. Search for **"Quick Price Editor for WooCommerce"**.
3. Click **Install Now** and then **Activate**.
4. Ensure WooCommerce is installed and active.
5. Navigate to **WooMaster → Quick Price Editor** to start editing prices.

Alternatively, upload the plugin ZIP file manually via **Plugins → Add New → Upload Plugin**.

== Frequently Asked Questions ==

= Does this plugin work with variable products? =

Yes, it fully supports variable products and displays each variation as a separate row. You can also use the "Use same prices for all variations" option to quickly apply the same price across all variations of a product.[reference:3]

= Will changes be applied immediately? =

No. All changes are saved only after you click the **Save selected rows** button. You can also use the **Preview** button to see the new prices before committing.[reference:4]

= Can I undo a change? =

The plugin does not include an undo feature, but you can always manually revert the prices using the editor again. Always double‑check the preview before saving.

= Does it support rounding? =

Yes. You can round prices using three methods (ceil, round, floor) and choose a precision of 1, 10, 100, or 1000. Settings are available under the "Rounding settings" section on the plugin page.[reference:5]

= Can I filter products by stock status? =

Yes, you can filter by In Stock or Out of Stock, as well as by category and tags.[reference:6]

= Is this plugin compatible with the latest WordPress and WooCommerce versions? =

Yes, we regularly test with the latest versions. It also declares compatibility with WooCommerce HPOS (custom order tables).[reference:7]

= Will this plugin slow down my site? =

No. The plugin is lightweight and only loads its assets on its own admin page. It does not affect your frontend performance.

== Screenshots ==

1. Main plugin interface with filters and product list.
2. Bulk adjustment controls and rounding settings panel.
3. Preview of price changes before saving.

== Changelog ==

= 3.1.1 =
* Maintenance release: version bump so all sites receive the update notice for the 3.1 feature release (undo history, CSV import/export, pricing rules, schedules and more).

= 3.1.0 =
* New: undo history, fixed-amount and exact-price changes, price endings, thousands separators.
* New: sale percentage / schedule / removal, extra filters, stock + SKU + cost + base price + quantity tiers editing, margin warning.
* New: CSV export/import with preview, pricing rules, WP-Cron schedules with automatic revert, currency rate pricing.
* New: quantity (wholesale) pricing in the cart, Bale/Telegram summaries, cache purge, REST API, WP-CLI, unit tests.
* New: grouped and external products, "All variations" summary row, optional columns.
* Fix: floating point noise could round 1100.0000000000002 up to 1101.
* The editor now falls back to the WooCommerce menu when the Woomas dashboard menu is not present.

= 3.0.1 =
* Fix: save/bulk-apply no longer reports success when rows failed; the real result (updated / unchanged / failed) is shown and failed rows are highlighted.
* Fix: rows beyond the first 100 were silently ignored; requests are now sent in small batches.
* Fix: Persian/Arabic digits and thousands separators in price fields are converted instead of being discarded.
* Fix: invalid price input no longer clears the stored price.
* Saved values are verified against the database after each save.
* Manually edited rows are now selected automatically.

= 3.0.0 =
Release date: July 14, 2026
* Major update: complete code refactor for better performance and security.
* Added live preview for individual rows and bulk adjustments.
* New rounding options (ceil, round, floor) with precision choices.
* Introduced nonce and capability checks for secure AJAX operations.
* Improved interface with sticky save button and select‑all functionality.
* Better support for variable products with "sync prices" toggle.
* Full compatibility with WooCommerce HPOS.
* Translations ready (but now handled automatically by WordPress).

= 2.0.0 =
Release date: March 2025
* Initial public release.
* Basic price editing with filters and bulk adjustments.
* Support for simple products only.

== Upgrade Notice ==

= 3.0.0 =
This is a major upgrade with new features and security improvements. Please back up your database before updating. The plugin now requires PHP 7.4+ and WordPress 5.6+.

== External services ==

This plugin only contacts external services when you configure them in Settings:

* **Bale Bot API** (https://tapi.bale.ai) – if you enable Bale notifications, a short text summary of a price operation (site name, product names, old and new regular price) is sent to the chat ID you entered, using your bot token.
* **Telegram Bot API** (https://api.telegram.org, or the HTTPS address you enter) – same data, if you enable Telegram notifications.
* **A rate JSON URL of your choice** – if you enter one, the plugin requests it (no data about your site is sent) to read a currency or gold rate.

No data is sent anywhere by default.

== Uninstall ==

Removing the plugin deletes its settings, rules, schedules and history table. Product meta (cost price, base price, quantity tiers) is kept.