How to include costs of goods in a commission page

WooCommerce Costs of Goods is a plugin that allows adding the production costs to each product.

Thanks to the integration between the two plugins, you can decide to include this cost in the commissions due to the vendor.

To do it, go to YITH Plugins -> Multi Vendor -> Commissions and enable the entry Cost of goods handling.

Cost of Goods handling

To show the production costs on the detail page of the commission, enable the Show Cost of goods information entry.

Show cost of goods

How to customize plugin templates

In order to override plugin files, you just have to create into the folder WooCommerce of your theme the same tree structure you find in the plugin.
Let’s say, for example, that you want to override the file vendor-list.php, that is in the folder templates > widgets in the plugin.

Template file

Copy the file you want to edit from plugin folder (in this case vendor-list.php in templates > widgets). Then, go to folder WooCommerce of your theme and create exactly the same path you find in the plugin (starting after “templates”) for that file.
So, in this case, you have to create the folder widgets and paste template file into this folder. Then, paste the copied file into this path.

Paste file in woococommerce folder

Integrations

All the plugins listed in the “Add-Ons” section are not included in YITH WooCommerce Multi Vendor.
In order to take advantage of a specific integration, you need to purchase and activate the premium version of the related plugin.

Auctions

With YITH WooCommerce Auctions you are able to offer your vendors an auction system. Vendors will be able to create ‘auction’ type products and can  manage:

  • price
  • backup price
  • required amount for a rise
  • auction length
  • a chance to automatically schedule the next auction for each product

Badge management

Enable badge management for vendors
By enabling the field “Enable badge management for vendors” each shop vendor can create badges to apply to his/her products.
Badge management - Vendor side
For all information about the plugin, you can refer to documentation.

Account Funds

The integration with YITH Account Funds allows you to issue vendors’ payouts into their digital wallet, by simply crediting the amount in their account funds. Please, refer to this page for more information.

Booking

YITH WooCommerce Booking allows an advanced management of a booking system for the products of your shop. Once you have configured the prices, services and availability, the plugin will automatically manage the product depending on the user choice.

Let’s analyze the details related to this integration.

After activating both plugins, go to Booking -> Integrations and enable the integration with Multi Vendor.

Enable integrations with Multi Vendor

Now, each vendor can create and sell Booking products.

Each vendor can have access only to the bookings registered for his/her product.

We suggest reading the plugin official documentation to learn about all the features available in YITH WooCommerce Booking.

The vendors can create and manage services and people differently from the super admin.

Services

The vendors can’t view nor use the services created by the super admin.

The vendors can apply the services they have created to their own products only.  

Services creation by vendor

Different vendors can create a service with the same name.

The super admin has access to the complete list of all the services created in the shop.  For each service, the name of the vendor who has created it will be highlighted.

Show vendor for service

People

The vendors can’t create new people types for their Booking products. They can use only those made available by the super admin.

People services

Bulk product editing

To enable the integration between the two plugins, it is essential to activate the add-on in Multi Vendor -> Add-Ons.

Enable Bulk Product Editing add-on

The integration allows the vendors of the shop to edit their own products in a massive way by using the features of YITH WooCommerce Bulk Product Editing.

Bulk Product Editing - Vendor side

Catalog mode

The plugin is 100% integrated with YITH WooCommerce Catalog Mode.
The integration allows vendors of the shop to configure catalog functionalities for their own products.
If you enabled both plugins, the first step is to enable their integration from “Add-ons” section of YITH WooCommerce Multi Vendor settings dashboard.

Enable Catalog Mode

At this point, a new dedicated section will be added right inside each vendor’s reserved area.

Vendor admin

On products not owned by the administrator, count the catalog settings configured by the vendor, except if in the plugin (YITH WooCommerce Catalog Mode) “Admin Override” field has been globally enabled.

Admin override

In this case, settings configured by the administrator will prevail on those configured by the vendor.
If you want this behavior to be valid for all vendors, except for a limited selection, click on “Do not apply to vendors in the “Vendor Exclusion List” (Exclusion)” field.

Catalog Mode options

Vendor exclusion list

If, on the contrary, you want shop administrator’s settings to overwrite only those of vendors included in the list, enable“Apply only to vendors in the “Vendor Exclusion List” (Reverse Exclusion)” field.

