=== Minimum Purchase for WP E-Commerce ===
Contributors: varktech
Donate link: http://www.varktech.com/wp-e-commerce/minimum-purchase-for-wp-e-commerce/
Tags: e-commerce, WP e-Commerce, shop, store, admin, price, pricing, minimum, purchase, limits, checkout
Requires at least: 3.3
Tested up to: 3.4.4
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html

This plugin allows you to set up minimum purchase rules for products in your store.  Purchases must meet these rules to proceed to checkout payment.



== Description ==

The Minimum Purchase plugin for WP E-Commerce gives you the ability to set up minimum purchase rules for products in your WP E-commerce 3.8+ store.  Customer purchases must then meet these rules, to proceed to checkout payment.

If a purchase in your store fails a minimum purchase rule, an error message appears at the top of the checkout page, identifying the error situation and rule requirements.  The customer must resolve the error, before the purchase can be completed.   

[Tutorials](http://www.varktech.com/wp-e-commerce/minimum-purchase-for-wp-e-commerce/?active_tab=tutorial) | 
[Documentation](http://www.varktech.com/wp-e-commerce/minimum-purchase-for-wp-e-commerce/?active_tab=documentation) | 
[Videos](http://www.varktech.com/wp-e-commerce/minimum-purchase-for-wp-e-commerce/?active_tab=video) | 
[Shameless E-Commerce](http://www.varktech.com/wp-e-commerce/minimum-purchase-pro-for-wp-e-commerce/)



= How does the rule choose what to look at in the cart? [Search Criteria] =
Free Plugin

*   By Role/Membership

[Pro Plugin](http://www.varktech.com/wp-e-commerce/minimum-purchase-pro-for-wp-e-commerce/)

*   By cart contents
*   For a single product
*   For a single product's variations
*   By Product Category or Minimum Purchase Category, and/or By Role/Membership

*Role/Membership is used within Wordpress to control access and capabilities, when a role is given to a user.  Wordpress assigns certain roles by default such as Subscriber for new users or Administrator for the site's owner. Roles can also be used to associate a user with a pricing level.  Use a role management plugin like [User Role Editor](http://wordpress.org/extend/plugins/user-role-editor/) to establish custom roles, which you can give to a user or class of users.  Then you can associate that role with a Minimum Purchase Rule.  So when the user logs into your site, their Role interacts with the appropriate Rule.*

[youtube http://www.youtube.com/watch?v=_2fyD57c9Zc]

= How is the rule applied to the cart search results? [Rule applied to] =

*   All – work with the total of the units/prices
*   Each – apply the rule to each product in the Rule Population
*   Any – Same as each, but limits the rule testing to the first X number of products.



= Does the Rule apply to Units Quantity amount or Price amount? =

*   Units Quantity Amount
*   Price Amount


= Here’s a sample of a minimum purchase rule: =

*   If the purchaser is a Subscriber - [search criteria:Subscriber]
*   The minimum total for all purchases - [rule applied to:  all]
*   Must be greater than $20. - [price amount: $20]


= Checkout Error Messaging =
At checkout, the rules are tested against the cart contents.  If products are found in error, an error message (in two possible locations) will be displayed.  The error situation must be resolved, before the customer is allowed to leave the checkout and proceed to payment. 

Error messaging css can be customized using the custom css option on the Rule Options Settings screen.  There are also currency sign options, and a comprehensive debugging mode option.

There are two Minimum Purchase error message formats available:

1. Text-based descriptive format
1. Table-based format


= More Info =
[Tutorials](http://www.varktech.com/wp-e-commerce/minimum-purchase-for-wp-e-commerce/?active_tab=tutorial) | 
[Documentation](http://www.varktech.com/wp-e-commerce/minimum-purchase-for-wp-e-commerce/?active_tab=documentation) | 
[Videos](http://www.varktech.com/wp-e-commerce/minimum-purchase-for-wp-e-commerce/?active_tab=video) | 
[Shameless E-Commerce](http://www.varktech.com/wp-e-commerce/minimum-purchase-pro-for-wp-e-commerce/)
  


== Installation ==

= Minimum Requirements =

*   WP E-Commerce 3.8+
*   WordPress 3.3+
*   PHP 5+

= Install Instructions =

1. Upload the folder `vt-minimum-purchase-for-wp-e-commerce` to the `/wp-content/plugins/` directory of your site
1. Activate the plugin through the 'Plugins' menu in WordPress




== Frequently Asked Questions ==


Please review the following printed and video documentation.

[Tutorials](http://www.varktech.com/wp-e-commerce/minimum-purchase-for-wp-e-commerce/?active_tab=tutorial) | 
[Documentation](http://www.varktech.com/wp-e-commerce/minimum-purchase-for-wp-e-commerce/?active_tab=documentation) | 
[Videos](http://www.varktech.com/wp-e-commerce/minimum-purchase-for-wp-e-commerce/?active_tab=video) | 
[Shameless E-Commerce](http://www.varktech.com/wp-e-commerce/minimum-purchase-pro-for-wp-e-commerce/)

 Please post questions at the [Support](http://www.varktech.com/support/) page at varktech.com.


== Screenshots ==

1. Minimum Purchase Rule Screen
2. Group Search Criteria
3. Rule application method - Any
4. Rule application method - Each
5. Rule application method - All
6. Quantity or Price Minimum Amount




== Changelog ==

= 1.0 - 2012-09-12 =
* Initial Public Release



== Upgrade Notice ==

= 1.0 - 2012-09-12 =
* Initial Public Release