Click here to go home

WP Buy A Get B Documentation

WP Buy A Get B is a Fulfillment Module that allows you to offer a selected product free when a customer makes a qualifying purchase.

This module can optionally add one of the selected free item to the customer's checkout for each multiple of the minimum quantity purchased. For instance, buy 2, get item B for free - would add one of product B for every 2 qualifying items the customer adds to the basket. Buy 4, customer would get 2 of item B for free, etc.

Qualifying events:
  • Category:
    Customer purchases required number of product(s) from a given category or categories.
  • Product:
    Customer purchases required number of qualifying product(s), regardless of category.
  • Subtotal:
    Customer's basket subtotal meets or exceeds threshold set by administrator.

Installing WP Buy A Get B

  1. Unzip the .zip file downloaded from Mivacentral.com.
  2. Login to your store admin.
  3. Expand the tab next to Modules.
  4. Click on Add Module.
  5. Click on the upload button
  6. Browse to the file wpbuyagetb.mvc and select it. Click on Open, then update.
  7. The module is now installed.

Activating & Licensing

  1. Navigate to Stores -> Your Storename -> Order Fulfillment Configuration.
  2. In the right hand pane, check the box next to WP Buy A Get B, then click update.
  3. WP Buy A Get B will appear as a tab on the right page.
  4. Click on the WP Buy A Get B link.
  5. Enter your license key as indicated in the email from mivacentral.com and click update.
The module is now ready for configuration.

Using Buy A Get B

Choose the product you wish to offer as the free product from the list of products. The selected product code will appear in the Free Product box below.



You may enter a short description of the free item or leave the default text to display.

You may only select one product to offer for free.

Select which method to offer free product by. Category, Product, or Subtotal and click the Update button
This will re-draw the screen with the proper configuration options based on the method you selected.



By Category Method:

Select which category or categories for qualifying purchase. The selected category or categories will appear in the Select Qualifying Categories box. If you make a mistake, click on the clear button. Click on Update to save your selection(s). You MUST click on update for the lower half of the admin screen to refresh with the correct options for selecting product exceptions.



If you wish to exclude specific products in your selected category(ies), you may select each product you do NOT wish to qualify towards the free item from the Product Exceptions box.



Select the number of purchased qualifying product(s) to get the free product you assigned above.



Check the box if you would like to offer 1 free item for each multiple of the minimum quantity purchased.



Click on Update.

The module is now configured and ready to offer the free product.

By Product Method:

Select which product(s) for qualifying purchase. The selected product(s) will appear in the Select Qualifying Products box. If you make a mistake, click on the clear button.



Select the number of purchased qualifying product(s) to get the free product you assigned above.



Check the box if you would like to offer 1 free item for each multiple of the minimum quantity purchased.



Click on Update.

The module is now configured and ready to offer the free product.

By Basket Subtotal Method:

Select which product(s) for qualifying purchase. The selected product(s) will appear in the Selected Products box. If you make a mistake, click on the clear button.



Enter the dollar amount required to get the free product you assigned above.



Click on Update.

The module is now configured and ready to offer the free product.

Known limitations/bugs
  • Only one free product may be offered.
  • Free products weight is not included in shipping costs.
  • Should a customer change their basket contents after visiting the OINF (Customer information) screen, free product listed in basket may not be accurate until they continue forward from OINF.

To report any other bugs or request features, please open a ticket with our helpdesk: http://www.wpcomp.com/support and select WP Buy A Get B as the category for the ticket.

©2006-2007 WolfPaw Computers