Read the official documentation of YITH WooCommerce Catalog Mode for further information about the plugin.

Composite Products

You only have to activate both plugins to enable the option for admin and vendors to add ‘Composite’ type products. You can add and edit the composite products from the product editing page.

composite mv settings

For more information on how to add a composite product, check the full documentation here.

With this integration you can allow vendors to offer “composite” products in their stores, by creating and configuring components that will only be visible for their products.

Coupon email system

Coupon Email System for vendors

Integration between YITH WooCommerce Multi Vendor and YITH WooCommerce Coupon Email System allows vendors to set up an automatic sending of customized coupons when certain conditions happen.
Administration side, you can select to make certain events available to vendors in YIT Plugins -> Coupon Email System -> Vendor Settings.

Select events for vendors

Vendors will have “Coupon Email System” section where they could set up coupons based on the events selected by the site administrator.

Coupon configuration - Vendor side

Coupons sent by a vendor can be used only for those products related to him/her.

For complete information about YITH WooCommerce Coupon Email System plugin, please refer to the documentation.

Custom Order Status

With YITH WooCommerce Custom Order Status you can create custom statuses which you can then assign to orders in your shop. You may also edit the default WooCommerce ones.

You will only have to activate both plugins, in order to make them work together. If you want your vendors to mangage their orders, and with them the orders statuses as wel, you will have to “Enable order management”  on the Multi Vendor settings page.

Enable order managment order status

Custom statuses created by general admins can than be assigned by the vendor to any order.

vendor email order

The integration will also let you add the ‘vendor’ to the email recipients, a notification email will be send when the order status changes.

Composite Products

YITH Composite Products for WooCommerce lets you create products made of several components, allowing users to choose the components they are interested in straight from the product page

You only have to activate both plugins to enable the option for admin and vendors to add ‘Composite’ type products. You can add and edit the composite products from the product editing page.

composite

For more information on how to add a composite product, check the full documentation here.

With this integration you can allow vendors to offer “composite” products in their stores, by creating and configuring components that will only be visible for their products. Like the example below for the Medina Store.

mv composite

Desktop Notifications

YITH Desktop Notifications for WooCommerce enables notifications on the desktop every time an action related to the shop is recorded on the site.

In combination with YITH WooCommerce Multi Vendor, you can enable desktop notifications for the orders related to the vendors. Notifications can be enabled when:

  • a new order has been created
  • the order turns into a specific status.

After installing and activating both plugins, you can set the above-mentioned notifications for vendors by selecting Vendor in the Role notification option.

vendor_notifications

For the complete information about YITH Desktop Notifications for WooCommerce,  please refer to the documentation.

Frontend Manager

Thanks to the integration with YITH Frontend Manager for WooCommerce, you can allow to all vendor of your shop to access to the “frontend dashboard”.

Instead of managing orders and products from WordPress dashboard, also the vendors can manage their shop from the site frontend.

Vendor frontend dashboard

From the plugin settings dashboard, you can select to which sections vendors can have access.

Enable sections for vendors

In addition to the default WooCommerce sections, you can also enable “Vendor settings” section to allow users to manage all the settings related to their vendor profiles.

Vendor settings

Live chat

Integration with YITH Live Chat allows enabling a chat system for each vendor so that he/she can be contacted by his/her own customers directly through the form in vendor’s page.

Chat form

When the option is enabled, each vendor can have access to “YITH Live Chat” section in his/her reserved area and reply to messages sent by users.

User reserved area

For information about how to use YITH Live Chat, refer to guide.

Membership

Enable membership for vendors

When the field is enabled, each vendor can create/view/edit/remove and sell memberships containing his/her own products.

Membership area - Vendor side

The admin is the only one who can edit the Membership plugin general settings and to associate membership plans to users manually.

Moreover, in any membership plan, the admin will be able to activate an option that limits the number of products that each vendor can publish. Associating the same plan to a certain group of vendors will let you have different “types” of vendors.

integration-multi-vendor-membership

For all information about how to create and organize a new membership, you can refer to the following documentation of YITH WooCommerce Membership.

Name your price

Enable 'Name your price' for vendors

