Forms Settings Overview

WC Vendors Pro introduces a full-featured frontend dashboard for vendors. The forms settings page allows the marketplace admin to control various aspects of the forms without the need to write code. This includes making certain fields required or hiding them altogether.

There are several subsections for the forms related to each frontend form available on the vendor dashboard.

  • General
  • Product
  • Coupon
  • Settings
  • Signup

General

These options will apply to all the forms in vendor dashboards.

  • Allow HTML In Inputs
  • Allow Media Uploads
  • Vendor Filename Prefix
  • Vendor Disk Usage Limit
  • Vendor File Count Limit
  • Limits Include Thumbnails
  • Shipping Type

Allow HTML In Inputs

This option allows the vendor to add an HTML source to the inputs and text areas on forms.

Allow Media Uploads

This option allows a vendor to upload media on the wp_editor on forms

Vendor Filename Prefix

The Vendor filename prefix will show for uploads such as images. There are four sections: No file prefix, Vendor ID, and Vendor Username. You can set a prefix for all vendor file name uploads.

Vendor Disk Usage Limit

This provides the ability for you to set a storage limit for each vendor. This value is set in megabits. You can ensure that your marketplace hosting does not fill up with unused vendor files.

Vendor File Count Limit

This will enable a file count limit for each vendor. Setting this, you can limit how many files the vendor can upload and store on their marketplace.

Limits Include Thumbnails

If this option is checked, the marketplace admin can include generated thumbnails in this file count.

Shipping Type

This allows the vendors to be able to define which shipping system they will use. Which will override the global setting.

Google Maps API

If you add a Google Maps API key, then this will enable the vendor addresses to use Google Maps for look-ups.

  • Google Maps API key
  • Map Zoom Level
  • Location Picker Visibility

Google Maps API key

There is where you would enter your Google Maps API key. This key is available from Google. You will need to have billing enabled in your Google account to be able to generate this key.

Map Zoom Level

Using this setting, set the default zoom level of the map.

Location Picker Visibility

This will determine if the map is shown on the vendors’ dashboard by default, or if they will have to toggle it.

Products

This settings page provides the settings to control how the product edit page will be displayed for the vendors. Here, you can control things such as the visibility and requirements for fields, set limits for the form, and set defaults.

  • Form Fields
  • Product Form

Form Fields

These are all the form fields that can be managed on the product edit form. This applies to all form fields and is independent of the Product Form Type you have selected in the default options.

These are broken down into various parts of the form including the following:

  • Basic
  • Media
  • General
  • Inventory
  • Shipping
  • Upsells/Cross-sells
  • Variations
  • Product SEO
  • Advanced
  • Variation Actions Type

Basic

The basic option allows you to conditionally enable or disable an entire product tab from the vendors’ product edit page. This is only relevant to the Standard product form. If you are using the Simple or Download, this setting will not be used.

Media

Media options can be set to hidden and or required. This will affect the featured image and gallery.

General

These are all fields on the general product tab that you can manage how these are displayed and used by vendors on their dashboard.

Inventory

Inventory fields can be set to hide or require. This will determine which fields the vendors can use.

Shipping

This will control all fields on the shipping tab.

Upsells/ Cross-sells

The upsells/cross-sells tab can be managed here.

Variations

The variations tab can also be managed like a simple product field settings.

Product SEO

Included is the ability for the vendors to set their own SEO fields. You can manage what they can add/edit on this tab.

Advanced

The Advanced tab allows vendors to custom order the products on their store and set purchase notes which will send to the customers after purchase.

Variation Actions Type

The variations tab provides a list of available actions at the top of the variations manager. There are two options for displaying these options, either as a single dropdown (the same as WooCommerce backend) or a new grouped dropbox interface.

Products Form

This section controls all the product form defaults. These options provide a lot of flexibility for your forms and form behaviors.

  • Default Product Form
  • Save Product Redirect
  • Use HTML
  • Allow Media
  • Category Display
  • Hide Categories
  • Categories limit
  • Tag Display
  • Tag Separator
  • File Display
  • Hide Attributes
  • Attributes Terms
  • Vendor Filename Prefix
  • Vendor Disk usage limit
  • Vendor File upload limit
  • Max Gallery Images
  • Max Image Width
  • Max Image Height
  • Min Image Width
  • Min Image Height

Default Product Form

WC Vendors Pro ships with three product forms that you can use as your default forms. This provides some flexibility in the kind of product edit form you present to your vendors. These three templates are also available to be overridden and customized as you require.

TemplateDescription
StandardThis is the standard template that mimics all functionality of the WordPress backend
SimpleThis is a cut-down form that creates simple products only. It has fewer options so that vendors can quickly add products without extra fields you need to disable fields.
DownloadThis is a dedicated downloadable product form. This allows you to quickly start a digital download marketplace.

Save Product Redirect

This option configures which page is to redirect to after the vendor saves a product. We provide four different actions you can choose depending on your specific user requirements.

OptionLocation
Edit Product FormThis will redirect back to the same form with the same product ready to continue editing
Product ListThis will redirect the vendor back to the list of the main products
Published/Preview ProductThis will redirect the vendor to the published or product preview page
Add new productThis will redirect the vendor back to the add a new product page.

Use HTML

This option enables the WP WYSIWYG editor for the product description and product short description form fields. This will give the vendors more control over the style of the content for these two elements.

Allow Media

This will enable the media uploader within the WP Editor for the fields above. This can be useful to allow vendors to add extra visual information to the product description.

Category Display

The category display provides the ability to change how the category selection functions. We provide three options for this.

