Wholesale Suite 文件

How To Import Wholesale Prices And Other Wholesale Data Into Your WooCommerce Store

Whether you』re moving your products to another site or just want to bulk edit the wholesale prices, it』s important to know the correct way of importing wholesale data with your products in the CSV file.
You have multiple options for importing as there are many tools on the market for it.
In this article, we will cover two ways:

Importing using the built-in WooCommerce CSV import/export tool
Importing using the popular WP All Import plugin

Importing using built-in WooCommerce Product import/export tool
In WooCommerce version v3.1, they introduced the Product Import/Export tool, which you can use to download and upload your product CSV file with wholesale data.
We recommend doing the following steps:
1. Create one or two products and set the Regular Price and Wholesale Price. If you』re using WooCommerce Wholesale Prices Premium, you can apply more features such as Minimum Order Quantity, Minimum Order Step and etc. Doing this will generate the custom meta fields when you export the Product CSV.

Apply Wholesale Prices on Product Settings (Click to Zoom)

2. Afterwards, go to Products > All Products, at the top part, click the Export button. Make sure to check the Export Custom Meta before clicking Generate CSV.

WooCommerce Export Tool (Click to Zoom)

3. Once the download is completed, open the CSV file and you should find the wholesale price meta key that should be named like this: wholesale_customer_wholesale_price
4. Edit the CSV by adding the wholesale prices, and other wholesale data to your products and then save your file.
5. Import your CSV file back using WooCommerce Product Import tool. You』ll notice that our custom meta keys are already set as Import as Meta. Just click the Run Importer

WooCommerce Import Tool (Click to Zoom)

Wholesale Suite Data Import as Meta (Click to Zoom)

6. After the upload is complete, your wholesale prices should now be applied to the products on your site. 

Subscribe to Wholesale Suite

Importing using WP All Import
You can also import the wholesale data by using WP All Import with their WooCommerce Add-On Pro. We suggest reading their documentation first on how to import WooCommerce products here.
1. Go to WP All Import Dashboard, whether you like to add new items or update existing ones, and select the option for WooCommerce Products

WP All Import Dashboard (Click to Zoom)

2. Continue to Step 3  and out the necessary data for the fields (Title, WooCommerce fields), then on the Custom Fields, click See Detected Fields.

WP All Import Custom Fields (Click to Zoom)

3. It should auto-detect the available custom fields and you should find our custom meta keys like wholesale_customer_wholesale_price. You』ll notice that it will have a value by default. Remove the value and replace it by dragging the title key from the upper right box to the field value instead.

WP All Import Custom Fields and Values (Click to Zoom)

4. Continue to step 4 and click the Auto-detect for the Unique Identifier. Select the necessary settings before you continue.

WP All Import Unique Identifier (Click to Zoom)

5. Proceed until you finish the import process. The wholesale data should now be applied to your Products.
Importing Product Quantity Based Wholesale Pricing
Our Quantity Based Wholesale Pricing metadata is saved as serialized data in the database. Previously, it was not possible to import/export this data in the product CSV when using the WooCommerce Product Import/Export Tool. But as of WooCommerce Wholesale Prices Premium version 1.17, you can now export user-friendly readable data that you can edit and import back to your Product page.
The two important meta keys to remember are Meta: wwpp_post_meta_enable_quantity_discount_rule and Meta: wwpp_post_meta_quantity_discount_rule_mapping.
The value of the first meta key should be set to yes if you want to enable quantity-based wholesale pricing.
The second meta key determines the values of the quantity discount pricing for that product.
For example, if I have this quantity based discounts in a product:

The corresponding value in your CSV for meta:wwpp_post_meta_quantity_discount_rule_mapping, should be:
[{「wholesale_role」:」wholesale_customer」,」start_qty」:」2″,」end_qty」:」10″,」price_type」:」fixed-price」,」wholesale_price」:」50″},{「wholesale_role」:」wholesale_customer」,」start_qty」:」11″,」end_qty」:」20″,」price_type」:」fixed-price」,」wholesale_price」:」40″},{「wholesale_role」:」wholesale_customer」,」start_qty」:」21″,」end_qty」:」」,」price_type」:」fixed-price」,」wholesale_price」:」30″}]
Based on this format, you can easily edit and copy this to your other products to apply the Quantity based wholesale pricing during your import.