If you enable the highlighted field in the image, plugin “YITH WoOCommerce Name Your Price” feature settings can be customized by vendors for their own products.
Each vendor can create customized price rules for product categories or for single products of the shop.

'Name your price' management - Vensor side

For complete information about YITH WooCommerce Name Your Price plugin, please refer to the documentation.

Order tracking

Using YITH WooCommerce Multi Vendor combined with YITH WooCommerce Order Tracking adds the chance for each vendor to enter the tracking details on each order they can access from the admin area.

'Order tracking' management - Vendor side

Vendors can select for their orders one of the couriers that global admins have set from YITH WooCommerce Order Tracking settings panel.

Vendors can select for their orders one of the couriers that global aadmins have set from YITH WooCommerce Order Tracking settings panel.

Shop admins can enter the tracking details only if the order includes products that aren’t associated with other vendors.
This data will then only be about a specific order bound to the admin and not any other sub-orders bound to vendors.

Main Order

For complete information about YITH WooCommerce Order Tracking plugin, please refer to documentation..

PDF Invoice and Shipping list

YITH WooCommerce Multi Vendor is totally integrated with YITH WooCommerce PDF Invoice and Shipping List.
Compatibility provides for the site administrator to enable the separated management of invoices for vendors. The option must be enabled in “Add-ons” section of Multi Vendor settings dashboard.

Enable PDF Invoice for vendors

PDF Invoice settings - Vendor side

When the plugin is used in combination with YITH WooCommerce Multi Vendor, the automatic generation of invoices will be disabled. The only way to create a new document, invoice or shipping document, is manually through the specific buttons you find in “WooCommerce -> Orders” or in order detail page.

User side, documents can be downloaded in “My Account -> Orders”. Administrator and/or vendor related to the order must generate the document to allow the user to have access to it. A different document is provided for each vendor in relation to products they own.

For further information about PDF Invoice behavior, read the official plugin documentation.

Product add-ons

The plugin is 100% integrated with YITH WooCommerce Product Add-ons.
The integration between the two plugins allows, in a multistore shop, vendors to create advanced options groups for their products.

If you have installed and activated the two plugins, go to “Add-ons” section of YITH WooCommerce Multi Vendor settings dashboard and enable YITH WooCommerce Advanced Product Options functionalities for all vendors.

Add-Ons - Multi Vendor panel options

At this point, all vendors will have the possibility to create options groups directly in their own administration area.

Advanced product options - Vendor side

Each vendor can create global, category or single product options groups.
All options groups created by vendors won’t show on products that don’t belong to them.

Options groups of global typology are added by default to all involved products (both for groups created by site administrator
and by the vendor).
However, vendors can change this behavior for any of their products:
By enabling “Disable globals”, from product editing page, global typology options will be removed
from the related product.

Disable globals - Vendor side

Product size charts

Enable Product Size Charts for vendors

This option allows enabling product size chart for vendors registered to the site.

For complete information about the plugin, please refer to the documentation.

Request a quote

YITH WooCommerce Request a Quote allows all users to request the quote for one or more products of the shop. Thanks to its integration with Multi Vendor, the request will be forwarded to the owner of the product. The global administrator will receive the request only for products not related to any vendor.
To enable the quote management from vendor side, activate “Enable request a quote for vendors” field that you find right inside “Add-Ons” section of the plugin settings dashboard

Enable request a quote for vendors

Vendor side orders management must be enabled as an essential condition. Every new request will be available from “Orders” section, both vendor side and administrator side. The vendor will be able to add products to the quote (from backend). If the vendor adds or removes products from the quote the commission will be recalculated.

Admin side

Manage quote - Admin side

Vendor side

Manage quote - Vendor side

For complete details about the use of YITH WooCommerce Request a Quote plugin, we suggest you read the official documentation.

Review for discounts

Enable Review for Discounts for vendors

When this option is enabled, vendors can customize the content of emails generated by the plugin, if the related product belongs to them

Review for discounts – Vendor sidReview for discounts - Vendor side

For complete information about YITH WooCommerce Review for Discounts plugin, please refer to the documentation.

Role based prices

With YITH WooCommerce Role Based Prices. you could allow the vendors of your shop to create price rules for the user role, which will be applied only to products they own.