OptionDescription
Multi selectAllow the vendor to select multiple categories at a time.
Single selectVendors are restricted to a single category for the product
CheckboxesThis provides a checkbox interface similar to the WordPress admin category select

Hide Categories

If you want to hide specific categories from your vendors you can use this option. To hide a category or categories, you will need to know the category ID for the particular categories you want to hide. To hide multiple categories, use a comma to separate the ID.

You can find the category ID when editing the category and find the ‘tag_id’ in the URL string.

Categories limit

You can also limit how many categories a vendor can select at a time. This ensures your marketplace is clean and vendors don’t spam the categories for better exposure. If you want vendors to only select five categories, add a 5 to the input and save.

Tag Display

The tag display provides two options for inputting tags.

Multi SelectThis will provide a standard open ended box for vendors to add tags with no restriction.
Multi Select limitedThis works much like a standard drop down and will limit the vendors to selecting pre-defined tags.

Tag Separator

The tag separated refers to the kind of separator the vendor needs to input so that the system will know what a new tag is. There are three options for this.

OptionDescription
Comma and spaceComma only supports multi-word tags but there is no space after the tag
Comma onlySpace only supports single-worded tags only.
Space onlySpace only supports single worded tags only.

File Display

The file display will change how vendors see the file details in the digital download files. We provide two options for displaying the file details.

OptionDescription
File URLThis will use the absolute file URL and display this on the digital download file
File NameThis will only show the file name and not the url. This can be useful if you are using offload media plugins.

Hide Attributes

This option allows you to hide specific product attributes from the vendor’s product form. You would use the same comma-separated list as the hide categories option above. You will find the attribute_id in the URL when editing the attribute.

Attributes Terms

Vendors cannot add product attributes but you can allow them to add terms to a product attribute. For example, you may want to allow vendors to add their own colors. We do not advise this as spelling errors can cause your attributes to become cluttered and require maintenance.

Vendor Filename Prefix

This option will enable a filename prefix on all files uploaded by vendors. This can be useful when scaling your marketplace and you need to clean up the file system or segment the uploads across multiple storage systems. There are three options for this.

OptionDescription
No PrefixNo prefix is added to files uploaded by vendors
Vendor IDThe vendor’s display name is prefixed.
Vendor nameThe vendors display name is prefixed.

Vendor Disk Usage limit

You can set a limit on disk space used by vendors. The amount is measured in Megabytes MB. For example, if you want to limit file uploads for your vendors to 100MB you would input 100.

Vendor File upload limit

You can limit how many files vendors can upload. This is a file count. For example, if you want to limit the vendors to 400 files at a time, you would input 400 here.

Max Gallery Images

You can limit the number of gallery images a vendor can select for a product. By default there there is a limit of 4 images, to set it to unlimited images clear the value in the input and save.

Max Image Width

This option provides the ability to give a maximum image width for images uploaded by vendors. . The measurement uses pixels (px) for the limitation. This can ensure vendors are not uploading raw files that are 6000px wide.

Max Image Height

This option provides the ability to give a maximum image height for images uploaded by vendors. . The measurement uses pixels (px) for the limitation. This can ensure vendors are not uploading raw files that are 6000px high.

Min Image Width

This option provides the ability to give a minimum image width for images uploaded by vendors. The measurement uses pixels (px) for the limitation. This can ensure vendors are not uploading small pixelated images.

Min Image Height

This option provides the ability to give a minimum image height for images uploaded by vendors. The measurement uses pixels (px) for the limitation. This can ensure vendors are not uploading small pixelated images.

Coupons

The coupon form settings do not have the option to control the form fields at this stage.

Save Coupon Redirect

This option configures which page is shown after the vendor saves a coupon. Three options are available for saving coupon redirect.

OptionDescription
Edit coupon formThis will redirect the vendor back to the same form to continue editing the coupon
Coupon listThis will redirect the vendor back to the coupon list on the dashboard
Add new couponThis will redirect the vendor to an empty add coupon form ready to create another coupon

Settings

Settings Form

The vendor settings page provides all the settings vendors will need to configure their store. There are various settings available for vendors to configure. These settings will allow you to hide a particular field or make it required.

  • Tabs
  • Store
  • Payment
  • Branding
  • Shipping
  • Social
  • Policies
  • SEO
  • Use HTML for policy

 Tabs

The tabs option allows you to completely enable/disable subsections of the settings form.

Store

Store settings are used for hiding or requiring a particular Store setting. This change will be reflected in the settings form of the vendor dashboard. The store name is always a required field and as such is not available as an option.

Payment

The payment options are related to how vendors would like to be paid out. These settings can be used to hide the fields but not to set them as required.

Branding

The branding options are related to the vendor store branding settings. These settings can be used to hide the fields but not to set them as required.

Shipping

The shipping options are related to vendor flat rate shipping settings. These settings can be used to hide the fields and set them as required.

Social

The social options are related to the vendor’s social media settings. These settings can be used to hide the fields but not to set them as required.

Policies

The policies fields are related to the vendor’s store policies. These policies are displayed on the single product pages. These settings can be used to hide the fields but not to set them as required.

SEO

The store SEO fields are output on the main vendor store and the single product pages. This includes the social sharing banners for the various social platforms. These settings can be used to hide the fields but not to set them as required.

There are two options for the settings and signup forms. These two options provide the ability to enable the WP Editor for vendor policies and the vendor’s store notice.

Signup

The signup form functions almost identically to the settings form. The settings and signup forms perform almost the same as each other. The only difference is the signup form does not allow vendors to upload files and is only displayed when someone applies to be a vendor.

Was this article helpful?

Related Articles