3. VMVendor Documentation - Options

The Options modal window is divided in tabs.
We'll go tab by tab and describe and developed every field.

IMPORTANT NOTICE: Rollover most fields titles to have specific information and instructions showing as tooltips!


Tab: General

Field: Profile manager
Options: None - Community Builder - Jomsocial - EasySOcial
Description: A profile manager is not for VMVendor, but you can enable it if you want to allow your users to separate things, having a public vendor profile and a private user profile for example. Also, it would enable specific features such as Activity Stream announcements for Jomsocial or EasySocial etc...

Field: Date display
Description: This is the date format. Check http://php.net/manual/en/function.date.php for more details Default is: Y.m.d

Field: Naming
Options: Name - Username
Description: Should VMVMendor component mention your users by their Name or their usernames (those filled in during registration)?

Field: Allow Product Deletion
Options: No - Unpublish only (Recommended if selling digital goods) - Deletion allowed only if no sell (Recommended if selling digital goods) - Yes
Description: Should Vendors be allowed to delete their own products. Problem with deleting a digital good product is that if some users have purchased it, they might have some downloads left they could not get any more...

Field: Terms & Conditions URL
Description: As you let users upload goods to your server, you should make sure they have the rights and what they upload is their belonging and they allow you to sell it on your shop etc... Leave empty to disable it.

Field: Multi-language behavior
Options: Current language only - Every Virtuemart languages (untranslated)
Description: Added products get added only in vendor's front end language Virtuemart DB table or into every language set in Virtuemart configuration page? If you set it to Every language, product will be available in every language but content (title and descriptions) will not be translated. On multilingual platforms, adding a product in a language makes it unavailable (not even visible) when visiting the front-end catalog from another language. Enabling this feature would add the new product to every language, even if it will be untranslated in the other languages. At least, the product will be visible.

Tab: Product forms
This tab concerns product addition and edition forms. You can customize the form to suit your products or vendor needs.

Field: Forbidden Categories
Description: Add here category IDs separated with coma for categories you don't want people to upload products in. This is useful when you want to keep some categories for some featured products of yours when having an open marketplace in the rest of the catalog categories.

Field: Autopublish
Options: Yes - No
Description: Auto Publish submitted products without moderating these before. Enable this if you trust your vendors. Also if not auto-published, the Product addition won't trigger the Jomsocial Activity Stream Notification.

Field: Show sku
Options: No - Yes
Description: Show or Hide Sku in forms. Sku is auto generated: [userid].[Ymd].[His].

Field: Enable short description field
Options: Yes - No
Description: If disabled, Product short description will be set using the beginning of the full description. Having 2 descriptions fields might be unfriendly to some users in some cases...

Field: WYSIWYG for Products
Options: Disable - Enable
Description: Enable WYSIWYG Editor in product addition and Edition forms for the description field.

Field: Enable Weight
Options: Disable - Enable
Description: Enable this if vendors are supposed to submit physical products with a defined weight

Field: Allowed Weight Units
Options (multiple): Kilogramme - Gramme - Milligramme - Pounds - Ounce
Description: Select the weight units vendors would find useful to use.

Field: Max Image Fields
Description: Allowed number of images per products. Image fields are shown dynamically in the form so it doesn't use too much space if not used. The vendor can select to show more or fewer image fields, in the limit you set here.

Field: Image Upload Field Mandatory
Options: No - Yes
Description: If you set VMVendor to show the image upload field, you can wish to make it mandatory. If enabled, only the first image field is mandatory.

Field: Max. Image Side size
Description: Maximum size of the largest image side in pixels. If the Uploaded image is larger, it will be resized.

Field: Thumbnail Quality
Description: Default: 90. Max: 100.

Field: File Upload field
Option: Disable - Enable
Description: Only enable this if you want your users to sell downloadable goods. This requires the VM Downloadable Goods component from Nordmograph plugin to have downloadable goods for sale in Virtuemart.

Field: File Upload field mandatory
Options: No - Yes
Description: If you set Vmvendor to show the file upload field, you can wish to make it not mandatory. If enabled, only the first file field is mandatory.

Field: Allowed File extensions
Description: Only for the file submission. Images and Thumbnail are limited to gif, png and jpeg. Add here all the extensions for the file types you allow your vendors to upload. Separate each with a coma.