Subscribe to Wholesale Suite

Note
In case you』re having visibility issues after importing, we recommend to visit this guide.

How to Enable The Order Form Beta?

We are building a more efficient  WooCommerce Wholesale Order Form v2.0 powered by React JS with exciting new features and improvements such as making it much more lightweight to boost the speed and allowing you to customize the style easily from the backend using a drag and drop interface. 
This order form v2.0 beta is available for early access. If what you need isn』t too complicated or you just simply can』t wait to check it out, feel free to try it!
Kindly note that we don』t recommend using it for production environments yet.  Some integrations and features may be incomplete or not working to the same standard as the current stable form. 
How To Enable The Order Form v2.0 Beta
In this step-by-step guide, we will show you how to easily enable the order form v2.0 beta. 
1. Generate WooCommerce API Key
The new form relies on the WooCommerce API. In order to use the API, the order form will need its own API access key. 
You can generate one from
Copy the key and secret and go to WooCommerce ➝ Settings ➝ Wholesale Ordering tab ➝ Beta in the submenu, and paste them in.

Next, click 「Auto Generate」 and it』ll generate the WooCommerce API Key automatically for you.

2.  Enable Beta Access
Click the 「Enable React JS Order Form」 checkbox to enable the form v2.0 beta.

3. Create Your New Form
In the order form v1.0, you could only have one form. In the new order form v2.0, you will be able to have multiple forms and each form has its own shortcode that you can place onto a page​​.
To create a new form, simply go to WooCommerce ➝ Wholesale Order Forms ➝ hit the 「Add Form」 button.
This 「Wholesale Order Forms」 page will show the list of  all order forms you have created. You can see the shortcodes, where the form is located and the status whether it』s been published or not.

There are three main sections on the  form:

Order Form Header
Order Form Table
Order Form Footer

For the header and footer, you can add sections and determine how many columns you want on each section. You can then drag elements into those sections.
There is only one section for the product listing table. You can drag the elements from the right over to the table and arrange the rows how you like.

If you click on the settings button (a pencil icon) of an element as you wave over it, you will be able to see configuration and styling options on the right side.
Once you are happy with your form, click the 「Publish」 button on the top. This will generate the order form』s shortcode.

Copy and paste the shortcode onto a page to show the order form on the front end of your site.

Current Scope & Limitations
Things we』ve worked on already and are considered working:

Form layout and display – products can show including variable products (each variation is shown individually or in a dropdown).
Speed – it』s lightning-fast and we』re aiming to keep it that way.
Multiple order forms – you can have more than one form in the system now
Each form has a shortcode that can be placed anywhere to show a custom order form
Element level configuration & styling – we』re working on improving this but you can alter the behavior of individual elements on your form

Things that still need attention:

It』s mostly integrated with WooCommerce Wholesale Prices Premium, but there are still some smaller features we』re yet to tackle.
No third-party plugin integrations (e.g. WPML)  as yet but we』re working on it.
Improvements to element level styling
Improvements to settings placement for elements

Found a bug in the v2.0 beta form? Report it to us 🙂
We』re more than happy to assist anymore in trying our new order form and are very grateful for any feedback you have for us.
As mentioned this is a beta feature so there』s bound to be a couple of bugs (though we are testing thoroughly as we go!).
If you need assistance in setting up your order form or find a bug, please send a message to our support including the steps you have figured out to reproduce the issue. It would also be helpful if we could get a copy of your WooCommerce Status report along with it.

Issue Updating: Plugin doesn』t meet minimum requirements error

