System Requirements

Installing the Yagendoo VM module for the top products is really easy and takes just a few steps. In the following, you will learn how to install and commission the Yagendoo Virtuemart module for the top products after downloading it.

1. Installing the Yagendoo VM Top Module

a) Unzip the package you have downloaded via the download link after the purchase to a local folder on your pc. It contains the module package and some files with information.

b) Navigate into your Joomla! backend to the Joomla! installer and select the module package you have previously downloaded to your PC and which is now on your pc. Install it using Joomla! installer. If the installation has been successful, a respective message will appear.

Note: As some servers are not 100% compatible with Joomla!, please check the CHMOD rights of the files and folders. All folders have to be set at a CHMOD of 755 and all files at a CHMOD of 644.

2. Overview on the Yagendoo Virtuemart Top Module

On the right, you see a possible view of the module. There are many configuration options which will be presented in detail in the following. You can choose, for example, a graphic display for discounted products or sold-out products. You can freely choose the display.

It is possible to enable or disable almost all elements in Yagendoo Virtuemart, e.g. the SKU, the description, the images.

You can enter whether the products to be displayed are to be from certain categories or if they are to be products from your entire Virtuemart Shop. In addition, you can determine whether a product will be regarded as a top product because of its reviews or because of its sales volume.

3. Basic Configuration of the Yagendoo Virtuemart Top Module

In your Virtuemart backend, navigate to the menu item Extensions -> Module. Here, you will find the "Yagendoo Virtuemart Top Products" module.

Amongst others, you can make the changes mentioned above here. The module suffix is followed by the designation of how a top product is determined: As according to its number of sales or by best reviews.

In the next step, you will find an input option for the number of columns in which the products are shown and the number of products to be shown. You can then select the categories the top products of which are to be displayed.

Now you have the following selection fields for enabling and disabling the following elements: the SKU, the short description, the price, the discount (if existing), the Addtocart button (button to add the product to the cart), the manufacturer, and the seller.

As next basic setting of the top products module, you can select whether you want to show the product image, as well as select its placement and its size.

4. Enhanced Configuration of the Yagendoo Virtuemart Top Module

In the basic module parameters, you can find the enhanced parameters.

First, you enter whether you want to display the image for the discount (badge). Then you can select the badge.

Afterwards, you can decide whether you want to show the sold-out badge and the badge to be used. By default, only one exists. If you want to create and use your own badges, please check the FAQs.

5. FAQs

The Yagendoo Virtuemart Module for top products does not look good and seems to be messed up.

It might happen that the template of your Joomla website overwrites the settings of the module.

The following trick might help you: Use FTP to download the main CSS file (often called "template.css") in the folder for css files (often called "css", "style" or "styles") in the /templates/YOUR-TEMPLATE/ folder.
Also, download the yagendoo.css in the modules/mod_yagendoo_vm_top/assets/css folder.
Copy everything from the Yagendoo CSS to the end of the template CSS. If this does not work, repeat the process with other CSS files of your template. Afterwards, re-upload the changed template CSS file to the server.
This trick can also help you with other modules and components if they are not displayed correctly.

I would like to add my own badge for discounts. What do I do?

You need to execute the following two steps:

1. Copy the new badge: Copy the image you have created (in PNG format) to modules/mod_yagendoo_vm_top/assets/img/badge_discount. Ensure that the name of your image file does not contain special characters (e.g. empty spaces).

2. Change the code: If you now select this image via the module parameters (it will be detected automatically), you will probably find that the placement and the angle of the writing on the image are incorrect.

You can make changes in the yagendoo_image.php in the modules/mod_yagendoo_vm_top/lib/ directory on lines 84-86. In the following, you see these lines:

Simply change the name of the image in line 84. In line 85, the first value (30) stands for the font size, the second value (45) for the angle, the third value (30) for the distance to the left and the fourth value (90) for the distance from the top. You might have to play around with these parameters to achieve the correct display. Do not forget to re-upload the changed file to the server.

I would like to add my own "sold-out" badge. What do I do?

This is pretty simple. Copy the desired image to modules/mod_yagendoo_vm_top/assets/img/en (for English) and any language you wish. German, for example, would be in the folder modules/mod_yagendoo_vm_top/assets/img/de. Thus, you can create the badge in several languages. Please ensure that the image has the same name in all directories.

I have added a product in a new category, but it does not appear.

Navigate to the module's parameters in the Joomla! backend and check if the new category has been marked in the category field.

When I try to install the module, I get a white screen headed "-1- an error occurred" and below "Unable to copy selected file."

Uninstall the module by browsing to the menu item Add-ons>Install/Uninstall and to the module tab therein. Here, select the module and uninstall it. Now re-install the module.