Field: Max File Size
Description: The Maximum upload file size is anyway limited to your server's php.ini file configuration, but here you can set a limit below it. The default 8000000 bytes stand for 8MB.

Field: Max File Fields
Description: Allowed number of files per products.

Field: Enable Price
Options: No - Yes
Description: If you use VM as a catalog only, you might want to disable Price fields in VMVendor.

Field: Enable Stock
Options: No - Yes
Description: If you sell digital products you might want to disable stock.

Field: Category Suggestion
Options: Disable - 1. Enable as email to admin - 2. Add to database unpublished - 3. Add to database published
Description: In product addition and edition forms, enabling this adds a link next to the category selection field. It allows a user to suggest or add a new product category to the shop. 1st option only sends an email to admin with the suggested category name, description and parent category. 2nd option sends the same mail and adds the category to the shop as an unpublished category. 3rd and last option adds and publishes the new category without notifying admin.

Tab: Promotion

Field: Enable Vendor RSS
Options: No - Yes
Description: Only if Autopublish is on. This genrates a shop RSS feed for each vendor. A RSS feed icon will be available on vendor's user profile.
RSS xml files are stored in /media/vmvendorss/

Field: RSS Items limit
Description: How many products to show in the vendor RSS feed. Default value is 10.

Field: Email Notification on addition
Options: No - Yes
Description: Automatic email to email address specified below. Email contains links to the added VM product and to the vendor's profile page if applicable. Make sure your smtp server is configured correctly. Email notification is forced if Autopublish parameter is not activated.

Field: Email Notification on update
Options: No - Yes
Description: Automatic email to email address specified below. Email contains links to the added VM product and to the vendor's profile page if applicable. Make sure your smtp server is configured correctly.

Field: Additional Recipient Email Address
Description: Additional Email Address to be notified

Field: Sells Activity Stream
Options: No - Yes, in vendor Activity stream - Yes, in admin activity stream
Description: Only when using Jomsocial, enable this to have Vendors products sales announced in Jomsocial Activity Stream. This is triggered when vendors get rewarded in AUP points for their sells. The script for this is located in the one modification code.

Tab: Pricing

Field: Minimum Price
Description: Set a minimum price. Set 0 if you allow free products to be added.

Field: Points/Currency ratio
Description: How many points for one of your currency unit.

Field: Commission Percentage
Description: Percentage of sales that goes to the site admin. This does not actually go to site admin , it is just deducted from the AUP points reward that goes to vendors.

Field: Tax mode
Options: Shared Tax (recommended) - Vendor administrated taxes (beta)
Description: As an admin you can create tax(es) rules in Virtuemart administration and set these as 'shared' so they apply to every vendors products. But you can also let vendors create and manage their own taxes. If you set this, vendors will be able to add and edit taxes from their dashboard. These taxes will be set only for their own products but set to every categories, every shopper groups and without time limitation.

Tab: Dashboard
The Dashboard page is a private page for Vendors showing their latest sells with customer contacts and statistics.

Field: Customer contact form
Options: Email Form - 
Description: Jomsocial PMS form

Field: Show Postal information
Options: No - Yes
Description: Show customer postal information. This could be useless if you only sell digital goods.

Field: Allow Orders Status Change
Options: No - Only for products without forSale files
Description: Enabling this allows vendors to change their customers' orders status from C (confirmed) to S(shipped). This is not supported if you don't use C and S status codes for Confirmed and Shipped. This is not recommended for downloadable goods as the st42_download (more recently called plgvm_istraxx_download ) plugin changes the status from C to S automatically when the for sale file has been downloaded.

Field: Notify Admin
Options: No - Yes
Description: Notify admin on order item status changed from confirmed to shipped or cancel

Field: Notify Customer
Options: No - Yes
Description: Notify customer on order item status changed from confirmed to shipped or cancel

Field: Reviews management
Options: Disabled - Enabled
Description: If enabled, vendor will be able to publish or delete reviews on own products.

Tab: Vendor Profile

Field: Vendor contact form
Options: Email form - Jomsocial PMS form
Description: 

Field: WYSIWYG Editor for Profile
Options: Disabled - Enabled
Description: Enable Editor in profile edition form.

Field: Facebook Like
Options: No - Iframe - HTML5
Description: 

Field: Facebook App ID
Options: 
Description: Required to use Html5 and send button (recommended)