Sometimes when we roll out new features we need to release an update to both the free WooCommerce Wholesale Prices plugin and the WooCommerce Wholesale Prices Premium plugin. They need to be updated at the same time.
If your website hasn』t pinged our server to check for updates of the WooCommerce Wholesale Prices Premium plugin yet and you have already updated the free plugin you may see a notice in your Dashboard like:
「Important Notice: We have detected an outdated version of WooCommerce Wholesale Prices Premium. You require at least version [version number] for this version of WooCommerce Wholesale Prices ([version number]). Please update now.」
To solve this notice, you just need to update WooCommerce Wholesale Prices Premium.
You can access the latest version of your plugins by logging into your account. You』ll find a link to the My Account page under the Download tab. Please download it then you could upload it manually to your website using FTP.
If you have WordPress 5.5 and above, you can upload the new plugin zip file by going to:
1. Plugins > Installed Plugins
2. Click Add New button
3. Click the Upload Plugin button
4. Click Choose File and navigate to your ZIP file
5. Click Install Now
If you are still having issues, please reach out to support here, noting what you have tried already, and we will happily assist you.

Is There A Changelog For Wholesale Suite plugins?

We publish a detailed changelog on every release for every one of our plugins.
Here are the changelog links:

WooCommerce Wholesale Prices (Free Version) Changelog
WooCommerce Wholesale Prices Premium Changelog
WooCommerce Wholesale Order Form Changelog
WooCommerce Wholesale Lead Capture Changelog

The changelog pages also show compatibility details about which versions of WooCommerce and WordPress we are compatible up to.
Usually, that is the latest version as we do regression testing with our plugins prior to the official WooCommerce and WordPress release using their beta and release candidates.
Even though we might not always push compatibility updates for each WordPress or WooCommerce release (because often it』s not needed) you can be assured that we』re always compatible with the latest versions of both.
If you are ever in doubt, we invite you to get in touch with our friendly support team to double check.

How To Enable Account Upgrade Request For A Regular Customer

Allowing an existing regular customer to upgrade their account to a wholesale customer was one of the most frequently asked features we received. In WooCommerce Wholesale Lead Capture 1.15, we finally introduced a new feature to allow this account upgrade request for a regular customer to become a wholesale customer.
Please go to WooCommerce > Settings > Wholesale Lead > General > then enable the Account Upgrade option.

Account Upgrade option in Wholesale Lead setting

When you have enabled this option, there』ll be a notice in the Dashboard section of a retail customer』s account page. This notice is customizable in the Wholesale Lead setting under the Upgrade Message option.

Account upgrade message for a regular customer

If the regular customer clicks the request an account upgrade link they』ll get redirected to the wholesale customer registration page with an Upgrade Account Request detail.

Wholesale Registration page – Upgrade Account Request

If you enabled the Automatic Approval option, their request will be automatically approved and they』ll get the wholesale customer role. If you enabled the Manual Approval Required, you can review their application first before to approve or reject their request.
When waiting for your approval, there』ll be a notice in the Dashboard section of their account page. Then, if you have approved them, they』ll see a notice as well that their account request has been approved. They』ll be able to get the wholesale price when browsing your shop.

Account is pending for approval notice

Account upgrade request has been approved notice

How to translate Wholesale Suite plugins

If you have a non-English site and you want to translate our Wholesale Suite plugins to a different language, our plugins are translation-ready and you can easily translate them with the help of this guide.
There are different ways to translate WordPress plugins and listed below are the recommended ways on how to do it.

Use of WPML plugins (paid plugin)
Use of free third-party translation plugin (preferably Loco Translate)
Use of PoEdit (software translation tool)

1. WPML
WPML is a paid plugin that allows your WordPress site to be fully multilingual. You can translate WordPress pages, posts, plugins, and other WooCommerce-related strings when used with other WPML』s add-ons.

Getting Started Guide

In translating the Wholesale Suite plugins, it is required to install these 4 WPML plugins:

WooCommerce Multilingual
WPML Multilingual CMS
WPML String Translation
WPML Translation Management

Steps:

