INCOMPATIBILITIES:

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.

Setup and Configuration

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.

General Information About Packaging Rule Sets

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.

Shipping Packages

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.

Rule Types

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:

• Product length
• Product width
• Product height
• Product weight
• Cart subtotal
• Cart quantity
• Cart has coupon
• Cart contains specific products
• Cart contains product category
• Cart contains shipping class
• Customer usernames
• Customer user roles
• Shipping country
• Shipping state, province, or region
• Shipping postal code (for postal codes you can enter ranges and wildcards. For example a range of postcodes (e.g. 90210…99000), or use wildcards (e.g. CB23*)

Package Rules can be any of the following:

• Products
• Length
• Width
• Height
• Weight
• Quantity
• Category
• Shipping class
• Product taxonomy (for example, product brands, vendors, suppliers, etc)
• Stock status
• Price
• Line total
• Post author (the user that published the product)

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.

• Wildcards are supported via using an asterisk.
• Rate name strings are not case sensitive.

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.

 Package Rules:

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.”

 

Activating shipping package rulesets

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.

Cart and Checkout

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.

 

 

Product bundles from WooCommerce.com

If the parent bundled product matches a rule then all items in the bundle are moved to the same package.

Composite products from WooCommerce.com

If the parent composite product matches a rule then all items in the composite are moved to the same package.

Installation

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.

Configuration

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.

 

Installation and Configuration

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.

Usage

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.

 

Installation and Configuration

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.

Orders

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.

Template Customization

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 “templates” subdirectory and copy the files in that subdirectory to your theme folder so that you wind up with in subdirectory called “woocommerce/multiple-address-shipping”.

Copy the files from here:

/wp-content/plugins/woocommerce-shipping-to-multiple-addresses/templates/

to here:

/wp-content/themes/MY-THEME-NAME/woocommerce/multiple-address-shipping/

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.

 

Configuration

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:

• Quantity discounts with markups for specific payment gateways. In this case you will define your quantity discounts and payment gateway markup amounts.
• Quantity discounts only. In this case you only need to configure quantity discounts.
• Payment gateway markups only. In this case you only need to configure payment gateway markups.

Configuring Payment Gateway Markups

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:

• Gateways – select any of the installed payment gateways that this rule pertains to
• Display label – enter text that will be shown to the shopper IF you enable the setting to “Show discount table on product pages.”
• Markup 1 – enter an amount as a percentage or flat amount. For example: 3.4%, or 5. Markup 1 is required.
• Markup 2 – not required – optionally enter a second markup amount as a percentage or flat amount.

Add as many rules as you need.

Configuring Quantity Discount Rules

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.

• Minimum amount – enter the minimum quantity of the product that is required for the rule to match.
• Maximum amount – enter the maximum quantity of the product that is required for the rule to match.
• Discount type – choose the discount type (explained below)
• Discount amount – enter the discount amount (explained below)

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:

• Percentage – enter the percentage to deduct from the product price when the rule matches. Do not include a percent symbol. To give a discount of 2% enter the number 2.
• Flat discount – enter the exact amount to deduct from the product price when the rule matches. For example to give a discount of 1.50 simply enter 1.50.
• Fix price – this discount type lets you change the product directly. For example if the product has a price of 100 you can set the price to 90 when the rule matches by choosing “Fixed price” as the discount type and enter 90 for the amount.

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:

• Activate the plugin on the Plugins page in your WordPress admin area
• Navigate to WooCommerce -> Settings -> Integration -> Product Enquiry, and adjust the setting that determines who can see the enquiry forms. This allows you to test as an administrator without revealing the forms to the public until you’re ready. Remember to adjust the setting again when you’re ready to make the forms live on your site. Be sure to save the settings at least once before proceeding.
• Navigate to WooCommerce -> Enquiry Forms. A “default form” should already exist in the list of available forms. Edit the form to suite your needs, or delete it and add your own forms. Note that you can create as many different forms as you need.
• After creating your forms edit a product and in its settings navigate to Product Data -> Enquiry Forms.
• Note that your default form appears for all products unless you disable the form in specific products. If you want to disable the form check the box “Disable enquiry form”.
• If you’ve created more than one form you can also select which form to show in a product page. Select the form in the drop down list.
• Save the product settings.

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:

• Activate the plugin on the Plugins page of your site.
• Edit a product and navigate to Product Data -> Shipping.
• Note that the default product settings for weight and dimensions serves as your first box so define the weight and dimensions for that first box.
• To add more boxes, look underneath the weights and dimensions setting click “Ship in multiple boxes”.
• Click the “add box” link to add another box.
• Adjust the weight and dimensions for each box that you add.

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.

 

PayPal Payouts

Before you begin with Payouts

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:

 

1. Configure PayPal Settings

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.

2. Configure 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.

 

Monitoring Payouts

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. 

Fees

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.

1. Add a new notification by clicking the button to do so near the top of the page
2. Review the settings and adjust them to suite your needs
3. Save/publish the notification.

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.

 

Getting Started

1.  Navigate to WooCommerce -> Quick Order Forms
2.  Click the Add Quick Order Form button near the top of the screen
3.  Give the form a title. Shoppers will not see this title, it’s for your reference only
4.  Adjust the settings to control what appears on the quick order form
5.  Click the Publish button to save the form
6.  When the form saves and the page reload look in the right sidebar near the top. Copy the shortcode shown in the Shortcode box
7.  Create a new page on your site (via the Pages menu). Paste the shortcode into the page where you want the order form to appear and publish the page.

That’s all there is to it!

 

1. Getting Started

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.

2. Email Notifications

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.

3. Adding Suppliers

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.

4. Adding Suppliers to Products

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 Everything First

Test all of your settings and the entire purchase flow before assigning suppliers to all of your products!

1. Adjust the plugin’s main settings.
2. Adjust the default email notice settings.
3. Create a supplier for testing, and set the supplier’s email address to one of your own.
4. Create a product for testing.
5. Assign your test supplier to the product.
6. Set the product price to 0 (zero) so that it’s free and you don’t have to pay at checkout to conduct a test.
7. Set a weight and dimensions (if your shipping modules expect weights or dimensions).
8. In the top right of the sidebar of the product editor, set the Catalog Visibility to Hidden so the product doesn’t appear in your public shop.
9. Publish the product.
10. Put the product in the cart and go through checkout.
11. View your new order in the admin area of your site to ensure it came in correctly.
12. Make sure the order has the status you set for the order trigger status in the plugin’s main settings.
13. Wait a few minutes so that mail has a chance to flow from your site to your inbox (mail flow time varies depending on your Internet services), then check your email.
14. In your inbox you should find the email notification sent by this plugin.

Importing Inventory Stock Status and Quantity from CSV Files

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:

• Quantity update – when you only import the quantity, then the in/out of stock status is set automatically base on whether the quantity if greater than zero.
• In/out of stock update – when you only import the stock status then only the stock status of the products are set as indicated in the CSV. A column that indicates in-stock (1) or out-of-stock (0) MUST contain a value of 1 or 0. Any other value assumes in-stock
• Quantity and in/out of stock update – when you import stock status and quantity then both settings in your products are set as indicated in the CSV, however if the quantity is less than one then the product is automatically set to being out of stock. If you want to allow backorders of out of stock items then you MUST turn that setting on your products yourself. The import routine will not adjust the backorders setting.

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.

IgniteWoo’s Shipping Extensions

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.

1. Give the product a title. For example: Product Posting Credits.
2. Set the product type to Vendor Post Credits or Vendor Feature Post Credits.
3. Set the price to buy the product
4. Below the price set the Credits Per QTY (quantity).
5. Check the Virtual box since this product is not shipped.
6. Near the top of the right sidebar, edit the Catalog visibility setting and adjust it to hidden so that it does not appear as a product on your site. Even though it is hidden from the overall store it will automatically appear in each vendor’s dashboard under the Credits tab.

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.

Getting Started

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:

Modes of Operation

Store requires logged in user, no custom passwords

• Set the Mode to Enter Store
• Leave the password box empty
• Enable Allow Logged-in Users – OR – Optionally define specific users and/or roles that are allowed access

Store requires custom password

• Set the Mode to Enter Store
• Define one or more passwords
• Optionally enable Allow Logged-in Users if you want existing users to have access without a custom password – OR – Optionally define specific users and/or roles that are allowed access

Store requires logged in user or custom password

• Set the Mode to Enter Store
• Define one or more passwords
• Enable Allow Logged-in Users – OR – Optionally define specific users and/or roles that are allowed access

Protect Specific Categories

• Set the Mode to Selected Categories
• In the Categories section of the settings, select one more more categories to protec
• Optionally enable Allow Logged-in Users if you want existing users to have access without a custom password – OR – Optionally define specific users and/or roles that are allowed access
• Optionally define one or more custom passwords

Menus and Widgets

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

Password Entry Form

Display a password entry form automatically

• Set the Show Password Form setting to Show Form
• Configure the related form settings

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"]

Redirect users

You can optionally redirect users that have not been granted access (not logged in or didn’t enter a password)

• Set the “Show Form or Redirect” setting to Redirect
• Enter a URL of where to redirect the user

 

 

Be sure to read all of the information below carefully so that you have a good understanding of how the software works.

Configuration

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.

General

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.

Endpoints

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.

Commissions

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.

Vendor Registration

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.

Stores

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.

Feedback & Ratings

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.

Pay to Post / Pay to Feature

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.

Product Editing

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:

• Inventory
• Shipping
• Linked Products
• Attributes
• Advanced

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:

• Taxes
• SKU

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:

• Virtual
• Downloadable

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.

Product Display

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

Coupons

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:

• Vendors can only create coupon types of product discount and product percentage discount. NO OTHER COUPON TYPES ARE ALLOWED.
• Due to limitations in WooCommerce itself, vendors cannot set options for free shipping; whether the coupon is applied before or after tax; whether the coupon can be used with other coupons; whether or not the coupon excludes sale items; and whether the coupon requires a minimum cart amount, and included and excluded product categories. IgniteWoo will attempt to address these issues as the WooCommerce coupons API evolves in upcoming versions, but we can make no guarantees one way or the other.
• If a vendor configures a coupon for product discounts and does not set any included products then the coupon is valid for all of the vendors products unless a product in the cart is set in the excluded product settings of the coupon.

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.

Taxes

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:

• Navigate to WooCommerce -> Settings -> Taxes
• Enable the tax setting
• Set the “Calculate Tax Based On” setting to “Customer Shipping Address”
• Set the “hipping Tax Class” to “Shipping tax class based on cart items”

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.

 

Orders

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

Shipping

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.

Packing Slips

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.

Auctions

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.

Payment Processing

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

• PayPal Mass Payment – Automatic. Using this method you can pay your vendors automatically at regular intervals using PayPal Mass Pay. The interval is controlled by your Payment Interval settings

• PayPay Mass Payment – Manual. .Using this method you process payments by exporting a CSV of commissions due and uploading the CSV into your PayPal account’s Mass Pay interface.

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 Mass Pay API Settings

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

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.

REQUIREMENTS

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’

DEFINITIONS

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:

• a single payment for multiple items from different merchants, such as a combination of items in your inventory and items that partners drop ship for you.
• purchases of items related to an event, such as a trip that requires airfare, car rental, and a hotel booking.

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.

LIMITATIONS

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.

PAYPAL DISPUTES

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.

PAYPAL TRANSACTION FEES

When using this plugin each receiver of funds pays their own PayPal transaction fees.

PLUGIN CONFIGURATION

General

• PayPal Email Address – enter your PayPal email address. Any funds collected on your behalf will go into the account associated with this email address
• PayPal User Name – enter your PayPal API User Name
• PayPal Password – enter your PayPal API Password
• PayPal Signature – enter your PayPal API Signature
• PayPal Application ID – enter your PayPal Application ID ( unless you are using sandbox mode in which case no APP ID is required for the plugin to operate correct )
• Invoice Prefix –  Enter a prefix for your invoice numbers. If you use your PayPal account for multiple stores ensure this prefix is unique as PayPal will not allow orders with the same invoice number.

Funds Collection

• Gateway Mode – Select the mode of operation. Parallel Payments lets the shopper each person receiving funds as part of the sale. Chained Payments only shows the store itself as the recipient of funds even when multiple recipients might be receiving a portion of the funds.

• Store’s Amount – Enter the percentage amount of each item you want to receive when a sale takes place. Enter a number only — <em>DO NOT enter a percent symbol. This value can be overridden by setting a different value on a per-product basis</em>. Example: enter 10 for 10%.

Tax Payer

• Who pays any taxes associated with line items in split payments? Set to Store to have the store collect all taxes. Set to Recipients to have each recipient receive the line taxes associated with their items. Note that this setting has no effect if your store is not charging taxes. THIS SETTING DOES NOT APPLY WHEN USING IGNITEWOO’S “VENDOR STORES” PLUGIN BECAUSE THAT PLUGIN HAS ITS OWN TAX PROCESSING SETTINGS.

Global Recipients

• You can optionally set a list of global recipients and associated payment percentage amounts. When you use this setting you do not need to set payment recipients for each individual product. You can however override the global recipient list by editing a specific product and setting payment recipient information in the product itself. And, if you want to omit a product from split payments entirely you can check the associated box when editing the product to exclude the product from split payments, in which case the store would receive the entire amount for the product.

Submission method

• Enable this to post order data to PayPal via a form instead of using a redirect/query string. In practice this makes no significant difference in overall payment flow or shopper experience. This setting is provided simply as a matter of convenience in case it assists developers in customization aspects of the payment process.

Error Message

• PayPal limits all parallel and/or chained payments to a maximum of 6 recipients or less. This is the error message displayed to a shopper when attempting to add an item to the cart where the payment for items in the cart would exceed different 6 payees ( including the store itself ). So in practice, if a shopper has 9 items in the cart and attempts to place 1 more item in the cart, and payment for all of those items would be due to more than 6 people then this plugin will prevent the shopper from adding the item to the cart and display this error message.

PayPal sandbox

• The PayPal sandbox can be used to test payments without any real money changing hands. To do that you need to sign up for a developer account and make sure PayPal enables all Adaptive Payment options in your test account. Note that you do not need to configure the PayPal Application ID in the plugin when using sandbox mode. However you do need to configure a PayPal Application ID when going live.

Debug Log

• This causes the plugin to log PayPal events, such as Pay Key requests, IPN requests, etc inside the wp-content/plugins/woocommerce/logs/ directory in a unique log file that would contain the words “adaptive payments” in the file name. Debug mode also might print debug info on the payment page but only when using lightbox mode ( lightbox mode is an upcoming feature – not yet implemented in this plugin ).

PRODUCT CONFIGURATION

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 enter more than 5 recipients
• If the total percentage for all recipients is greater than 100
• If the percent for any single recipient equates to zero or less

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.

OPERATIONAL BEHAVIOR

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.

GOING LIVE WITH YOUR STORE

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.

Email Messages

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.

Dashboard and Reviews Pages

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 Shipping

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.

Widgets

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.

How to Manually Create and Edit Vendors

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.

WARNINGS

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.

Mass Pay Cron Jobs

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.

Shipping Costs

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.

• Vendor Shipping – included with Vendor Marketplace Pro. Enable this module at WooCommerce -> Settings -> Shipping

• IgniteWoo’s UPS Drop Shipping, and our Fedex Drop Shipping Pro, and our USPS Drop Shipping Pro, and our Table Rate Shipping Pro

Shortcodes

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.

Payment Account Connections:

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.

PayPal Payouts

Before you begin with Payouts

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:

 

1. Configure PayPal Settings

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.

2. Configure 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.

 

Monitoring Payouts

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.

 

Customization

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.

Translators

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.

Payment Gateway Developers

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:

• – gather a list of sellers whose items are in the cart
• – build a list of which sellers can be paid during this checkout transaction, mark any other sellers as unpaid
• – if a seller cannot be paid using the gateway give the sale to the store for payment purposes during this transaction
• – process the payments
• – update the order meta indicating which sellers were paid and which were not

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 ) { 
		....
	}