From “Add-ons” section in settings dashboard of YITH WooCommerce Multi Vendor, enable the plugin functionalities, so that vendors can have access, in the administration area, to the dedicated section to create price rules.

Enable plugin for vendors

Global vendor rule settings

All general rules created by site global administrator won’t cause any effect on products related to a vendor.
For further information about the plugin YITH WooCommerce Role Based Prices, read the official documentation.

Sms notifications

The integration with YITH WooCommerce Sms Notifications allows the vendors to receive SMS notifications related to the orders of the products they own.
Go to Multi Vendor -> Add-ons and enable “Enable SMS Notifications for vendors” to activate the integration between the two plugins.

Enable SMS Notifications add-on

Now, the “Sms Notifications” section is enabled vendor side.

Vendor side

Within this section the vendor can:

  • insert one or more telephone numbers to which forward the SMS notifications of the orders related to his/her products
  • choose the order statuses to receive the SMS notifications
The global shop administrator is the only one who can configure the settings for the SMS sending to the users.

Stripe Connect

For the integration with Stripe Connect, please, refer to this page.

Subscription

Enable subscription for vendors

By enabling this field, each vendor can create and organize subscription plans for his/her products.

Product page

By accessing “Subscription” section, the vendor can refer to the list of subscriptions registered by the system.

Section 'Subscription'

For complete information about “YITH WooCommerce Subscription” you can consult the documentation of the plugin.

Surveys

Enable surveys for vendors

By enabling the highlighted option in the image, vendors can create one or more surveys to display on their own product page.

Surveys management - Vendor side

For complete information about YITH WooCommerce Surveys plugin, please refer to the documentation.

Waiting list

Enable Waiting List for vendors

When this option is enabled, vendors can organize their products waiting list and send emails to users who want to be updated when the product is available again.

Waiting list - Vendor side

For complete information about YITH WooCommerce Waiting List plugin, please refer to the  documentation.

How to create a vendors menu

The plugin supports the possibility to use each vendor as menu field. This allows you to create a new WordPress menu including the list of vendors you have selected.

Click on WordPress “Appearance -> Menus”. Create a new menu or select one already available in which you want to insert the list of vendors.

Select menu

Now enable, in case it isn’t, “Vendors” field that you find in “Screen options”.

Screen options -> Vendors

Now select and insert the vendors within your menu.

Select vendors

Here is an example of menu that includes the list of vendors of the site.

Vendors menu

How to create a sidebar for vendor page with YITH theme (framework 1.0)

Select the Sidebar entry that you can find in Theme name tab, write the name off the sidebar you want to create, and click on the “Add” button.

Sidebar creation

Once created the sidebar, go to the Widget section of the theme to add the widgets you want to show in the detail page of the vendor.

Widget selection

To assign a sidebar you have created, go to the settings, choose where you want to place the sidebar and use the dropdown menu to choose the vendor’s page.

Vendor's page example

How to create a sidebar for vendor page with YITH theme (framework 2.0)

Click on the “YIT Sidebar” entry that you can find in the YIT Plugins section, write the name of the sidebar you want to create and click on the “Add” button.

YIT Sidebar

Once created the sidebar, go to the “Widgets” section of the theme to add the widgets you want to show in the detail page of the vendor.

Add widgets

To integrate the sidebar you have created, click on Layouts and scroll the page to the Vendor entry.

Integrate sidebar

If you want to apply this configuration to the detail page of all vendors click on “Vendor”, otherwise select one of the vendors that you want to configure. In our example, we use the general configuration for all the vendors.

Vendor

Now go to the “Layout” section in the option list. Choose the position where you want to show the sidebar in the page and select the name of the created sidebar for the detail page of the vendor in our “Vendor Page”.

Select sidebar

Shortcodes

Vendors list

