Manual
Minimum Reqirements

  1. Joomla 1.5.x

  2. Virtuemart 1.1.0 to 1.1.4 (has been tested in these versions).

  3. PHP 4.4.7  PHP 5 recommended

  4. MySQL 5 +
 
Installation

The installation is the typical installation of every joomla extension.

Into the vmf folder there are the com_vmFiltering and the mod_vmFiltering.

 

Go to:

Extensions -->Install/Uninstall-->Browse to find one of these files in your hard drive

and then press Upload File & Install.

 

*Do the same for the other File.

 
 
VMFiltering Component - Usage

Notice:

In order to use the VMF component it needs the existance of Categories in the Virtuemart component.

Features

Features indicate the features of each Category of the Virtuemart.
Each category contains certain products and certain properties that enrolls them in this category.

New

Pressing the New Button helps the user navigate to a form of creating the New Feature.

From there the user can :

  1. Give Name to the feature.
  2. Select the Virtuemart Category to which it refers to.
  3. Give Multiple Values to this Feature.

To give Values to a feature go to the Values Section to the right of the form:
  1. write the Value you want.
  2. Press the Add Button

Do the same as many times as you want.

To delete a Value :
Press the delete icon to the right of the Value

 

Notice :
The delete icon deletes a value even if you do not press Apply or Save.

If the Value has been saved, will be deleted when the progress bar finishes.



To edit a Value :
Press the edit icon to the right of the Value

When you have finished then press Apply or Save

Values

In this page/view you can see all of the Values of each Feature.

Edit & Assign Products

Pressing Edit & Assign Products you can assign Products to each value.
You can select multiple products together.
Also  Edit the Name, Order and Publish properties of the Value.

Parameters

In the parameters form you can configure issues that concern its function.

params_scrnsht

Matching of selected Values.

Relative means that VMF will return every product that match at least one of the selected criteria and will display higher those that match to more

Absolute means that VMF will return only those products that absolutelly match to all the selected criteria

Pagination

Set it yes if you want to use the pagination settings set by the joomla configuration form, otherwise set it to no.
 
Uninstalling VirtueMart

Its strongly advised to uninstall the VMF component if you uninstall Virtuemart.

If you don't want to loose your data concerning VMF, you can empty (trancate) the table
#__vmfprodsubcategory from your database.
 
VMF Module

The module displays the filtering form for your e-shop.
Its the user's tool for filtering the products.

 

Parameters

The module comes with a set of parameters concerning its display style and its functioning.

From the extensions-->module manager the user could select :

1) Display Price field. Setting it to yes will display the price filtering fields (From , To).

2) Display Features. Setting it to yes will display the features filtering fields.

noticeThe Manufacturers are also considered as a feature.

 

3) Display Manufacturers as Feature. Setting it to yes will display the manufacturers that correspond to the selected category

 

 


4) Display Values with no Products Assigned.

This parameters decides if will be displayed feature's values that have no products assigned.

*If the end user selects only a Value that has no products assigned
the vmf won't return-display any products.

 

Appearance Section

1) Module Class Suffix. The suffix of the module's class. Could be use for styling the module

 

2) VM categories ids. Using this setting the user could select the VM categories that he want to be displayed in the front end.

notice The categories ids should be separated by a comma.Example: 6,9,11

notice The categories are being displayed in the order that the user has entered them.

 

3) Hold selected filters in the results page. Display all the selected criteria in the VMF module after the search (In the results page).

 

4) Categories selection type. Single for radio buttons (only 1 possible selection). Multiple for checkboxes (multiple possible selection).

notice If you enable the Multiple selection you should also activate the Relative matching from the vmf component->values->parameters


4) Background Color. We are offering 5 different background colors for the module.

If these colors don't  fulfill the user's demands, the module styling could easily change from a css  file (css/stylesheet.css) included inside its folder.

 

5) VM categories ScrollBar. With this setting the admin could define a certain height after which a scrollbar will be appeared to the categories box.

notice The height units should also be included in the text field. Example : 180px

 

6) Features Appearance

a) Horizontally
Every feature and it's Values appears in a row.


 

b) Vertically
Every feature and it's Values appears in a column.

 


6) Currency Symbol Position. With this setting the admin could define the currency symbol position for the price filtering text boxes.

Currencies have different symbol position that the admin has to define. Example: 100€ or $100

 

 

The Module is 100% HTML, CSS Valid !!

The appearance of the module has been checked in all major Browsers. Any distortion happens because of css from the template you use ,is not our Responsibility.
 
Language Installation

The language files doanloaded from the download area are being installed using the joomla installation proccess.

Extensions->Install/Uninstall