Global Plugin Settings

Navigate to WooCommerce -> Settings -> Wholesale Pro Suite. There you’ll find a series of sub-tabs for each aspect of the plugin.

Settings Tab

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.

Roles Tab

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 Tab

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.

Qty Discount Rules Tab

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.

Min/Max Quantities Tab

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.

Registration Tab

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.

Quick Order Forms

1.  Navigate to WooCommerce -> Quick Order Forms
2.  Click the Add Quick Order Form button near the top of the screen
3.  Give the form a title. Shoppers will not see this title, it’s for your reference only
4.  Adjust the settings to control what appears on the quick order form
5.  Click the Publish button to save the form
6.  When the form saves and the page reload look in the right sidebar near the top. Copy the shortcode shown in the Shortcode box
7.  Create a new page on your site (via the Pages menu). Paste the shortcode into the page where you want the order form to appear and publish the page.

That’s all there is to it!

 

Shortcodes For Hiding and Showing Content

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.

 

Template Customization

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/”

 

 

 

Documentation

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.

Shipping Coupons

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.

For shipping discounts:

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.

For flat fee shipping by using a coupon:

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

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”:

• Coupon #1: Minimum spend of $100 to get a 10% discount
• Coupon #2: 10% all shoes

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.

Starting Date/Time, Expiry Date/Time, and Valid Days of the Week

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.

