VirtueMart User Manual Sören Eberhardt-Biermann
VirtueMart User Manual Sören Eberhardt-Biermann Russel Walker www.netshinesoftware.com [http://www.netshinesoftware.com/] Copyright © 2005-2007 Soeren Eberhardt-Biermann This document is published under the Open Content License available from www.opencontent.org/opl.shtml] http://www.opencontent.org/opl.
Table of Contents Preamble .................................................................................................................... ix 1. Introduction .............................................................................................................. 1 1.1. What is VirtueMart? ......................................................................................... 1 1.2. What does it not do? ........................................................................................ 2 1.
vi
List of Figures 1.1. Frontend: Category Overview Page ............................................................................ 3 1.2. Frontend: Product Details Page with Review Feature ..................................................... 3 1.3. Administration: Homepage / Summary / Statistics ......................................................... 4 1.4. Administration: Product List ..................................................................................... 4 4.1. The Configuration Form ....
VirtueMart User Manual 4.52. VirtueMart Administration: Vendor Category List ..................................................... 4.53. VirtueMart Administration: Vendor Category Deletion ............................................... 4.54. VirtueMart Administration: Shipper Form ................................................................ 4.55. VirtueMart Administration: Shipping Rate List ......................................................... 4.56. VirtueMart Administration: Shipping Rate Form .
Preamble The content of this document is related to VirtueMart. VirtueMart is free Software, licensed under GNU/GPL; VirtueMart [ http://virtuemart.net ], © 2005-2007 Sören Eberhardt-Biermann & the VirtueMart Development Team The Software 'VirtueMart' is intended for use in Joomla! or Mambo (version 4.5.x, 4.6.x). (Joomla! and Mambo is free Software, licensed under GNU/GPL; Joomla! is available from www.joomla.org [http://www.joomla.
x
Chapter 1. Introduction 1.1. What is VirtueMart? 1.1.1. About VirtueMart is a Shopping Cart Application for selling goods over the internet. It's a Component (= plugin) for a Content Management System called Joomla! (and Mambo) and can't be used without Joomla!. It installs fairly easy using the automatic Component and Module Installer. It's intended for use in small / mid-sized Online Businesses / Online-Shops.
What does it not do? • Shoppers can add their own Shipping Addresses • let your Customers easily search for Products through a Search Form • feature specific products by setting them on special • let your shoppers know when a product is available again • Shoppers can see, in what time a product will usually ship, on product-details page (with nice images!) • Shoppers can manage their User Accounts (registration required) • Shopper can view all their Orders (and Order Details) • Order Confirmation Mail (cus
Frontend Screenshots (using the Template solarflare_ii) Frontend Screenshots (using the Template solarflare_ii) Figure 1.1. Frontend: Category Overview Page Figure 1.2.
Administrator Screenshots Administrator Screenshots Figure 1.3. Administration: Homepage / Summary / Statistics Figure 1.4.
Chapter 2. Installation 2.1. Joomla! / Mambo Installation Joomla! and Mambo must be installed prior to the Installation of VirtueMart, because VirtueMart needs a CMS as runtuime environment. The Joomla! / Mambo Installation is not part of this Manual, because it is subject to change and would have to cover a series of Tutorials for all different types of Joomla! and/or Mambo. You can find further information about the Installation in the • Joomla! 1.5 Installation Manual [http://help.joomla.
Installation and Upgrade 1. The automatic installation with Joomla's / Mambo's Element (Component-, Module-, Mambot-) Installer. 2. The manual installation. Some users can't use the automatic Installer because of the PHP setting 'safe_mode' being set to 'On'. In case you're running into trouble with the automatic Installer try the manual installation instead. Upgrade from mambo-phpShop You want to upgrade to VirtueMart from mambo-phpShop? That is easy.
Automatic Installation CHANGE `product_price` `product_price` DECIMAL( 12, 5 ) NULL DEFAULT NULL # Adjust order item price ALTER TABLE `jos_vm_order_item` CHANGE `product_item_price` `product_item_price` DECIMAL( 15, 5 ) NULL DEF # Adjust order item final price ALTER TABLE `jos_vm_order_item` CHANGE `product_final_price` `product_final_price` DECIMAL( 12, 2 ) NOT NU # Adjust order total, allowing totals up to 9 999 999 999 999.
Automatic Installation Backend Login Screen You need to have the priviliges of an Administrator / Superadministrator to install Elements. 3. Click 'Installers' => 'Components' (or 'Components' => 'Install/Uninstall' when using an older Mambo version) in the Top Menu. List of installed components Caution You must check if the directories listed above the component list are writable! If the directories are not writable, use ftp or JoomlaXplorer to change the permissions.
Automatic Installation If the upload takes too long, try Step 4 or do the Manual Installation. 4. Alternative: You can unpack the contents of 'com_virtuemart_x.x.tar.gz' and upload those files to a remote directory using a ftp connection. Now specify the directory on the server from where you want to install the files and click 'Install'. Note Package Files are mostly a ZIP or tar.gz compressed file directory, which includes all information for the installation.
Automatic Installation Click 'Modules' -> 'Site Modules' in the Top Menu. Now browse through the list of installed modules and find the one with the name 'VirtueMart Module'. Select it (click on the name) and modify its settings/details. You can now choose where to put the Module on your Joomla! site. For more information about modules please refer to the Joomla! documentation (help.joomla.org [http://help.joomla.org]). Important Anywhere you place the module on your site, IT MUST BE PUBLISHED.
Manual Installation 7. Recommended: Mambot Installation Click on 'Installers' => 'Mambots' (or 'Mambots' -> 'Install/Uninstall' when using an older Mambo version) in the Top Menu. SearchBot: Performs a search on the product table and delivers search results for Joomla's / Mambo's site search. Select the file 'virtuemart.searchbot_x.x.tar.gz' and click 'Upload File & Install'. Mambot ProductSnapshot: Displays product figure/price/add-to-cart link in content items. Select the file 'mosproductsnap_x.x.tar.
Installation FAQ http://www.your_site.com/administrator/index2.php? option=com_virtuemart and submit (press Enter). 7. You should now see the "Installation was successful..." Screen. There you can click on "GO TO THE SHOP >>" or "INSTALL SAMPLE DATA >>" (when you want to have some sample Products and Categories in your Shop). 8. That's it. 9. To install the Modules and Mambots for VirtueMart, follow the instructions of the Automatic Installation, Steps 6 and 7.
Installation FAQ Sometimes the tables beginning with jos_pshop_ or mos_pshop_ are not found. Before you click on "Install sample data" or "Go directly to the shop" you can just type in this URL in the addess bar of your browser: index2.php?option=com_virtuemart&install_type=update12pl3 After that the upgrade procedure begins! 2.2.5.1.6. After the installation I try to access VirtueMart, but it just prints out an error like "store is not a valid VirtueMart module...".
14
Chapter 3. First Steps Do you have installed the VirtueMart Main Module? If not, do so now. Don't forget to publish it somehere on your site. This module is meant to display all categories and to control the component.
Joomla! Global Configuration Caution If you don't change your Store Information and the Email Address, VirtueMart sends Order Confirmation Emails to demo_order@virtuemart.net. Localization / Language Whatever language you set in the Global Configuration: VirtueMart tries to pick it from its own language directory: /administrator/components/com_virtuemart/ languages If the selected language isn't found, the english language file is loaded by default - so never delete it.
Chapter 4. Administrator Tutorial 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.
Global 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.
Global 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.
Security 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-EngineFriendlyness of your shop. Currency Converter Module This allows you to select a certain currency converter module.
Site (Display & Layout) This is the page which will be loaded in the frontend by default. ERRORPAGE 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.
Shipping 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. Note You can change the Category's Number of products per row for each category in its category form! Category Template default: browse_1 This defines the category template for displaying products in a category when no special template is set.
Checkout 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. The selected Shipping Module will list all available Shipping Rates on Checkout. Note 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. 4.1.5.
Getting Started Tip 86400s=24h Keep Product Stock Level on Purchase? When enabled, the stock level for a downloadable product is not lowered although it was purchased by customers. 4.2. Getting Started To access the configuration of VirtueMart, select "Components | VirtueMart" in the Joomla! Administration Interface. Figure 4.2. Joomla! Administrator: Component Drop-Down List If you see the VirtueMart "Welcome" page when accessing VirtueMart, click "Go Directly to Shop".
Store Setup Figure 4.3. VirtueMart Control Panel You may also access this page from within the VirtueMart interface under "Store | Summary" 4.3. Store Setup To begin setting up your store, select "Store | Edit Store" from the VirtueMart admin interface. Figure 4.4.
Store Information Form Fields 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 Required The name of the Store. Store Company Name Required The name of your company. URL The Store's Internet Address. Address 1 Address Line 1 Address 2 Address Line 2 City The City where your Store is located.
Countries, Currencies, Core Modules & Functions Thousands separator 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. Note All currencies selected here can be used at checkout! If you don't want that, just select your country's currency (=default).
Managing Currencies 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.
VirtueMart Core Modules 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.
VirtueMart Core Modules Figure 4.9. VirtueMart Administration: Module List To add a new module, click "New" in the top of the list and fill out the fields in the module form. Figure 4.10. VirtueMart Administration: Currency Form Don't forget to save and the new module is added to the list. You can modify existing modules. To do so, just click on the name of a module in that list and a form opens and you can modify the properties of this module. Again don't forget to save your changes.
VirtueMart Core Functions 4.4.4. VirtueMart Core Functions "Functions" are a core feature of VirtueMart and allow to control the access to all processes in VirtueMart. Functions are executed using the "func" parameter in the URL given the other URL parameters as function variables. Caution You need to act carefully in this part of VirtueMart. Changing Core Functions and their permissions can result in locking out other users or even yourself from the store. Functions are always assigned to core modules.
Manufacturer Administration Figure 4.12. VirtueMart Administration: Function Form Don't forget to save and the new function is added to the list. You can modify existing functions. To do so, just click on the name of a function in that list and a form opens and you can modify the properties of this function. Again don't forget to save your changes.
Manufacturers To create a new manufacturer category, select "Manufacturer | Add Manufacturer Category". Manufacturer Category Form Fields: Category Name The name of the Manufacturer category. Category Description A description of the Manufacturer category (optional). Click on the "Save" icon. You will be redirected to the "Manufacturer Category List" page, showing the "-default-" category, and the new category you just entered.
Product Administration Description Information promoting or about the manufacturer. Click the "Save" icon to create your new manufacturer. Editing Manufacturers To edit an existing manufacturer, select "Manufacturer | List Manufacturers" to see a list of all manufacturers. You may also get to this screen by clicking on the linked text, "Manufacturer List", in the Manufacturers column on the Manufacturer Category List screen.
Product Categories 4.6.1.1. Adding or modifying Product Categories To create a new product category, open the Product Category Form: "Products" # "Add Category". To modify an existing category, click on the name of the category you want to edit in the category list. Figure 4.14. VirtueMart Administration: Category Form Product Category Fields Publish? Used to specify whether the category will be published on the site. Category Name The name that will be used to identify the category.
Products The template file for displaying the products of this category in a list. Category Flypage Syntax: shop.flypage This is the template file for displaying the Product Details of a product in this category. You can create your own templates by modifiying existing templates (in the directory /components/com_virtuemart/ themes/templates/product_details). The file for preparing the display of the Flypage is /html/ shop.product_details.php.
Products 4.6.2.1. Adding/Updating Products To create a new product, click on "Products" # "Add Product" to display the product form. Complete the product entry form and click the Save button in the top right corner to save the new product. When Updating a product, just click on the Product Name in the Product List to display to Product Form of that product. Figure 4.15. VirtueMart Administration: Product List Product Form Figure 4.16.
Products Name The name that will be used to identify the product. URL A URL that can be displayed with a product. Usually used as a link to the product vendor or manufacturer. Category The product categories with which this product will be associated. Vendor The vendor with which the product will be associated. Manufacturer The manufacturer with which the product will be associated. Retail Price The price for the default Shopper Group. Just fill in a decimal number.
Products Figure 4.18. VirtueMart Administration: Product Form, Tab 3 - Product Status Quantity in Stock The current quantity in stock for the item. Used for shipping and inventory purposes. Availability Date When the current quantity in stock is available for distribution. Used for shipping and inventory purposes. Availability Text / Image This is used to display it on the product details page. E.g.: "48 hrs." or "On Order".
Products to add Attributes and after that Items for each Attribute Value using the Item Form. Custom Attribute List Syntax: Attribute1;Attribute2;Attribute3 Adds custom attributes to the product. These are attributes which can be selected by a customer. This does not create items for each attribute value! If you want to check the stock on each item (e.g. green, red and black T-Shirts...use the Attribute Form to add Attributes and after that Items for each Attribute Value using the Item Form. Figure 4.19.
Products po / pound(s) kg /kilogram(m)(s) ou / ounces lb / LB Figure 4.20. VirtueMart Administration: Product Form, Tab 5 - Product Images Thumbnail A thumbnail image that can be displayed along with the product. Full Image A larger image that can be displayed along with the product.
Product Price Management Figure 4.21. VirtueMart Administration: Product Form, Tab 6 - Related Products Now you're done. Just click on "Save" to make sure the changes are stored. 4.6.2.2. Importing Products using CSV Import VirtueMart allows a comfortable, automated mass Import of products using CSV- and Excel-Files. Note You can't import product images using this import, but just the names of the image files. You still need to upload the images into the product image directory.
Product Price Management Figure 4.22. VirtueMart Administration: Product Form, Price Form in the Product Form You can also directly add and modify Product Prices from the Product List. Just click on one of the Price Entries with the yellow background. This opens a Price Form where you can select Currency and Shopper Group this Price is for. Figure 4.23. VirtueMart Administration: Price Form in the Product List Each time you change the Shopper Group from the Drop-Down List, the Form refreshes.
Product Price Management Figure 4.24. VirtueMart Administration: Price Update Notice To add Prices for Quantity Ranges, you need to go to the Product Price List, which is available from the toolbar in the Product List. Figure 4.25. VirtueMart Administration: Product List - List Prices You can also access the Price List for a Product from its Product Form. Just click on "List Prices" as shown in the following figure.
Product Price Management Figure 4.26. VirtueMart Administration: Product Form - List Prices In the Price List for this Product you can find a List of all available Prices, for Shopper Groups and Quantities. That's where you have a great Price overview. In this List you can modify existing Prices by clicking on a Group Name or add new Prices by clicking on the "New" button in the toolbar. Figure 4.27.
Product Attributes Figure 4.28. VirtueMart Administration: Product Price Form Don't forget to save your changes when you're done. 4.6.3.2. Deleting a Price Prices can only be delete from the Product Price List. How to access this List can be read in the Section "Adding or Modifying Prices". In this List you can click on the Trash Bin Icon at the end of the row of each Price Entry to remove a Price. You can also select multiple Prices using the Checkboxes and then click on "Remove" in the Toolbar. 4.6.4.
Items (create Child Products for Parent Products) Product Attributes Form Fields Name The name used to identify the attribute. Number in List The order in which the attribute is listed. 4.6.4.2. Editing product Attributes To edit an existing product attribute, click on "Products" # "List Products" to display the list of products. Then click on the name of the parent product for which the attribute is being edited to display the product entry form for that parent product.
Items (create Child Products for Parent Products) Figure 4.29. VirtueMart Administration: Add Attribute Click on "Add Attribute" and a new window will open displaying the Attribute Form. Complete the attribute entry form and click the Save button in the toolbar to save the new item attribute. Once all item attributes have been defined, it is time to create the individual items (=child products!). Figure 4.30.
Product Types Editing Items Figure 4.31. VirtueMart Administration: Edit Items To edit an existing item, open the product List and click on the "Item Information" Link behind a Product. You will be presented a List of all Child Items of that product. If you want to make changes to a specific item, click on the name of the item you want to edit to display the item entry form for that item. Make your changes and click the save button at the end of the form to update the item.
Product Files and additional images 4.6.7. Product Files and additional images VirtueMart allows to manage additional files and images for each product. The File Manager can be accessed from the Product List: Figure 4.32. VirtueMart Administration: The image icon is the link to the file manager. The number behind the icon is the total number of all files assigned to this product. The File List for a Product contains all files currently assigned to the product.
Product Discounts To add a new file, let's say an .mp3 file which is the file we want to sell, we just open the file form by clicking the "New" button in the toolbar of the file list. Figure 4.34. VirtueMart Administration: File Form You have the chance to upload a new file, which makes sense if you just upload a smaller image or product specsheet.
Product Discounts Figure 4.35. VirtueMart Administration: Access the Product Discount Now fill in the details for this Discount Record: Figure 4.36. VirtueMart Administration: Product Discount Form Discount Amount (required) This is the amount of discount you want to have subtracted (added) from the product price. Has the syntax: 000.0000 (no comma!) Discount Type (required) The Discount Type specifies how the amoung is handled: either as a percantage or as a total amount.
Product Reviews Deleting a Discount You can easily delete a discount. Note that this removes the Discount from all products which are assigned to it. Just go to the Product Discount List and click on the Trash Icon of the row of the Discount you want to delete at the right side of the List. Confirm that you "want to delete this record" and done. 4.6.9. Product Reviews 4.7. User Management VirtueMart comes with an extended User Management compared to Joomla's User Management Features.
Users Figure 4.37. VirtueMart Administration: Shopper Group List To add a new shopper group, just click on the "New" button in the toolbar. In the following shopper group form just fill out the necessary fields. Figure 4.38. VirtueMart Administration: Shopper Group Form 4.7.1.2. Deleting Shopper Groups You can delete Shopper Groups from the Shopper Group List by clicking the "Trash Bin" icon in the last column of each row in the shopper group list.
User Groups 4.7.3. User Groups User Groups are "Permission Groups" and used to restrict access to certain parts and functions of the shop. Each user is assigned to a user group. By default registered customers are members of the group "shopper". When can this be useful? Imagine you have a user, who wants to access the "Report" section of the store. Usually this is restricted to admins and stoeradmins.
User Registration Fields Here you can choose a name for the group and the group level. Note The higher the group level, the less permissions are assumed: "admin" has higher permissions than "storeadmin", because the group level number is lower. After you have saved the user group, it is available in the core module and function list/forms. Figure 4.41.
User Registration Fields or "EU VAT ID". In our example we will add a new field where users from the EU can fill in the EU VAT ID of their company if applicable. Figure 4.43. VirtueMart Administration: Add a new User Field The Form Fields have the following meaning: Type The type of this field. Can't be changed afterwards! Table Field Name The name of the column that will be inserted into the table structure of the tables "jos_vm_user_info" and "jos_vm_order_user_info" in your database.
User Registration Fields Description This description will be shown to the customer in the frontend in a small tooltip besides the field to explain the field. Required? If this is set to yes, a value must be provided or chosen, otherwise registration will not be possible. Show on Account? This defines wether the field is shown in the account maintenance form or not. User Read Only? If this is set to yes, the field is read-only and can't be changed by the customer.
User Registration Fields 4.7.4.2. Modifying Fields Fields can be reordered, renamed, published, set to be required or not and much more. Reordering Fields Fields can be reordered using the blue arrows in the user field list or using the text input fields in each row of the list: Figure 4.45. VirtueMart Administration: Re-Ordering in the Field List If you have used the input fields to change the ordering of the fields, you must apply your changes by clicking the Save Icon in the top of this column.
Order Administration Figure 4.46. VirtueMart Administration: Modifying a Field 4.7.4.3. Deleting Fields You can delete all non-system fields from the User Field List. You just need to click on the Trash Bin icon at the end of the row of the item you want to remove. You can also select the checkboxes of the fields which you want to delete and then click the "Remove" button in the toolbar. 4.8.
The Order List The order record has a ‘status’ to indicate where the order is in the stream of events – for example, whether it has been paid for, shipped, or cancelled. The actual values you use for status are up to you, but by default you are given status values of Pending, Confirmed, Cancelled, Refunded, and Shipped. If you want to define your own status values, you can do so by selecting "List Order Status Types’ from the ‘Order Status’ sub-menu of the "Orders" menu.
The Order Details 4.8.2. The Order Details Figure 4.48. VirtueMart Administration: Upper Part of the Order Details The Order Details View shows all details which are relevant to the store owner. You have three tabs in the upper part: Order Status Change, Order History and Modify Order. Figure 4.49. VirtueMart Administration: Bottom of the Order Details In this part of the order details screen you see the list of all purchased products.
Vendor Administration You can also change the order status for single order items using the status drop-down list in each row of the order item list. 4.9. Vendor Administration Warning THIS PART OF VirtueMart STILL IS NOT COMPLETE. IT'S NOT RECOMMENDED TO USE THIS FEATURE. Vendors and Vendor Categories represent the top most tier of VirtueMart administration. Through vendor administration, the store keeper is able to manage products, users, and orders by vendor or supplier.
Vendor Categories Figure 4.50. VirtueMart Administration: Vendor List for a Category This will open the Vendor List page. 4.9.1.2. Adding Vendor Categories To create a new vendor category, select "Vendor | Add Vendor Category" from the VirtueMart admin interface. This will bring up the Vendor Category Form. Figure 4.51. VirtueMart Administration: Vendor Category Form Vendor Category Form Vendor Category Form Fields Vendor Category Name The name used to identify the vendor category.
Vendor Categories Figure 4.52. VirtueMart Administration: Vendor Category List Vendor Category List You may also add a new vendor category with the Vendor Category Form by clicking on the "New" button in the toolbar. 4.9.1.3. Editing Vendor Categories To edit an existing vendor category, select "Vendor | List Vendor Categories" in the VirtueMart admin menu. This will return the Vendor Category List screen (shown above).
Vendors Vendor Category Deletion Click 'OK' to confirm deletion of this category. 4.9.2. Vendors Vendors are the main organizational factor in VirtueMart. Products and product categories, billing options, etc. are all configured per-vendor. Upon installation, a global, default vendor is created. This special case cannot be deleted, and is managed separately via the "Store | Edit Store" menu option.
Vendors Description This is the Vendor 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. Store Name Required The name of the Vendor Store. Store Company Name Required The name of the vendor company. URL the vendor's Internet Address. Address 1 Address Line 1 Address 2 Address Line 2 City The City where the vendor is located.
Tax Rates Before deleting an existing vendor, all products, product categories, users, and orders associated to that vendor must be removed through either deletion or re-association to another vendor. VirtueMart will not allow the deletion of a vendor while these child records still exist for that vendor. Once these child records have been removed, select "Vendor | List Vendors" to see a list of all vendors. Then click on the name of the vendor you would like to delete.
Shipping Modules Tax Rate Example: 0.0825 The tax rate, as a decimal value. For example, 8.25% would be entered as 0.0825 Click on the "Save" icon to add your new Tax Rate information. 4.11. Shipping Modules 4.11.1. Standard Shipping It is wise first of all to think about how you will charge for postage and packing. The easiest way is to have a fixed shipping price for all of your products, but this is not always practical – especially if your products vary greatly in size and/or weight.
Standard Shipping Figure 4.55. VirtueMart Administration: Shipping Rate List By clicking on the name of a shipping rate in this list, you can access the shipping rate form to edit this shipping rate. To add a new shipping rate, click the "New" button in the toolbar.
Standard Shipping Figure 4.56. VirtueMart Administration: Shipping Rate Form In this form you can specify the details of the shipping rate. Shipping Rate Description This is the name of the Shipping Rate, displayed to the customer in the checkout. List Order The order of this shipping rate in the list of all other shipping rates (numeric value). Shipper Select the carrier for this shipping rate. Country The country/countries this shipping rate applies to.
UPS Shipping Module Fee The Fee for this shipping rate = the costs. Package Fee The package fee = additional costs for packaging. Currency The currency, which applies to the costs you have filled in above. VAT ID Here you can select a tax rate which is applied to this shipping rate. If you select "none", no tax will be applied. 4.11.2. UPS Shipping Module 4.11.3. USPS Shipping Module 4.11.4. Intershipper Shipping 4.11.5. Zone Shipping 4.12.
Add and Edit Payment Methods The configuration options for each payment method are different – depending on what is required by that payment service provider. Usually your payment service provider will give you some kind of code, key, or user name which needs to be entered in the Payment Method Editor. The Payment Method Editor consists of 2 tabs – the first of which you will probably not need to touch.
Pre-Configured Payment Methods See the Section "Pre-Configured Payment Methods" for more details on specific payment gateways. Other payment service providers may use different methods of automatically notifying you when a payment is received. Again, it is probably easiest to get your web designer to sort out the requirements for this, but if you need to do it yourself, check with your payment service provider as to what their requirements are.
Pre-Configured Payment Methods finishes the Payment, Worldpay copnnects to this script on your server and when the transaction AND the payment have been successful, updates the order status. 4.12.3.3. authorize.net www.authorize.net This payment module uses the authorize.net AIM method, which means that the customers stay on your site and enter all Credit Card details. When the order is being completed, the Payment Module connects with authorize.
Coupon Administration See section "authorize.net". 4.12.3.8. NoChex ... 4.12.3.9. PayMeNow ... 4.13. Coupon Administration You can access the list of coupons from the menu: "Coupons" # "Coupon List". Figure 4.60. VirtueMart Administration: Coupon List Here is where you can add, modify or remove existing coupons. To add a new coupon, click the "new" button in the toolbar. The coupon form shows up. Figure 4.61.
Reports Now you need to fill in the necessary value for the new coupon: Coupon Code This is the "code" a customer needs to fill in to redeem this coupon. This can be a simple word or a secret string with numbers and characters. Percent or Total Here you can choose wether the coupon value is a percentage of the cart total or a fixed total value. Coupon Type There are two types of coupons: Gift Coupons and Permanent Coupons.
78
Chapter 5. About VirtueMart 5.1. Known Problems See Bug Tracker [https://dev.virtuemart.net/cb/proj/tracker/browseTracker.do?tracker_id=1] 5.2. To-Do List 5.2.1. Wishlist / Not implemented Features • Meta Description/Keywords for products • Quick-Add: Discount on *all* Products • allow "send as gift" with individual text on order • Shipping based on Cart Total 5.2.2. General • improve performance • improve Security • Clean up code • XHTML compliance • Clean up checkout 5.3.
The Documentation There's also an active Forum, where discussion and bug reporting can take place: Forum [http:// forum.virtuemart.net/index.php]. 5.5. The Documentation This documentation was written using XMLMind XML Editor [http://www.xmlmind.com/xmleditor] using the DocBook [http://www.docbook.org] XML Format. DocBook defines a set of markup elements useful for marking up text so that the text can then be transformed into several different formats.
