Have you any kind of doubt?
WooCommerce B2B Sales Agents is very simple to use, but some doubts could but you may have some doubts, it's normal. For this reason, we have collected the requests made most often by our customers to provide all new users with answers to their doubts quickly and easily.
Here most popular questions, take a look.
You can download from your Envato account the zip file that contains both the plugin and the documentation, also available online:
https://woocommerce-b2b.com/sales-agents/documentation/
in which all features are described in detail, with examples, screenshots, hooks.
WooCommerce B2B Sales Agents is designed and developed to be compatible with all WooCommerce themes. WooCommerce B2B Sales Agents uses all the standards and best practices provided by WordPress and WooCommerce (general WordPress/WooCommerce hooks that all themes should use), to ensure complete compatibility with all third-party assets that use the same standards.
Compatibility is excellent, WooCommerce B2B Sales Agents actually work fine with any theme, below is a list of the mayor themes already tested and used by our users:
- Tested with wide range of themes
- Compatible with top WooCommerce Envato themes: Flatsome, Woodmart, Porto, Avada, Betheme, Enfold, Xstore, Uncode and much more
- Compatible with WooThemes themes: Storefront and much more
- Working out-of-the-box with 99% themes out there: Divi, Astra, OceanWP, Generatepress, Shoptimizer and much more
By installing WooCommerce B2B Sales Agents through the admin section of WordPress (“Plugins” page), you may receive the error:
“The uploaded file is not a compatible plugin”
This means that the file you downloaded is not the correct one.
In your Envato account, in fact, you have the possibility to download two types of ZIP archives by clicking on the “Download” button:
– All files & documentation: the ZIP file contains both the plugin and the documentation related files
– Installable WordPress file only: the ZIP file contains only the installable plugin
To install WooCommerce B2B Sales Agents directly from the WordPress “Plugins” page, simply use the second file type (“Installable WordPress file only”).
WooCommerce B2B Sales Agents provides multiple features that, depending on the different combinations, can give life to different scenarios and contexts, according to your specific needs.
To get to know the options and how each of them works, I suggest you take a look at documentation, where you can find descriptions, examples and screenshots.
For a todo list of the minimum steps to follow to start using WooCommerce B2B Sales Agents take a look at the “Quick start” section in the documentation:
When an update is available, you will receive a notification email and you will be able to download and install the new version. Since v1.0.7, you will receive plugin updates notification directly in your WordPress plugins page. You can update in several ways:
To install new release, simply download it from your Envato account, then go to WordPress backend page:
Plugins > Add new
Click on “Upload plugin” button and browse your folders to select WooCommerce B2B Sales Agents downloaded archive file.
To install new release, simply download it from your Envato account, unzip the archive file and copy the entire folder:
wp-content/plugins/woocommerce-b2b-sales-agents/
with the new one by using an FTP client (such as FileZilla).
If you prefer to automate this process and receive notification directly in the backend of your WordPress, you can install the free third party “WP Envato Market” plugin available on GitHub (https://github.com/envato/wp-envato-market).
## Important! ##
In some cases (depending on the release) you may get the message:
“WooCommerce B2B Sales Agents database update required. Before to update, please be sure to have a database recovery backup”
To update the database simply click on the “Update WooCommerce B2B Sales Agents database” button. This operation is necessary for the correct functioning of the plugin and the updating of data.
NB: To know more, please take a look to Documentation
Keep calm and do not panic!
The first thing to do is enable WordPress debug mode, as described in Debugging in WordPress guide.
The general best practice for dealing with a malfunction is to narrow down to understand the cause or source, often the cause is not where you think!
It is common practice in WordPress to disable all plugins and use a basic theme, re-enabling one plugin at a time and carrying out a new test once enabled until the problem occurs again.
This way, you will be able to narrow down the context that causes the problem and tackle debugging in a faster and more limited way.
Before opening a support ticket, make sure you have narrowed down the possible source of the problem so you can contact the right support team.
If with these tests you have ensured that the problem is caused by WooCommerce B2B Sales Agents, please open a ticket to our Support Center, our team will be pleased to help you to resolve your doubts!
By default the plugin delete all its data if you uninstall it. Alternatively, you can always deactivate the plugin without loosing data.
In the admin page, under WooCommerce `Settings` menu, in `Sales agents` tab.
Our team does not provide custom development on demand, but we are happy to recommend the best freelance Marketplace in the world!
On Fiverr, you can find the professional that best suits your needs:
WooCommerce B2B Sales Agents is already provided in two languages: English and Italian. All plugin strings have been localized using the GNU gettex framework to make it completely “translation ready”, so it can be easly translated in the same way that other WordPress plugins.
WooCommerce B2B Sales Agents is also compatible with WPML, the most famous translation WordPress plugin. Take a look here to get a guide.
Take a look to language packs provided by our awesome users: Translations.
In the included documentation you’ll find a simple guide to translate WooCommerce B2B Sales Agents in the language of your choice.
Yes, since 1.4.0 version, WooCommerce B2B Sales Agents introduced full compatibility with WooCommerce HPOS (High-Performance Order Storage), previously knowed as COT (Custom Order Tables).
WooCommerce B2B Sales Agents extends default WooCommerce import/export tools. So, simply go to:
Products > All Products
and click on the “Import” or “Export” button near the page title.
Notice: to export WooCommerce B2B Sales Agents data, please check “Yes, export all custom meta”.
WooCommerce B2B Sales Agents allows you to enter commissions as a percentage, but you can easily get around this.
Consider that the sales agent commissions for each product can be bulk updated through WooCommerce’s default Import / Export tools, with a CSV file.
Then, it is possible to calculate the percentage starting from the product price and flat commission you want directly with Excel, for example, and upload the file to update the commissions as percentage.
In example:
Product price: 80
Desired commission amount: 5
Calculate commission percentage: Commission amount / Product price × 100 = 5 / 80 * 100 = 6.25%
Yes, from the page you set up as sales agents “Dashboard”. When a user registers from this page, he is automatically detected as a sales agent.
If you have enabled “Moderate registration” option from WooCommerce B2B Sales Agents settings page, sales agent account will not be active until administrator approval.
Since version 1.3.2, WooCommerce B2B Sales Agents allow you to select desired roles to consider as sales agent (or customer) in plugin settings page. You can know more about this hook by reading documentation, in Settings page section.
Since version 1.0.5, WooCommerce B2B Sales Agents allow you to use its features on other roles except sales agents, by using the proper hook “wcb2bsa_has_role_sales_agent” (or “wcb2bsa_has_role_customer” to extend customer features). You can know more about this hook by reading documentation, in Plugin Hooks section.
If you want, you can also work around the problem by using the free plugin Multiple-roles, with which you can assign your custom role to users who already have the customer role and use both of them.
Notice: Multiple roles is a third part plugin, then Code4Life is not responsible of problems or malfunctions resulting from its use
WooCommerce B2B Sales Agents allows you to create a multi-level network of sales agents (pyramidal system).
Looking from the bottom up, each user with the “Sales agent” role can have a sales agent who acts as a manager, who in turn can have another manager and so on.
Looking from the top down, each sales agent can then have one or more sub-sales agents.
Each sales agent can have a commission % and a sub-commission %.
Commission % is applied to orders made by a direct customer of the agent.
Sub-commission % is applied to orders made by a customer of one of your sub-agents.
The sub-commission is calculated starting from the primary (or previous) commission, upward.
NB: This is because in hierarchical commission systems you could also have multiple levels, but if all the subcommissions were calculated starting from the total amount, you would end up even exceeding the order amount! In this way, however, your profit margin is always preserved.
When a customer places an order, the primary commission is calculated based on the % commission of the referring direct agent. Then, going up the hierarchy, the sub-commission of each sales agent manager is calculated and subtracted from the primary commission.
Let’s take an example:
Sales-1
- Manager: none
- Commission %: 10
- Sub-commission %: 3
Sales-2
- Manager: Sales-1
- Commission %: 5
- Sub-commission %: 1
Sales-3
- Manager: Sales-2
- Commission %: 8
Customer-1
Assigned to Sales-1
Customer-2
Assigned to Sales-2
Customer-3
Assigned to Sales-3
————————————————–
Case 1: Customer-1 make an order
Totale order: 100
Total primary commission: 10% = 100 * 10 / 100 = 10 (is calculated using the commission % of direct sales agent for customer – Sales-1 in this case)
Sales-1 commission: 10
Sales-2 commission: 0 (because he is lower in the hierarchy than Sales-1, who manages Customer-1)
Sales-3 commission: 0 (because he is lower in the hierarchy than Sales-1, who manages Customer-1)
Case 2: Customer-2 make an order
Total order: 100
Total primary commission: 5% = 100 * 5 / 100 = 5 (is calculated using the commission % of direct sales agent for customer – Sales-2 in this case)
Sales-1 commission: 3% = 5 * 3 / 100 = 0,15
Sales-2 commission: 5 – 0,15 = 4,85 (because part of the commission is distributed in the form of sub-commissions at higher levels)
Sales-3 commission: 0 (because he is lower in the hierarchy than Sales-2, who manages Customer-2)
Case 3: Customer-3 make an order
Total order: 100
Total primary commission: 8% = 100 * 8 / 100 = 8 (is calculated using the commission % of direct sales agent for customer – Sales-3 in this case)
Sales-2 commission: 1% = 8 * 1 / 100 = 0,08
Sales-1 commission: 3% = 0,08 * 3 / 100 = 0,0024
Sales-3 commission: 8 – 0,08 – 0,0024 = 7,9176 (because part of the commission is distributed in the form of sub-commissions at higher levels)
Of course, you can add all levels you desire to scalate your network.
To fix 404 error, simply go to WooCommerce B2B Sales Agents settings page and click on `Save` button.
Then, from main WordPress admin menu go to:
Settings > Permalinks >
and click on `Save changes` button.
In the admin page, under `Users` menu.
Before of all, you need to enable this capability. To do this, simply go to WooCommerce B2B Sales Agents settings page and enable `New customers` option. Now, your sales agents can add customers in their own area, clicking on `Add new customer` in customers list page.
Yes, by choosing “Allow to choose” in “Default sales agent” option, a new field will be added to checkout page. In this way, customers can choose their desired sales agent among those available. If customer is logged in and already has a sales agent assigned, no field will be added.
Simply go to:
Products
and edit your desired product. In `Commissions` tab, you can find your sales agents list and give a different commission to each of them for this product. You can bulk update your products by using WooCommerce default Import/Export tools.
Simply, go to single order page, edit single item row (product, shipping cost, fees) and input your desired commission for this row.
In the sales agents area, from the customer list, click “Details” for the desired customer and click on the “Make purchase as customer” button.
A sales agent can change the data of a customer by switching on his account, by clicking on the “Make an order for this customer” button, in sales agent area, in customer details page.
In this way, the sales agent takes possession of the customer account and can operate independently, including modifying personal data and addresses.
Simply go to:
WooCommerce B2B Sales Agents > Notifications
then click on `Add new` in top left of the page (near title). In notification edit page, on right sidebar, you can choose all sales agents you want to read the notification.
From the WooCommerce B2B Sales Agents settings page, simply uncheck the widgets or charts you prefer not to display in your sales agents’ dashboard.
Edit files in an upgrade-safe way using overrides. Copy the template into a directory within your theme named /sales-agents/ keeping the same file structure but removing the /templates/ subdirectory.
Example: To override the dashboard, copy:
wp-content/plugins/woocommerce-sales-agents/templates/myaccount/dashboard.php
to:
wp-content/themes/{YOUR_ACTIVE_THEME}/sales-agents/myaccount/dashboard.php
The copied file will now override the WooCommerce B2B Sales Agents default template file.
No, WooCommerce B2B Sales Agents can be installed and used without WooCommerce B2B.
Yes, when WooCommerce B2B is installed and active, in the backend sales agent profile modification page, you will find the “B2B DEFAULT GROUP FOR NEW CUSTOMERS” option. Here you can choose from the groups created with WooCommerce B2B the one you want to be the default for this sales agent. This way, when a sales agent registers a customer, they will automatically be assigned to this group.
Since version 1.2.1, notification and commissions pages in WP-ADMIN are under `Users`.