=== WooCommerce Name Your Price ===

Contributors: Kathy Darling    
Requires at least: 3.8    
Tested up to: 4.6.1    
Stable tag: 2.4.2
License: GPLv3    
License URI: http://www.gnu.org/licenses/gpl-3.0.html    
WC requires at least: 2.1.0    
WC tested up to: 2.6.4    

Allow customers to set their own prices for WooCommerce products

== Upgrade Notice ==
WooCommerce 2.0 is no longer supported. Do not upgrade unless you are using at least WooCommerce 2.1.

== Description ==

The WooCommerce Name Your Price extension lets you be flexible in what price you are willing to accept for selected products. You can use this extension to accept user-determined donations, gather pricing data or to take a new approach to selling products!  You can *suggest* a price to your customers and optionally enforce a minimum acceptable price, but otherwise this extension allows the customer to enter the price he's willing to pay.

[https://raw.githubusercontent.com/woothemes/woocommerce-name-your-price/master/screenshots/screenshot1.png]

== Installation ==

To install Name Your Price:

1. Download the extension from your WooThemes account

2. In your WordPress admin, go to Plugins > Add New and then click on the "Upload" tab

3. Click the "Choose File" button, select the zip file you just downloaded to your computer and then click "Install Now"

4. After installation has completed you can activate the plugin right away or you can activate the 'WooCommerce Name Your Price' extension through the 'Plugins' menu in WordPress at any time

== Upgrading to Name Your Price 2.0 ==

Please be advised that Name Your Price 2.0 is a very major update and if you were previously using Name Your Price 1.x you might want to consider testing your theme in a developmental environment first. This is a must if you were using the $wc_name_your_price variable or overriding old templates.  

Name Your Price will continue to work with WooCommerce 2.0.20, but WooCommerce 2.1 is preferred. Support for variable products and variable subscriptions will not function until WooCommerce is upgraded to version 2.1. WooCommerce 2.1 also better handles entering prices with localized decimal points. 

== Plugin Settings ==

Name Your Price has several strings that can be modified from the plugin's settings. Go to WooCommerce->Settings and and click on the Name Your Price tab. From here you can modify the add to cart button texts, the minimum, "From:" and suggested text strings. 

[https://raw.githubusercontent.com/woothemes/woocommerce-name-your-price/master/screenshots/screenshot3.png]

== How to Use ==

= How to Use With Simple Products = 

[https://raw.githubusercontent.com/woothemes/woocommerce-name-your-price/master/screenshots/screenshot2.png]

To enable flexible, user-determined pricing on any simple product:

1. Edit a product and look for the 'Name Your Price' checkbox in the Product Data metabox. Simple, subscription and bundle products will support customers naming their own price. 

2. Tick the checkbox to allow users to set their own price for this product.  The suggested and minimum price fields will not be visible until this is checked.  Note that this might not function properly if you have javascript disabled. 

3. Fill in the suggested and minimum prices as desired. The minimum price prevents products from being sold for less than you are willing to accept. 

4. Save the product.  When viewing the product on the front-end, the suggested and minimum prices will be displayed in place of the regular price and a text input will appear above the Add to Cart Button where the customer can enter what she is willing to pay.  

= A Few Notes =

*Important* - When entering prices, do NOT enter thousands separators! As of WooCommerce 2.1 you will be able to enter prices with the decimal point of your region, as long as it is the same one as you have specified in the settings.

6. To *not* display a suggested price, you can simply leave the suggested field blank. Similarly, to not enforce a minimum, simply leave the minimum field blank. 

= How to Use With Subscripton Products = 

Subscription products work similarly to simple products. If you check the Name Your Price box, the subscription price box will be disabled in favor the suggested and minimum price inputs. The subscription billing period inputs remain unchanged. 

[https://raw.githubusercontent.com/woothemes/woocommerce-name-your-price/master/screenshots/screenshot4.png]

As of Name Your Price 2.0, you can now also offer a variable billing period, which allows the customer to decide if she'd like to pay per month or per day, etc. To enable this, you need to check the "Variable Billing Period" checkbox. With this checked, if you enter suggested or minimum prices, you must select a corresponding suggested or minimum billing period. 

[https://raw.githubusercontent.com/woothemes/woocommerce-name-your-price/master/screenshots/screenshot5.png]

= How to Use With Variable Products = 

As of Name Your Price 2.0, you can now have name your price variations on variable or variable Subscriptions products. Within each variation look for a "Name Your Price" checkbox and follow the same rules as simple products for suggested and minimum prices for each variation.

[https://raw.githubusercontent.com/woothemes/woocommerce-name-your-price/master/screenshots/screenshot6.png]

On the front-end when a Name Your Price variation is selected, the Name Your Price price input will appear. 

[https://raw.githubusercontent.com/woothemes/woocommerce-name-your-price/master/screenshots/screenshot7.png]

== FAQ ==

= How do I update my code from Name Your Price 1.+ to Name Your Price 2.0 =

If you were accessing the global variable `$wc_name_your_price` that still exists, but is being deprecated. You can access the class instance in the following manner:

```
if( function_exists( 'WC_Name_Your_Price' ) ){
	$wc_nyp = WC_Name_Your_Price();
}
```

The functions that are primarily concerned with this coding change (those involving the price input and minimum price) are now in the `WC_Name_Your_Price_Display` class, which can be accessed through the main class like so:

```
WC_Name_Your_Price()->display
``` 

= How do I change the markup? =

Similar to WooCommerce, the Name Your Price extension uses a small template part to generate the markup for the price input. For example, you can use your own price input template by placing a price-input.php file inside the /woocommerce/single-product folder of your theme. However, much of what makes the Name Your Price component function is wrapped up in helper functions in that template, so only edit this if you really know what you are doing.

= How can I move the markup? = 

The suggested price & minimum price are displayed in place of the regular price, which is attached to the WooCommerce 'woocommerce_single_product_summary' action hook, while the text input is attached to the 'woocommerce_before_add_to_cart_button' hook. Following typical WordPress behavior for hooks, to change the location of any of these templates you must remove them from their default hook and add them to a new hook.  For example, to relocate the price input place the following in your theme's functions.php and be sure to adjust 'the_hook_you_want_to_add_to' with a real hook name.

Please note that as of **Name Your Price 2.0** how you access the Name Your Price functions has changed. If you were moving the markup you will need to update your code. 

**Name Your Price 2.0**

```
function nyp_move_price_input(){
	if( function_exists( 'WC_Name_Your_Price' ) ){
		$wc_name_your_price_display = WC_Name_Your_Price()->display;
		remove_action( 'woocommerce_before_add_to_cart_button', array( $wc_name_your_price_display, 'display_price_input') );
		add_action( 'the_hook_you_want_to_add_to', array( $wc_name_your_price_display, 'display_price_input' ) );
	}
}
add_action( 'woocommerce_before_single_product' , 'nyp_move_price_input' );
```

**Name Your Price 1.+**

```
function nyp_move_price_input(){ 
	global $wc_name_your_price;

	remove_action( 'woocommerce_before_add_to_cart_button', array( $wc_name_your_price, 'display_price_input') );
	add_action( 'woocommerce_after_main_content', array( $wc_name_your_price, 'display_price_input' ) );
}
add_action( 'woocommerce_before_single_product' , 'nyp_move_price_input' );
```

= How do I remove the stylesheet? =

The Name Your Price stylesheet is pretty minimal, only offering a tiny bit of styling for the minimum price and for the text input. You can disable it from the plugin's settings. Go to WooCommerce->Settings and click on the Name Your Price tab.