Add the shortcode “[yith_wcmv_list]” to the editor of your page to show the complete list of your vendors in the pages of your site.
Shortcode attributes:

  • “per_page”: it lets you activate the paging by selecting how many vendors you want to display. (es. per_page=2) (Default: -1).
  • ”hide_no_products_vendor”: hide the vendors without products (Default: false).
  • ”show_description”: add the vendor description for each vendor (Default: false).
  • ‘description_lenght”: number of characters for description (if enabled) (Default: 40).
  • “vendor_image”: [store/gravatar] allows selecting the image type to combine to vendor’s profile, choosing from the default one of the plugin (store) or the gravatar connected to vendor’s email address (gravatar). (Default: store).
  • “order_by”: [name/slug/description] defines the parameter for vendors organization within the list. Note: for this arg, the allowed values are ‘name’, ‘slug’, ‘term_group’, ‘term_id’, ‘id’, ‘description’. (Default: name).
  • “order”: [asc/desc] ascending or descending order. Allowed value: ASC or DSC (Default: ASC).
  • “include”: it allows adding the ID of the vendor(s) you want to show (separated by comma).

01_001

Become a vendor

The shortcode [yith_wcmv_become_a_vendor] allows adding the registration form to become a vendor.

Shortcode

To allow your users to become vendors, make sure to select the page where you inserted the shortcode in “Become a vendor” field from the plugin settings dashboard in the “Frontpage” section.

Products by vendor ID

The shortcode [yith_wcmv_vendor_products vendor_id=XX] allows showing products by vendor ID.

Please note – it works only with WooCommerce 3.2.X or higher.

The shortcode arguments are the following:

Available Product Attributes

The following attributes are available to be used in combination with the [yith_wcmv_vendor_products] shortcode. They are split into sections for a primary function to make the navigation easy. Here are some examples:
Display Product Attributes
  • limit -> The number of products to show. Defaults: -1. With the value -1, it shows all products.
  • columns –> The number of columns to show. Defaults: 4.
  • paginate –> Toggles pagination on. To be used in combination with limit. Defaults: false. Set to true to paginate.
  • orderby –> Sorts the products shown by the selected option. One or more options can be entered by adding both slugs with a space between them. Available option: date (the date when the product was published).
  • id –> The post ID of the product.
  • menu_order –> The Menu Order, if set (lower numbers show first).
  • popularity –> The number of purchases.
  • rand –> Randomly order the products on page load (may not work with sites that use caching, as it could save a specific order).
  • rating –> The average product rating.
  • title –> The product title. This is the default orderby mode.
  • skus –> Comma-separated list of product SKUs.
  • category – >Comma-separated list of category slugs.
  • tag –> Comma-separated list of tag slugs.
  • order –> States whether the product order is ascending (ASC) or descending (DESC), using the method set in orderby. Default: ASC.
  • class –> Adds an HTML wrapper class so you can modify the specific output with custom CSS.
  • on_sale –> Retrieves on sale products. Not to be used in conjunction with best_selling or top_rated.
  • best_selling –> Retrieves the best selling products. Not to be used in conjunction with on_sale or top_rated.
  • top_rated –> Retrieves top-rated products. Not to be used in conjunction with on_sale or best_selling.
