Managing Currencies

Managing Currencies

Currencies are managed in the currency list, which can be accessed through "Admin" ⇒ "List Currencies".

VirtueMart Administration: Currencies List

Figure 4.7. VirtueMart Administration: Currencies List


To add a new Currency, click "New" in the top of the list and fill out the fields in the Currency form.

VirtueMart Administration: Currency Form

Figure 4.8. VirtueMart Administration: Currency Form


Don't forget to save and the new currency is added to the list.

You can modify existing currencies. To do so, just click on the name of a currency in that list and a form opens and you can modify the properties of this currency. Again don't forget to save your changes.

To remove one or more currencies from the list, you should first always consider to just unpublish the currency. If you delete the currencies it can fast happen that your store may miss it for a product, calculation rule, or similar. But if you are really sure that you want to delete it, then either click on the "trash bin" icon in the last column of each row and confirm to remove the currency or select multiple currencies using the checkboxes and click on "Remove" in the toolbar.

Managing Countries

Managing Countries

Countries are managed in the country list, which can be accessed through "Admin" ⇒ "List Countries".

VirtueMart Administration: Country List

Figure 4.5. VirtueMart Administration: Country List


To add a new country, click "New" in the top of the list and fill out the fields in the country form.

VirtueMart Administration: Country Form

Figure 4.6. VirtueMart Administration: Country Form


Don't forget to save and the new country is added to the list.

You can modify existing countries. To do so, just click on the name of a country in that list and a form opens and you can modify the properties of this country. Again don't forget to save your changes.

To remove one or more countries from the list, either click on the "trash bin" icon in the last column of each row and confirm to remove the country or select countries and click on "Remove" in the toolbar.

Shop Configuration

This tutorial will walk you through the setup of your site, ongoing management, and advanced administration accessed via the VirtueMart administrative interface.
It assumes that you have already installed and configured your site (VirtueMart 1.1 with Joomla! 1.0.13).
VirtueMart allows you to select "Simple Layout" and "Extended Layout". The simple layout is the standard layout and provides a basic cross-browser-safe layout. The extended layout instead uses the fabulous ExtJS library for creating a nested layout that allows better presentation of the administrative functions of VirtueMart. So it opens items for editing in a new tab inside the main panel. It should work fine on Internet Explorer 6+, Firefox 2+, Opera 9+ and Safari 2+.

{typography list type="arrow_black"}Global{/typography}
{typography list type="arrow_black"}Security{/typography}
{typography list type="arrow_black"}Site (Display & Layout){/typography}
{typography list type="arrow_black"}Shipping{/typography}
{typography list type="arrow_black"}Checkout{/typography}
{typography list type="arrow_black"}Downloads{/typography}
{typography list type="arrow_black"}Feed Configuration{/typography}

The Configuration Panel is the most important part of VirtueMart. It can be accessed via "Admin" ⇒ "Configuration".

The Configuration Form

Figure 4.1. The Configuration Form


Note that the Configuration Panel can be accessed by Users with Permissions "admin" only (by default).

You can access the different parts of the Panel by clicking on the Tab Headings.


Shop is offline?

Here you can switch the shop from Online to Offline mode. In offline mode, the offline message is displayed instead of the product pages. This means the whole shop section isnt usable for customers. Administrators won't see the shop too.

Offline Message

This message will be displayed to customers who try to access your store.

Use only as catalogue

Hides all "Add to Cart" buttons.

Show Prices