On your Dashboard, go to WPML > String Translation
On the 「Select strings within domain」, select the Wholesale Suite plugin you want to translate.
You can use the 「Search for」 option to easily locate the string you want to add the translation.
Add the Translation and make sure that the code format remains similar to the original.
Check the Translation is complete and click Save.

2. Loco Translate

Loco Translate

Loco Translate is a free WordPress plugin that you can download and install to your Plugins page. Once installed, you can easily translate the strings from our plugin to the language you want.
Steps:

On your Dashboard, go to Loco Translate > Plugin and find the Wholesale Suite plugin you want to translate.
Choose the language and location where you want to save the translation file.
Find the string you want to translate and its translation.
Then hit the Save button.

Step 1: Loco Translate > Plugin and choose a Wholesale Suite plugin

Step 2: Choose the language and language location.

Step 3: Find the string you want to translate and add the translation

For more information on how to use Loco Translate, please check their beginner』s guide here.

3. PoEdit
PoEdit is a translation tool that you can use to translate PO files and you can use this editor to translate strings of our Wholesale Suite plugins.
Steps:
1. Download and install PoEdit on your computer.
2. After installing, get the pot file of the plugin you want to translate.
In the image below, let』s say we want to translate strings from the WooCommerce Wholesale Prices Premium. You can get the pot file on the plugin folder of your site, then on /woocommerce-wholesale-prices-premium/languages/

3. Open the pot file using PoEdit and create the translation. You can use the search feature to easily locate strings.

4. After adding the translated string, please make sure that the coding format is retained. Once satisfied with the translation, click Save As and it is important that the file is named correctly.
There is a naming convention when saving Pot files to Po and Mo files. It should have the original name and followed by the suffix of the translated language.
In the example below, I』m translating the original English string to the Spanish language so I need to use es_ES suffix.

5. After saving, the Mo and Po translation file should be generated and you can upload it to your site using FTP and place it inside the same language folder of the translated Pot file.

Additional Notes:
WordPress has a repository of translated plugins by the contributors for the free plugin. You can search our WooCommerce Wholesale Prices plugin if there』s a contributor that started a project to translate our plugin. You can check plugin projects here: https://translate.wordpress.org/

How To Send User Information To Zapier On Approval

Zapier is a very powerful tool that acts as the agent in between API』s. If you haven』t heard of it, and you are in need of shifting data around from one place to another, definitely check it out.
This guide is an advanced guide and I』m assuming you have knowledge of PHP coding and how APIs and Webhooks work.
With that out of the way, we recently had a case where we had to send the user the wholesale customer』s email and name to a special wholesale mailing list in Campaign Monitor on approval. This is a task that is very well suited to Zapier because it has integrations already with all the major email marketing platforms.
The only part missing was the ability to get the data out of WordPress and over to Zapier, we chose to do this with a simple webhook POST.
In Zapier you can set up a webhook to collect data, I』ll leave the explanation of this part to them:

https://zapier.com/zapbook/webhook/
https://zapier.com/blog/how-use-zapier-webhooks/

What we』re interested in is how to send the data over to Zapier and here is a code snippet of how to do it when a new wholesale user is approved:

function wwlcSendWebhook( $user ) {
$url = 'https://zapier.com/hooks/catch/XXXXXXXX'; // replace this with your Zapier provided webhook URL

$args = array(
'method' => 'POST',
'body' => array(
'first_name' => $user->user_firstname,
'last_name' => $user->user_lastname,
'email_address' => $user->user_email,
)
);

wp_remote_post( $url, $args );
}

add_action( 'wwlc_action_after_approve_user', 'wwlcSendWebhook', 10, 1 );

Add the above code to your functions.php and it will send the user』s data to the defined Zapier webhook URL whenever a wholesale customer user is Approved.

How to Show Wholesale Price to Non-Wholesale Users?