Content Product Attributes
  • attribute –> Retrieves products using the specified attribute slug.
  • terms –> Comma-separated list of attribute terms to be used with attribute.
  • terms_operator –> Operator to compare attribute terms. Available option: AND (it will show products from all of the chosen attributes); IN (it will show products with the chosen attribute. Default: terms_operator value; NOT IN (it will show products that are not in the chosen attributes).
  • tag_operator –> Operator to compare tags. Available options are: AND (it will show products from all of the chosen tags); IN (it will show products with the chosen tags. Default: tag_operator value); NOT IN (it will show products that are not in the chosen tags).
  • visibility –> It shows products based on the selected visibility. Available options are: visible (products visible on shop and search results. Default: visibility option; catalog (products visible on the shop only, but not search results); search (products visible in search results only, but not on the shop); hidden (products that are hidden from both shop and search, accessible only by direct URL); featured (products that are marked as Featured Products).
  • category –> Retrieves products using the specified category slug.
  • tag –> Retrieves products using the specified tag slug.
  • cat_operator –> Operator to compare category terms. Available options: AND (it will show products that belong to all of the chosen categories); IN (it will show products within the chosen category. Default: cat_operator value); NOT IN (it will show products that are not in the chosen category).
  • ids – > It will show products based on a comma-separated list of Post IDs.
  • skus – > It will show products based on a comma-separated list of SKUs.
Please note – If the product is not showing, make sure it is not set to Hidden in the Catalog Visibility.
Special Product Attributes
These attributes cannot be used with the “Content Attributes” listed above, as they will likely cause conflict and not display. You should only use one of the following special attributes.
  • best_selling –> It will show your best selling products. Set to: true.
  • on_sale –> It will show your on-sale products. Set to: true.

Product Category shortcodes

These two shortcodes will display your product categories on any page.
  • [product_category] –> It will show products in a specific product category.
  • [product_categories] –> It will show all your product categories.
Product Category attributes
  • ids –> Specify specific category IDs to be listed.
  • limit –> The number of categories to show.
  • columns –> The number of columns to show. Default: 4
  • hide_empty –> Default: 1 (this will hide empty categories). Set to “0” to show empty categories.
  • parent –> Set to a specific category ID if you want to show all the child categories.
  • orderby –>Default: order by “name”, can be set to “id”, “slug”, or “menu_order”. If you want to order by the IDs you specified then you can use orderby=”include”.
  • order –> Defines whether the category ordering is ascending (ASC) or descending (DESC), using the method set in orderby. Defaults: ASC.

Widgets

YITH Vendor List

The widget “YITH Vendor List” can be added in any sidebar of your website and shows the list with all enabled vendors in your shop.

Widget - YITH Vendor List

Users have the possibility to access detail page of the vendor: they just have to click on the name that they find in the widget list.
Here is a list with all attributes of the widget:

  • Title: widget name
  • Hide this widget on vendor page: this option allows you to hide the widget in the page of the vendor.
  • Vendor’s amount of products: show the amount of products associated to the vendor, next to the vendor’s name.
  • Hide vendors with no products: this option allows you to hide vendors that do not have any products.

YITH Vendor Quick Info

“YITH Vendor Quick Info” widget adds a contact form which users can use to send a request to site administrator and to vendor.

Widget - YITH Vendor Quick Info

“Name” and “Email” fields get the default values of the “Username” and “Email” of the current user if logged in.
If you want to hide the form to unlogged users, you need to activate the Hide from guest option of the widget.
Enabling the option Send a copy to website owner, the generated email will be sent automatically both to the vendor and the administrator.

You can add the widget to the vendor and product page sidebars.
Concerning the product page, the contact form is shown only if the product is associated to a vendor.

YITH Vendor Store Location

The widget “YITH Vendor Store Location” adds a box in the sidebar with a map (in Google Maps) showing the location of the vendor. You do not have to add any further information, because the map will be automatically generated according to the address added by the vendor in the field Location in the vendor’s admin panel.

Widget - YITH Vendor Store Location

The widget has to be added to WooCommerce shop sidebar but it will be displayed only in the vendor’s page.

As required by Google, support to displaying integrated maps is limited if no API KEY is specified.
For this reason, if you have a Google account, we suggest you enter the API KEY required into the “Google Maps API Key” field at the path “Multi Vendor > Frontpage”.

Google API KEY

For further information, please read this page.

Emails

YITH WooCommerce Multi Vendor creates an automatic email when one of the following conditions occurs:

  • the order is completed and commissions for the vendors are generated; the email is sent to administrators.
  • Commissions are paid; the email is sent to administrators and vendors.
  • Registration of a new vendor; the email is sent to vendors.
  • Approval for a vendor account; the email is sent to vendors.
  • A new order is completed and it contains one or more products of a vendor; the email is sent to vendors.
  • An order containing one or more products of a vendor is deleted; the email is sent to vendors.

Any of the previous emails can be set from the “WooCommerce -> Settings -> Emails” section.

WooCommerce emails

Customize emails

You can customize template of every email that plugin use.

To edit the email template, select the email and click on the “Copy file to theme” button.

Copy template email

A copy of the email template email will be created within your theme, in the selected path.

Now you can edit the file in two ways: open the file with your editor or directly from the panel: click on the “View Template” button and edit the code as you want.

How resend an email

The plugin lets you manually send the email for a second time to vendors to notify them about the creation or the deletion of an order. Go to the order page and select the related entry of the dropdown menu in the “Order Actions” section.

Resend email

If you want to prevent the vendors from resending the email, enable the Prevent vendors to resend order emails option that you find in YITH Plugins -> Vendors -> Order Management.

Prevent vendors to resend order emails