When enabled, product prices are displayed. (useful when using "catalog-only" functionality. Note that you can't hide prices from unregistered users to show prices only to registered users. Either ON or OFF!

Membergroup to show prices to

default:"Public Frontend"

Here you can decide which membergroups of your site are allowed to see product prices.

Show "(including XX% tax)" when applicable?

When checked, users will see the text "(including xx% tax)" when prices are shown incl. tax (which depends on shopper group settings!).

Show the price label for packaging?

Use "price per packaging" label?

Show Prices including tax?

Sets the flag whether the shoppers sees prices including tax or excluding tax. When enabled prices are displayed like "X.XX (including XX% Tax)"

Enable content mambots/plugins in descriptions?

If enabled, you can use your mambots and plugins for dynamic content in the product or category descriptions.

Enable Coupon Usage

If you enable the Coupon Usage, you allow customers to fill in Coupon Numbers to gain discounts on their purchase.

Customer Review/Rating System

If enabled, you allow customers to rate products and write reviews about them. So customers can write down their experiences with the product for other customers.

Auto-Publish Reviews?

If enabled, customer reviews are instantly shown after being submitted. Maybe not a good idea, because you want to check the product reviews before.

Comment Minimum Length

This is the amount of characters a customer must write at least before a review can be submitted.

Comment Maximum Length

This is the maximum amount of characters a customer can write before a review can be submitted.

Enable Affiliate Program?

This enables the affiliate tracking in the shop-frontend. Enable if you have added affiliates in the backend.

{typography icon type="alert" boxstyle="float: none; margin: 5px;"}The Affiliate Program doesn't fully work. It must be completed in future versions.{/typography}

Virtual Tax

This determines whether items with zero weight are taxed or not (only applies in Ship-To-Address based Tax Mode).

Tax mode

This determines which tax rate is taken for calculating taxes. It can be either the tax rate of the customer's shipping address location, the tax rate of the store/vendor location or - in EU Mode - the tax rate of the country, the store is located in, regardless where the goods are shipped to.

Enable multiple tax rates?

Check this, if you have products with different tax rates (e.g. 7% for books and food, 16% for other stuff).

Discount before tax/shipping?

Sets the flag whether to subtract the Discount for the selected payment BEFORE (checked) or AFTER tax and shipping.

User Registration Type
  • Normal Account Creation:

    This type of registration asks each customer for a username and password and all other published registration details.

  • Silent Account Creation:

    In this mode, users don't need to fill in a username and password for a new account. Instead the email address is used for the new account and a random password is generated. The registration details are mailed to the customer.

  • Optional Account Creation:

    The customer can select if a persistent account is created or not. If the customers chooses to create an account, he is asked for an username and password. If he chooses not to create an account, a hidden account is created - so the customer can be silently logged in and check out.

  • No Account Creation possible

    In this mode the customer can checkout without being able to create an account for returning later on. Each time a dummy user account is created to keep the data structure intact.

Show the "Remember me" checkbox on login?

The "Remember me" feature allows to set a cookie in the customer's browser, so the customer doesn't need to login each time he returns to the site. This is done by default. But such cookies can be a security risk - especially when people are sharing a PC in an Internet Cafe. So check this checkbox to allow customers *not* to store a user cookie.

Customers can select a state/region?

When enabled, your customers are presented a drop-down list with states where they can select one.

Must agree to Terms of Service?

Check if you want a shopper to agree to your Terms of Service before registering to the shop.

Agree to T.o.S. on EVERY ORDER?

Check if you want a shopper to agree to your terms of service on EVERY ORDER (before placing the order).

Show information about "Return Policy" on the order confirmation page?

Store owners are required by law to inform their customers about return and order cancellation policies in most European countries. So this should be enabled in most cases.

Legal information text (short version)

This text instructs your customers in short about your return and order cancellation policy. It is shown on the last page of checkout, just above the "Confirm Order" button.

Long version of the return policy (link to a content item)

This is the long and detailled version of your returns policy. This text is linked in the short version and appended to each order confirmation email.

Check Stock?

Sets whether to check the stock level when a user adds an item to the shopping cart. If set, this will not allow user to add more items to the cart than are available in stock.

Show Products that are out of Stock?

Let's you decide wether Products that are out of Stock are displayed or hidden (only available when Check Stock is enabled).

Enable the Cookie Check?

If enabled, VirtueMart checks wether the browser of the customer accepts cookies or not. This is user-friendly, but it can have negative consequences on the Search-Engine-Friendlyness of your shop.

Currency Converter Module

This allows you to select a certain currency converter module. Such modules fetch exchange rates from a server and convert one currency into another.

Order-mail format:

This determines how your order confirmation emails are set up:

  • as a simple text email

  • or as a html email with images.


Turns on the debug output. This causes the DEBUGPAGE to be displayed at the bottom of each VirtueMart page. Very helpful during shop development since it shows the carts contents, form field values, etc.




The secure URL to your site. (https - with trailing slash at the end!)

{typography icon type="alert" boxstyle="float: none; margin: 5px;"}Be careful what you fill in here - if the address doesn't exist, customers would be redirected to a non-existing location and receive a 404 error!{/typography}

Shop Areas which must use https

Some of the areas of your shop can be forced to use the SECUREURL connection. Here you can choose the modules which must use this SECUREURL. By default this is: "account" (Account Maintenance) and "checkout" (the complete Checkout).

Generally prevent secure connections?

When checked, the shopper is redirected to the normal URL when not browsing in those shop areas, which are forced to use the SECUREURL.

Encryption Function

Recommended: AES_ENCRYPT

Choose the MySQL function, which is used to encode/encrypt important data in the database tables. AES Encrypt is far more secure, as it actually encrypts the data, not just encodes it. AES_ENCRYPT is available in MySQL >= 4.0.2.

Encryption Key

The secret key for encrypting payment account data like credit card numbers and storing them encrypted in the database.

Store Credit Card Information?

Allows to completely disable the storage of Credit Card data.

Allow Frontend-Administration...

...for non-Backend Users?

With this setting you can enable the Frontend Administration for users who are storeadmins, but can't access the Mambo Backend (e.g. Registered / Editor).

Table Prefix for VirtueMart Tables

This is an experimental feature to allow multiple shops in one Joomla! installation.


Example: shop.index

This is the page which will be loaded in the frontend by default.


Default: shop.error

This is the default page for displaying VirtueMart Error Messages.

Proxy Server URL

The URL of the Proxy Server you need to pass from the server for connections into the Internet.

Proxy Port

The Port of the Proxy Server

Proxy Auth Username

Only if needed: the username for authentication at the proxy server

Proxy Auth Password

Only if needed: the matching password for authentication at the proxy server

Site (Display & Layout)

VirtueMart makes use of the Joomla/Mambo Templates' CSS. It uses the Standard-CSS Classes defined for Joomla! like sectiontableheader, sectiontableentry1, sectiontableentry2 and so on.


PDF - Button

Show or Hide the PDF - Button in the Shop Frontend.

Show the "Recommend to a friend" button?

Show or Hide the link to the form for recommending a product to a friend in the Shop Frontend.

Show the "Print View" link?

Show or Hide the link for the print view page in the Shop Frontend.

Show Page Navigation at the Top of the Product Listing?

default: checked

Switches On or Off the Display of Page Navigation at the Top of the Product Listings in the Frontend.

Default Product Sort Order

Here you can select by which criteria products are ordered in the product lists.

Available "Sort-by" fields

Here you can select the criteria which is available for the customer to reorder the product list.

Show the Number of Products?

default: checked

Switches On or Off the Display of Products in a Category right behind the Category Name like "Power Tools (3)".

"no image" image

default: /components/com_virtuemart/themes/default/images/noimage.gif

This image will be shown when no product image is available.

Show footer "powered by..." ?

Displays a powered-by-VirtueMart footer image. Give credits back to the author!


Global Shop Theme

Here you can select which theme is used to style the shop. The configuration link takes you to the theme configuration screen.

Default number of products in a row

This defines the number of products in a row. Example: If you set it to 4, the default category template will display 4 products per row.

{typography icon type="info" boxstyle="float: none; margin: 5px;"}You can change the Category's Number of products per row for each category in its category form!{/typography}

Category Template

default: managed

This defines the category template for displaying products in a category when no special template is set. You can create new templates by customizing existing template files (which reside in the directory /components/com_virtuemart/themes/default/templates/browse/ and start with "browse_").

{typography icon type="info" boxstyle="float: none; margin: 5px;"}You can override this Category Template Setting for each Category in its Category Form!{/typography}


default: shop.flypage

This is the page used for displaying product details when no special flypage is set.

{typography icon type="info" boxstyle="float: none; margin: 5px;"}You can change the Flypage for each category in its category form!{/typography}

Dynamic Thumbnail Resizing?

If checked, you enable dynamic Image Resizing. This means that all Thumbnail Images are resized to fit the Sizes you provide below, using PHP's GD2 functions.

{typography icon type="info" boxstyle="float: none; margin: 5px;"}You can check if you have GD2 support by browsing to "System" ⇒ "System Info" ⇒ "PHP Info" ⇒ gd.{/typography}

The Thumbnail Image quality is much better than Images which were "resized" by the browser. The newly generated Images are put into the directory /shop_image/prduct/resized. If the Image has already been resized, this copy will be send to the browser, so no image is resized again and again.

Thumbnail Image Width

The target width of the resized Thumbnail Image.

Thumbnail Image Height

The target height of the resized Thumbnail Image.


In the Shipping section you can select one or more of the provided Shipping Modules.

{typography icon type="info" boxstyle="float: none; margin: 5px;"}You can configure Online Services (like UPS® or Intershipper®) in "Store" ⇒ "List Shipping Modules" ⇒ Service Name. Other Shipping methods like Standard Shipping or Zone Shipping must be configured through their own administrative interface: "Shipping" ⇒ Shipping Rates / Shippers or "Zone Shipping" ⇒ "Zone List". The Free Shipping module can be configured by amount only in the Store Form.{/typography}

The selected Shipping Module will list all available Shipping Rates on Checkout.

{typography icon type="info" boxstyle="float: none; margin: 5px;"}If you want no Shipping Rate Selection, you must select "Disable Shipping method selection" AND a checkout process (next Tab) which doesn't include Shipping Method selection.{/typography}


Enable the Checkout Bar

default: Enabled

Check this, if you want the 'checkout-bar' to be displayed to the customer during checkout process ( 1 - 2 - 3 - 4 with graphics).

Checkout Steps

The Checkout Process is divided into different Steps. Steps can be combined to so-called "Checkout Stages" by giving the same ordering number. Each one of the steps can be re-arranged by using the input boxes and writing a numeric value into it indicating the step number.


Enable Downloads

Check to enable the Download Feature. Only If you want sell downloadable goods.

"Enable download" Status

value: can be some Order Status (not cancelled ;-)).

