Jigoshop Order Limits

Installation

The main zip that you download contain two folders, Plugin and Documentation.

The Plugin folder contains an unzipped version of the plugin (jigoshop-order-limits folder) and a zipped version (jigoshop-order-limits.zip). The Documentation folder contains this documentation.

There are two ways to install the plugin: through the Wordpress admin panel or upload using FTP.

Remember...

Jigoshop must be installed before you install the Jigoshop Order Limits Plugin

Note...

The Jigoshop Order Limits Plugin requires Jigoshop 1.5 or greater to function correctly. If you are using an older version, please consider upgrading.

1. Install using Wordpress Admin Panel

To install the plugin, log into your WordPress admin panel and navigate to: Plugins > Add New.

There will be a sub-menu across the top of the page, click upload

Browse to the plugin folder and select the jigoshop-order-limits.zip file. Click install now.

After a few seconds, Wordpress should notify you that the plugin was installed successfully and give you the option of activating the plugin.

Clicking Activate Plugin wil activate the plugin immediatley. Alternativley, you can activate the plugin from the Plugins page.

2. Install using FTP

If you have no idea what FTP is or how to log into your hosting using FTP then do not attempt this. Instead install the plugin using the Wordpress Admin Panel as explain above.

Watch out!!!...

Be careful of permissions and file ownership when uploading through FTP. The plugin implements an autmatic update feature which may fail if the file permissions/owernership are not correct resulting in Wordpress being unable to make changes to the files. Uploading the plugin though the Wordpress dashboard (as outlined in the previous section) will ensure all permissions/ownership are correct.

Login into your hosting using your chosen FTP client and browse to your wordpress installation and go to your plugins folder (usually wp-content/plugins). Upload the whole of the jigoshop-order-limits folder from within the Plugin folder that you downloaded.

Once uploaded, login to your wordpres admin and go to Plugins > Installed Plugins and activate the plugin.


Note...

If you try to activate the plugin when Jigoshop is inactive or deactivate Jigoshop, the plugin will automatically deactivate itself.

Overview

The Jigoshop Order Limits plugin is designed to allow you to put limits on the amount of products a user can purchase.

Limits can be set on either the minimum quantity of the products - ensuring atleast a certain amount is purchased everytime, or on the maximum quantity of the product so onl a certain amount can be purchased.

Minimum and maximum limits can also be set on the total value of the cart.

The plugin is fully customisable allowing you to create each individual error/notification message the user sees aswell as giving you options to make reaching the limits set easier for the user.

Setup

Once installed, the plugin will add a few extra options to various parts of Jigoshop. The global settings for the plguin can be seen within the Jigoshop settings page.

The plugin will add all of its global settings under the Products & Inventory tab.

Product Purchase Limits Settings

The product purchase limits section holds settings that allow you to enable product purchase limits as well as set what the global minimum and maximum purchase limits will be.

As well as showing product purchase limit errors on the cart page, the plugin will also give a notification to the user every time they add a product to the cart that is not with the purchase limits for that product.

Enable product purchase limits

Enable product purchase limits by ticking this options. If enabled, this will also give you the option of setting individual limits for each product on the product edit page (see below).

Global setting

The global setting is used to determine which limit will be used for each product. If set to 'Use global limit for all products' then the limit set in 'Global purchase limit' will be used for all products. However this can still be override from wihin the product edit page. If set to 'Use limit defined in each individual product' then it will use the limits set in each products edit page.

Note...

You can still override the global limits in the product edit page.

Global purchase limit

The global limit will be used for all products if the 'Global setting' is set to 'Use global limit for all products' unless it is overriden for each individial product. Use the sliders to set the minimum and maximum limits. Sliding the sliders all the way to the left or to the right will remove the limit completely.

Individual Product Limits

Each product has its own limit range that can be set. If the Global limit is set to 'Use limit defined in each individual product' then this limit will be used instead of the Global purchase limit. However, even if the global limit is set to 'Use global limit for all products' it can still be overriden for each individual product by ticking the 'Override' checkbox on the product edit page. Ticking this will use the individual limit set rather than the global limit.

Cart Value Limits Settings

The cart value limits section holds settings that allow you to set limits on the value of the cart. you can set what the limit range the cart needs to be in before the user is allowed to checkout and which cart total that limit applies to (i.e. subtotal with tax, subtotal without tax or total cart value)

Cart value limits error will be shown directly on the cart page.

Enable cart value limits

