About this document

This document offers the basic knowledge for installing , configuring and using the custom fields for all plugin. This document is copyrighted © 2013 -2014 Sakis Terzis / breakdesigns.net. The document is licensed under the terms of Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License [http://creativecommons.org/licenses/by-nc-nd/3.0/]. You can distribute it freely as long as you do not modify it and state its source and/or author. You cannot use this document or any portion of it for commercial purposes. If you require such use, for example to deliver it to your clients as part of your site building service,please email the author in order to acquire such a license and the source to this document.

Minimum Requirements

Joomla 2.5.x

Virtuemart 2

PHP 5.2

MySQL 5

Installation/Update and Setup

After downloading the plug-in from our site, just install it using the joomla installation process.

installation

The same process is used for updating your version. Just use the joomla installer without uninstalling your existing version. Your data will remain intact.

 

Then you should go the the Extensions > Plug-in Manager and publish it.

enable plugin

Create your Custom fields in Virtuemart

Go to Components > Virtuemart > Custom Fields and press New. Then as Custom Field Type select “Plug-ins”. Fill in the rest fields till the end of the page.
In the “Select a plug-in” select “Custom Fields For All”

 create cf

After selecting the plugin type, the parameters of that plugin will be loaded.

 create cf2

The correct configuration of the plug-in is essential to the plug-in's behavior in the back-end and the front-end of your site. So it follows an explanation of the settings found here.

  • Display type: It defines how the custom field will be displayed in the front-end of the site i.e. Buttons ,Color Buttons, Drop-down lists, etc.
  • Data type: This is used to validate that the inserted data will be of the type you want. It also can be used later for filtering.
    • String/Text allows any input
    • Color Hex. (Hexadecimal) allows only colors in hexadecimal format.
      If you select this, a color picker popup will be displayed when you will try to insert a new color.
    • Integer Number allows only integers e.g. 10
    • Float Number allows decimal numbers e.g. 10.45
  • Price Variant: Set this to Yes only if your custom field values will affect the price of the product.
  • Display Price : This setting has meaning only if the custom field is price variant.
    It indicates how the price of each custom value will be displayed in the front-end of the site.
  • Values : This section displays all the values of that custom field. You can insert the values you intent to use now or later from within the product form.

notice iconIf you want to insert hex. color values. You better first save your custom field and then insert the values. This way you will be able to use the color picker popup.

Assign Custom fields to the products

After the creation of the custom field lets go to assign it to a product.
Select a product and go to the Custom Fields Tab.
Then from the Custom Field Type list select the custom field you have created previously.

product assignment

If any value has been assigned to that custom field previously, you will see that in the list.
You can select the existing values, insert new values or do both.

product assignment2

product assignment colors

 

If the custom field is price variant, only 1 value can be set per row.
You have to insert the custom field multiple times to the product, to set multiple values.

product assignment2 price

Manage the custom values

If you go to your custom field's page (Products > Custom Fields). You will see that all the values that you have assigned to your products, are there.

manage-customvalues

Here is the control panel of your custom field. Every modification you do here will affect all the assignments you have done to your products.
For example if you rename the Metal to Metal/Inox , this modification will be reflected to all the products where Metal is assigned.


If you delete any value, all the assignments of this value to the products will be deleted.

Another important functionality here is that you can order the custom values as you want them to be displayed in your front-end site and in the admin, inside the product form.