Select the order status at which the customer is notified about the download via e-mail.

"Disable download" Order Status

Sets the order status at which the download is disabled for the customer.


The physical path to the files for the custumer download. (trailing slash at the end!)

{typography icon type="alert" boxstyle="float: none; margin: 5px;"}Must be a physical path, no URL.{/typography}

{typography icon type="alert" boxstyle="float: none; margin: 5px;"}For Security Reasons you should specify a directory somewhere outside of the Document Root of your Web Server. If your Website resides in /var/www/sitename/htdocs/, you should - for example- choose /var/www/sitename/downloads/ as the Download Root.{/typography}

Download Maximum

Sets the number of downloads which can be made with one Download-ID for one order.

Download Expire

Sets the time range in seconds in which the download is enabled for the customer. This range begins with the first download! When the time range has expired, the download-ID is disabled.

{typography icon type="info" boxstyle="float: none; margin: 5px;"}86400s=24h{/typography}

Keep Product Stock Level on Purchase?

When enabled, the stock level for a downloadable product is not lowered although it was purchased by customers.

Feed Configuration

Enable Feed Configuration

Store Setup

To begin setting up your store, select "Store | Edit Store" from the VirtueMart admin interface.

VirtueMart Administration: The Store Form

Figure 4.4. VirtueMart Administration: The Store Form