Enable cart value limits set in 'Cart value limit'. The limit will be applied to the cart value selected in 'Cart value to apply limit to'.

Cart value to apply limit to

Select which cart value to want to apply the limit to: subtotal without tax, subtotal with tax or total cart value which includes tax and delivery charges.

Cart value limit

The limit range the cart value needs to be within. As with the product purchase limit, use the sliders to set the minimum and maximum limits. Sliding the sliders all the wa to the left will remove the limit.

Tip...

Having trouble selecting the exact value you want? You can use the arrow keys on the keyboard to move the sliders and they will move by an increment of 1 only.

Product Purchase Limit Errors/Notifications

If product purchase limits is enabled, the default notifications shown when adding a product to the cart will be replaced with the notifications set in the Adding to cart messages sections on the settings page.

When writing your notifications, you will have the options of adding tags that will input useful information into the notification making them more user friendly and understandable.

Show 'Add remaining amount' button

When a product is added to the cart but it hasn't reached the minimum purchase limit that has been set then the user will be notified with the notification set in 'Minimum product quantity not reached message'. Enabling this option will add a button at the end of the message which will allow the user to add the correct quantity needed to reach the minimum limit in a single click. The text of the button can be set in the setting 'Add remaing amount button text'.

Add remaining amount button text

The text of the 'Add remaing amount' button. The tags available to use are: [product_name], [min_limit] and [needed_qty]. An explanation of each tag is shown below.

Minimum product quantity limit not reached message

The notification to show when a product is added to the cart but the minimum purchase limit has not been reached yet. The message can be shown with or without the 'Add remaining amount' button. The tags available to use are: [product_name], [min_limit] and [needed_qty]. An explanation of each tag is shown below.

Maximum product quantity limit reached message

The error to show when the user tries to add a product to the cart but has already reached the maximum purchase limit for this product. The tags available to use are: [product_name] and [max_limit]. An explanation of each tag is shown below.

Note...

The notification that are output use Jigoshops default styling. If your theme changes these styles then your themes styling will be used instead.

The Tags


[product_name] - the name of the product being added to the cart.

[min_limit] - the minimum purchase limit of the product being added to the cart.

[max_limit] - the maximum purchase limit of the product being added to the cart.

[needed_qty] - the quantity needed to reached the product minimum puchase limit.

Cart Page Errors/Notifications

If product purchase limits or cart value limits are enabled, all of the errors will be shown on the cart page as a list at the top of the page. The error message iteslf as well as the list of errors can be set with the settings in this section.

Show icon next to each product name

Any product that is not within the product purchase limits set will show an exclamation icon next to the product name as well as showing what the error is in the error list at the top of the page. You can disble this to not show the icon.

Error Message Display

This allows you to add extra text before and after the error list is output. The tag [error_list] will be replaced by the error list with the settings below being used for each error.

Products minimum quantity limit not reached error message

The error message to show if the product has not reached is minimum purchase limit. Available tags: [product_name], [min_limit] and [needed_qty]. An explanation of the tags is given below.

Products maximum quantity limit reached error message

The error message to show if the product has exceeded is maximum purchase limit. Available tags: [product_name] and [max_limit]. An explanation of the tags is given below.

Carts minimum limit not reached error message

The error message to show if the cart value has not reached the minimum cart value limit set. Available tags: [min_limit]. An explanation of the tags is given below.

Carts maximum limit reached error message

The error message to show if the cart value has exceeded the maximum cart value limit set Available tags: [max_limit]. An explanation of the tags is given below.

Checking out...

If there are error in the cart the user will no be able to checkout. Everytime the try to go to the checkout page the plugin will detect that there are errors in the cart and will redirect the user back to the cart page.

The Tags


[product_name] - the name of the product being added to the cart.

[min_limit] - (product limit message) the minimum purchase limit of the product being added to the cart.

[max_limit] - (product limit message) the maximum purchase limit of the product being added to the cart.

[needed_qty] - the quantity needed to reached the product minimum puchase limit.

[min_limit] - (cart value message) the minimum cart value limit set.

[max_limit] - (cart value message) the maximum cart value limit set.

Note...

When outputting the carts minimum/maximum values. The plugin will output the value using the same currency and format that you have set in you Jigoshop settings.

Cart Widget Message

The plugin gives you the option of adding a message to the cart if there is something wrong with either the products quantity or the carts value as per the limits sets.

The setting allows you to add HTML to the message to help with styling it to match your cart widget. There are no tags to input in the message as it is only there to serve as a quick notice to the user.