Require All Products and Require All Categories

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”

Automatically Add Products to the Cart

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.

Automatically Apply Coupon to Cart

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?

Minimum and Maximum Quantities and Subtotals

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.

Order Requirements

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.

Users and Roles

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.

Payment Gateways and Shipping Gateways

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.

Destinations

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.

Remove Other Coupons & Invalid with Other Coupons

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.

Apply Coupons via URL or Shortcode

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.

Additional Shortcodes

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.

[coupon_is_applied]

This shortcode covers two usage scenarios:

• Scenario A – Show content conditionally based on whether certain coupons have been applied to the cart.
• Scenario B – Show coupon information for applied coupons.

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]

[coupon_is_not_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.

[coupon_is_valid]

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 comma
• op : (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 valid

[coupon_is_not_valid]

This 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 comma
• op : (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 invalid

[coupon_enumerate]

This 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 coupons
• type : (optional) the coupon type (see below)
• order : code (default) or ID
• orderby : ASC (default) or DESC

Allowed types (for the type attribute) :

• Specific coupon types: fixed_cart, percent, fixed_product, percent_product, sign_up_fee, sign_up_fee_percent, recurring_fee, recurring_percent
• Coupon type sets: cart, fixed, percent, product, recurring, sign_up, subscription

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.

[coupon_code]

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 space

[coupon_description]

This 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 space
• element_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 descriptions
• prefix_separator : defaults to a single space, used when prefix="code" is indicated

[coupon_discount]

This 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 space
• element_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 descriptions
• prefix_separator : defaults to a single space, used when prefix="code" is indicated
• start_date: display the coupon validity start date if the date is in the future, use start_date="true", defaults to “false”

 

 

 

 

Description

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.

Configuration

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:

• Title: A title for the deal, for your reference only. Shoppers do not see this.
• Deal Description: A description for the deal, for your reference only. Shoppers do not see this.
• Deal Status: The controls whether the deal is active. The status must be set to Active for the deal to activate on its start date. The deal is automatically set to Ended when the end date is reached. You may at any time stop the deal by setting the status to Inactive or Ended. When the deal is stopped ( either by you setting the status to Inactive or Ended, or when the deal end date is reached ) the products linked to the deal removed from the deal of the day category and their sale price is removed from their respective settings.

Deal Settings

• Deal Mode: Determines how you want to link products to the deal.  Important: 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.
• Number of Products: The number of products to link to the deal
• Relink Days: Only available when the Deal Mode is “Randomly select any product” or “Randomly select a product from specific categories”. If you set any weekdays in this setting then existing linked products are removed from the deal and X number new products are linked to the deal on each occurence of that weekday while the deal is active and the end date has not been reached. In this scenario X is controlled by the “Number of products” setting.
• Starts: Date and time when the deal should start
• Ends: Date and time when the deal should end
• Price Adjustment Type: This controls how you want to calculate the linked product’s sale price.
• Percentage off regular price: The product’s price is lowered by a percentage of the regular price. For example, if the regular price is 100 and your discount amount is set to 25, then the product’s sale price becomes 75
• Amount off regular price: The product’s price is lowered by the amount you set. For example, if the regular price is 200 and your discount amount is set to 60, then the product’s sale price becomes 140.
• Set price manually: The product’s sale price becomes the amount your set.
• Amount: The amount of the discount. This should correspond with your Price Adjustment Type. When using “Percentage off regular price” you can include a percent symbol if you want to, but it is not required.

Linked Deal Products:

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.

Variable Products:

* If you link a one or more variations of a product then the entire product will be displayed on the deals page

Shortcodes

[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:

• ‘id’ ( a specific deal ID number  )
• ‘inline’ = false ( display products inline even if there is only one product in the deal – useful when embedding a deal into a the body of a page or post, etc.
• ‘per_page’=12, ( how many products to display per page when a deal has many products)
• ‘columns’=4, (how many columns to display per page when a deal has many products)
• ‘orderby’=’title’, (order the list of products by title or ID)
• ‘order’=’asc’, (show products in ascending or descending order based on the “orderby” parameter

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!

Shortcodes

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

• price – shows the product’s regular price
• qty – displays the quantity purchased so far
• savings – displays the savings amount as a percentage, where the savings is the calculated between the regular price and sale price
• days – displays the days remaining before the sale ends
• time – displays the time remaining before the sale ends

time_format=”%H:%I:%S” This format would show: 04:21:57

CUSTOMIZATION

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.

 

 

 

Configuration

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.

• US: Visa, MasterCard, Discover, American Express
• Canada: Visa, MasterCard
• UK: Visa, MasterCard, Solo, Maestro/Switch (requires the use of 3D Secure)

Debug Log – Tick checkbox to enable/disable for troubleshooting purposes

Processing Manual Payments

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.

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.

 

 

 

Configuration

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.

• API Settings – Your API access details are obtained from the FedEx website. After signup for an account, get a developer key. After testing, get a production key.
  • FedEx Account Number * – Provided by FedEx after signup. More info at: Open a FedEx Account.
  • Fedex Meter Number * – Provided by FedEx after signup.
  • Web Services Key * – Provided by FedEx after signup.
  • Web Services Password * – Provided by FedEx after signup.
  • Production Key * – Tick this box according to type of account (developer or production).

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

LTL Freight

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.

1. If you’re using WooCommerce 2.6 or newer navigate to WooCommerce -> Settings -> Shipping -> Shipping Classes, otherwise for older versions of WooCommerce navigate to Products -> Shipping Classes
2. Add a new class and enter a name that makes sense to you
3. In the Freight Class setting choose the correct freight class
4. Save the shipping class, and repeat for as many classes as you need to cover all of your products that ship via freight

Next, edit your products that ship via freight:

1. Edit the product
2. Navigate to the Product Data -> Shipping section
3. Choose the correct shipping class for the product
4. Save the product

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.

 

Global Plugin Settings

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.

• Per Product – in this mode the default fee will be applied when no other fee rules match the products in the cart, the fee is applied once per product in the cart. If the fee is a flat amount then the fee is calculated as (Quantity x Fee) for each item in the cart. If the fee is a percentage the fee is calculated as (Product Price x Fee ) x Quantity for each item in the cart.
• Per Quantity of Product – in this mode the default fee will be applied when no other fee rules match the products in the cart, the fee is applied once per quantity of each product in the cart. For example, if some is buying a quantity of 10 of “Product A” then the fee will be multiplied by 10.
• Per Order Always – in this mode the plugin will always apply the default fee, even if fee rules add other fees
• Per Order Fallback – in this mode the plugin will apply the default fee when no other fee rules match the items in the cart

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.

Product Fee Rules

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 Product Fee Rule Processing

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.

Note that the “Roles” setting for a given fee rule controls which user roles that fee will apply to. When set the fee only applies to logged in user with any of the selected roles. When not set (the field is empty) then the fee applies to all shoppers if the other rule settings match.

Overriding Global Product Fee Rules with Product Specific Rules

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.

Global Cart Fee Rules

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.

 

Video Overview

Settings

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

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.

Per-Product Tabs

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.

Operational Notes

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.

Customizing Tab Content Templates

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;
	}

 

Plugin Configuration

1. Install the plugin and activate it. Then navigate to WooCommerce -> Settings -> Integration and look for the Phone Orders & Manual Orders section.
2. Copy the shortcode that you see under the page selection setting.  Leave that page open, then open a new tab to create a new page in WordPress. Title the page whatever you like and paste the shortcode into the content area of the page, then publish the page.
3. Return to this plugin’s settings area, refresh the page to reload the list of available pages on your site. Now select the page you just created, then save the settings.

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.

The “Configure Product” Button

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.

Adding Arbitrary Products to an Order

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.

“Invoice” Payment Gateway

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.

Custom Shipping Price Gateway

The plugin includes an shipping cost gateway, which lets you set a custom price for shipping for manual/phone orders. When enabled this shipping gateway only appears on your manual/phone orders page. To enable the gateway navigate to WooCommerce -> Settings -> Shipping, 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.

Hold Order In Progress

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.

Load Existing Order or 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:

• When the checkbox is checked the selected order will be loaded, its status will be immediately set to ‘Pending Payment’, and when you submit the order the existing order will be permanently and completely overwritten!  This cannot be undone! Make sure this is your intention before choosing this option!
  
• When the box is not checked the order will be loaded as-is, you can alter the contents, billing, and shipping info as you see fit, and you click the button to place the order a new order will be created. This is a great way to use existing orders as a “template” for new orders.

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!

Form Field Customizations

There are 3 filters that allow a developer to add or remove billing, shipping, and order meta fields for the form:

ignitewoo_manual_phone_orders_billing_fields
ignitewoo_manual_phone_orders_shipping_fields
ignitewoo_manual_phone_orders_orders_fields

Template Customization

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.

Loading The Form via API Request

This section is for developers that want to integrate ordering form access into a 3rd party platform such as a customer relationship management (CRM) platform.

WARNING: We strongly suggest that your site be running with HTTPS (SSL).

The API returns the URL to the ordering page, or an error message.

API Endpoint URL:

https://localhost.example/wp-json/wc-ignitewoo-order-form/v3/populute-order-form

Parameters:

• user: required
• pass: required
• customer: optional (assign a specific customer to the order, customer must have a WordPress user account, send customer ID number or email address)
• product_ids: optional (product IDs to insert into the order; comma separated)
• product_skus: optional (product SKUs to insert into the order; comma separated)

Note that you can use HTTP GET or POST methods.

Example HTTP GET request:

https://localhost.example/wp-json/wc-ignitewoo-order-form/v3/populute-order-form?user=salesperson&pass=test123&product_ids=101,123,2345&product_skus=adsf,2345234&customer=test@test.dev

Example error message:

{"result":"REST API ERROR","message":"Invalid authorized user data"}

Example success message contains the URL to the ordering page after customer has been assigned (if provided) and products have been added (if provided). This is URL is for the ordering page as configured in the plugin’s main settings.

{ "result": "success"; "message": "https://localhost.example/order-page" }

 

 

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.

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.

Customization

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.

• Enable/Disable – Check the box to enable Flat Rates.
• Method Title – Give the method a title – this is what the customer will see when selecting a shipping method.
• Method availability – Define ‘All allowed countries’ or ‘specific countries’ to limit where Flat Rates is offered.
• Tax Status – Define whether tax is applied to the shipping amount or not.
• Base Cost Per Order – The base cost is essentially the minimum cost quoted to the shopper by this shipping module. All other shipping costs defined in the other cost definition areas ( explained further below ) are added to the base cost.

 

ADDED COSTS

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:

• Per Order – calculated against the subtotal amount of the cart
• Per Item – calculated against the price of the product
• Per Class – calculated against the cost assigned to the shipping class as defined in the added cost

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.

 

Additional Options

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:

1. Flat rate – 10
2. Priority – 15
3. Express – 20

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:

• The ‘Flat Rate’ is going to add 9.95 minus .2% to the entire order.
• The ‘Regular Rate’ will add 9.95 to the base flat rate shipping.
• The ‘Super Fast Rate’ will add $9.95 plus 0.2% to the entire order.

Debug Mode

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:

For shipping discounts:

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.

For flat fee shipping by using a coupon:

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.

Other coupon options

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.