Field: FB width
Options: 
Description: Required to use Html5 and send button (recommended)

Field: FB Action
Options: Like - Recommend
Description: 

Field: Twitter
Options: No - Yes
Description: 

Field: Google Plus
Options: No - Yes
Description: 

Field: LinkedIn
Options: No - Yes
Description: 

Field: Show Products category link
Add the hypertext link to product category on vendor profile products list. Disable this if you don't want visitors to be redirected to other vendors or main catalog categories.

Field: Enable Star ratings
Enable a 5 stars rating (with halves) for vendors.  Basically, only customers who effectively purchased from the current vendor can rate a vendor.

Field: How many stars
Enable a 5 stars rating (with halves) for vendors.  Basically, only customers who effectively purchased from the current vendor can rate a vendor.

Field: Purchase required?
Is a purchase required to be able to rate a vendor?

Field: Show Vendor jUser group
Vendor plans are based on Joomla user groups so you can have it displayed right below the vendor avatar on the vendor profile page.  Field: jComments integration on profile
Options: No - Yes
Description: Add the jComment 3rd party component integration to vendor profile pages as an additional tab. Only enable this if you have the jComments component installed. Download it free from http://www.joomlatune.com.

Field: Facebook Comments integration on profile
Options: No - Yes
Description: Enable the Facebook comments tab on vendor profile. This requires you also fill in the previous Facebook App ID field with the Appid you got from facebook dev pages at https://developers.facebook.com/


Tab: Downloads

This tab concerns Digital Goods. If you want VMVendor to manage and sell digital goods like ebooks, software, apps, music or videos etc..., you must use Nordmograph VM Downloadable Products to be purchased separately from here. If you change the following settings, new values will only apply to new product additions.

Field: Enable on
Select here the order statuses to enable the download for files added via VMVendor product addition/edition forms.

Field: Expiry and Expiry period
Define here how long after purchase will the download link be available to customers on the product page.


Tab: Custom Fields

VMVendor will be integrating some 3rd party Virtuemart Custom Field plugins from Nordmograph.com

Field: Enable VM2tags
Options: No - Yes
Description: Product Tagging solution. Vendors will be able to add tags to a product. tags will be searchable and displayed in some tag clouds modules.

Field: Tags Limit
Options: 
Description: Limit the allowed quantity of tags per product. This limitation only applies to front-end tags submission.

Field: Enable VM2geolocator
Options: No - Yes
Description: Product Geolocation plugin. Vendors will be able to plot a location on a map for their product location.

Field: Allow Core Custom Fields (Beta)
Options: No - Yes
Description: Enable VirtueMart core custom fields for products addition and edition forms.

FIeld: Auto Add Customfields
In case you need to have custom fields added automatically to your Virtuemart Products without the need to show on VMVendor form (ex. shipping calendar). Comma-separated fields ID list.

Tab: Advanced

Field: Reset Reviews on Price changed
Options: No - Yes
Description: Reset Product Reviews and rating when item price is updated from Free to commercial.

Field: Vendor ACY Mailing list ID
Description: You can use ACY Mailing list component to have Vendors added to a list when they upload their first product. Great way to make the communication between site administration and vendors easier. Create a list in the ACYmailing component for Vendors and specify the List ID here.

Field: Jomsocial Profile Types
Options: No - Yes, core profile types - Yes, JSPT profile types 
Description: Allows to restrict VMVendor features to one or more Jomsocial profile types.

Field: Profile Types IDs
Description: If you enabled the previous parameter, set here the profile types IDs for users to be allowed to use VMVendor. Separate multiple profile types IDs with coma. To find the profile type ID, you can enter the admin page for that profile type and you find the ID in the URL. For example: administrator/index.php?option=com_community&view=multiprofile&layout=edit&id=1

Last few fields concern jQuery and Bootstrap files URL.
The point to distant files but you could host these locally and edit the urls here to point to your local jQuery and Bootstrap.
  • Created on .
  • Last updated on .
Disclaimer: Nordmograph is not affiliated with or endorsed by The Joomla! Project™. Any products and services provided through this site are not supported or warrantied by The Joomla! Project or Open Source Matters, Inc. Use of the Joomla!® name, symbol, logo and related trademarks is permitted under a limited license granted by Open Source Matters, Inc.