=== MIPL Name Your Price for Woocommerce ===
Contributors: mulika
Tags: woocommerce, name your price, custom price, product price, donation
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
Requires Plugins: woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html


Allow customers to enter or select their own price for WooCommerce simple products.


== Description ==

MIPL Name Your Price for WooCommerce lets store owners allow customers to choose a custom price before adding a product to the cart.

The plugin supports global Name Your Price settings, product-level settings, and product category settings. You can define minimum price, maximum price, price step, price input type, and default value behavior.

Main features:

* Add a Name Your Price tab to WooCommerce simple products.
* Enable, disable, or use default Name Your Price settings per product.
* Configure global settings from WooCommerce settings.
* Configure category-level price rules for product categories.
* Show either a number input field or a price dropdown on the product page.
* Validate the customer-entered price before adding to cart.
* Apply the custom price in cart and checkout.
* Save the selected custom price in order item meta.
* Add a Settings link on the WordPress Plugins page.

== Requirements ==

* WordPress 5.8 or higher.
* WooCommerce installed and active.
* PHP 7.4 or higher.


== Installation ==

1. Upload the `mipl-name-your-price` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the WordPress Plugins screen.
3. Make sure WooCommerce is installed and active.
4. Go to WooCommerce > Settings > Name Your Price to configure global settings.
5. Edit a simple product and open the Name Your Price product data tab to configure product-level settings.


== Configuration ==

= Global Settings =

Go to WooCommerce > Settings > Name Your Price.

Available global options:

* Default Value: product price, minimum value, maximum value, or empty value.
* Type: input field or select dropdown.
* Minimum Price.
* Step.
* Maximum Price.
* Dropdown values generated from minimum, maximum, and step settings.

= Product Settings =

Edit a simple WooCommerce product and open the Name Your Price tab.

Available product options:

* Default(Settings): use global or category settings.
* Enable: use product-specific Name Your Price settings.
* Disable: disable Name Your Price for this product.
* Price Type: input field or select dropdown.
* Minimum Price.
* Step.
* Maximum Price.

= Category Settings =

Open Products > Categories and add or edit a product category.

Available category options:

* Enable Name Your Price for the category.
* Suggested Price.
* Minimum Price.
* Step.
* Maximum Price.


== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. WooCommerce is required because this plugin works with WooCommerce products, cart, checkout, and settings.

= Which product types are supported? =

The plugin is designed for simple products.

= Can customers enter any price? =

Customers can enter or select a price based on the configured minimum price, maximum price, and step values.

= Where is the custom price saved? =

The custom price is applied to the cart item and saved in the WooCommerce order item meta.


== Screenshots ==

1. Name Your Price global settings in WooCommerce settings.
2. Name Your Price product tab for simple products.
3. Name Your Price category settings.
4. Custom price field on the frontend product page.


== Changelog ==

= 1.0.0 =
* Initial release.
* Added global, product, and category Name Your Price settings.
* Added frontend custom price input and select dropdown support.
* Added cart, checkout, and order item custom price handling.


== Upgrade Notice ==

= 1.0.0 =
Initial release.