One of the methods to get more wholesale customers to register on your website is to show them what benefits they could get. You could create a list of these benefits or show them how much savings they could get as a wholesale customer.
In WooCommerce Wholesale Prices 1.15, we introduced a new feature that lets you show the wholesale price for non-wholesale customers. You can find this option in WooCommerce > Settings > Wholesale Prices > Prices, then tick the 「Show Wholesale Price to non-wholesale users」 option.

Show Wholesale Prices to Non-Wholesale Price Setting

Show Wholesale Prices to Non-Wholesale Price Setting – All Options Unlocked

If checked, it will display the wholesale price on the front end to entice non-wholesale customers to register as wholesale customers. This is only shown for guests, customers, administrators, and shop managers.
You can set to show this option in the Archive and Single Product page. If you have the WooCommerce Wholesale Order Form installed and activated on your website, you can display this option on the wholesale ordering form page.
If you have the WooCommerce Wholesale Prices Premium installed and activated on your website, you can select which wholesale roles you』d like to show for the guest users.
If you have the WooCommerce Wholesale Lead Capture installed and activated on your website, you can add a 「register text」 link to the wholesale prices box on the front end. It will help you capture even more wholesale leads.

Show Wholesale Prices to Non-Wholesale Price Setting in the Single Product Page

Ps. Please keep in mind that non-wholesale users will still get the retail price. This feature only shows the wholesale price they can get if they are registered as one.

How to Make A Wholesale Only Coupon

If you have been using the WooCommerce Wholesale Prices Premium for a while, you might be familiar with the Disable Coupons For Wholesale Users feature which disables the coupons functionality for customers with a wholesale user role.
However, there may be some instances when you want to give your wholesale customers extra discounts and this is where the coupons would come in handy.  
Restricting a coupon to specific user roles is super easy with the Advanced Coupons For WooCommerce plugin. Here is how to do it:

Install and activate the Advanced Coupons For WooCommerce Free plugin from here.

Make sure you have enabled the use of coupons from WooCommerce > Settings > General tab > tick the checkbox of the Enable the use of coupon codes option

Create a new coupon from Coupons > Add New

From the Coupon data box, click the Role Restriction tab and tick the box to enable the role restrictions

For the Type, choose Allowed then select which wholesale user roles can use this coupon

Advanced Coupons for WooCommerce』s Role Restriction Setting

Now, you can test this coupon and check if only users with the selected user roles can use it.
On the other hand, if you do not want wholesale customers to use this coupon, choose Disallowed for the Role Restriction Type and select which user roles are not allowed to use this coupon.
This feature is also great for testing your coupons before sharing them with your customers. Simply restrict the coupon to the Administrator user role then test the coupon to make sure it works as expected.
If you need to set certain cart conditions, create a BOGO Deal or give an automatically added free product, you are going to love the Advanced Coupons For WooCommerce Premium! It has tons of features that enable you to be flexible when creating coupons.

How to Renew Your License?

Remembering to renew important business-critical software is actually a big problem that can cost businesses a lot of money. When your license is expired, you』ll no longer get updates that often include feature improvement, security fixes, and bug fixes. Our team spends a lot of time on this kind of work so we can ensure our products are safe and compatible with the latest version of WordPress and WooCommerce.
You』ll be automatically renewed each year on the anniversary of your purchase. But, we do send you a reminder email about 2 weeks before this happens.
The good thing is you can cancel the automatic renewal at any time from your account page before the renewal date to ensure you don』t get automatically charged and if you wish you can re-activate your renewal in case you want to start the renewals again from the 「Subscriptions」 tab on your account page.
On the Subscriptions tab, tick the box to select which license you would like to renew then click the 「Renew Now」 button.
Subscription tab on My Account Page
All plans automatically renew yearly at a regular price using the payment method you provided at the time of purchase. The renewal price will depend on which products you purchased originally.
You can see all the details about your existing subscription under My Account ➝ Subscriptions on our website or click the link here https://wholesalesuiteplugin.com/my-account/subscriptions
If you have any troubles accessing your account, try resetting your password, and if that fails please contact support.