This plugin is not compatible with multiple shipping address plugins and it may not be compatible with other software that package or repackage cart items. Be sure to test compatibility carefully and fully.
In some rare cases a shipping rate calculator plugin might be designed to do its own packaging by directly reading the cart contents thereby completely bypassing the WooCommerce package processing subsystem. A shipping plugin of that type will render your packaging rules ineffective. If that happens consider switching to a different shipping rate plugin.
To access the settings navigate to WooCommerce -> Settings -> Shipping -> Shipping Packages Pro
Before you begin:
There are few basic settings that affect all packaging rules:
“Enable the packager rules” – this setting controls whether your shipping package rules are processed. You can Disable them entirely, enable them only for users logged in as an Administrator and Shop Manager, or enable them for everyone. When setting up your rules for the first time we recommend that you set it to Administrators and Shop Managers only. After configuring and testing your rules you can them enable for everyone.
Debug – This setting outputs debug information when the rules are processed. Only Administrators and Shop Managers see the debug information. This information can be helpful when determining how the rules are being processed. We recommend that you leave this setting off unless you’re having trouble getting your rules configured properly.
Override Cart Packaging – This setting is ON by default and you should leave it on unless you know for sure that you need to turn it off. When enabled the software will attempt to override any other software the repackages the cart contents, which is useful when you have shipping modules that attempt to creating their own packages to get shipping rates.
When the packager is enabled it can optionally override most other plugins that try to repackage the cart. This is the default mode of operation.
Each shipping package rule set is processed in the order listed. Keep in mind that as items are processed, if rules indicate the product should be in a package then it is not processed more than once, meaning once it is determined that the product goes into a package other rules will not move it into a different package nor remove it from a package.
The screenshot below shows two sets of example shipping package rules, one labeled Backordered and the other labeled Battery package.
When creating a new set of shipping package rules be sure to give it an informative title so that you know what it’s for. Your shoppers will not see this title, it’s for your own reference only.
NOTE: Each shipping package ruleset has a mode setting. When set to “admins and shop managers” then the package will only be processed for users with those roles. This allows you to test your package settings without affecting customers on your live site.
Each shipping package ruleset contains Package Triggers and Package Rules.
Package Triggers are used to examine the cart contents to determine if packaging should occur.
Package Rules determine which product(s) go into their own separate packages, and optionally, which shipping methods are allowed for the package.
Package Triggers can be any of the following:
Package Rules can be any of the following:
Each rule has a comparison: Equal to, not equal to, greater than or equal to, less than or equal to, equal to any, equal to all, not equal to any, not equal to all. Note that not all of those comparisons will be available for each rule type.
Each rule also should also have one or more values to compare against.
Package rules also allow you to limit which specific shipping rates are returned. To do that enter the rate names, ONE PER LINE. You can view rate names in your shipping rate plugin settings, or view then on your public cart or checkout page.
For example, to only allow UPS Ground enter “ups ground” without the quotes. All other rates will be removed and not made available to the shopper.
In another example, to only allow Fedex Ground and Fedex Ground Home Delivery enter “fedex ground*” without the quotes. Note the trailing asterisk that serves as a wildcard to match any shipping method that begins with “fedex ground”.
If you’re using Shipping Zones in your WooCommerce configuration you can also limit the shipping rates based on shipping zone by selecting one or more zones for your shipping rate rules. If you don’t use shipping zones then leave either the zone selection empty or select the default zone labeled “Locations not covered by your other zones.”
Below is a screenshot showing an example set of a ruleset. The set of rules works like this: “Check the cart contents, if the cart contains any products from the “Batteries” category then check to see if the product “Lithium batteries” product is in the cart, if it is then process those products in the cart into their own separate package. Then only allow UPS Ground as the available shipping methods for that package if the shopper’s shipping address is in the USA, if the address is not in the USA then only allow Fedex rates for the package.”
Another example is shown in the screenshot below. The set of rules works like this: “Check the cart, if any products in the cart have a stock status of out of stock or on backorder then process the products in the cart. Move any products that are out of stock or on backorder into their own separate package labeled Backordered items, and allow any available shipping methods.” Note that in this case all available shipping methods are allowed because there are no specific shipping methods defined.
Within any shipping package rule set you can define one or packages. Each package has its own set of rules and packages are processed in the order listed on the screen. You can drag and drop the packages to rearrange their order.
Be certain to set a “Package name” for the package. This name will be shown to your shoppers for the package if the associated rules take effect for their cart contents.
Optionally enter specific shipping method names for the package. If you leave this setting empty then any available rates will be displayed to the shopper.
Package rules can have 1 or more sets of rule groups.
Each group has rules that are visually grouped with a gray background color. If any group of rules contains more than one rule then those are considered to “AND” rules, meaning “if this matches and this matches” then this group of rules match so put the matching items into their own separate package.
See the example rule below, its logic reads like this: “If the cart contains the Album product AND the total cart quantity of all items in the cart is greater than 10 then this set of rules match.”
If you have more than one group of rules then the groups are considered “OR” groups. See the example rules below.
In the above example the rule reads like this: “If the cart contains the Album product AND the total cart quantity of all items in the cart is greater than 10 then this set of rules match, OR, if cart contains any products from the Tshirts category or Hoodies category AND the total cart weight is greater than or equal to 7 then this set of rules match.”
When creating a set of shipping package rules you can publish the rules, or leave then in Draft mode, or Pending Review mode.
IMPORTANT: Only shipping package rules that are Published are processed against the cart contents regardless of which user is shopping on the site. Therefore you must always publish the rules before you can test them.
NOTE that when you publish a set of rules you can also enable “Test mode.” When enabled for a ruleset then those rules are only processed when a shopper is logged in with a role of Administrator or Shop Manager. It’s especially helpful when you are adding a new set of packaging rules while having other packaging rules that are already enabled and live on your site. This allows you to build and test rule sets without affecting the existing shipping package rule processing for your shoppers.
When the package rules are processed matching products are put into their own packages. Any product not matching your rules go into their own package.
When separate packages are creating those packages are then given to your shipping rate calculator modules to be used to calculate rates for each package. At checkout the shopper will then select a shipping method for each separate package.
In the cart and checkout pages shoppers will see a list of packages with shipping options for each package.
In the example screenshot below you see the cart page, in the Cart Totals section you see 3 packages: One for batteries that only allows UPS Ground as the shipping method, one for backordered items that allows all available shipping methods, and one for the remainder of the cart contents that allows all available shipping methods.
If the parent bundled product matches a rule then all items in the bundle are moved to the same package.
If the parent composite product matches a rule then all items in the composite are moved to the same package.
Install the plugin and activate it on the site as with any other plugin.
Be sure to install the IgniteWoo Updater, you’ll see a message near the top of the Plugins page in your WP Admin area asking you to click to install it. When you click the link the updater will be downloaded and installed automatically. Then just activate the plugin.
Then navigate to Dashboard -> IgniteWoo Licenses and activate your license key.
Now you can proceed to adjust the settings for Ship to Multiple Address. Navigate to WooCommerce -> Settings -> Metal Discounts.
The settings are explained below:
Discounts table – enable this setting to display a discounts table on single product pages.
Discounts table placement – Select where to display the discounts table if enabled.
Payment gateway markups
This section is optional. If you want to offer different product prices depending on the payment gateway selected by the shopper at checkout then set your markup amounts here.
For gateway rule select the payment gateways that the rule applies to, define Markup 1, this must be set for a rule even if you only enter a 0 (zero). You can optionally set a second markup if necessary. Note that markup amounts can be a percentage or a flat amount. For example, 2.5%, or 4.
You must also enter a text label to show the user when the table is displayed when you’ve enabled the “Discounts table” setting.
Here’s a working example:
If your normal payment method for the lowest possible price is Check/Bank transfer, then choose the Check Payment and Bank Transfer payment gateways, set Markup 1 to 0, set Markup 2 to 0. Set the label to “Check/Wire”.
Let’s assume you next highest price is to pay via PayPal or Credit Card and in that case you want to increase product prices by 2.5% + 0.30. Choose the PayPal and Credit Card payment gateways, enter 2.5% for Markup 1 and enter 0.30 for Markup2. Set the label to “Card/PayPal”.
Create a gateway rule for each payment gateway used on your site at checkout.
Sitewide discounts
Discounts are based on quantity, so effective “sitewide discounts” are quantity discounts. Using this feature is optional.
Rules are grouped into sets. You can create as many sets of rules as you need, and as many discount ranges as you need within each set.
Rules are checked in the order defined on the screen. The first matching rule is applies. You can drag and drop the rulesets and rules to re-arrange them.
The configure your discounts choose who the rule applies to (everyone, specific users, or specific user roles). Chose which product categories the rule applies to. Then define the quantity discount ranges and amounts.
Set a minimum quantity, maximum quantity, a discount type, and the discount amount.
Here’s an example: Let’s assume you want to offer a discount of 2% if someone buys between 11 and 20 of any product in your gold product category. Set the minimum to 11, set the maximum to 20, set the discount type to Percentage Discount, set the amount to 2.
Notes:
Every rule must have a minimum and maximum value defined.
If you want to create a rule that has no maximum then use an asterisk (*) in the maximum field.
The plugin supports two ways to define discount rules: Globally, and per product that can be defined when editing a product.
If a product has discount rules defined then those rules are checked first and any matching rule is applied. If the product has no rules defined, or no defined rules match then the global discount rules are checked.
Install the plugin and activate it on the site as with any other plugin.
Be sure to install the IgniteWoo Updater, you’ll see a message near the top of the Plugins page in your WP Admin area asking you to click to install it. When you click the link the updater will be downloaded and installed automatically. Then just activate the plugin.
Then navigate to Dashboard -> IgniteWoo Licenses and activate your license key.
The plugin is completely automated, there are no settings to configure. When the plugin is activate along with our Shipping to Multiple Addresses plugin then orders will be split automatically when a new order comes if the shopper chose to ship items to multiple addresses.
Install the plugin and activate it on the site as with any other plugin.
Be sure to install the IgniteWoo Updater, you’ll see a message near the top of the Plugins page in your WP Admin area asking you to click to install it. When you click the link the updater will be downloaded and installed automatically. Then just activate the plugin.
Then navigate to Dashboard -> IgniteWoo Licenses and activate your license key.
Now you can proceed to adjust the settings for Ship to Multiple Address. Navigate to WooCommerce -> Settings -> Integration -> Ship to Multiple Addresses.
Enable the plugin by checking the Enable checkbox.
You can enable a setting to add shipping email and shipping phone number fields to checkout and user’s profiles. This is useful if you need to send tracking numbers to shopper or provide a phone number for shipping labels.
Disable type – This setting lets you disable giving the shopper the option to ship to multiple address under various conditions. You can disable only for matching products in the cart and in this case you choose which products to match against. This allows shoppers to choose multiple addresses for any other items in the cart. You can also opt to disable shipping to multiple addresses if any defined product is in the cart. Set the products to match against in the “Disable for Products” field, or the “Disable for Categories” field.
When a new order comes in and the shopper has chosen to ship to multiple addresses then when you view the order in the admin area you’ll see their chosen addresses and you can adjust the status for shipping to each address. Note that 3rd party shipping label tools such as Stamps.com, ShipStation, ShipWorks, Shippo, ShipperHQ, etc., probably won’t be able to detect the extra addresses in the order to generate labels. So you’ll need to copy/paste those addresses into your shipping label creator tools.
If you want to add extra functionality to allow 3rd party shipping label creator tools to automatically detect the correct shipping address and items to ship to the address then check into our Split Order with Multiple Address plugin.
Navigate to WooCommerce -> Settings -> Metals Discounts.
First decide whether you want to show a discount table and/or pricing table on your products page. If you do then enable the “Discounts table” setting. We recommend that you enable this setting.
Next, if you enabled the “Discounts table” setting then decide where to show it by selecting an option for “Display table placement”.
Now you can proceed to configure your quantity discount rules and/or payment gateway markup amounts.
You can configure the plugin to be used in 3 different ways:
In the main settings you can add gateway rules that markup the cost of all products in the cart based on the payment selected by the shopper.
Add a new rule then configure the following fields for the rule:
Add as many rules as you need.
Quantity discount rules work for simple and variable products.
You can define global quantity discounts rules that apply to products in specific products categories, or you can define quantity discount rules specific to a product by editing the product and adding the discount rules in the section Product Data -> Qty Discounts.
If you define rules in a product then those rules take precedence over any global rules you might have configured.
Each ruleset can be configured to apply to everyone, or specific users, or specific user roles.
Global rules require that you select product categories that the rule pertains to.
Each rule – global or product specific – required minimum quantity, maximum quantity, a discount type, and a discount amount.
Be sure to create your rules from highest to lowest. For example if you want to create discounts for quantities ranging from 10 to 20, and 21 to 50, enter the “10 to 20” rule first in the list.
If you want your rule to not have maximum quantity upper limit then enter an asterisk (*) or a very large number such as 999999.
For the discount type you can select percentage, flat discount, or fixed price. This affect what discount you enter:
If any of your products are “variable” with many different “variations” your discount rules apply to each individual variation: Each variation is treated as an individual product for purposes of checking the quantity to determine if a discount rule matches.
To use the plugin follow these steps:
By default the enquiry form appears in a tab in your product page. If your theme doesn’t use tabs or you want the form to appear elsewhere in the page you can use the shortcode inquiry_form
to show the form. You might use this shortcode in the product description somewhere.
To use the plugin follow these steps:
That’s all there is to it!
Note that if you use a shipping gateway where you’re getting rates only with weights and not dimensions then you do not need to set dimensions for your boxes.
You must have a PayPal business account to use Payouts, and Payouts is not enabled by default in your PayPal account. To use PayPal Payouts you must be approved by PayPal. After requesting access to Payouts they will review your account and your business before enabling Payouts in your account.
To begin the process of requesting access login to the PayPal Developer page and navigate to My Account. You’ll see a page similar to the image below. Scroll down to Payouts and in the Live column click Enable. You’ll be walked through a series of forms that you must fill in and submit.
After you have been granted access to Payouts follow the steps below:
You need to create an “app” in your PayPal settings. Open the PayPal Developer page in your browser. Sign in and navigate to My Apps & Credentials then scroll down the page to REST API apps. Click the blue Create App button.
You’ll the see the form below.
Enter a name for your app and select the user for the app in the dropdown box, the click the Create App button. When you do that a Client ID and Secret will be generated. You’ll need to copy those in the plugin settings.
In your WordPress admin area navigate to the Paypal Payouts menu item, there you’ll see the settings.
If you’re testing Payouts in sandbox mode then copy your sandbox Client ID and Secret into the related sandbox fields and choose Sandbox in the “Use Live or Sandbox“ setting. Otherwise copy your live Client ID and Secret into the related fields.
Next choose a Payout mode. Instant payouts happen almost instantly after an order is processed. Delayed payouts happen after the number of delay days you set. Manual payouts must be initiate manually by you.
In the Order Statuses setting select which order statuses will cause a payout to be created. We suggest that you select Completed and Processing since those two statuses mean that an order was paid for successfully.
After you’ve adjusted the settings and saved them check the Enabled checkbox when you’re ready to use the software on your site.
When you save the settings the software automatically creates a “webhook” in your app at PayPal. Be sure to check your PayPal app settings to ensure that you see a new webhook listed. To check that, find the app you created and click its name. Then scroll down the page to the Webhooks section. If you don’t see the Webhook created yet then double check your Client ID and Secret to ensure you have them entered correctly in the plugin’s settings and resave the settings. Resaving the settings causes the plugin to attempt to create the webhook for your app.
You can view any payouts that have been created on your site by navigating to the PayPal Payouts -> Payouts page. On that page you see a list of payouts.
In the Details column you can click the info button to see details about any particular payout.
If a payout hasn’t been processed into PayPal yet you can click the currency icon in the details column to initiate processing. Do this to manually initiate a payout.
If a payout status doesn’t show SUCCESS yet you can click the refresh icon to check the status at PayPal.
Once a payout has been sent it cannot be cancelled unless the recipient fails to claim it for 30 days. Ordinarily if a recipient has a PayPal account then their account automatically claims it as soon at the payout is processed by PayPal. If you need the funds back from whoever received a payout you must contact that person directly and ask them to return the funds.
With PayPal Payouts the sender of the payout pays the fees. See their documentation on fees.
The plugin is simple to use: Install on your site, activate the plugin on the Plugins page in WordPress, that’s it! With that done it works automatically.
The way it works is this: When a shopper lands on the My Account page of your site (or whatever you may call it, it’s the default account page automatically created when you install WooCommerce), the plugin tries to detect the referring page – the page they came from on your site. If the plugin can detect the referring page then it temporarily remembers that page URL and when the user logs in the plugin tells WordPress to automatically sends the shopper back to the page they came from.
First adjust tyhe plugin’s main settings, navigate to WooCommerce -> Settings -> Integration Email Notifications to view the settings, be sure to save the settings at least once.
Then navigate to WooCommerce -> Email Notifications.
In the settings you’ll find 3 tabs: General, Triggers, and Contact Info
General settings
Important: don’t enable the email notification until you’ve adjusted all the settings first!
Each setting on this tab has a help tip icon that you can hover your mouse over to see an explanation of the field.
Enter the email address (separated by a comma) that should receive this notification
Enter a recipient name
Choose what to include in the notification email message
Triggers tab
The triggers control when this email will be sent.
Note that you must choose one or more “Conditions”, which correlate to order statuses. The “Conditions” (order status) must match before this notification will be sent for the order.
You can also define other optional triggers based on product categories, specific products, specific roles for the shopper that made the purchase, specific shipping classes for products in the order, and shipping destination countries.
If you define optional triggers (beyond “Condition”) then those triggers are processed via “OR” logic. For example: If the order receives a status of Processing AND (has products from Category Abc OR is shipping to Canada) then send this notification.
Contact info tab
Any contact information you enter into this tab is for your reference only and is never included in a notification email.
You can use these settings to help remind you what the notification if used for.
Configuration
Navigate to WooCommerce -> Settings -> Integration -> Cart Discounts.
Adjust the basic settings to suit your needs, and note that you can hover over the question mark icon to see a description of each setting.
To add new discount rules click the Add Rule button near the bottom of the page.
For each rule you can set a label, a From and To amount range, and a discount amount. For example, to apply a 10% discount labeled “Automatic Discount” if the shopper spends between 100 and 200 you’d set the label accordingly, set the From amount to 100 and the To amount to 200, and set the Discount Amount to 10%.
If you want to apply a flat amount discount then don’t include a percent symbol.
Note that the first matching rule is applied. You can drag and drop the rules into any order you prefer.
That’s all there is to it!
After installing and activating the plugin, navigate to WooCommerce -> Settings -> Integration -> Drop Shipping.
There you will find the general settings, most of which are related to the PDF packing slip content and are self-explanatory.
However, a couple of the settings may need clarification:
Enable – This setting controls whether email notifications will be sent. When not enabled no notifications will be sent.
Order Status Trigger – This controls when email is sent to your suppliers. If you configure the setting to Processing then your suppliers will be sent an email notification when any new order receives the status of processing if the order contains items for a shipping supplier.
Default Supplier Notification – This is the default email notification sent to all suppliers unless you create different email notifications and set a supplier to receive a different email notification. See the section on Email Notifications below.
PDF Packing Slips – Configure the general content of your packing slip. These settings will be used for all packing slips sent to all suppliers. You can view a sample of the PDF by clicking the Download a Sample button near the bottom of the settings. Keep in mind this is only a sample. The actual packing slip will contain actual data from the orders.
When you active the plugin one default email notification is automatically created. All suppliers will receive this notification unless you create additional email notifications and assign them to individual suppliers.
Navigate to WooCommerce -> Email Notifications
There you will find the default email notification. Hover over the title and click the Edit link to view its settings. Adjust the settings to configure which content will be included in the email body, and optionally enable the PDF packing slip setting if you want a packing slip attached to the email message.
Navigate to Products -> Suppliers to add new supplier.
You must at least configure a title and an email address.
The settings are self explanatory, with one exception which comes into play if you’re using any of Ignitewoo’s UPS Drop Shipping Pro, Fedex Drop Shipping Pro, or USPS Dropshipping Pro extensions for WooCommerce. See the shipping section below for more information.
Edit a product. In the right sidebar you’ll see a box where you can optionally assign one supplier to the product. Save the settings.
That’s all that’s required for the plugin to know that this product ships from a supplier so it can send the supplier an order email notification automatically.
Test all of your settings and the entire purchase flow before assigning suppliers to all of your products!
This feature requires WooCommerce 3.0 or newer. It will not operate correctly if you’re using older versions of WooCommerce.
First ensure your CSV contains a SKU number and that your products have SKU numbers configured. This is required. You cannot import inventory updates with SKU numbers. The SKU number is used to find the correct product for the correct supplier
Next, ensure your CSV file contains one or both of the following two types of a columns:
Stock status indicator – this column would indicate whether the product is in stock or out of stock. The values in this column must be set to 1 or 0 (zero). No other values will be interpreted correctly!
Stock quantity – this could would be a numeric value that represents the quantity of the product that the dropshipper has available.
As long as your CSV file contains at least 2 of those 3 columns the inventory update import should operate correctly.
BE SURE TO BACKUP YOUR DATABASE BEFORE ATTEMPTING ANY IMPORT!
There are 3 types of possible data combinations when running your inventory update import. Your choice of CSV fields determines which kind of update will happen:
To begin an import, navigate to Products -> Suppliers, find the supplier in the list, and click the Import Inventory CSV button. You’ll be redirected to the import page for that specific supplier. You cannot import more than one supplier’s inventory update at the same time.
Select the CSV file from your computer, set the CSV delimiter (usually a comma), and click the button to continue.
Next you’ll see a CSV field mapping screen. Make sure that the SKU field is mapped to the corresponding field in your CSV file. Then, select the corresponding field in your CSV file for the Stock Level and/or the Stock Status field. Now click the button to run the import.
After the import runs you’ll see the next page that tells you how many products were updated and how many were skipped. A product will be skipped if the the update process cannot find a product matching the SKU number for the supplier for which you’re running the inventory import update.
If you’re using any of IgniteWoo’s UPS Drop Shipping Pro, Fedex Drop Shipping Pro, or USPS Dropshipping Pro extensions for WooCommerce then you gain some additional very powerful features:
First, every supplier will have new settings for you to configure the origin from which your dropshipper ships their products. Each shipping module adds a zipcode/postcode field. Some may also add a setting for country and state/province. You must set each field if you want the shipping modules to calculate shipping from the dropshipper’s actual shipping origin.
Secondly, each of the mentioned shipping modules will have a setting that you can enable that tells the shipping module to group items in the cart by supplier for purposes of calculating shipping. This way, if a shopper buys 3 items from Supplier A, and 2 items from Supplier B, and 5 items from Supplier C, then the shipping modules will calculate shipping from each of the three supplier’s origins, and at checkout your shopper will select a shipping method (Ground, 2nd Day, etc) for each group of items.
This method of handling packages gives your site the ability to offer far more accurate shipping rates, which benefits you and your shoppers.
See the documentation for the individual shipping modules for details on their configuration and use.
Install and activate the plugin. Then create one or more products to sell credits to post product and/or feature products on your site.
The setting “Credits per QTY” lets you control how many credits are issued per quantity of the product that is purchased.
To enable credit system, navigate to WooCommerce -> Settings -> Vendor Marketplace Stores, and click the Pay to Post / Pay to Feature tab. On that tab section you’ll find checkboxes to enable pay to post and pay to feature. You’ll also need to define how many credits are charged to post a product or feature a product.
Credits are debited from a vendor when the vendor first saves their product while editing. The credits are are not returned to the vendor if the vendor deletes the product or the administrator declines to publish the product.
Credits are debited when a vendor features a product. The credits are are not returned to the vendor if the vendor un-features the post.
Note that if an administrator or shop manager is publishing a product in the WordPress admin area for a vendor then no credits are automatically debited. Admins must manually subtract credits from the vendor’s user account.
To manually adjust credits for any vendor user, edit their user account where you’ll find the related settings. Simply increase or decrease the number of credits in the setting and save the user’s account settings.
A Note About Featuring Products:
The idea of featured products is that they are prominently displayed somewhere on your site. Vendor Marketplace Pro does not handle displaying featured products, only your site’s theme can do that! So you must ensure that your theme can display feature products in some way or other.
If you theme doesn’t have a way to display feature products then you might use the “featured_products” shortcode built into WooCommerce (wee the WooCommerce shortcode documentation for more help with shortcodes.), or you can use the Products widget built into WooCommerce to display widgets in sidebars to show featured products.
Navigate to WooCommerce -> Settings -> Integration
Global rule definitions
Min Subtotal – the minimum cart subtotal that a buyer must have in their cart before being allowed to checkout. Do not use a currency symbol. If you leave this field blank then no minimum order subtotal will be enforced for the shopper.
Max Subtotal – the maximum cart subtotal of all items in the cart that a buyer can have and still proceed to checkout.
Min Qty – the minimum total quantity of all products in the cart required before a shopper is allow to checkout.
Per Item Qty – the minimum number of each product that must be in the cart before a buyer can place the order. For variable products, this applies to the product’s variations as a whole. So for example, if a product has 3 variations and the buyer has one of each in the cart, then the total quantity count for the product is 3.
Orders – causes the rule to be applied to shoppers with less than the defined number of orders.
Product rule definitions
When editing an individual product you can a different type of quantity requirement rules. Navigate to the General section of the Product Data for the product. Below the pricing and tax settings you’ll find a Quantity Rules section. Here you can define rules for minimum and maximum quantities that pertain only to this product. You can also define “Increments” if you only sell the product in specific increments, for example maybe for a given product you only sell quantities of 2, so a shopper can buy 2, 4, 6, etc., but not 1, 3, 5, etc. To do that set the Increments value appropriatey.
For any given product rule you can also optionally assign the rule to specific users and/or roles.
In your WordPress admin area, Navigate to WooCommerce -> Settings -> Integration -> Password Protected Private Site.
First adjust all the settings. Then when you’re ready to have the plugin protect your site check the Enable box and save the settings.
There are several ways to adjust the settings depending on what you want to accomplish:
Store requires logged in user, no custom passwords
Store requires custom password
Store requires logged in user or custom password
Protect Specific Categories
If the mode is “Entire Shop” then the plugin attempts to hide all menu and widget links to the WooCommerce shop page, categories, and products; and it also hides all widgets built into WooCommerce
Display a password entry form automatically
Display a password entry form using a shortcode
Use the shortcode [store_login]
Optional parameters:
before_form
– text to display before the form
form_title
– form title, display before the password entry field
submit_button_text
– text for the submit button
after_form
– text to display before the form
visit_text
– text to display if lands on the login page and has already entered a password, this text is hyperlinked to your main store page.
success_message
– text to display after the user successfully enters a password
Note that if you don’t supply shortcode parameters then the default settings built into the plugin are used, or settings as configured in the plugin are used.
Example shortcode:
[store_login before_form="Welcome, enter your password to access the store"]
You can optionally redirect users that have not been granted access (not logged in or didn’t enter a password)
Table of Contents
Be sure to read all of the information below carefully so that you have a good understanding of how the software works.
Navigate to WooCommerce -> Settings -> Integration -> Vendor Stores. Configure the settings as you like. Be sure to refer to the setting descriptions below so that you understand the implications and use of each setting.
Vendor Store Slug
Vendor Store Slug
The permalink structure used for the store permalinks. WARNING: Slugs can only contain letters, numbers, dashes, forward slashes, underscores (and percent symbols when used to represent the shop_vendor taxonomy). For example: vendor
is valid, as is store/vendor
Note: We don’t offer support for custom permalinks beyond the default setting.
Vendor Dashboard Page
The page on your site used for the Vendor Dashboard area, which is used by vendors to access their settings, orders, etc. This page is created automatically when you enable the plugin. The default title for the page is “Vendor Dashboard”. This must be set correctly otherwise accessing sections of the frontend dashboard may result in “404 – Page not found” messages, or similar.
The permalink structure used for the sections of the frontend dashboard permalinks. WARNING: Slugs can only contain letters, numbers, dashes, forward slashes, underscores (and percent symbols when used to represent the shop_vendor taxonomy).
Note: We don’t offer support for custom endpoints, we only support the default endpoints.
Default Commission
This is the default amount used if no commission is set in the vendor’s store settings. By default no percentage is defined in a vendor store when the store is created – unless you manually set the commission. When no commission is set in a vendor’s store this default commission setting is used.
You may use a percentage or a fixed amount. To define a percent for each product sold use a percent symbol after the amount. Example: 25% or 45.5% To define a fixed amount per product sold enter a number without a percent symbol. Example: 10 to give $10 commission, or 75% to give a 75% commission. Keep in mind the commission is calculated on a per product basis, per quanity. Example: If you set the commission to 75% and the vendor sells one person 5 yellow t-shirts $20 each in the same order, the total sale amount is $100 and the vendor will receive $75 ( 75% of $100 ).
If no commission is defined then vendors recieve no commission unless you defined a commission in their store settings. Note that per-product commission settings override vendor store commission settings.
Default Commission For
This controls the default setting of who receives the commission when a new vendor store is created. You can override this setting for any vendor store by editing the settings for the vendor store, or on a per-product basis by editing individul products.
This setting lets you configure your store in a variety of ways. For example, you might want to take $5 from the sale of each product. In that case, set the Commission to $5 and set the Commission For to “Store”
Or you might want to pay the vendor $10 for each item sold. In that case set the Commission to $10 and set the Commission For to “Vendor”
You can override the defaults by editing the settings of any vendor store.
You can also override the settings at the product level by simply editing the product settings.
If no setting is defined the plugin gives commissions to the vendor.
Include Shipping in Calc
When enabled the per item shipping amount is included when calculating vendor commission. This setting is only applicable when commission is a percentage and “Give per item shipping cost to vendor” is enabled
Give order item tax to vendor
When enabled, any taxes collected for the sale of the item are given to the vendor.
Give per item shipping cost to vendor
When enabled, any shipping cost associated with the sale of a vendor’s item is given to the vendor – IF you’re using a supported shipping method.
These settings determines how people can become vendors in your site.
For the vendor registration, you can choose to screen all requests for vendor access, or automatically grant vendor access when anyone submits a request. To screen requests select the option “Users can request access to post products,” and you’ll receive an email message every time someone requests access. The email message will contain a link to their user profile where you can review the account, and if you decide to grant them access as a vendor you must change their user role from Pending Vendor to Vendor and save the settings, and they’ll be sent an email letting them know that they’ve been granted access as a vendor.
If you allow users to request to become a vendor, then any logged in user can click the button on their My Account page to request to become a vendor. If the user is not logged in then they can register for an account and request to become a vendor at the same time. NOTE: To enable registration for non-logged in users you must enable user registration on the My Account via the WooCommerce setting in your admin area at WooCommerce -> Settings -> Accounts -> “Enable customer registration on the My account page.”
You can also enable the Extra Registration Fields, any of which can be disabled, or made to be required or optional. Any field that is not disabled will appear in the “Register” section of your site’s My Account page. Near the bottom of the register form a checkbox to “request vendor access” is automatically included if you allow people to request access via the “Vendor registration” setting.
Most of the settings in this section are self-explanatory, you can hover your mouse over the help tip (question mark icon) for any setting for help.
Note that Vendor Marketplace Pro offers the ability for you allow your vendors to set a “Store Status” for their store, which helps if they need to temporarily disable all sales for their items due to vacations, etc., or if they need to display a message on their store pages and products. You can enable this feature if you want to allow this functionality. When enabled you can choose any or all of four different statuses vendor may set for their store:
Normal – normal behavior, all products are visible and purchasable
Normal w/Notices – normal behavior, all products are visible and purchasable however the vendor can write a message that will be displayed on their store page and all of their product pages on the site. This is useful if the vendor might need to inform shoppers of something important, for example maybe they need to inform shoppers they’re experiencing shipping delays, etc.
Disallow purchases – Vendor’s products are accessible on the site but cannot be purchased
Disabled – this disables their store entirely so that non of their products are visible or accessible on the site.
You can enable the feedback and ratings systems that allows shoppers to leave written feedback and ratings for all items that they purchase. You can also opt to allow the feedback and ratings to be visible on the site, otherwise only the vendor can view the feedback and ratings in the dashboard. Admins can view feedback in the admin area of WordPress at WooCommerce -> Vendor Reviews.
When feedback and ratings are enabled on the site links to the feedback appear on a vendor’s main store page, and on individual product pages in a tab. A sample screenshot of how they appear is shown below.
For ratings, there are four rating labels. You can change any of the default text. The labels are used to build a list of of star ratings where the user can select from 1 to 4 stars to rate their response to each label. See the screenshot above for example.
Any label can be disabled by removing all of its label text.
Caution: Do not change the endpoint settings for the feedback for and reviews pages unless you’re absolutely certain that you need to and understand the implications.
These settings are only applicable if you’re using IgniteWoo’s WooCommerce Vendor Stores Paid Features add-on for Vendor Marketplace Pro. The add-on allows you to sell credits that vendors can redeem to post products and/or feature their products on your site. If you’ve purchased this add-on then see the documentation for the add-on for more information on these settings.
Allowed Product Types
This determines which types of products a vendor can post in their store. We recommend allowing Simple and Variable.
If you enable new plugins that add new product types ( for example, WooCommerce Subscriptions ) then be sure to revisit this setting and make adjustments if you want vendors to be able to create products of the new post type.
Hide Product Panels
The product data panels that you want to hide. This works for the following panels:
Any other panels added by other plugins must be removed or hidden using your own CSS or Javascript
Hide Product Fields
The product fields that you want to hide. This works for the following fields:
Any other fields must be removed or hidden using your own CSS or Javascript
Hide Product Type Options
The product type options that you want to hide. This works for the following types:
Any other type fields must be removed or hidden using your own CSS or Jvascript
New Product Notice Recipients
A list of addresses (comma separated) who receive notices when new products are posted by vendors. Defaults to mark@simplercomputing.net
New Product Notice Title
Message subject. Use {blogname} to insert the site name
New Product Notice Message
Message content. Use {username} to insert the user name and {url} to insert a URL to view / edit the post
Automatic Approval
If you enable this setting by defining a number, then when the vendor has the defined number of products published the vendor will gain the ability to publish product any time they like with no notice sent to the store admin. To disable this feature, leave the field totally empty. To grant every vendor the ability to publish products without review set the value to 0 ( zero ).
Trusted Vendors
Any vendors selected can post products with no administrative review. This setting entirely bypasses the automatic approval setting for the selected vendors.
Editor CSS
You can enter CSS in this field that is loaded when products are edited by vendors. For example you may want to hide certain fields. You can use this CSS field to do that.
Product Editor Layout
The product editor in the vendor dashboard has sections that can be rearranged, and the section titles can also be changed. Drag and drop the sections to change their order.
Note that you cannot change the layout of the elements within a section. You can only rearrange the order of display of the sections.
Show “Sold By” in Shop Pages
When enabled this adds a label to general store pages (main shop page, category pages, etc) informing the shopper of which store sells the product.
Show “Sold By” in Cart
When enabled the product pages will show which vendor sells the product.
Show “Sold By” in Email
When enabled order confirmation emails will show which vendor sells the product.
Show Seller Tab
Show the seller tab on single product pages.
Show Seller Address in Tab
Shows the seller’s address (if they’ve configured it in their store settings) in the seller tab, if the seller tab is enabled.
Seller Tab Label
The seller tab label on shown single product pages.
Show Seller Policies Tab
Adds a tab to product pages if the vendor defines any shipping and returns policies
Enable Vendor Tools Shortcuts
Adds shortcut links to a vendor single product pages for quick access to Edit or Duplicate a product, and a quick link back to the Vendor Dashboard page.
Add “Contact Seller” Tab
Add a tab to single product pages that allows a shopper to send the vendor a message. This feature requires a free ReCaptcha account.
Contact Tab Label
The contact tab label on shown single product pages.
ReCaptcha Public Key
Enter your Google reCaptcha public key
ReCaptcha Private Key
Enter your Google reCaptcha private key
When you enable the coupons option vendors can create and manage their own coupons. You must enable the coupon feature in WooCommerce itself otherwise shoppers will not be able to use coupons!
There are some limitations in the way vendors can create coupons. Make note of these!
Vendors can create coupons just like an administrator can, however:
Also note that shop managers and site administrators will see an additional author field when editing coupons. This field is added by Vendor Stores to allow shop manager and administrators to see which vendor published the coupon and adjust the coupon ownership when necessary. Other than that, the author of a coupon is present to help Vendors Stores control access to editing the coupon. This setting has no affect on the use of the coupon by shoppers.
You can enable taxes in your site and vendors can optionally enter their own tax tables. You must enable taxes in the WooCommerce settings before WooCommerce will attempt to calculate taxes.
You can optionally set up your own storewide tax tables per the WooCommerce documentation if you need to.
When you enable taxes in Vendor Marketplace Pro then vendors can enter a table of taxes in their dashboard area. The tax settings are basically the same as the storewide tax table settings, except that these rates are only available to the vendor’s products. If a vendor configures a tax table and assigns their tax tables as the tax class when editing a product then the taxes will be calculated using their table.
You should configure the following settings to enable taxes in your store when you want vendors to be able to set their own tax rates:
Adjust the other settings to suit your needs keeping in mind that these settings apply to all vendors.
If you need to edit tax tables for a vendor then you must login as that vendor and visit the WordPress admin area, and navigate to the Store Taxes menu.
Here’s an example of the vendor’s tax table settings page. When the vendor enters tax rates and saves the settings a custom tax class is created for the vendor. Note that this custom tax class is hidden from the regular admin view of the WooCommerce tax settings and can only be viewed while logged in as a vendor.
You also need to instruction vendors how to assign their custom tax class to their products. When editing a product, on the General tab of the product settings, the vendor will set the tax settings for the product. In the tax settings area the vendor must check the “Use Store Tax Class” checkbox to automatically assign their taxes to the product. When the box is checked the vendors custom hidden tax class is automatically assign to the product. When the box is unchecked their custom tax class is automatically removed.
See the screenshot below for an example of the product editor tax settings area with the “Use Store Tax Class” checkbox checked. In the example you see that the Tax Class is set to “My Store Tax Class” ( which is a generic label seen by all vendors who enable their tax class for their products.
Disable New Order Notices
When you enable this option vendors will not receive new order notices via email
Show Email Address
Allow vendors to see buyer email addresses
Show Billing Address
Allow vendors to see buyer billing addresses
Show Phone Number
Allow vendors to see buyer phone numbers
Show Shipping Address
Allow vendors to see buyer shipping addresses
Add Vendor to Note
When a vendor adds a note to an order then prepend the vendor store name to the note
These settings control how items are packaged before WooCommerce calculates shipping for a customer’s order at checkout, keeping in mind that any shipping module needs to know how many packages are being shipped along with what the packages might weigh and how big they are.
Vendor Marketplace Pro attempts to repackage all items in an order based on the Shipping Packages setting you choose, and in most cases this setting will take effect in any shipping module you decide to use. There are three options:
Group by Vendor – This is the suggested setting and is required if you intend to give the vendor the cost of shipping their items. This settings groups all items from each vendor in an order into one package per vendor. This way Vendor Marketplace Pro can determine how much of the overall shipping charges to give to a vendor when more than one vendor’s items are in a single order.
All items together in one package – This causes all items in an order to be grouped into one single package even if more than one vendor’s items are in a single order. This setting cannot be used when giving shipping costs to vendors.
One item per package – This causes each item in an order to be placed into a separate package. This setting cannot be used when giving shipping costs to vendors.
Note that you can use our UPS Drop Shipping, Fedex Drop Shipping, or USPS Drop Shipping extensions to give your shoppers the most accurate shipping rates possible since each of them allow your vendors to define their own shipping origin for the items they sell. Otherwise, other shipping modules may only use a single defined origin for all shipping regardless of where items actually ship from.
This option is available when you use our PDF Invoices & Packing Slips Pro plugin. This add-on allows vendor to print PDF packing slips. Without the add-on vendors can print HTML-based packing slips.
This setting is only used when you’re also use IgniteWoo’s Auctions Pro software to allow your vendors to post auctions. See the Auctions Pro documentation for help with that extension.
Disable Instant Payments – With his option enabled, regardless of which payment gateway you have installed no vendors will be paid automatically at the time a shopper places a new order. Instead all commissions due will be recorded for processing at a later time
PayPal Required – With this option enabled all vendors will be required to supply their PayPal email address before being able to publish products in your site
Payment Processing
Note that you must have a PayPal Premier or Business account to use Mass Pay.
You can enable any payment gateways you prefer, however only gateways officially supported by Vendor Stores are capable of paying vendors immediately ( Currently this includes IgniteWoo’s PayPal Adaptive Payments, WePay, and Stripe gateways).
If for example you enable an unsupported gateway and a shopper makes payment with that gateway then the vendor cannot be paid immediately and as a result their commission will be recorded as “Unpaid” in the commission table, and you will need to process payment to them in some other way ( via Mass Pay, or mail them a check, etc ).
BE SURE TO PERIODICALLY REVIEW YOUR COMMISSION RECORDS to determine which vendors need to be paid their commissions.
Payment Interval
ONLY USED FOR MASS PAY. Required if using Mass Pay in automatic mode. Automatically process commission payments every X number of days from the date the commission is recorded.
PayPal Transaction Mode
Sandbox or Production. Sandbox requires a PayPal Sandbox account with Adaptive Payments and Mass Pay enabled in the Sandbox account. Contact PayPal for any assistance you may need with your PayPal accounts.
PayPal Email Address
Your PayPal email address
PayPal Username
Your PayPal API username
PayPal Password
Your PayPal API Password
PayPal API Signature
Your PayPal API Signature
PayPal Fee Offset
Allows you to subtract a fixed amount from the amount being sent a payment recipient.
PayPal Adaptive Payments is built into Vendor Marketplace Pro. This payment gateway automatically splits payments between your store’s PayPal account and your vendors’ PayPal accounts based on the commission settings you define for vendors. Note that Paypal is retiring Adaptive Payments. If you’re already using it then you can probably continue using it. If you’re not already using it then use PayPal Payouts instead. See the Payouts section of this documentation for use information.
To enable this payment gateway navigate to WooCommerce -> Settings -> Checkout -> PayPal Adaptive Payments. Be sure to configure all the settings.
You can set a storewide commission that applies to all vendors in the Commission section of the Vendor Marketplace Pro settings. You can override the global commission setting for any given vendor by setting a different amount when editing a vendor’s store at Products -> Stores in your admin area. Or, you can set a different commission for different products by editing a product and setting the commission within the product.
Parallel payments and chained payments allow you to split payments between multiple recipients.
You MUST have a PayPal Premier or PayPal Business account AND you must be approved for the Adaptive Payments API. To gain approval follow the steps outlined by PayPal to register your Web app.
When registering your app with PayPal follow the basic guidelines in the PDF file that comes inside the plugin zip file – and note that these are only a guideline. Tailor your app submission settings to suit your exact needs. When selecting services BE CERTAIN to select Basic Payment if you intend to use Parallel Payments, and select Chained Payments ( and the “Instant” sub-selection ) if you intend to use chained payments. Note that chained payment require additional review by PayPal and as such your app may not be approved immediately. If you need assistance with getting approval for your app you must contact PayPal directly. IgniteWoo cannot provide such support.
As of October 2013, PayPal’s Adaptive Payments API currently only works with the following currencies: ‘AUD’, ‘BRL’, ‘CAD’, ‘MXN’, ‘NZD’, ‘HKD’, ‘SGD’, ‘USD’, ‘EUR’, ‘JPY’, ‘TRY’, ‘NOK’, ‘CZK’, ‘DKK’, ‘HUF’, ‘ILS’, ‘MYR’, ‘PHP’, ‘PLN’, ‘SEK’, ‘CHF’, ‘TWD’, ‘THB’, ‘GBP’, ‘RMB’
Parallel Payments
A parallel payment is a payment from a sender that is split directly among 2 to 6 receivers. Technically, a parallel payment is a set of multiple payments made in a single Pay request within the PayPal API.
Parallel payments are useful in cases when a buyer intends to make a single payment for items from multiple sellers. Examples include the following scenarios:
In these cases, the sender of the payment becomes aware of all receivers and the amount paid to each one.
Chained Payments:
A chained payment is a payment from a sender that is indirectly split among 2 to 6 receivers. It is an extension of a typical payment from a sender to a receiver, in which a receiver, known as the primary receiver, passes part of the payment to other receivers, who are called secondary receivers.
You can have at most one primary receiver and 1 to 5 secondary receivers. Chained payments are useful in cases when the primary receiver acts as an agent for other receivers. The sender of the payment deals only with the primary receiver and does not know about the secondary receivers nor how a payment is split among receivers.
Guest Payments
These are using a sender’s credit card without logging into PayPal to complete the transaction. The sender is not explicitly identified as a PayPal account holder during the transaction and is not required to have a PayPal account.
With either payment type ( parallel or chained ) each receiver of a guest payment must be a verified PayPal Business Verified or Premier Verified account holder.
This plugin DOES NOT SUPPORT DELAYED chained payments. It does support instant chained payments.
This plugin always redirects shoppers to PayPal’s site to make payment. PayPal DOES NOT ALLOW embedded payment forms when using Adaptive Payments – DO NOT contact us asking us to add this feature because as of October 2013 it remains impossible to achieve due to PayPal’s restrictions on Adaptive Payments implementation. PayPal does however allow a “Lightbox” mode for Adaptive Payments. We intend to implement this feature in a future version of this plugin.
PayPal limits all payment amounts to 2 decimal places. Do not set WooCommerce to use more than 2 decimal places, and do not set prices to have more than 2 decimal places.
As of October 2013, PayPal limits the entire transaction amount to $4000 or less for US residents, and $2000 or less for recipients outside the US. If these payment limits are exceeded during any checkout process then payment will fail.
PayPal limits ALL adaptive payments to having no more than 6 recipients total. As such, this plugin restricts a shopper’s ability so that they can only add products to the cart as long as the total cart contents amounts to 6 payment recipients or less, including the store itself if the store takes a cut or sells products of its own. There is no checking performed on the transaction amount total.
Any attempt to add items to the cart when the addition would surpass the recipient limit will result in an error/warning message being displayed to the shopper instructing them that they cannot add additional items to the cart and must pay for their current cart contents first before purchasing additional items.
PayPal’s Adaptive Payments API does not support sending a list of items included in a purchase transaction. Therefore IgniteWoo’s Adaptive Payments plugin attempts to itemize the cart contents using the transaction’s memo field. However PayPal limits the length of the memo field to 1000 characters, so all cart contents may not appear in the memo.
Our current understanding of the PayPal dispute process is that if payment is split between 2 or more sellers and the buyer files a dispute with PayPal asking for a refund then the buyer can dispute items in the order individually, or collectively, and each seller whose item was disputed will need to address to dispute individually.
Check with your PayPal representative for clarification.
When using this plugin each receiver of funds pays their own PayPal transaction fees.
General
Funds Collection
Tax Payer
Global Recipients
Submission method
Error Message
PayPal sandbox
Debug Log
If you’re splitting payments for the product with someone else then you’ll need to enter the PayPal email address of the person who will receive a percentage of the sale of this item along with the percentage of the product cost that they will receive.
You can enter up to 5 recipients per product.
To configure payment recipients for a product, edit a product and go to the General tab in the Product Data settings. Look for the PayPal Split Payment box. In the box enter up to 5 recipients, one per line, where each line is formatted as Percentage|Email
So for example:
25|someone@thisdomain
60.5|thisperson@thatdomain
In the above example when the item is sold someone@thisdomain would receive 25% of the product price and thisperson@thatdomain would receive 60.5% percent of the product price. The remainder would be received by your store.
Remember that the total percent for all receivers cannot exceed 100.
You’ll see an error message above the recipients box when editing the product if any of the following conditions are true:
If you want to exclude the product from split payments entirely when using a global recipient list in the main product settings then simply check the Do Not Split Payments box when editing the product, and the store will receive the entire amount for the product when purchased by a customer.
If you’re using IgniteWoo’s WooCommerce Vendor Stores plugin, then note that when determining who might receive money from the sale of a product, this PayPal Adaptive Payments plugin will first check to see if a vendor is assigned to the product and if so that vendor becomes a receiver of money for the sale of the item. If no vendor is assigned to the product then this plugin checks the PayPal email field setting for the product and if an email address exists then the person associated with that email address becomes a receiver of money for the sale of the item. If no PayPal email address is configured in the product, and no vendor is assigned to the product, then the store itself becomes the sole receiver of money for the sale of the item.
NOTE that we DO NOT provide support for PayPal accounts or associated adaptive payments Web applications. The links below should get you started. If you require assistance with your credentials or with registering your application contact PayPal directly and ask them for assistance in getting your application set up to process Adaptive Payments.
REMEMBER that if you need to use Chained Payments you must request this API access specifically from PayPal.
REMEMBER that the you MUST submit your Web application for review by PayPal. When you register your application, a PayPal agent reviews it to ensure that it meets the criteria outlined by PayPal. The review process varies from site to site. For more information on the overall process review all the information in PayPal Going Live documentation.
Vendor Marketplace Pro sends a number of different email messages for various purposes. To view these email messages navigate to WooCommerce -> Settings -> Emails
On that page you’ll find several different vendor-related email messages. For any given message you can enable it, disable it, or change the heading title, message subject, etc.
All email messages are sent using your site’s WooCommerce email styling.
Two pages are automatically created when you install Vendor Marketplace Pro: Vendor Dashboard and Seller Reviews.
The dashboard page is the page that contains the entire vendor dashboard.
The seller reviews page is used to display reviews for a given vendor. If you view this page directly by its permalink you won’t see any reviews. It’s dynamically populated with reviews when you click on the reviews link on vendor’s store or product pages on the frontend of your site.
See the shortcodes section in this documentation for the shortcodes used in those pages.
Vendor Marketplace Pro includes a Vendor Shipping module that lets your vendors set their own flat rates for shipping their items. You can enable this module at WooCommerce -> Settings -> Shipping -> Vendor Shipping.
When enabled, vendor will see additional settings in their dashboard area that allow them to define global flat rates that apply to all of their products. They can also define specific flat rates for any individual product when editing that product. If a product has no individual flat rates, and there are global rates defined, then the global rates will be used, otherwise if a product has its own flat rates defined then those rates override any globally defined flat rates.
The plugin includes two widgets. The WooCommerce Vendor Store widget can be added to your store sidebar if you theme has such a sidebar. The widget only shows up on individual product pages and displays the vendor’s logo, store name, and store description, and has a link to the vendor’s store on your site. This works similar to the “See seller’s other items” link you see on eBay auctions.
The WooCommerce Vendor Stores List widget displays a list vendors on your site that have published products visible to the public. When using this widget you can limit the number of vendors to display, or leave that setting set empty to display the full list.
To manually create a new vendor first add a user account for the vendor. Then navigate to Products -> Stores, and add a new vendor store. In the Store Administrator field select the user that you added for this store. Adjust the other settings as you see fit.
Enter a title for the store. This is displayed on the public side of your site when a shopper is viewing the vendor’s store. Keep in mind that vendor’s have the ability to change this title if they want to.
Optionally enter a slug for the store. This becomes part of the permalink URL for accessing the store on the public side of your site. If you leave this field blank WordPress will automatically generate the slug for you.
Enter a description for the store. Again, this is displayed on the public side of your site when a shopper is viewing the vendor’s store. Keep in mind that vendor’s have the ability to change this if they want to.
PayPal email address is optional, but strongly encouraged if you intend to automate payments to vendors. The address is used to automatically pay vendors when you use IgniteWoo’s PayPal Adaptive Payments plugin.
Note that you do not have to enter a value for the commission. When you leave this blank the store default is used. If you decide to enter a value then for a fixed currency commission only enter numbers. For a percentage-based commission enter a number followed by a percentage symbol.
Be sure to check the “Commission is for” setting. This controls who the commission amount is for.
For example, to give the vendor $5 for each item sold enter 5. To give the vendor 10% for each item sold enter 10%. In either case select “Vendor” in the “Commission is for” field. Or, if the $5 or 10% represents how much the store should get then select “Site” in the “Commission is for” field.
You can optionally upload a logo for the store. The logo appears on the public side of your site when a shopper is viewing the vendor’s store.
When adding products, as a site administrator, for a given vendor you must select the corresponding store and the corresponding user in the product’s settings. The store setting is located in the right sidebar. The user setting is located somewhere below the product description and product data in its own metabox.
Users can only be assigned to one store. DO NOT try to programmatically assign a user as the vendor of more than one store.
Products can only be assigned to one store. DO NOT try to programmatically assign products to more than one store.
If you’re using automatic MassPay payments and your site doesn’t receive much traffic you may want to create a cron job in your hosting account to load a page on your site periodically so that automatic MassPay payments are triggered.
You can use this URL format for setting up cron jobs to process automatic mass pay payments:
http://YOURDOMAIN.COM/?masspay=go
The payment interval setting is obeyed when using cron.
Commissions are recorded on a per item and per quantity basis. So for example if a shopper buys a quantity of 2 of the exact item then the plugin will record 2 commissions – one for each qty. This allows you to edit an order to add or remove an order item and then manually adjust commissions for the order by simply adding a new commission or deleting an existing commission.
When you want to give shipping costs for order items to the vendor associated with the item you do the following:
1. Enabled the “Give per item shipping cost to vendor” setting in the Vendor Marketplace Pro settings
2. Use one or more of the supported shipping methods listed below. NO OTHER SHIPPING METHODS ARE SUPPORTED AT THIS TIME. You can enable other shipping methods, but when unsupported shipping methods are selected by a shopper no shipping costs can be automatically given to the vendor of shippable items.
The plugin does include a few shortcodes that are used internally only, currently only three shortcodes are supported for your use on your site, none have any parameter settings. They are listed below:
[vendor_store_dashboard]
– shortcode to display vendor store dashboard page content
[vendor_list]
– displays a list of vendor stores in a grid, including store image and title
[view_vendor_reviews]
– displays reviews for a given vendor.
If you’re a developer that happened to discover the internally used shortcodes note that we do not offer any support for your use of those shortcodes.
Vendor Stores supports automatic payments out-of-the-box when you use PayPal Adaptive Payments (included with Vendor Marketplace Pro), or IgniteWoo’s Stripe payment gateway.
Automatic payments DO NOT work with payment gateways from any other software developers unless you’ve had them customized to support Vendor Marketplace Pro, or you’re using the PayPal Payouts module bundled with Vendor Marketplace Pro.
When IgniteWoo’s payment gateways are enabled you can optionally remove any particular payment method from the vendor dashboard if you don’t want vendors to connect the method to their account for automatic payments. To do so you need to add some PHP code to your theme’s functions file:
Remove WePay connect button in vendor’s store settings:
remove_action( ‘ignitewoo_vendor_stores_add_payment_setting_fields’, ‘woocommerce_wepay_connect_user’ );
Remove Stripe connect button in vendor’s store settings:
remove_action( ‘ignitewoo_vendor_stores_add_payment_setting_fields’, ‘woocommerce_stripe_connect_user’ );
Remove PayPal email address field in vendor’s store settings:
Use the related plugin setting.
You must have a PayPal business account to use Payouts, and Payouts is not enabled by default in your PayPal account. To use PayPal Payouts you must be approved by PayPal. After requesting access to Payouts they will review your account and your business before enabling Payouts in your account.
To begin the process of request access login to the PayPal Developer page and navigate to My Account. You’ll see a page similar to the image below. Scroll down to Payouts and in the Live column click Enable. You’ll be walked through a series of forms that you must fill in and submit.
After you have been granted access to Payouts follow the steps below:
You need to create an “app” in your PayPal settings. Open the PayPal Developer page in your browser. Sign in and navigate to My Apps & Credentials then scroll down the page to REST API apps. Click the blue Create App button.
You’ll the see the form below.
Enter a name for your app and select the user for the app in the dropdown box, the click the Create App button. When you do that a Client ID and Secret will be generated. You’ll need to copy those in the plugin settings.
In your WordPress admin area navigate to the Paypal Payouts menu item, there you’ll see the settings.
If you’re testing Payouts in sandbox mode then copy your sandbox Client ID and Secret into the related sandbox fields and choose Sandbox in the “Use Live or Sandbox“ setting. Otherwise copy your live Client ID and Secret into the related fields.
Next choose a Payout mode. Instant payouts happen almost instantly after an order is processed. Delayed payouts happen after the number of delay days you set. Manual payouts must be initiate manually by you.
In the Order Statuses setting select which order statuses will cause a payout to be created. We suggest that you select Completed and Processing since those two statuses mean that an order was paid for successfully.
After you’ve adjusted the settings and saved them check the Enabled checkbox when you’re ready to use the software on your site.
When you save the settings the software automatically creates a “webhook” in your app at PayPal. Be sure to check your PayPal app settings to ensure that you see a new webhook listed. To check that, find the app you created and click its name. Then scroll down the page to the Webhooks section. If you don’t see the Webhook created yet then double check your Client ID and Secret to ensure you have them entered correctly in the plugin’s settings and resave the settings. Resaving the settings causes the plugin to attempt to create the webhook for your app.
You can view any payouts that have been created on your site by navigating to the PayPal Payouts -> Payouts page. On that page you see a list of payouts.
In the Details column you can click the info button to see details about any particular payout.
If a payout hasn’t been processed into PayPal yet you can click the currency icon in the details column to initiate processing. Do this to manually initiate a payout.
If a payout status doesn’t show SUCCESS yet you can click the refresh icon to check the status at PayPal.
IMPORTANT: After a payout has been sent to PayPal there is no way to cancel it.
The plugin comes with several template files used to display vendor store data on your site.
These templates are located in the templates subdirectory of the plugin.
To override any of the templates, copy the template to a subdirectory within your theme or child theme into a “store_vendors” subdirectory.
You may also make a custom copy of the fontend.css file if you want to edit the styles. Copy the assets/css/frontend.css into your theme or child theme in a “store_vendors” subdirectory.
You may then edit the templates without losing your changes when you upgrade the plugin.
Note that the template files may change in new version of Vendor Marketplace Pro, so you may need to upgrade or adapt future template changes when you upgrade the plugin.
The text domain for this plugin is “ignitewoo_vendor_stores”
You should find a .pot file and.mo file located in the languages subdirectory of the plugin.
Create your mo/po files with a filename of “ignitewoo_vendor_stores-en_US.mo” where en_US is your language code.
Put your language files in wp-content/languages subdirectory of your site.
Only gateways that can process multiple charges during the process_payment() function can be modified to support Vendor Stores.
You must do the following to make a payment gateway compatible with splitting payments during the checkout payment process.
In your process_payment function do the following:
With that done the Vendor Stores plugin will handle adding commission records for all sellers in the order. Paid sellers will have their commissions marked paid, unpaid sellers have their commissions marked as unpaid.
Below is SAMPLE CODE you can modify to insert into your process_payment() function. This example assumes the payment gateway is Stripe Payments. You MUST modify this sample code to suit your particular payment processing gateway:
// Tracks all sellers and whether they are paid or unpaid
$sellers = array();
// Tracks all payments to process
$receivers = array();
// If Vendors Stores is active build a list of sellers and receivers
if ( class_exists( 'IgniteWoo_Vendor_Stores' ) )
foreach( $order->get_items() as $item_key => $item ) {
$_product = $order->get_product_from_item( $item );
if ( empty( $_product ) )
continue;
// get the product author
$sql = 'select post_author from ' . $wpdb->posts . ' where ID = ' . $_product->id;
$post_author = $wpdb->get_var( $sql );
if ( empty( $post_author ) )
continue;
// check if author is a vendor
$vendor = get_user_vendor( $post_author );
// See if the vendor has an account linked to this payment gateway
// For example, if this gateway is Stripe Payments check for their Stripe access tokens
if ( !empty( $vendor->ID ) ) {
// Get user associated with vendor
$user = get_vendor_admins( $vendor->ID );
if ( !empty( $user[0]->ID ) )
// Get user's access token
$access_token = get_user_meta( $user[0]->ID, '_stripe_connect_access_key', true );
}
// Product has a vendor but no Stripe account is connected
// Note this so a commission of paid or unpaid can be recorded by the Vendor Stores plugin
if ( !empty( $vendor->ID ) && empty( $access_token ) )
$sellers[ $vendor->ID ] = 'unpaid';
else if ( !empty( $vendor->ID ) && !empty( $access_token ) )
$sellers[ $vendor->ID ] = 'paid';
// Give item amount to store Stripe account
if ( empty( $access_token ) || empty( $vendor->ID ) || 'yes' == $ignitewoo_vendors->settings['disable_instant_payment'] ) {
$total = $item['line_total'] + $item['line_tax'];
$shipping = $ignitewoo_vendors->shipping->get_shipping_due( $order, $item, 0 );
$receivers[ 0 ][ $_product->id ] = array( 'line_total' => $item['line_total'], 'qty' => $item['qty'], 'total' => $total, 'app_fee' => 0, 'tax' => $item['line_tax'], 'shipping' => $shipping );
continue;
}
/**
app_fee is the store's cut
*/
$variation_id = $order->get_item_meta( $item_key, '_variation_id', true );
if ( empty( $receivers[ $vendor->ID ][ $_product->id ] ) )
$total = 0;
else
$total = $receivers[ $vendor->ID ][ $_product->id ]['total'];
if ( empty( $receivers[ $vendor->ID ][ $_product->id ] ) )
$app_fee = 0;
else
$app_fee = $receivers[ $vendor->ID ][ $_product->id ]['app_fee'];
$comm = calculate_product_commission( $item['line_total'], $_product->id, $variation_id, $vendor->ID );
$total += $comm; // line total already takes item qty in consideration
$app_fee += $item['line_total'] - $total;
$tax = !empty( $item['line_tax'] ) ? (float)$item['line_tax'] : 0;
// Who gets the item tax? Store or vendor?
if ( 'yes' == $ignitewoo_vendors->settings['give_vendor_tax'] )
$total += $tax;
else
$app_fee += $tax;
$shipping = 0;
// Who gets the item shipping? Store or vendor?
if ( 'yes' == $ignitewoo_vendors->settings['give_vendor_shipping'] ) {
if ( empty( $vendor->ID ) )
continue;
$shipping = $ignitewoo_vendors->shipping->get_shipping_due( $order, $item, $vendor->ID );
$total += !empty( $shipping ) ? (float)$shipping : 0;
}
$receivers[ $vendor->ID ][ $_product->id ] = array( 'line_total' => $item['line_total'], 'qty' => $item['qty'], 'total' => $total, 'app_fee' => $app_fee, 'tax' => $tax, 'shipping' => $shipping );
// Add the vendor's Stripe access token
$receivers[ $vendor->ID ]['access_token'] = $access_token;
// Put the store's cut into the total field
$receivers[ 0 ][ $_product->id ] = array( 'line_total' => $item['line_total'], 'qty' => $item['qty'], 'total' => $app_fee, 'app_fee' => 0, 'tax' => $item['line_tax'], 'shipping' => $shipping );
}
// Required for Vendor Payments to track who can and can't be paid in this transaction
update_post_meta( $order_id, '_commission_recipients', $sellers );
// Now take the $receivers array and process payments for each receiver in the array
// being careful to determine if the payment was successful. The total amount due to a receiver is in the 'total' array element for each receiver.
// MAKE NOTE THAT RECIEVER #0 IS THE STORE ITSELF
foreach( $receivers as $rec ) {
....
}
Navigate to WooCommerce -> Settings -> Wholesale Pro Suite. There you’ll find a series of sub-tabs for each aspect of the plugin.
The plugin introduces three settings: Role Only Filter and Retail Filtering, and Taxes.
When Role Only Filter is enabled and a user is logged with an account that has one of your tiered pricing roles then that user will only see products that have a price set for their role. When that filtered is not enabled the user will see all products in your store.
When Retail Filtering is enabled and shopper is not logged in or is logged in as a regular customer then any products that do not have a regular price set will not be displayed to the shopper. When that filter is not enabled then the shopper sees all products in your store as they normally would.
For tax control when a shopper is logged in with a tiered pricing role you can choose how to display prices in the shop, how to display prices in the cart and checkout, and indicate whether you entered your tiered prices including tax or excluding tax. These 3 settings are identical to the tax settings built into WooCommerce itself, except that the settings in Tiered Pricing Filters only affect users logged in with one of your tiered roles.
Display Regular Price – this shows the regular price on your product page and allows you to set the label for the display
Display $ Savings – this shows the saving amount ( difference between the regular price and tier price ) on your product page and allows you to set the label for the display.
After adding roles edit a product. Near the Regular Price field you’ll find price fields for each role. Set the price for reach role. If you leave any role’s price blank then anyone who logs in with an account that has that role will see your regular price. If you leave the role’s price blank and the regular price blank then WooCommerce will display your product, but there won’t be any add to cart functionality for that product. This is standard WooCommerce behavior.
In this area you can create new roles and delete any roles that you’ve added. Click the “Add New Role” role button, enter the role name, and click the “Save Changes” button to save the new role(s).
To delete a role check the box next to that role and click the “Save Changes” button. Note that if you delete a role then any users that have that role with have their role changed to the standard “Customer” role created by WooCommerce.
To enable or disable taxes for shoppers with the role select Taxable or Non-taxable and optionally select specific tax classes if you want the shopper to be exempt from those tax classes when the role is set to Taxable.
You can selective allow access to specific shipping and payment gateways. When you do this only the selected gateways will be available to shoppers with the corresponding role.
If you check the Backorders checkbox then shoppers with the corresponding role will be allowed to order items even if they’re out of stock and you’ve set the product to disallow backorders.
For developers, or for importing/exporting product prices you’d probably need to know the “post meta key name” of where the prices are stored. Below each role/tier that you’ve created you’ll find the meta key name for that role.
Global pricing lets you define global pricing discounts for each role that you’ve already created. You can optionally enter a percentage amount. When you do this the price of every product in your entire store will be discounted by this amount for shoppers with the corresponding role.
You an optionally define price discounts for specific categories of products, and if you do that then those discounts override the global pricing discounts. To set discounts for a category navigate to Products -> Categories, then edit a category where you find a discount amount field for that category.
These settings allow you create global quantity discount rules. If you want to create discount rules for a specific product you can do that too, explained further below in this section.
Enable Discounts Table – this setting causes a table of discounts to appear on a single product page if you have any rules defined that apply to that product.
Discount Table Placement – select where you want the discount table to appear.
Enable Discount Calculator – this setting causes a discount calculator to appear on a single product page if you have any rules defined that apply to that product. The calculator allows the shopper to check what the price of the product would be for a given quantity based on the entire current cart contents. The calculator may be helpful when you define discount rules based on product categories.
Create global rules if you need them. Keep in mind global rules are checked before individual product rules. If no individual product rules exist, global rules are applied if they exist. If product rules do exist, they take precedence over global rules. When rule precedence has been determined the plugin applies the first matching rule based on cart contents.
When entering percentages and dollar amounts do not use a percent symbol or currency symbol.
To create rules that have no maximum limit, enter a large number for Max Quantity, such as 99999 or use an asterisk (*).
Specific per-product discount rules are similar to global rules, except the there is no “sum of category” setting for per product rules. To add a rule to specific product edit that product then navigate to Qty Discounts tab in the Product Data area of the product. Add your rules there.
This feature lets you enforce minimum and maximum cart quantity and cart subtotals.
When you intend to use this feature be sure to check the box to enable the rules (the first setting on the page). Also review the message strings to ensure they contain the text you want to display to the shopper in various situations.
Global rule definitions
Min Subtotal – the minimum cart subtotal that a buyer must have in their cart before being allowed to checkout. Do not use a currency symbol. If you leave this field blank then no minimum order subtotal will be enforced for the shopper.
Max Subtotal – the maximum cart subtotal of all items in the cart that a buyer can have and still proceed to checkout.
Min Qty – the minimum total quantity of all products in the cart required before a shopper is allow to checkout.
Per Item Qty – the minimum number of each product that must be in the cart before a buyer can place the order. For variable products, this applies to the product’s variations as a whole. So for example, if a product has 3 variations and the buyer has one of each in the cart, then the total quantity count for the product is 3.
Orders – causes the rule to be applied to shoppers with less than the defined number of orders.
Product rule definitions
When editing an individual product you can a different type of quantity requirement rules. Navigate to the General section of the Product Data for the product. Below the pricing and tax settings you’ll find a Quantity Rules section. Here you can define rules for minimum and maximum quantities that pertain only to this product. You can also define “Increments” if you only sell the product in specific increments, for example maybe for a given product you only sell quantities of 2, so a shopper can buy 2, 4, 6, etc., but not 1, 3, 5, etc. To do that set the Increments value appropriatey.
For any given product rule you can also optionally assign the rule to specific users and/or roles.
This feature allows you to create a custom registration page if you want to have such a page on your site for shoppers to sign up to become a wholesale buyer (or any of your custom roles created on the Roles tab explained above).
The Registration Form Designer section of the page is where you create your form layout, which contains all the fields you want to have on your registration form. The right box contains a default form installed by the plugin. You can modify the form as you see fit. The left box has a list of possible fields that you can add to the form. Click a field to add it to the form, it will be added to the bottom of the form where you can then drag it into any position on the form that you want it to be. Each field has a checkbox, when check that causes the field to be required – i.e. the user must provide information for that field before being allow to submit the form.
To use the form you must create a page on your Web site and insert the shortcode [wholesale_pro_suite_register]
then publish the page. After you’ve done that, revisit the Registration tab in the Wholesale Pro Suite settings then select your new registration page in the Registration Page setting. You must do this so that the plugin knows which page to use for registration. You can link the page anywhere on your site (menu, sidebar, etc), or use the settings to cause a link to the page to appear on your site’s My Account page as explained below.
Note that any time the form is submitted a user account is automatically created for the person submitting the form, unless they’re already logged into an account. Any newly created user account will have a user role of Customer, which is the default user role used by WooCommerce. The Customer role has no special privileges, it’s simply a regular user account.
Several settings control how the form is used:
Add Button to My Account Page – when enabled, this causes a link or button to appear on your site’s My Account page (the page is installed automatically by WooCommerce). The button will appear when the user is not logged in and you have the WooCommerce setting “Enable customer registration on the “My account” page. ” turned on. To review that WooCommerce setting visit WooCommerce -> Settings -> Accounts.
Add Button to My Account Page Logged In – when enabled this causes a link or button to appear on your site’s My Account page if the user is already logged in. This is helpful when you may want to allow existing users to request to become part of your special pricing programs.
Automatic Approval – when checked, if a user submits the form then one or two things may happen: If the user is not logged in to an account when they submit the form then a user account will be created for the user and the user role will be automatically set to which role you select in the Automatic Approval Role setting. If the user already logged in to an account then their account user role will be automatically set to which role you select in the Automatic Approval Role setting.
When the form is submitted the site admin will receive an email message containing all the data from the form as submitted by the user. The email message will also contain a direct link to the user’s account in your WordPress admin area, which is helpful if you want to review their user account or adjust its settings – for example if you’re not using Automatic Approval then you can review their account and decide whether to grant them access to your special pricing programs by adjusting their user role to whatever you prefer.
That’s all there is to it!
The shortcode you can use to hide or show content is [wsp_hide_or_show roles]
Here’s an example of its use:
[wsp_hide_or_show roles="administrator" mode="show" restricted_message="ooops" restricted_style="margin-bottom:1em;color:#cf0000"]
THIS IS THE CONTENT
[/wsp_hide_or_show]
The above example shows THIS IS THE CONTENT to an user logged in as an administrator. Anyone else would the text “ooops”, which is optional if you want to use it.
Shortcode Parameters:
roles – which roles to affect, comma separated list
mode – show the content inside the shortcode, or hide it.
restricted_message – optional message to display when the content inside the shortcode cannot be viewed the a given user
restricted_style – optional CSS code to alter the display of the restricted message
For custom wholesale roles:
You’ll need to know the correct “slug” for the role you want to use with the shortcode. For roles created via the Wholesale Pro Suite software, navigate to WooCommerce -> Settings -> Wholesale Pro Suite, then click the Roles tab.
For each listed role look right below the name, you’ll see a meta key name something similar to “_ignite_level_589a05b092e87_price“. Copy the key name, remove the leading underscore, and the trailing _price aspects, and you wind up with something similar to “ignite_level_589a05b092e87” — that is the role slug. Keep in mind the slugs are unique to your site, and each role will have it’s own unique slug.
To customized the quick order form templates copy the files in the plugin’s ‘templates/quick-orders/’ subdirectory to your theme directory into a subdirectory “/wholesale-pro/quick-orders/” and edit as you see fit.
For example, if you use TwentyTen theme, copy the template files to ‘wp-content/themes/twentyten//wholesale-pro/quick-orders/”
Install the plugin and activate it.
IMPORTANT: active your license key.
Add or edit a coupon. There you will find all the new coupon settings added by this extension.
WooCommerce Super Coupons adds 3 new shipping coupon types: Shipping Discount flat amount, Shipping Discount % amount, and Shipping Flat Fee. For the first two new types you can set the amount of the discount and when the coupon is applied to the cart the associated discount is calculated and applied to each available shipping method available for the order.
For the Shipping Flat Fee coupon type, the plugin includes a new Flat Fee Shipping gateway that is only available when the coupon is applied. For this type of coupon you set the coupon amount to be the amount shipping will cost when the coupon is used by the shopper. When the coupon is applied to the cart the flat rate shipping method will become available to the shopper and the cost will be whatever you set in the coupon amount.
Create a new coupon, set the type to “Shipping Discount”, “Shipping Discount %” set the amount of the discount, and adjust any of other coupon settings to suit your needs. When the coupon is applied to the cart the associated discount is calculated and applied to each available shipping method.
Navigate to WooCommerce -> Settings -> Shipping -> Flat Fee Shipping. Check the box to enable the shipping method and adjust the settings to suit your needs.
Next, create a coupon, set the coupon type to “Shipping Flat Fee”, and set the coupon amount to be the amount shipping will cost when the coupon is used by the shopper. To be clear, this is not a discount, this is the amount you want the shopper to be charged for flat fee shipping when the coupon is applied to the cart. The plugin reads that amount to know what the flat fee shipping option should cost.
When the coupon is applied to the cart the flat rate shipping method will become available to the shopper and the cost will be whatever you set in the coupon amount.
Chained coupons is a new type of coupon that introduces a very useful feature:: It lets you define any number of coupons that will all be added to the cart (i.e. added them in a chain all at once).
Chained coupons themselves do not apply discounts, instead a chained coupon lets you define a set of coupons (any coupons that you’ve already created in your site) that are automatically added to the cart when the chained coupon’s code is entered.
For example, maybe you have the following coupons chained together in a new coupon with the code of “savebig”:
When the shopper applies the chained coupon code “savebig” to the cart then Coupon 1 and 2 are automatically added to the cart, and WooCommerce checks to ensure that the cart contents matches the coupon requirements based on each coupon’s settings.
To create this type of coupon choose the Chained Coupons type, then select the already-existing coupons to chain together.
New settings allow you set start date and time for when the coupon becomes valid, and the coupon’s expiration date and time, plus you can set the coupon to be valid only on certain days of the week.
These settings effectively allow you to schedule your coupons for use in a diverse manner. For example, maybe you want to create a coupon that is valid between December 1 and December 30 – you can do that. Or maybe you want to make a coupon valid from March 1 until July 31, but only on Fridays. You can do that too. It’s easy with these new date, time, and day settings.
The date / time settings and days of the week settings are self-explanatory.
Just be sure that IF you decide to type in dates / times manually (instead of using the popup date/time picker) that you use the format of YYYY-MM-DD HH:MM – any other format could result in the date/time not being interpreted correctly.
When editing a coupon in WooCommerce you can defined products and/or categories of products that a coupon is valid for. WooCommerce Super Coupons adds two new settings, one for products and one for categories.
This setting is located in the Usage Restriction section.
When the new products setting requires the shopper to have all of the products you’ve configured into the coupon settings to be in the cart before the coupon is considered to be valid. When the new categories setting requires that shopper to have products from all categories defined in the coupon in the cart before the coupon is considered to be valid.
In plain language it gives you the ability to create a coupon where “this coupon is only valid if you’re buying these exact products”
Sometimes you may want to automatically add products to the cart for a promotion or sale. This features let you define any number of products that will be automatically added to the cart when a coupon is applied, and for each product you define you can also set the quantity to be added to the cart and you can set the price of the product if you want it to be different than the product’s regular price. Note that if you set the product price in the coupon’s settings then this price applies to all quantities of that product in the cart regardless of the quantity, as long as the coupon is applied to the cart.
WARNING: If you leave the price field totally empty WooCommerce will not allow the shopper to have that item in the cart!
As an example, maybe you want to run a promotion for your shoppers where they get 10% off 3 specific products if they buy at least 2 of each product. This feature lets you do that – automatically. All the shopper has to do is apply the coupon code to the cart (or maybe click on a coupon link on a Web page or in an email message, which we explain further below) and the products and discounts are automatically added to the cart.
Or maybe you want to offer a free product with a coupon. Choose the product, set the quantity, and define its price as zero – all right in the coupon. You can use the same process to do a “buy one get one free offer” by simply setting the quantity to 2 and setting its price to 50% of its regular price, then adding Usage Requirement settings that make the coupon only valid for that specific product.
This is a great feature that lets you automatically give discounts of any type. With this feature enabled as soon as a shopper adds anything to their cart the coupon is automatically applied instantly. It’s a great way to help ensure the shopper completes their purchase. Who doesn’t love a discount?
This feature gives you control over requiring that the shopper purchases a certain minimum or maximum number of products, and/or that their cart subtotal is a certain minimum or maximum amount.
For example, maybe you want the coupon to only be valid if the cart subtotal is at least 25 but not more than 150. You can do that.
Or maybe you want to ensure that the coupon is valid only if the shopper purchases at least 3 products but not more than 25 products.
You can optionally use the quantities or subtotal requirements, and for either one can set optionally set a minimum or maximum, or both.
If you set a minimum quantity requirement then at least that many items must be in the cart before the coupon is valid. If you define specific products in the Usage Requirements section then the quantity pertains to those products.
If you set a maximum quantity requirement then no more than that many items must be in the cart before the coupon is valid. If you define specific products in the Usage Requirements section then the quantity pertains to those products. If you do not define products in the Usage Requirements section then the total number of items in the cart, regardless of which products are in the cart, cannot exceed the maximum number you set otherwise the coupon is invalid for use.
These powerful order requirement features let you require that a shopper have a certain amount of purchases, or previous purchases of specific products.
For example, maybe you want to offer a coupon that’s only valid for first time customers. No problem, you can do that. Or maybe you want to offer a coupon that’s only valid for shoppers that have previously made 3 other purchases from your store, you can do that too. Or, taking this a bit further, maybe you want to offer a coupon to customers that have purchases one or more other specific products from you in the past.
If you set a value for the Order Count then the coupon will only be valid if the shopper is logged in and their total order count matches your setting.
If you set values for the Previously Purchased products then the coupon will only be valid if the shopper is logged in and the shopper has previously purchased all or any of the defined products, depending on your selected setting.
The users and roles settings let you create coupons that are only valid for specific logged in users and logged in users with specific roles.
If you define users then the coupon is only valid for those users. If you define roles then the coupon is only valid for those roles. If you define both then a match of either one makes the coupon valid.
If you define invalid users and/or roles then these settings totally override the valid users and roles. A match of either one makes the coupon invalid.
This feature lets you restrict the use of a coupon so that it’s only valid if the shopper chooses specific payment gateways or shipping methods. For example maybe you want to create a coupon that is only valid if the shopper choose UPS as their shipping option, or maybe you want it to be valid only if the shopper payment by credit card.
WARNING: This feature creates a condition where the shopper cannot apply the coupon until they are on the checkout page and have already selected their payment gateway and/or shipping method!
For shipping restrictions you can define for example UPS as a whole, but you cannot define specific methods of transport, for example you cannot specify UPS Ground.
The destinations feature lets you configure a coupon so that it is only valid for specific shipping destinations. You can configure these settings by country, state or province, city, and postal codes. And you you can mix match any or all of those destination settings. For example maybe you want a specific coupon to be valid if the shopper’s shipping destination is in the USA. Or maybe you only want the coupon to be valid in a specific city. No problem, you have enough control to do that.
WARNING: This feature creates a condition where the shopper cannot apply the coupon until they are on the checkout page and have already entered their destination – unless the shopper is logged in and has already made a purchase, in which case their shipping information may already be stored in their account. In that case they might be able to enter the coupon code on the cart page. However if they go to checkout and change the destination and it no longer matches the coupon settings then the coupon will be removed from the cart.
These settings allow to you configure a coupon so that when it is applied to the cart then all other coupons are removed from the cart, or you can opt to only remove specific other coupons from the cart. When used this occurs if any coupons are already applied to the cart.
You can also adjust the coupon settings so that the coupon is cannot be used if specific other coupons are applied to the cart. For example, maybe you have a coupon code “ABC” and you don’t want that code to be used if the customer is also using code “EFG”. You can do that.
These features are great for ensuring shoppers aren’t using coupon combinations that you don’t want them to use.
Every coupon you create has a unique URL that can be used to automatically apply the coupon to the cart.
To view the URL or shortcode view the URL & Shortcode section of the coupon’s settings.
You can use the URL in a Web page, email message, or maybe in a post to your favorite social media accounts etc. And every coupon already it’s own unique shortcode that you can embed into a post, or page, or widget etc. – anywhere you can use a shortcode on your site. The shortcode embeds the coupon code which is linked to the coupon’s URL, so clicking on the coupon code triggers the same action as the coupon URL.
The plugin provides a set of additonal lshortcodes beyond the one described above. These can be used to display information about coupons.
There are two classes of shortcodes, conditional shortcodes which display content they enclose based on the validity of one or more coupons, coupon information shortcodes which are used to display the coupon code, description or discount information derived from the coupon settings.
Each shortcode is described below. The shortcodes may allow you to specify one or more coupons.
Make sure to use the correct syntax in each case. Double-check your shortcode and parameters before contacting us for support!
Note: If a coupon is only valid for a specific email address, or specific users, or specific roles, then the coupon will not display unless the shopper is logged in and has the matching email address, user, or role. Note that the email address is matched against the shopper’s billing email address.
This shortcode covers two usage scenarios:
Attributes
code
: (required) One or more coupon codes, separated by comma, or *
to show information for applied coupons.op
: (optional) The operation applied to evaluate the validity, and
(default) as well as or
are accepted. Indicating op="and"
requires all codes to be applied, op="or"
requires at least one to be applied.Example for Scenario A:
[coupon_is_applied code="test"]
This is only displayed if the test coupon is applied to the cart.
[/coupon_is_applied]
Example for Scenario B:
[coupon_is_applied code="*"]
The following discounts have been applied:
[coupon_discount separator="" element_tag="li"]
[/coupon_is_applied]
This shortcode is similar to the previous one, except it will show content conditionally based on whether a coupon or a set of coupons is not currently applied to the cart.
Note that this shortcode does not allow to indicate a *
for the code
attribute.
This shortcode will display the content it encloses only if the specified coupon codes are currently valid, or alternatively, if one of the coupon codes is valid.
A useful application of this shortcode is to increase a customer’s satisfaction, making her or him aware of the discount applied and increasing the chances of a completed checkout.
Example:
[coupon_is_valid code="test"]
This is only displayed if the test coupon is valid.
[/coupon_is_valid]
Attributes
code
: (required) one or more coupon codes, separated by commaop
: (optional) the operation applied to evaluate the validity, and
(default) as well as or
are accepted; and
requires all codes to be valid, or
requires at least one to be validThis shortcode will display the content it encloses if the specified coupon codes are currently not valid. It also can be used to display its contents if one of the codes is not valid.
A useful application of this shortcode is to motivate a customer to add items to the cart to obtain the discounts related to the coupons.
Example:
[coupon_is_not_valid code="test"]
This is displayed if the test coupon is not valid.
[/coupon_is_not_valid]
Attributes
code
: (required) one or more coupon codes, separated by commaop
: (optional) the operation applied to evaluate the validity, and
(default) as well as or
are accepted; and
requires allcodes to be invalid, or
requires at least one to be invalidThis shortcode produces a list of codes that can be used to display information when combined with coupon information shortcodes.
Examples:
[coupon_enumerate code="*"]
[coupon_discount element_tag="div" prefix="code"]
[/coupon_enumerate]
The above example will produce a list of all coupons and show the coupon codes along with their discount information.
[coupon_enumerate code="*" type="percent"]
[coupon_discount element_tag="div" prefix="code"]
[/coupon_enumerate]
The above example will produce a list of percentage discount coupons showing the coupon code along with their discount information.
Attributes
code
: (required) one or more coupon codes, separated by comma, *
can be used for all published couponstype
: (optional) the coupon type (see below)order
: code
(default) or ID
orderby
: ASC
(default) or DESC
Allowed types (for the type
attribute) :
One or more types can be indicated, separated by comma.
The shortcodes below can be used on their own or within the conditional shortcodes above. If used within [coupon_is_valid]
or [coupon_is_not_valid]
, you do not need to specify the coupon codes again as these shortcodes will be aware of the coupon codes that have been used to evaluate the display condition. This can be an advantage depending on the use case and the number of codes specified.
This will display the coupon code(s) as provided through the code
attribute. Rather than using this shortcode on its own, it usually makes more sense to use it within one of the conditional shortcodes, as in that case, you don’t need to specify the code(s) again and can use it to display the coupon code to the customer.
Attributes
code
: one or more coupon codes, separated by comma – only required when used on its own (see above)separator
: characters used to separate several codes, defaults to a spaceThis shortcode displays the description(s) of the coupon code(s) specified, or when used within a conditional shortcode without specifying the code
attribute, for those coupons indicated with the conditional shortcode.
Attributes
code
: one or more coupon codes, separated by comma – only required when used on its own (see above)separator
: characters used to separate several codes, defaults to a spaceelement_tag
: defaults to span
, also allows li
(the ul
will enclose the list), div
and p
prefix
: if code
is indicated for this attribute, the coupon codes will be prefixed to the descriptionsprefix_separator
: defaults to a single space, used when prefix="code"
is indicatedThis shortcode displays information about the discount related to the coupon. This will be displayed for the coupon code(s) specified, or when used within a conditional shortcode without specifying the code
attribute, for those coupons indicated with the conditional shortcode.
Attributes
code
: one or more coupon codes, separated by comma – only required when used on its own (see above)separator
: characters used to separate several codes, defaults to a spaceelement_tag
: defaults to span
, also allows li
(the ul
will enclose the list), div
and p
prefix
: if code
is indicated for this attribute, the coupon codes will be prefixed to the descriptionsprefix_separator
: defaults to a single space, used when prefix="code"
is indicatedstart_date
: display the coupon validity start date if the date is in the future, use start_date="true"
, defaults to “false”
Hot Deals Pro lets you schedule special deals on select products. It works with simple products, variable products, and variations of a product. Grouped products and other product types are not supported.
1. Activate the plugin
2. Create a product category for your “Deal of the Day” products.
3. Navigate to WooCommerce -> Settings -> Integration -> Deals
Check the box to enable the plugin.
If you want your deal-related products to be temporarily put into a specific category then select your Deal of the Day category (or whatever you labeled it as) in the related setting.
Save the settings.
4. Navigate to WooCommerce -> Deals
5. Add a new deal
On the deal editor page you’ll various settings, explained below:
This shows which products are currently linked to the deal
Link Products: This button links products to your deal based on your deal settings.
NOTE: When the Deal Mode is set to “Randomly select any product” or “Randomly select a product from specific categories”, then any products that are already part of any other running deal will not be linked to any other deal . Keep in mind that in this context “running deal” means any deal whose status is set to “Active” and the deal’s start date/time has been reached but the deal’s end date/time has not been reached.
Fill in the required fields, then in the Linked Deal Products section click the Link Products button.
That will link products to the deal so that when the deal status is “Active” and the start date has been reached the products will be automatically put on sale and put into your Deal of the Day category.
When the deal end date is reach, or if you set the deal status to Ended or Inactive, the link products are take off sale, returned to their regular price, and removed from the deal of the day category.
When a deal is triggered into action by itself start time one or products are selected based on the deal settings. The products are put into the Deal Category defined in the main plugin settings.
A product data meta key is set with a value of the deal expiration date. When the date becomes in the past the meta key is removed and the product is removed from the Deal Category.
When a product becomes an activate part of a deal it’s sale price will be set based on your deal rules. When the deal expires the sale price will be removed and the product will be removed from the deal category.
* If you link a one or more variations of a product then the entire product will be displayed on the deals page
[deal_products]
If there is only one product in the deal then the shortcode displays the single product page for that one product. If there are more than one linked product then the shortcode shows a list, like a product category page.
Optional shortcode parameters and their default values:
Shortcode examples:
[deal_products per_page="10" columns="2"]
[deal_products id=1234 inline="true"]
First, navigate to WooCommerce -> Settings -> General and scroll down to the Daily Deals section, adjust the settings to suit your needs.
To create a daily deal product, add a new product or edit an existing product.
In the product’s General settings tab locate and check “Limited deal” checkbox. That will reveal addition settings below the checkbox.
Enter a date start / time of when the sale should start, and an end date / time of when the sale should end.
Optionally enter a URL and button text. These two settings take effect after the sale ends when a shopper views the single product page. The button text replaces the normal “Add to Cart” text, and the URL is used to redirect the user when they click the button.
NOTE: You must set a regular price and sale price for every daily deal product!
To insert the banner manually, either in the product description or any other page on your site use the following shortcode:
[woocommerce_daily_deals_banner]
When inserted into a product page description the shortcode will automatically detect the sale settings for that product. When using the shortcode in other pages on your site should add a parameter of product_id=”XXX″ where XXX is the product ID of the product you want to show a banner for:
[woocommerce_daily_deals_banner product_id="333"]
If you want to display various aspects of a daily deal product, you can use the shortcode below to display the price, or qty, or savings amount, or the date and/or time remaining for the product’s sale. You can also specific a time format when displaying the time. For example:
[woocommerce_daily_deals_info product_id="333" show="price"]
Possible attributes include:
product_id=”123″ Show the specified information for a specific product. Leaving this blank shows it for the current product being viewed
show=”XXX” where XXX is one of the following: price, qty, savings, days, or time
time_format=”%H:%I:%S” This format would show: 04:21:57
To customize the banner layout first copy the banner.php file to your theme directory into a “wc-limited-deals” subdirectory. This way you won’t lose your changes your update the plugin.
For example, copy:
/wp-content/plugins/woocommerce-limited-deals/templates/banner.php
TO:
/wp-content/themes/YOUR-THEME=NAME/wc-limited-deals/banner.php
Then edit the file to suit your needs.
Navigate to WooCommerce -> Settings -> Checkout
Select PayPal Pro.
Adjust the settings to suit your needs.
Enable – Enable the payment method
Title – Enter a title to be shown on the checkout page
Description – Enter a description shown to shoppers when they select this payment method on the checkout page
Test Mode – Enable test mode for testing transactions in the PayPal Sandbox
API Username – PayPal Pro API username
API Password – PayPal Pro API password
API Signature – PayPal Pro API signature
Payment Action – Chose “Capture” or “Authorize”. In capture mode payments are captured into your account immediately. In authorize mode funds are only authorized and not captured immediately. You must capture the funds manually using your PayPal Manager account.
3DSecure – Enable or 3D secure. Only necessary for sites that have a UK-based PayPal account that are accepting Maestro cards.
Send Item Details – Send item details to PayPal during the payment transaction. Disable this feature if you experience payment rounding errors during the payment process.
Soft Descriptor – Optional description shown in user’s account statement, e.g., your site/store name. Limit of 23 characters
Card logos:
Enable the card logos that you want displayed on the checkout page. Note the following card availability and requirements – do not enable card logos for cards that your PayPal account cannot accept as doing so will result in payment processing errors.
Debug Log – Tick checkbox to enable/disable for troubleshooting purposes
When viewing or editing an order you’ll find a Manual Payment form in the right sidebar. You can use this to process pay for an order.
Before you process a payment make sure that you’ve added all desired items to the order, calculated taxes, and entered any shipping amount you want to charge. After doing so update the order and then enter the payment information into the manual payment form. The payment form will automatically detect the order total and when the payment is processed the amount charged will equal the order total.
After you process a payment the payment result will appear below the Process Payment button and an order note will be added reflecting the payment results ( you will not see the new note until you refresh the page ). After payment processing you can then set the order status to whatever status you want the order to have. The payment processing does not automatically change the order status!
If you use shipping zones navigate to WooCommerce -> Settings -> Shipping -> Shipping Zones, add the method to whichever zones you prefer, and configure its settings within the zone.
If you’re not using shipping zones, navigate to WooCommerce -> Settings -> Shipping -> Use My Shipper and configure the settings.
Method Title – Set this whatever you want the shopper to see as the shipping method label on the checkout page
Method availability – This controls which parts of the world the shipping method is valid for.
Field Label – This is the label next to the field where the shopper would enter their shipper account number
Allowed Shippers – A comma separated list of shipper names. For example: Fedex, UPS, DHL. These become options in a dropdown list for the shopper to choose from.
Enable Shipping Note – When enabled an additional note field will appear on the checkout page below the shipping option if the shopper selects the Use My Shipper shipping method
Add to order emails – When enabled, if the customer chose the Use My Shipper shipping method and a shipper, and supplied an account number, then that information appears in the order emails. If the shopper included a shipping note then their note is include in the emails too. This info will appear below the order summary table in the body of the email. There’s no way to get it into the order table itself without you modifying your email templates with your own custom code.
Navigate to WooCommerce -> Settings -> Shipping
It’s a shipping method that you must add to a shipping zone. If you haven’t added any zones then add it to the default zone “Locations not covered by your other locations”, otherwise add it to which zones that you want to make it available in. Then configure the shipping method’s settings within that zone.
On the plugin’s settings page make sure the shipping method is enabled, adjust the title, and adjust the main settings so that the Free Shipping Requires setting is set to “A minimum order amount” or “A minimum order amount OR a coupon”. Also be sure to set a minimum amount, for example 1.
To enable the banner notices on your site set the Display Banner Notice to Enabled and define the text to display to the customers across your store page (main store, category pages, individual product pages). This is the message displayed when the shopper does not have enough items in the cart to meet your free shipping requirements which are based on the settings in the Free Shipping method.
The Free Shipping Notice string appears when the shopper does have enough items in the cart to qualify for free shipping.
That’s all there is to it.
The plugin is very simply to use:
– Install the plugin into WordPress and activate it.
– Edit a user account. In the list of account settings check the box label Tax Exempt to disable charging sales tax for the user.
– Optionally set a Tax ID, this is for you information only and is not required
– Optionally set an expiration date for tax exemption. If you leave this empty then exemption never expires. If you set a date then exemption expires after that date.
When you have more than one type of tax configured your store then you can also optionally set the user to be exempt from specific types of taxes. To do that select the tax types in the Tax Type Exemptions field. Note that this setting is only applied if the user is also set to be tax exempt.
You must have a Fedex account to use this plugin!
Install the plugin to your site and active it.
Navigate to WooCommerce -> Settings -> Shipping -> Fedex
Configure the settings to suit your needs.
Be sure to enter your Fedex credentials ( Account number, Password, Meter number, and API Key ). If you don’t know what these are contact your Fedex representatives for help. The credentials are totally different from your username and password used to login to the Fedex Web site.
MAKE ABSOLUTELY CERTAIN that you set a weight for every product in your store that requires shipping.
If you do not do that then Fedex cannot calculate shipping rates and so shipping might appear to be free.
If you use this plugin for sites that ship very large items that need to be shipped via Fedex Freight be sure to turn on the “Ship Individually” and “Include Dimensions” options otherwise Fedex may not return rates, or may return rates that are too low when people have large items in the cart that need to go via freight.
DO NOT CONTACT IGNITEWOO FOR SUPPORT UNLESS YOU’VE VERIFIED PRODUCT SETTINGS
Make sure that you’ve set your currency and preferred measurements for your store.
Review WooCommerce -> Settings -> General AND WooCommerce -> Settings -> Catalog to review these settings
If you ship heavy items and have Fedex LTL Freight enabled in your Fedex account then you can calculate freight rates using this plugin. Simply enable the freight shipping option in the plugin and fill in the fields for your freight account details – all fields are required.
Note that Fedex only support LTL freight shipments in the United States, Canada, and Mexico. Also note that freight items have maximum dimension limits as follows: Max height = 106 inches ( or equivalent ), max width: 93 inches ( or equivalent ). In theory there is no maximum length limit, however lengths equal to 180 inches ( or equivalent ) or great will incur a surcharge imposed by Fedex.
The plugin supports the typical freight classes as outline by NMFC. To get LTL rates from Fedex you need to assign the correct freight class to products that must be shipping via LTL.
Next, edit your products that ship via freight:
That it’s.
Note that if any items in the shopper’s cart ship via freight then the entire order will be calculated as if all items ship via freight.
Also note that if more than one item in the cart must ship via freight then the largest shipping class will be used for the entire order.
Navigate to WooCommerce -> Settings -> Integration -> Product Fees.
On the page you can set a default fee and global fee rules.
The default fee can be set to be applied Per Product, Per Quantity of Product, Per Order Always, and Per Order Fallback.
Compound Fees – Under the hood in the code, WooCommerce requires that all fees have unique label names. Therefore if you have 2 fees with the same label names then when those fees are applied to the cart WooCommerce would not apply the second fee because both fees have the same labels and WooCommerce sees the second as a duplicate and refuses to apply it. This may not be desirable depending on your needs. When this setting is enabled, the Product Fees & Cart Fees plugin will add together to amounts of fees that have the same label name. In this way the plugin bypasses the limitations imposed by WooCommerce.
Add as many fee rules as you need. All rules are processed for the cart and the fees for all matching rules are applied to the cart.
When creating a rule you can set the mode, the fee label ( see the note regarding Compound Fees to clarity on how to choose fee labels! ), the fee amount, the tax status and tax class, products, and product categories.
If you set a fee and do not choose specific products or categories for the rule then the rule applies to all products.
Global rules are processed one by one in the order seen in the global rule configuration. Product specific rules are checked first, then the global rules are checked. If a product specific fee applies then the global rules will not be processed for that product. See the next section in this documentation for information about product specific rules.
Product categories are checked first during rule processing. If the categories are set and any of the categories match any of the categories for a product in the cart then the rule applies. If not categories match and products are configured for the rule then the rule’s products are checked against the items in the cart. If the products for the rule match a product in the cart then the rule applies.
Product specific rules are fee rules that you define when editing a product in your store. You can override any global fee rules for a given product by editing the product and adding fee rules to the product itself. Edit the product, navigate to the Product Data -> General section, and there you will find the fee settings for the product.
You can define as many cart fee rules as you prefer. When you set cart fee rules they are always applied if the rule’s minimum and maximum range matches the cart subtotal.
Navigate to WooCommerce -> Settings -> Integration, then locate the Tab Control Pro settings section.
Enable:
This controls visibility of your custom tab configurations. Leave this set to Admins & Shop Managers until you’re ready to have the public view your custom tab arrangements – at which point simply change the setting to Everyone and save the settings.
Default Tabs:
The default tabs are the tabs that will be visible for all products on your site unless you override those settings for an individual product by editing the product’s settings.
Choose a tab to add, and note that Description, Additional Information, and Reviews are the default tabs built into WooCommerce. Any 3rd party tabs added by your theme or other plugins will be prefixed with an asterisks.
If you want to add a tab with custom content choose New Empty Tab, then add it, adjust the title, optionally choose an icon, and write the content for the tab.
Global Tabs are tabs are tabs that you can create once and then re-use many times. For example you could create global tabs and add them to your default tabs, or add them to specific products.
You can define tabs that only pertain to specific products if you want to. Edit a product, look in the Product Data section for the Tabs nav, click that to display the tab settings.
Default tabs:
The “Default tabs” setting controls how the product uses the default tabs. You can use only the default tabs, completely override the default tabs with new per-product tabs, or add per-product tabs and merge the default tabs before or after your per-product tabs.
Tabs:
Add a tabs you prefer to the product and save you settings, then view the product page on your site to see the results.
When adding a new empty you gain the use of the WordPress visual editor for styling the text and adding content. You can use shortcodes and media embedding in the same way you can when editing a blog post, a page, or a product description.
Drag and drop tabs to rearrange their order.
You can customize the templates for custom tabs created with Tab Control Pro. Note that we do not provide support for customizations, we simply provide this information as a courtesy to developers and people who are adventurous with PHP coding.
To do that, the templates need to be located in a subdirectory of your theme. For example put the templates in a directory like this:
wp-content/YOUR-THEME/woocommerce/single-product/tabs/
You can make an all-purpose template called tab-content.php
that can be used for all global and custom tabs.
If you want to make a special template for a specific tab use the tab slug ( seen under the table after you edit and save tabs ). The slug is the title converted to lower case with all non-numeric characters removed and the spaces replaced by a dash. For example, if your title is “Warranty Info” then the slug would be “warranty-info” and so the template file name would be warranty-info.php
In your custom template you’ll need to add PHP code. Here’s an example of how to display content for a custom tab created in a product
if ( !empty( $tab['content'] ) ) {
echo apply_filters( "the_content", $tab["content"] );
return;
}
Here’s an example of how to display content for a global tab:
if ( !empty( $tab['pid'] ) ) {
$q = new WP_Query( array( "p"=>$tab["pid"], "post_type"=>"wc_custom_tabs" ) );
if ( $q->have_posts() ) {
while( $q->have_posts() ) {
$q->the_post();
the_content();
}
}
unset( $q );
wp_reset_query();
return;
}
You may now access your phone order / manual order page at the URL for that page. Bookmark it for easy and quick access.
By default, only Administrators and Shop Managers have access to the new order page you created. If you want to allow other users to access the page configure those users, or roles on this plugin’s settings page.
SECURITY: If you site uses SSL for the checkout page, you must examine your checkout settings. Navigate to WooCommerce -> Settings -> Checkout, if you have the “Force secure checkout” setting turned on then turn off the “Force HTTP when leaving the checkout” setting so that you may access your Phone Orders & Manual Orders page using HTTPS.
After you search for a product and select it from the list you will see two button: Add to Order and Customize Product. When click Add to Order the product is placed into the order immediately. When you click Customize Product the actual product page on your site is loaded into a pop up window that appears on your screen. In the pop up you can make whatever selections on the product page that you need to make in order to get the item into the order along with any custom selections that may be present. So for example, if you use our Product Add-on Forms, or Gravity Forms, etc., and need to make custom selections for the product before adding it to the cart then use this method of getting the product into the order. In the pop up, you’ll see your product’s normal “Add to Cart” button, click that to add the product to the cart, after adding the item to the cart close the pop up window and your manual/phone order will be updated.
When you need to add a product to an order that doesn’t exists on your site you can add it as an arbitrary product by clicking the Add Arbitrary Product button. You’ll see a popup window where you must set a title, price, and quantity. Other fields in the popup are optional. When you’ve fill in the fields click the Add to Cart button in the popup window and the item will be added to the cart.
Note that when you do this then a product will be temporarily created in your site and hidden from view so that other shoppers on your site do not see it. The product will be automatically deleted after the order is placed and the order status becomes Processing or Completed, or in one hour after you add the arbitrary product to the order – whichever comes first.
The plugin includes an “Invoice” payment gateway, which is a just a “dummy” gateway that lets you place an order without requiring payment at the time the order is placed. When enabled this payment gateway only appears on your manual/phone orders page. To enable the gateway navigate to WooCommerce -> Settings -> Payment, click the “Phone & Manual Orders – Invoice” item, adjust the settings to suit your needs and then enable the gateway and save the settings.
When you choose this option as the payment method when placing the order you can optionally also choose to automatically send your customer an invoice when the order is placed. When you do that then an email will be sent. The email will either be an order receipt (if the order status is Processing or Completed), or an invoice with a link to pay online if the order status is Pending Payment.
Note that WooCommerce already sends an email receipt when the order status becomes Processing or Completed, so don’t use the option to email an invoice if you’ve configured the payment gateway’s settings to set the order to have one of those two statues.
The plugin includes an shipping cost gateway, which lets you set a custom price for shipping for manual/phone orders. When enabled this payment gateway only appears on your manual/phone orders page. To enable the gateway navigate to WooCommerce -> Settings -> Payment, click the “Phone & Manual Orders” item, adjust the settings to suit your needs and then enable the gateway and save the settings.
Then, on the manual/phone order page in the shipping cost section of the order review area you’ll see the gateway listed with an empty field when you can enter whatever shipping cost you want to assign to the order. When you assign the cost then that cost is added to the order as a shipping option which you can then select before placing the order.
If you ever need to stop managing an order before it’s placed then you can do that easily. The plugin includes an “Hold Order” payment gateway, which is a just a “dummy” gateway that lets you put the order on hold without losing your progress (i.e. items in the cart, selected customer, etc). When enabled this payment gateway only appears on your manual/phone orders page. To enable the gateway navigate to WooCommerce -> Settings -> Payment, click the “Phone & Manual Orders – Hold Order” item, adjust the settings to suit your needs and then enable the gateway and save the settings.
Then, any time you want to place an order on hold simply select the Hold Order payment gateway in the order review section and click the button to place the order. The order will then be stored in the database until you’re ready to complete the order. See the next section “Load Existing or Held Order” for details on how to load a held order.
At the top of the manual/phone order screen you’ll see a box that lets you search for, and load, an existing order. This tool lets you load any order, even orders that were already completed and any orders that you’ve held using the Hold Order process mentioned above.
To use this feature first decide if you want to load an existing order to finish a held order, replace the order entirely, or simply use the order as a “template” of cart contents for a new order. This works via the checkbox labeled “Load and overwrite”, here’s how that works:
Now, in the search field start typing an order number or the name of a customer, or the name of the billing company. You’ll see a list of found results. Select a result to load that order. When the order loads you’ll find that the billing and shipping info are loaded into place, and all the products in the order are now in the manual/phone order cart. You can adjust any of that however you need to, then place the order as you normally do.
That’s all there is to it!
If you need to customize the template files included with the plugin be sure to copy the files before modifying so that you don’t lose your changes when you update the plugin. To copy the files do this:
In the plugin’s directory, locate the “phone-orders” subdirectory and copy it to your theme folder so that you wind up with in subdirectory called “phone-orders”.
Copy:
/wp-content/plugins/woocommerce-manual-phone-orders/phone-orders
to
/wp-content/themes/MY-THEME-NAME/phone-orders
Then you can edit the files. WARNING: When you update the plugin check the changelog to see if there are any template modifications that you might need to carry over into your modified copies.
WooCommerce Free Gifts lets you award shoppers a free gift if their cart subtotal reaches a certain threshold set by you, the store administrator.
Before you begin using it you need to adjust the settings.
Navigate to WooCommerce -> Settings -> Integration -> Free Gifts
Adjust the settings to suit your needs before enabling the feature. Hover over the question mark icons to see an explanation of the settings.
Must be logged in: You can adjust the settings to only offer free gifts to logged in users. When this setting is disabled all shoppers are offered the gift if their cart subtotal is equal to or greater than the minimum cart subtotal amount you define in the settings. When you enable gifts only for logged in users you can optionally give them a gift only once. After they receive the gift they are not offered a gift during future visits to your site. If you enable this feature, and logged in shoppers make a purchase and receive a gift, and you later turn this feature off the shopper WILL NOT be offered a gift in the future – only shoppers that never received a gift will be offered a gift.
Minimum cart subtotal: When the cart subtotal ( the amount before tax and shipping ) is equal to or greater than the amount you define in the settings the shopper will be able to add a free gift to the cart with a cost of $0 – even if you’ve set a price for the product, the shopper gets it free if they choose to add it to the cart.
Gift award method: You can select either select a single product that all shoppers will be offered, or select a product category of products from which the shopper can choose one product.
Gift category or Gift Product: If you choose “Gift from category” then select which category to allow shoppers to choose a gift from. Otherwise select a specific product that they can receive.
NOTE 1: The plugin only works with simple, variable, and grouped products as gifts. IF you select any grouped products as free gifts then all products in the group will be added to the cart if the shopper chooses that grouped product.
NOTE 2: If you don’t want your free gift products to appear in your main shop set their “Visibility” to “Hidden” when editing the product. That setting can be*
found in the area of the “Publish” or “Update” button when editing a product.
Cart item price label: When the shopper opts to add the gift to their shopping cart the cart will display this label in the Price column of the cart contents.
Disable gifts with coupons: You can optionally set the plugin to disallow a gift if ANY coupon is applied to the cart. If a gift is in the cart and shopper applies a coupon then the gift will be removed from the cart automatically.
You can optionally display messages to your shoppers regarding a free gift. Even when you enable both message types only one of these messages will appear at any time, depending on the shopper’s cart subtotal amount. You can disable either or both of them.
Enticement notice: The “enticement” message appears across your entire shop if the shopper’s cart subtotal is NOT equal to or greater than the minimum cart subtotal amount you define in the settings.
Eligible notice: The “eligible” message appears across your entire shop when the shopper’s cart subtotal is equal to or greater than the minimum cart subtotal amount you define in the settings. If the shopper adds the gift to the cart this message is not show.
You can copy the 2 template files from the plugin’s “templates” subdirectory into the root of theme directory in a subdirectory named “ignitewoo-free-gifts”. For example copy
wp-content/plugins/woocommerce-free-gifts/templates/woocommerce-free-gift-select-from-category.php
TO
wp-content/themes/YOUR-THEME-DIRECTORY/ignitewoo-free-gifts/woocommerce-free-gift-select-from-category.php
Then you can edit the files without losing your changes when you update the plugin.
Cart Based Flat Rates lets you define sets of rates. You can choose to calculate rates per item, per shipping class, per order, per the total weight of items in the cart, per the cart subtotal, or the quantity of items in the cart. To adjust the settings navigate to WooCommerce > Settings> Shipping > Cart Based Flat Rates.
The first part of the settings is seen in the image below. You can enable the shipping gateway, set the method title, which is shown to the shopper, set the available geographic areas which the shipping option is available, set the tax status, and set the base cost per order.
The next section lets you configure added costs as seen below.
Added Costs Based On – Determines the calculation method used for the added costs.
When using Per Order, Per Item, or Per Class, the settings look like those in the first screenshot below. In these modes of calculation you define a shipping class for which the rate applies, a cost, and an optional handling fee that can be a fixed amount or percentage amount. A percentage amount for a handling fee is calculated as follows:
Note that if you need help with understanding and using shipping classes refer to the WooCommerce Product Shipping Classes documentation.
When using Cart Subtotal, Item Count, or Item Weight the settings will look as they do in the screeshot below. Notice that the shipping class field is replaced by a field labelled “Total Greater Than or Equal To” field. This field presents the measure by which to compare against based on your selected “Added Costs Based On” setting. So for example, if you select “Cart Subtotal” as your setting then and the value is 11 in the “Total Greater Than or Equal To” field then the settings are interpreted as “This cost applies when the cart subtotal is greater than or equal to 11”.
Note than when using the Cart Subtotal, Item Count, or Item Weigh methods of calculation the handling fee is always calculated based on the subtotal of the cart contents.
For ease of documenting purposes the Minimum Handling Fee is shown in the screenshot below, however it applies to all rate types. This setting lets you define a value that can used to ensure this minimum fee is charged when any applying fees, which is particularly useful when using percentage based fees.
The Additional Options field is not required. When used it lets you add extra rates that are shown to the shopper. Note that these costs are added to the base cost and shown to the shopper as independent shipping options that they can choose from.
Define each additional rate on its own line in the format:
Option Name | Additional Cost | Per-cost type
Option name will be the label shown to the shopper for the shipping cost.
Additional cost will be added to the “cost per order” and any other costs defined in flat rate shipping.
Per-cost type can be set to ‘order’, ‘class’ or ‘item’ and controls how the additional cost is applied. e.g. with an additional cost of 9.99, ‘order’ would apply 9.99 to the entire order, ‘class’ would apply 9.99 multiplied by the number of shipping classes present in the cart, and ‘item’ would apply 9.99 multiplied by the quantity of items in the cart.
For example, if the base rate for this shipping method is 10, and that you have no Added Costs defined, and you configure additional rates as follows:
Priority | 5 | order Express | 10 | order
The following rate options would be shown to shoppers:
In another example lets assume you want to add a cost + percentage for an additional rate labelled “Super Fast”
Flat Rate | 9.95 - 0.2% | order Regular Rate | 9.95 | order Super Fast Rate | 9.95 + 0.2% | order
In this example:
You can enable debug mode to display some information on the cart and checkout page that helps you understand which rates might be applied, and how they might be calculated. You do not need to use this unless you’re having issues configuring your rates.
You can use this plugin in one of two ways, or both:
Create a new coupon, set the type to “Shipping Discount”, “Shipping Discount %” set the amount of the discount, and adjust any of other coupon settings to suit your needs. When the coupon is applied to the cart the associated discount is calculated and applied to each available shipping method.
Navigate to WooCommerce -> Settings -> Shipping -> Flat Fee Shipping. Check the box to enable the shipping method and adjust the settings to suit your needs.
Next, create a coupon, set the coupon type to “Shipping Flat Fee”, and set the coupon amount to be the amount shipping will cost when the coupon is used by the shopper. To be clear, this is not a discount, this is the amount you want the shopper to be charged for flat fee shipping when the coupon is applied to the cart. The plugin reads that amount to know what the flat fee shipping option should cost.
When the coupon is applied to the cart the flat rate shipping method will become available to the shopper and the cost will be whatever you set in the coupon amount.
The plugin supports the following standard WooCommerce coupon settings: discount amount, expiration date, minimum spend amount, maximum spend amount, individual use only, email restrictions, usage limit per coupon, and usage limit per user.