Plugin Description

Maximum Purchase for WP E-Commerce (free) allows you to set up maximum purchase rules for products in your WP E-commerce 3.8+ store. Purchases must meet these rules to proceed to checkout payment.

In the free plugin, rules search by Role/Membership or 'Not logged in' status.     (see the Pro Plugin for all search options).

Error Message in Table Format

If a purchase in your store fails a maximum 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.

Lifetime Purchase Limit by Customer

Lifetime purchase limit is a maximum purchase rule option, which allows you use all rule criteria to set cumulative lifetime limits on purchases by customer. Purchasers are identified by optional criteria, including IP addess, email address, billto name, billto address, shipto name, shipto address. This powerful option is available in   Maximum Purchase Pro.

• 1.03 - 2012-12-18 * Lifetime purchase limit option support changes added. Fix to 'nuke' function on options page => repairs the situation where the nuke rules button is hit, and the options record goes away.
• 1.02 - 2012-10-24 * Upgrade reporting wording, * upgrade currency symbol list, * moved activation hook to is-admin
• 1.01 - 2012-10-08 * Fix to Table Format Error Reporting in 'Each' and 'Any' mode
• 1.0 - 2012-09-12 * Initial Public Release

Documentation

Maximum purchase rules are applied at checkout time. They are a tested against the cart contents, and if the purchase fails a rule, an error message is produced. And even if the 'continue to payment button' is selected, checkout won't proceed until the error is resolved.

Plugin Requirements

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

Plugin Options

Optons Page 1

If a purchase in your store fails a maximum 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.

Show Error Messages in Table Format

Error message formatting is offered in text style by default (value="no"), and in table format as an option.

Show Error Messages Just Before Checkout Products List

The error message can be show in two places - just before the checkout products list, and just before the checkeout address area. This option sets the error message to display before the products list.

Show Error Messages Just Before Checkout Products List - HTML Selector

For the Product area error message, this option supplies the ID or Class HTML selector this message appears before. This selector would appear in your theme"s checkout area, just above the products display area. Be sure to include the "." or "#" selector identifier before the selector name.
Default value = ".checkout_cart".

Show Error Messages Just Before Checkout Address List

The error message can be show in two places - just before the checkout products list, and just before the checkeout address area. This is the 2nd second option showing the error message, and becomes particularly useful if your theme's checkout is a multi-pane design.

Show Error Messages Just Before Checkout Address List - HTML Selector

For the Address area error message, this option supplies the ID or Class HTML selector this message appears before. This selector would appear in your theme"s checkout area, just above the products display area. Be sure to include the "." or "#" selector identifier before the selector name.
Default value = ".wpsc_checkout_forms".

Show Rule ID in Error Message

There is an option to show the rule id in the error message. This is useful in testing to track error messages back to their originating rule.

Show Product Category Names in Maximum Purchase Error Message (Pro Only)

This (Pro Only) option allows the display of Product Category names in the error message, if error message criteria is included. This more full explanation of the rule criteria will help the customer resolve any errors.

Show Rule Category Names in Maximum Purchase Error Message (Pro Only)

This (Pro Only) option allows the display of Maximum Purchase Rule Category names in the error message, if error message criteria is included. This more full explanation of the rule criteria will help the customer resolve any errors.

Custom Maximum Purchase Error Message CSS, used at checkout time

There's an option to customize the css of the error message format chosen. Simply place the css in the option field, and it will override the standard css.

Options Page 2

Select a Currency Sign

Error message currency sign can be selected from the options available.

Apply More Than 1 Rule to Each Product

Do we apply multiple maximum purchase rules to EACH product in the cart? If not, we apply the FIRST rule we process which applies to a given product. It is ***Strongly Suggested*** that this option be set to "NO", as otherwise the compounding error messages could be quite confusing for the ecommerce customer.

Test Debugging Mode Turned On

The final option turns on the debugging mode. This mode will print to screen all of the structures used in rule testing and error message creation. Only use during testing.

Options Page 3

The killer buttons at the bottom of the options screen

Use these buttons wisely. Great to clear out test rules or repair errant structures. Very powerful, handle with care.