The Information from the Store Information Form is displayed in various Locations on the Shopping Site. This is your Store's primary Identity - essentially a special "Master" Vendor.

Store Information Form Fields

Store Name


The name of the Store.

Store Company Name


The name of your company.


The Store's Internet Address.

Address 1

Address Line 1

Address 2

Address Line 2


The City where your Store is located.


The State / Region where your Store is located.


The Country where your Store is located.

Zip/Postal Code

The ZIP of your Store's location.


Your Store's Phone Number

Last, First & Middle Name

The Name of your Contact Person.


The title of the Contact Person.

Phone 1 & 2

Your contact's Phone number.


The Fax number for the Contact.

Email Address

Primary store contact email address

Full Image


Displays the currently configured store logo.

Upload Image


Browse to your company logo. This will be uploaded when you click on the "Save" icon.

Minimum Purchase Order Value

This is the amount which is the minimum Order Value for Checkout.

Minimum Amount for Free Shipping

This is the amount, from which on Shipping is free.


The Store's global / default Currency

Currency symbol

This is the currency symbol which will be used when displaying prices.


Number of decimals.

Decimal symbol

Can be somethin like . , or empty.

Thousands separator

Same as decimal symbol.

Positive format

Display Order / Style for positive numbers.

Negative format

Display Order / Style for negative numbers.

List of accepted currencies

This list defines all those currencies you accept when people are buying something in your store.

{typography icon type="info" boxstyle="float: none; margin: 5px;"}All currencies selected here can be used at checkout! If you don't want that, just select your country's currency (=default).{/typography}


This is your Store's Description which is shown on the page shop.index.

Terms of Service

This is the complete text for your Terms of Service that is displayed to the customer.

Click on the "Save" icon. Now you're ready to begin adding Categories, Products and Manufacturers.

Getting Started

To access the configuration of VirtueMart, select "Components | VirtueMart" in the Joomla! Administration Interface.

Joomla! Administrator: Component Drop-Down List

Figure 4.2. Joomla! Administrator: Component Drop-Down List


If you see the VirtueMart "Welcome" page when accessing VirtueMart, click "Go Directly to Shop".

Navigating to the VirtueMart admin interface will bring up the "Store: Summary" page.

VirtueMart Control Panel

Figure 4.3. VirtueMart Control Panel


You may also access this page from within the VirtueMart interface under "Store | Summary"

More Articles ...