Home

VirtueMart User's Manual

Contents

1. N Publish Ui blish R Reload Ces O New Publish Unpublish j Remove jReloa M Products VW A Use CSV upload vi Category Tree Search Products Category Name Category Description Products Publish ListOrder 3 Ze Ren List Products O Add Product 1 7 MN Hand Tools Hand Tools 3 Show v Y 1 View inventory 2 7 11 Power Tools Powe r Tools 2 Show v a Y 2 Special products Ela nM 3 12 Outdoor Tools Outdoor Tools 1 Show v w 4 roduc ders af Indoor Tools Indoor Tools 1 Show v 5 gt Product Disco sr s Add Edit Prod a Garden Tools Garden Tools 4 Show v a 3 gt Product Type List Add Edit Product Type 7 List Categories Add Category Figure 4 13 VirtueMart Administration Category List 34 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 e Category Infor mation Images Publish ke Category Name Category Description show hide OQBIVER Seem 2 X Bw eH 4h x x ZZE da Styles Font family sii Font size zl A a Q Format vf ESTAS DA a YT dl A pP v Path A S image E page brear ListOrder New items default to the last place Ordering can be changed after this
2. REL EAS E 1 0 13a nDEV_STATUS stable you must change the jos to your prefix mostly The queries can be found in the file sq1 UPDATE SCRIPT VirtueMart 1 0 x to VirtueMart_1 0 3 sql and sql UPDATE SCRIPT_VirtueMart_1 0 3 to VirtueMart_1 0 5 s ql Automatic Installation VirtueMart is a complex script It s not component only but also requires a Module So it comes to you in a file called VirtueMart_x x_COMPLETE_PACKAGE zip This file contains various Elements for VirtueMart Important This file is not installable Its contents are but they must be unpacked first Package Contents 10 additional Modules 2 Mambots 1 Search 1 Rh Unpack the file Virtu 1 Component com_virtuemart_x x tar gz Content Mambot eMart x x COMPLET 1 Main VirtueMart module nod virtuemart x x tar gz E PACKAGE zip toa local directory 2 Log in into Mambo s Backend using the URL http joomla_url administrator to access the administrativ e interface Automatic Installation FA Login ES Username Welcome to Joomla Use a valid username and Zeie password to gain access to the administration console Login Joomla is Free Software released under the GNU GPL License Backend Login Screen You need to have the priviliges of an Administrator Superadministrator to install Elements Click Installers gt Componen
3. Reload Add Edit a User Group Jser Group Name New Group Jser Group Level 500 Q9 Figure 4 40 VirtueMart Administration User Group Form 55 User Registration Fields 4 7 4 4 7 4 1 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 D Module List Search S t Module Name admin storeadmin shopper eb md T Functit admin r r dA a e Functic D store FF r Fr D e Functic product NF n n List Figure 4 41 VirtueMart Administration The New Group in the Module List Now you can start to grant permissions to this new group by checking the boxes in this list for the column of the New Group Important The same needs to be done for the function list of each module User Registration Fields The User Fields Management allows you to freely modify the fields displayed on registration and account maintenance Such fields are for example First Name Last Name Telephone The User Field Management can be accessed via Admin Manage User Fields CEST S New Publish Unpublish Remove Reload amp Users A User Groups i 4 p Manage User Fields cn e Manage User Fields List Countries Ad
4. order a Ani JE order BLE E Q EH E E V V OS V order su m final price m order item final price al m orders otal order total m orders btotal Allow larger coupon amounts ALT A R TABLE HANGE cou R TABLE HANGE pon bi Q ALT cou Q pon Allow larger ALTER TABLE j HANGE R TABLE HANGE A E Q ALTI payment PDATE WHE RE name If you have another database prefix than jos 1 mos then OS V OS V value pay OS V order d jos v jos components m orders discount m coupons product ite produc allowing totals up to 9 999 999 9 D order subto coupon discount NULL DEFAULT NULL D m price DECIMAL 15 5 t final price DECIMAL 12 NOT 99 999 99 2 ECIMAL 15 5 NULL DEFAULT NULL tal D ECIMAL 15 5 D ECIMAL 12 2 NOT D coupon value ent discounts m orders iscount m payment method method discount m S virtue ET params mart version D order discount paymen ECIMAL 12 2 NOT NULL DEFAULT DECIMAL 12 2 nt D method discou ECIMAL 12 NULL D GI N NULL DEFAULT NU NULL DEFA 0 NOT NULL DEFAUL 2
5. O New Remove Reload d Function List admin SENT D Function Name Class Name Class Method admin storeadmin shopper demo ARsch none ls Remo Permissions 1 i adminPasswdUpdate ps user update admin passwd Le L IR F z I 1 2 n changeordering vmAbstractObject class handleordering jo Lj DL r F F D 6j 3 countryAdd ps country add Le Le mW E F F D 6j 4 countryDelete ps country delete Le Le Cj rr F F H 5 countryUpdate ps_country update na Le r F 5 4 6 curencyAdd ps currency add I L r F mi 4 7 currencyDelete ps currency delete Le i Fr F x II 8 F currencyUpdate ps currency update Le Le Li Lr F i 1 D F functionAdd ps_function add r1 F Fr F PR II A 10 functionDelete ps_country show_checkout_bar Le Li Li r F Lr 1 E 11 functionUpdate ps function update EX m L3 r F Lr 1 Figure 4 11 VirtueMart Administration Function List To add a new function click New in the top of the list and fill out the fields in the function form 31 Manufacturer Administration Save Cance Reloa load Function Information Function Name Class Name Class Method add xl shopper Function Ferms storeadmin 3 admin Ma Restriction Se Function Description 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
6. Proxy Auth Password Only if needed the matching password for authentication at the proxy server Site Display amp Layout VirtueMart makes use of the Joomla Mambo Templates CSS It uses the Standard CSS Classes defined for Joomla like sectiontableheader sectiontableentryl sectiontableentry2 and so on 4 1 3 Display PDF Button Show or Hide the PDF Button in the Shop Frontend Show the Recommend to a friend Show or Hide the link to the form for recommending a product button 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 default checked of the Product Listing 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 ps_image 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 Design Global Shop Theme He
7. 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 Title This is the Label of the Field in the Registration Account Maintenance Form 57 User Registration Fields Description Required Show on Account User Read Only Show at Registration Published Size Max Length Move the customer into the following Shopper Group This description will be shown to the customer in the frontend in a small tooltip besides the field to explain the field If this is set to yes a value must be provided or chosen otherwise registration will not be possible This defines wether the field is shown in the account maintenance form or not If this is set to yes the field is read only and can t be changed by the customer If this is set to yes the field will be shown in the registration form Here you can unpublish the field completely so it won t be shown in any form This defines the length of text input fields This is the maximum number of characters that can be filled into the text field Here you can select into which shopper group the newly registered customer is moved when the EU VAT ID has been succesfully validated If you are finished filling in the necessary values don t forget to Save your changes Here is a screenshot
8. Used to indicate whether there are any specials running for the product When checked this product will be displayed on the Featured Products Module Discount Type The type of special being run on the product Select a discount from the discount list When there are no discounts create one using the Product Discont Form Advanced Attribute List Syntax Size XL 41 99 M S 2 99 Colour Red Green Y ellow ExpensiveColor Adds easy 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 39 Products to add Attributes and after that Items for each Attribute Value using the Item Form Custom Attribute List Syntax Attributel 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 Q Save Cancel Reload MIMI New Product Product Information Display Options Product Status Product Dimensions and Weight Proc Product Dimensions and Weight Length Ir Width TI Height Ir Unit of Measure inches Weight Unit of Measur
9. It will need some file copying 1 2 Download the Manual Installation Package This is just another Package Form of VirtueMart Unpack the archive file VirtueMart_x x_Manual Installation Package tar gz you have downloaded in Step 1 to a local directory using Winzip or Winrar You should now see at least four directories The directory structure in those directories is the same as in your Joomla Mambo site administrator components mambots modules Open up an FTP Connection to your site you should use an FTP Program like SmartFTP and upload the directories to the root of your Joomla site site root administrator site root components site root mambots site root modules Login in to the Backend Administration of your site http www your_site com administrator When having logged in you see this URL in the address bar http www your_site com administrator index2 php Now just add option com_virtuemart after index2 php so it looks like this in your browser s address bar 11 Installation FAQ 2 2 5 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 gt gt or INSTALL SAMPLE DATA gt gt when you want to have some sample Products and Categories in your Shop 8 That s it 9 To install the Modules a
10. Pending v Product Price Net Product Price Gross Total 58 19440 67 51 67 51 Update LO1 Order Status 79 99000 86 59 86 59 Pending vf Update P03 1 Order Status 48 12000 52 09 52 09 Pending Update H02 Order Status 2 00000 2 17 2 17 Pending v Update SubTotal 188 31375 Tax Total 20 24 Shipping and Handling Fee 0 00 Shipping Tax 0 00 Fee 2 00 Total 210 36 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 If the products are downloadable products you can re send the Download Notification Email or re initiate the downloads if the maximum download number has been reached or the download period has expired 62 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 4 9 1 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 TODO heirarchial drawing For simple stores where there are only a few products offered vendor administration is not necessarily needed but for larger more complex stores such as a
11. 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 The target width of the resized Thumbnail Image The target height of the resized Thumbnail Image In the Shipping section you can select one or more of the provided Shipping Modules Tip 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 22 Checkout 4 1 5 4 1 6 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 Checkout Enable the Checkout Bar default Enabled Check this 1f 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
12. s sserssrseersrorerrrsrrrrerrrrrrrrrrrrrrrr semissem ese sese seen 63 ATO Tax Rates na dir rn rav 68 4 11 Shipping Modules og re reete one eret ve erbe Does s yeso Een 69 4 12 Payment Methods 4 eee ero EP PO RISE EELER POTES EE dE eeh E 72 4 13 Coupon Administration ss rssieersstevsesisivesersbvenissssssr I eene emen entere 76 4 14 Reports co eer SR Piece ER eX hotter on erate pos Pd eS Up TE M EET TI 5 About Virtue Mart ie ERR E VEND MN ON EE RES 79 Fal Known Problems oer er er eue mE EE 79 SPAM o O n 79 5 3 The Projects ettet A DEE 79 5 4 The Community EE 79 5 5 The Documentation ssi err e EP Po ERR REPTO RE E D PUR EN GT etes 80 vi List of Figures 1 1 Frontend Category Overview Page s csccssscsestsssseastas e sintiera 3 1 2 Frontend Product Details Page with Review Feature sssmsomsssrssesrrsrererrrsrerrrsrerrrrrerrrrrrr er rr rna 3 1 3 Administration Homepage Summary Statistics s sssssssesserresrerrerrerrerrerrrrrrrerrrrrrrrrrrrr rena 4 1 4 Administration Product List 4 4 1 The Configuration om iot eo e eg re PRO E Ree ER E EEN 17 4 2 Joomla Administrator Component Drop Down List s sssssssssseeserrrsrerresrerrerrrrrrrrrrrrrr rr rna 24 4 3 VirtueMart Control Panel ed oir et rer ERR ER EE EXER REPE role 25 4 4 VirtueMart Administration The Store Form cooococcnccocononnconcnncononocononocononnconanoconanoconos 25 4 5 VirtueMart Administration Country List 27 4 6 VirtueMar
13. varies VirtueMart sends Emails using the global Mail Configuration So be sure to modify the Values according to your Server 15 Joomla Global Configuration Localization Language Search Engine Friendly URLs Caution If you don t change your Store Information and the Email Address VirtueMart sends Order Confirmation Emails to demo_order virtuemart net 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 Recommended Off VirtueMart is fully SEF compatible but please note that some the SEF links for VirtueMart which are generated by Joomla s Mambo s SEF module or others sometimes lead to URL redirection limit exceeded or internal server errors 16 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 4 1 1 Global 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
14. 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 If you assign this user to the admin storeadmin group he will also be able to access other sensible parts of the store where he could change or delete important data The solution is to add a new User Group called Report which will have the same permissions as shoppers PLUS access to the report core module After the Group has been added you can assign this user to the new group User Groups can be added modified and deleted from the User Group List Admin User Groups O New Q Remove Reload e User Group List Search E User Group Name User Group Level Remove 1 PR admin 0 fi 2 Li storeadmin 250 A7 3 m shopper 500 A7 4 m demo 750 5 m New Group 1500 A7 Figure 4 39 VirtueMart Administration User Group List You can click on the name of an existing group to open the user group form Note The groups admin storeadmin and shopper are key groups in VirtueMart and can t be modified nor removed You can add a new Group by clicking on the New button in the toolbar This opens the User Group Form v Save Q Cancel
15. A nufacturer aw a 3 A Saw oA 2 gt 2 2 ovel Item Information lt 2 tem Information E PO P033 H02 G01 Price 20 90000 pufaciurer Shopper Group defaut El nufacturer Currency US Dollar nufacturer nufacturer Hand Tools Manufacturer ro Garden Tools Manufacturer Customer Reviews Add Review Add Review Add Review Add Review Add Review Add Review Clone Publish See w y X 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 If the Price Field is empty there s currently no Price for this Shopper Group You must save your Changes for the Price of a certain Shopper Group before you switch to another Shopper Group or your Changes will get lost So just click on Save and your Changes will be saved 43 El Product Price Management Customer Clone Reviews Wf Product Add v Revi o Info The product price sii has been updated Add y Review Add Review v Add i Review v tem Information 99 Go Hand Tools Manufacturer Jidd w 2 USD Review nformation 5 G02 m Garden Tools Manufacturer erdt y 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
16. CJ Reload Payment Method Form Payment Method Form Configuration Active Payment Method Name PayPal Code PP Payment class name Ps _paypal si O Payment method type Credit Card L Use Payment Processor C Bank debit L2 Address only Cash on Delivery HTML Form based e g PayPal Shopper Group defautt y Discount 0 00 Gd Discount Type Percentage Y Total Maximum discount amount Doo Minimum discount amount poo List Order p Figure 4 58 VirtueMart Administration Payment Method Editor Some payment processors will allow you to specify a script to be run on successful completion of a payment Such a script could be used to automatically update the order status in VirtueMart so that you don t have to manually tie up all of your online receipts with your product orders Another advantage of this process is that when you re selling downloadable files you don t have to set the Order Status that enables the Download this sends out the Download ID email manually This is done automatically by the script 73 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 che
17. Group Just fill in a decimal number Select the Product Currency from the drop down list at the right VAT ID The ID of the tax rate that will be applied to this product Here you can select a specific tax rate for this product If you don t want that this product is taxed fill in a zero weight at product weight and Disable Virtual Tax Short Description The short description that will be displayed on the browse overview page for a category or search result Flypage Description This is the details description that will be displayed on the Flypage details page of this specific product Display Options v Save Q Cancel Reload 4200404 11 New Product Product Infor mation Display Options Product Status Product Di mensions and Weight Product Images Re Display Options Use Parent Settings L3 Override Child products Display Values and use parents List Use List box for child List Style products S ee One Add to Cart Button Display Child Description Add to Cart Button for 0 Child Description each Child Width Display Table Header how Child Attribute Lin to child product from Width list Child Class Suffix Include Product Type With Child Extra IDs Product IDs to include Quantity Standard Quantity Box Drop Down Box Values Hide Quantity Box Start Value Use Dropdown Box End Value Use Check Box Use Radio Box 1 AARMA Figure 4 17 VirtueMart Administration Product Form Tab 2 D
18. Name derma shopper Es storeadmin 3 admin Mo Restriction Se Module Perms Show Module in Admin menu Yes D Display Order Madule Description 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 To remove one or more modules from the list either click on the trash bin icon in the last column of each row and confirm to remove the module or select modules and click on Remove in the toolbar 30 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 So at first you need to go to the module list Admin List Modules and then click on Function List in the row of the module you want to manage functions for If you have done this you can see a list of all functions for that module
19. Parameters 4 6 6 3 Product Type Relations 49 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 Wl Product List Search a Product Name mi Chai n Saw Circular Saw of Gren Hammer Hand Shovel Item Information Ladder Item Information Nice Saw Power Sander Shovel Cl wa Cl wa Cl A O Smaller Shovel E m 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 Files can have different roles like downloadable file to be sold additional file and additional image O New Cancel Remove Reload Search FileManager Image File List for Chai n Saw Filename Role View File Title File Type Published Remov 1 F normal_333 1206 1871 1 jpg N normal_333 1206 1871 1 jpg w i A 2 Chain Saw 458beft939727 jpg E LE iie d View Chain Saw 458beffa30727 jpg jpg v fi TC res JEEP mv D Q Figure 4 33 VirtueMart Administration File List 50 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 too
20. Product Type New Publish Unpublish Remove Reload Search Product modified v Afer xj 15 34 16 4 2007 Search FF Selecta category Zo Product List esce Administration SEI Customer Clone gt Admin 7 Product Name Media SKU Price Category Manufacturer SC Publish product Remove Id D Store 1 chain saw 0 Po 14999USD Outdoor Tools Manufacturer d Zu O D 19 Products W Use CSV upload 2 7 Circular Saw 2 poz 22080USD Power Tools Manufacturer Paca v D e At Kee 3 T pa 2 Po 4812USD indoor Tools Manufacturer Re v D o e Add Add Product 4 7 Hammer 2 Ho2 2 00USD Hand Tools Manufacturer Review w Du 6 d Meu katary 5 HandShovel tem information B cot 499USD Hand Tools Manufacturer d v amp Special products SES R Product Folders 6 7 Ladder Item Information BA 602 4999USD Garden Tools Manufacturer SN v i 2 Product Discount List 7 Nice Saw 0 mm 2499USD Hand Tools Manufacturer pats v mi 5 Add Edit Product Discount 8 7 Power Sander 0 pos TAS9USD Power Tools Manufacturer Pardo v 10 Product Type List Add Edit Product Type 9 Shovel 2 603 2498USD Garden Tools Manufacturer Sc v a 3 List Categories 10 7 Smaller Shovel 0 co 1888USD Garden Tools Manufacturer Pest v Bo Add Category A ee Y Figure 1 4 Administration Product List Chapter 2 Installation 2 1 Joomla Mambo Installation Joomla and Mambo must be installed prior to the Instal
21. 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 Payment Methods The area of payment processing can get a bit complicated and it might be best to leave this to your web designer to sort out if possible If you are able to use one of the payment processing companies that are already supported by VirtueMart 1t will make life a lot easier you will need to sign up with a payment processor yourself the program won t do that for you You can see the options available by clicking on the List Payment Methods icon on the store summary or by selecting List Payment Methods from the Store menu 4 12 1 Payment Method Management Simple Layout Extended Layout a lt Publish Unpublish Y Remove Reload e Payment Method List Administration I SEOOUOLLLLLLLLLXGILRIALIEALLQXOLLLLLLESLLLA ESEXEEELLUILAALLLLLLSSI LnqLLLU O O D Name Code Discount Shopper Group Payment method type Active Remove 2 Admin 1 2Checkout 200 0 00 default HTML Form based e g PayPal v d 1 Store D Summary 2 Credit Card AN 0 00 default Use Payment Processor x I Edit Store 3 Credit Card cc 0 00 default Credit Card wv i 7 List Payment Methods 4 Credit Card eProcessingNetwork EPN 0 00 default Use
22. VirtueMart Tables so let s do a fresh installation Make a Donation Basic Installation has been finished You can To fill your Shop with dummy products and use VirtueMart in a moment after having to see how things can be set up you can clicked on a link below install some Sample Data now Go directly to the Shop gt gt Install SAMPLE DATA gt gt Goto virtuemart net for further Help Installation Welcome Screen You can now choose whether you want to install Sample Data 18 products with attributes in 5 categories to see how things have to be set up Or you can go directly to the Shop gt gt without installing Sample Data Caution This step again takes some time amp the VirtueMart installer is running a lot of Database Queries now So please be patient 6 Click Installers gt Modules or Modules gt Install Uninstall if you re using an older Mambo version in the Top Menu to proceed to the installation of the VirtueMart Main module Choose the file mod_virtuemart_x x tar gz in the File Dialog and click Upload File amp Install Repeating this step you can install the additional modules for VirtueMart Publishing the Module Automatic Installation Click Modules gt Ste 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
23. category fields have been populated for you and item attribute fields for the attributes you have defined are now available Complete the product entry form and click the Save button in the toolbar to save the new item 48 Product Types Editing Items Product List Product Name Chain Saw Circular Saw L 703 171 Drill Hammer Hand Shovel Item Information 11 1 7 Ladder ltem Information 7 Nice Saw 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 Click on the Return to Parent Product link at the top of the page to edit another item Deleting Items To delete an item List the Product s Items like in the previous section Then click on the basket at the end of the row of the item you want to delete If you want to delete all items you must delete each item before deleting the parent item Once all items have been deleted click on the Delete button at the end of the product entry form of the parent item to delete the parent item 4 6 6 Product Types 4 6 6 1 Product Type Management 4 6 6 2 Product Type
24. 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 Managing Currencies Currencies are managed in the currency list which can be accessed through Admin List Currencies O New Remove Q Reload a H Currency List a D 5 Currency Name Currency Code Remove 1 Afghanistan Afghani AFA 1 2 Andorran Peseta ADP ku 3 7 aok AOK fi 4 Argentiniean Peso ARP i 5 Aruban Florin AWG if 6 Australian Dollar AUD ku 7 Bahamian Dollar BSD 5 8 Bahraini Dinar BHD i 9 Bangladeshi Taka BDT La 10 Barbados Dollar BBD di 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 28 VirtueMart Core Modules 4 4 3 YA Save 3 Cancel O Reload Add Currency Currency Name Currency Code 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 yo
25. item is saved Parent Default Top Level Ez Show x products per row 1 Category Browse Page managed y Category Flypage flypage tpl vi 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 Category Description The description that will be displayed for the category ListOrder The Place of this category in a list with other categories Parent The parent category with which this category will be associated If the category is to be a top level category leave the Parent drop down list with the Default Top Level selected If the category is to be a sub category of an existing category choose the appropriate parent category from the Parent drop down list Show x products per row The number of products per row when displaying products of this category Note The Browse Page usually has to be adjusted when the number of products per row has been changed You can use browse 2 for 2 products per row browse 3 for 3 products per row and so on maximum per default 5 Category Browse Page Example browse 1 35 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 b
26. 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 4 1 Shop Configuration The Configuration Panel is the most important part of VirtueMart It can be accessed via Admin Configuration v Save Q Cancel Configuration lopt lampp htdocs joomla administrator components com virtuemart virtuemart cfg php Writeable Global Path amp URL Checkout Downloads Feed Configuration Global Price Configuration Shop is offline r5 If you check this the Shop will display an Offline Show Prices e 7 x Membergroup to show Le Enable this feature Offline Message lt h2 gt 0ur Shop is currently down for prices to EAE p O aintenance lt h2 gt Please check back again Registered soon Author Editor v Show including XX O tax when applicable Show the price label Use only as catalogue If you check this you disable all cart functionalities for packaging e O Frontend Features Tax Configuration Enable content Virtual Tax 7 O mambots plugins in O descriptions Tax mode Based on vendor address vf O Enable Coupon Usage 7 O Enable multiple tax rates O Enable Customer I 7 Review Rating System Subtract payment Auta Dublich Dauiaue 77 Lo discount before E Di e Figure 4 1 The Conf
27. 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 Check this if you have products with different tax rates e g 7 for books and food 16 for other stuff 18 Global Discount before tax shipping User Registration Type Show the Remember me checkbox on login Customers can select a state region Must agree to Terms of Service Agree to T o S on EVERY ORDER Show information about Return Policy on the order confirmation page Legal information text short version Long version of the return policy link to a content item Check Stock Sets the flag whether to subtract the Discount for the selected payment BEFORE checked or AFTER tax and shipping 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 persistant 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 hidd
28. missing You need to make sure that the tables jos vm functions and jos vm modules have been created in your database and contain records If they are missing you can add those tables manually by using the SQL installer file sql virtuemart installation joomla sql Search for those tables copy the SQL code and paste it into the textarea in phpMyAdmin s SQL execution screen 2 2 5 After having installed the component I add a Main Menu Link to the VirtueMart component But clicking on that link only displays the text Welcome to Washupito s What s wrong VirtueMart is no component only script It s programmed to be used together with the corresponding VirtueMart Main Module VirtueMart will not operate properly without the VirtueMart Main Module 13 14 Chapter 3 First Steps Do you have installed the VirtueMart Main Module Tf 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 Note All following procedures mean that you use the Main Menu of the VirtueMart Administration Tip VirtueMart provides FULL ACCESS to its Administration Panel from the Frontend That means that you don t have to login at the backend of your site to make all your changes but just click on Administration in the VirtueMart Main Module requires admin or storeadmin permissions 1 Go to Store gt Edit Store and make all important se
29. of your company The Store s Internet Address Address Line 1 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 The ZIP of your Store s location Your Store s Phone Number The Name of your Contact Person The title of the Contact Person Your contact s Phone number The Fax number for the Contact Primary store contact email address Required Displays the currently configured store logo Optional Browse to your company logo This will be uploaded when you click on the Save icon This is the amount which is the minimum Order Value for Checkout This is the amount from which on Shipping is free The Store s global default Currency This is the currency symbol which will be used when displaying prices Number of decimals Can be somethin like or empty 26 Thousands separator Positive format Negative format List of accepted currencies Description Terms of Service Countries Currencies Core Modules amp Functions Display Order Style for positive numbers Display Order Style for negative numbers 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 This is your Store s Description which is shown on the pag
30. 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 Editing Manufacturer Categories To edit an existing manufacturer category select Manufacturer List Manufacturer Categories in the VirtueMart admin menu This will return a list of existing manufacturer categories Click on the name of the manufacturer category you want to edit make any necessary changes to the fields listed above and click on the Save icon You will be returned to the Manufacturer Category List Deleting Manufacturer Categories Before deleting an existing manufacturer category all manufacturers associated to that category must be removed through either deletion or re association to a different manufacturer category VirtueMart will not allow the deletion of a manufacturer category while manufacturers still exist for that manufacturer category See below under Manufacturers for information on re association and deletion of a manufacturer Once the manufacturers have been removed select Manufacturers List Manufacturer Categories from the VirtueMart admin menu Click on the name of the manufacturer category you want to delete In the Manufacturer Category Form click on the Remove icon Click OK to confirm that you are sure you want to delete this category You will be returned to the Manufacturer Category List Note that the man
31. the default category and the new category you just entered Vendor Categories Back to Joomla Administration VirtueMart Administrat gt Products A gt O New Reload gt Shopper eech Vendor Category List wm 7 Vendor List Vendors BEE Add Vendor Category Name Category Description Vendors Remov E 1 defaut Default List ji gt Tax gt Shipping gt Coupon gt Manufacturer v gt Help w j j gt 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 Click on the linked text showing the name of the vendor category you would like to edit to bring up the Vendor Category Form When you have finished making changes click on the Save button You will be redirected back to the Vendor Category List screen 4 9 1 4 Deleting Vendor Categories If you remove a vendor category all vendors in that category will be reassigned to the default vendor category that was created upon installation You can then re associate the affected vendors if needed as described below under Vendors To delete a vendor category just go
32. the fields Approved URL and Pending URL 5 Fill in the secret word from Step 1 into the Field Secret Word 6 Move the file YOUR JOOMLA PATH administrator components com virtuemart 2checkout notify php to YOUR JOOMLA PATH 2checkout notify php means into the Mambo root When those steps have been completed you can use 2Checkout with automatic Order Status updates on your site 4 12 3 5 eWay WWW eway com au This payment module implements the eWAY XML Payment Solution The customers stay on your site and enter all Credit Card details When the order is being completed the Payment Module connects with the eWay gateway and tries to initiate the Money Transfer using the Payment Details of the buyer 4 12 3 6 Paymate 4 12 3 7 eProcessingNetwork com www eProcessingNetwork com 75 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 New Remove Reload e 0 0 Coupon List E Code Percent or Total Coupon Type Value Remove 1 IT test2 Percent Permanent Coupon 15 00 a 2 E test3 Total Permanent Coupon 4 00 AT 3 T test4 Total Permanent Coupon 1000 00 a 4 test1 Percent Permanent Coupon 500 00 AT 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 butto
33. 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 If it is not you can t access or browse your shop Additional modules mod_product_categories mod_productscroller mod_virtuemart_allinone mod_virtuemart_cart mod_virtuemart_featuredprod mod_virtuemart_latestprod mod_virtuemart_manufacturers mod_virtuemart_randomprod mod_virtuemart_search mod_virtuemart_topten Product Categories Module It can display the product categories you have set up Product Scroller Module It can scroll certain products somewhere on your site using a marquee tag All in one module Can display the latest featured top ten or random products in one module using tabs Mini Cart Module Displays the mini cart for the customer with a link to the cart page Featured Products Module Can display featured products in your store Featured products are those which are on special Latest Products Module Displays the newest products in your store Manufacturer Module Shows all manufacturers from your store with a link to find all products of the selected manufacturer Random Products Module Does what the name says displays random products from your store or a certain category Searchbox Module Displays the VirtueMart
34. to the Vendor Category List screen Click on the trash can icon in the Remove column next to the name of the vendor category you would like to delete New QReload Vendor Category List Search Die Seite mit der Adresse http localhost meldet Categc Vendors Remov a 2 9 Are you sure you want to delete this record 1 defau ye List A7 2 Newd List Ti Abbrechen OK M d Figure 4 53 VirtueMart Administration Vendor Category Deletion 65 Vendors 4 9 2 4 9 2 1 Vendor Category Deletion Click OK to confirm deletion of this category 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 If you are running a shopping site for a single vendor for example if you are the only vendor that will be offering products in your store then there is no need to create additional vendors If however you will be running an online mall site that will be host to several vendors then create one vendor account for each storefront owner It may be worth noting here that you should not confuse vendors with manufacturers A single vendor may have a different manufacturer for each product that they offer If the person supplying the products on your si
35. 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 Not only do you need to think about shipping rates but also shipping methods Will you offer more than one shipping method eg next day delivery as well as standard DHL as well as Royal Mail Even if you decide to only use one company for all of your shipping you still need to tell VirtueMart about it To set up a new shipper select Create Shipper from the Shipping menu This takes you to shipper editor v Save Cancel O Reload Shipper edit create Shipper Company Listorder Figure 4 54 VirtueMart Administration Shipper Form List order is just a numeric value which is used to sort the shipper names so enter 1 for the shipper that you want to be listed 1st 2 for the one you want to be listed 2nd etc When you have added the shipping companies you want to use you need to configure the shipping rates You can set up different rates for different service levels eg next day two day first class etc or according to the weight of the shipm
36. 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 Downloads 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 DOWNLOADROOT The physical path to the files for the custumer download trailing slash at the end Important Must be a physical path no URL Caution For your own shop s security If you can please use a directory ANYWHERE OUTSIDE OF THE WEBROOT 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 23 Getting Started Tip 86400s 24h Keep Product Stock Level on When enabled the stock level for a downloadable product is Purchase 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 j x Joomla Administrator H
37. 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 customizable is sent to Shopper and Store Owner manage different Currencies Countries amp States use safe SSL encryption 128 bit capable of live Credit Card Processing e use payment gateways like authorize net http www authorize net eWay Worldpay PayMate and NoChex e use PayPal http www paypal com or the 2Checkout IPN gateway extend your Shop with other Payment amp Shipping Modules or just write your own many more Just browse to virtuemart net http virtuemart net for more Features amp Extensions 1 2 What does it not do VirtueMart is a simple Online Shop application But it is surely no out of the box killer application for professional companies It s not tested in 10046 secure environments It s not meant to be 10096 performant You will need some time to customize this application to fit your needs Be prepared to be confronted with bugs which have currently not been found yet VirtueMart has an active community and a forum where problems and questions can be discussed http virtuemart net http Vir
38. KUP BACKUP BACKUP Upgrade from VirtueMart 1 0 0 1 0 5 We have fixed a lot of bugs An upgrade is highly recommended Just get the Patch Package for your current VirtueMart version and overwrite your exising files with the ones from that package The are two small changes to the database so you must run the following SQL queries on your database to update it Just open phpMyAdmin and run those queries e SOL update script for upgrading from VirtueMart 1 0 x to VirtueMart 1 0 5 Hee HH HEE EE EE EE EE EE EE EH HE aE HE aE EE EE EE EE EE EE EE EE ALTER TABLE jos vm product mf xref CHANGE product id product id INT 11 NU ALTER TABLE jos vm orders ADD order tax details TEXT NOT NULL AFTER order tax Allow Shopper group discounts up to 100 00 ALTER TABLE jos vm shopper group CHANGE shopper group discount shopper group discount DECIMAL 5 2 NOT NU Allow bigger discounts than 999 99 ALTER TABLE jos vm product discount CHANGE amount amount DECIMAL 12 2 NOT NULL DEFAULT 0 00 Allow prices up to 9 999 999 999 99 ALTER TABLE jos vm product price Automatic Installation 2 2 3 produ t order i ABLE jos GE produ c t mu t price e V product price DECIMAL 12 5 m price m order item item price c t order it ABLE JOS_ GE produc to OS mu
39. Manufacturer List screen Deleting Manufacturers Before deleting an existing manufacturer all products associated to that manufacturer must be removed through either deletion or re association to another manufacturer VirtueMart will not allow the deletion of a manufacturerwhile these child records still exist for that manufacturer Once these child records have been removed select Manufacturer List Manufacturers to see a list of all manufacturer Then click on the name of the manufacturer you would like to delete In the Manufacturer Add Information form click on the Remove icon You will be returned to the Manufacturer List screen Once this manufacturer has been deleted it is removed from the system To recover this manufacturer you must re create the manufacturer information and re associate all appropriate products 4 6 Product Administration 4 6 1 VirtueMart offers the ability to categorize products not only by manufacturer but also by product category Product categories may also contain subcategories enabling storekeepers to manage their products in as much detail as possible Because products and product categories are associated to a particular vendor it is important to create your vendor records before creating the product and product category records Product Categories VirtueMart includes the ability to associate products to product categories and subcategories to enable better product management
40. Mart Administration User Group List sssssssssrsresserresrererrrerrrrrsrerrrrrerrerrrrrrrrrr rr rr ana 55 4 40 VirtueMart Administration User Group Form ssssmssreserresrerrerrerrrrerrerrrrrer reser rr rr rr rr rr rna 55 4 41 VirtueMart Administration The New Group in the Module Lier 56 4 42 VirtueMart Administration Manage User Fields ooonccoccnccnnccnnccnnconnconnconnconnconacinncos 56 4 43 VirtueMart Administration Add a new User Field seen 57 4 44 VirtueMart Administration New Field EU Vat ID in the registration form 58 4 45 VirtueMart Administration Re Ordering in the Field Lier 59 4 46 VirtueMart Administration Modifying a Field ssssssssrsssrssersrsserresrerrerrrrrrrrrrerrrrrrr rer r rr rr nr 60 4 47 VirtueMart Administration Order List 61 4 48 VirtueMart Administration Upper Part of the Order Details 62 4 49 VirtueMart Administration Bottom of the Order Details 62 4 50 VirtueMart Administration Vendor List for a Category ss 64 4 51 VirtueMart Administration Vendor Category Form sse 64 vii VirtueMart User Manual 4 52 4 53 4 54 4 55 4 56 4 57 4 58 4 59 4 60 4 61 VirtueMart Administration VirtueMart Administration VirtueMart Administration VirtueMart Administration VirtueMart Administration VirtueMart Administration VirtueMart Administration VirtueMart Administration VirtueMart Ad
41. Payment Processor x 9 Add Payment Method 5 Credit Card PayMeNow PN 0 00 defautt Use Payment Processor x gt Shipping Module List 6 Dankort PBS PBS 0 00 default HTML Form based e g PayPal x i a 7 Check CH default Ik debit ii Credit Card List eCheck net ECK 0 00 lefaul Bank debi x D Add Edit Credit Card Types 8 eWay EW 0 00 default Use Payment Processor x iT List Export Modules 9 iKobo IK 0 00 default HTML Form based e g PayPal x i D List Export Modules 10 iTransact ITR 0 00 default HTML Form based e g PayPal x ii 5 Products Figure 4 57 VirtueMart Administration Payment Method List It is possible to create a new payment method there is a New toolbar button but you may to hack the VirtueMart code in order to make use of it not for the faint hearted 72 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 The next Figure shows the 2nd tab Configuration which varies depending on the payment service provider and the example shown here is for WorldPay 4 12 2 Add and Edit Payment Methods YA Save Y Cancel
42. Price will be independent from the Quantity in Cart 45 Product Attributes Ya Save QQ Cancel Reload Price Information New Price for Product Chai n Saw Product Price Net Product Price Gross D Currency USDolar zl Shopper Group defaut Quantity Start Quantity End 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 4 6 4 4 6 4 1 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 Product Attributes Attributes are the characteristics of a product like Color Size or Type If you add attributes to a product this product becomes a parent product After that you can add child products called Items to this parent product each having different values for each attribute Adding Product Attributes To create a new product attribute click on Products List Products to display a list of all products Then click on the name of the product for which the attribute is being created to display the product entry form for that parent item Then click on the Add Attribute button on the top of the s
43. VirtueMart User Manual Soren 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 http www opencontent org opl shtml http www opencontent org opl shtml Table of Contents Eelere eege Ee daa Edert patrol ad 1x De OCA A A e ter ui AEA BS 1 1 1 What as Virtue M ae As rp cere Ee Ee 1 12 Wat dd cases 2 1 32 creen EE 2 25 A INE 5 2 1 Joomla Mambo Installation sssssssessessrrsersrererrrerrrrrrrrrrrrr rr rer ers sr rr rr ere e e eene 5 22 VirtueMart Installat A es 5 3 FirstStepS s ete tete HS PR sb saa EE pat dE Ee AER EE De edt 15 3 1 Joomla Global Configuration coooccoccnncnnccnnccnnconnconnconnconnconnconnconronncnnrnnaronicanos 15 4 Administrator Tutorial ENN 17 AS A A bert prt NEEN dee SEAN 17 LIP MG E WEE 24 LESSE ENIM MEME 25 4 4 Countries Currencies Core Modules amp Functions ssssssserserrrrrrrrrrrrrrrrrrrrrrrrrrr rr rr er 27 4 5 Manufacturer Administration ssssmssssessrerersrrrrsrrrrrrrrrrrrrrrrrrrrrr rr rr rese emma nne 32 4 6 Product Administration o ooocncncncncncncncncononononononono nono ers ere ere eese rr tette serere enn 34 4 7 User Management ed tede ed np nmi E EE E e eR e UE ur IDEE 53 4 8 Order Administration EE 60 4 9 Vendor Administration
44. 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 Project VirtueMart is an Open Source E Commerce solution for Joomla and Mambo VirtueMart is released under the GNU Public License It is free to download and use There s a small group of developers who help in making this Shopping Cart Script more professional and easily usable The author of this documentation is the Lead Developer and having not much time besides Wife Work amp Studies History VirtueMart is the successor of mambo phpShop mambo phpShop was the first port of phpShop to Mambo phpShop was developed by Edikon Corp http www edikon com and the phpShop community http www phpshop org 5 4 The Community Since VirtueMart is free and Open Source Software everyone using it can and should contribute to this project You can send your code snippets hints and anything else helpful to the Homepage of the project http virtuemart net 79 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 defin
45. ants to build up a Online Store can use this Component for selling something to Customers 1 1 2 Features e manage an unlimited Number of Products and Categories use it as a Shop or just as an Online Catalog you can even turn off Price Display sell downloadable Products powerful Web Administration Interface Product Import amp Export using CSV Files add Images and Files like Spec Sheets and Flyers to a Product add Attributes like Size or Color to your Products manage your Customers in Shopper Groups assign more than one Price to a Product each Shopper Group has its own display Prices either including or excluding tax manageable for each Shopper Group Shop Statistics Control Panel with a Summary of new Customers new Orders manage the Stock Level for Products and Items notify Shoppers when a Product is back in Stock use Zone based Tax Calculation city state amp country region OR Store Owner based Tax Calculation e g in european countries manage your own Shipping Carriers and Rates use InterShipper UPS USPS or Canada Post Shipping Rate API complete Order Management with Order History Customer Notification and Order Edit Functionality basic Reporting Feature sold Items monthly amp yearly Revenue e manage Order Statuses What does it not do Shoppers can add their own Shipping Addresses let your Customers easily search for Products through a Search
46. atus 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 To view all of the orders in the system click on List Orders on the Orders menu This takes you to the Order List which is illustrated in the next figure 4 8 1 The Order List Q Remove Reload rt Ep Order List Son Pending Confirmed Shipped Cancelled All 2 y Zei Name aL Track ka Ai Order Date TM a Status Update SubTotal Remov EA RE E Gomer mmm f 2 m 00005 POR a D n D n Fees mm P gt Toma D a D n n qus bene sm P eros DC a Din QU ees mm P Figure 4 47 VirtueMart Administration Order List When you click on an order number you are given the full details of the order as shown in the next figure When you click on the name of the customer you will be taken to the user form for this user The Print View Link opens a new window that allows you to print out the order In the status column you can see the current status of this order You can change this value and after that click on the Update Status button to the right to update the order status If you wish to notify the customer about this action check the option Notify the customer To delete an order use the Trash Bin icon in the last column or select multiple orders using t
47. ault shopper group v AT gt Tax 2 AA 5 4 gt Shipping 2 Gold Level Washupito s Tiendita Gold Level phpShoppers x I 1 gt Coupon E 3 Wholesale Washupito s Tiendita Shoppers that can buy at wholesale x a gt Manufacturer gt Help Your Version VirtueMart 1 1 0 beta vils l gt 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 v Save Q Cancel Reload Shopper Group Form Default Group Name Gold Level Vendor Washupito s Tiendita Show Prices including tax Yes zl O Price Discount on default Shopper Group in bo O Group Description show hide Mi L Mj t NN U iz jc dax Q X Gad dm 2 Ji A W 0 Fal X x Chuac wll Fant family wil Fant civa 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 You could also check the checkboxes of each shopper group which you want to remove and click the Remove button in the toolbar Note You can t delete shopper groups which still has customers assigned to it 4 7 2 Users 4 7 2 1 Adding or modifying Users 4 7 2 2 Deleting Users 54 User Groups
48. ck with your payment service provider as to what their requirements are Often automatic notification is referred to as IPN or Instant Payment Notification 4 12 3 Pre Configured Payment Methods VirtueMart already comes with several Payment Modules that allow accepting payments from customers after a short time for setting them up with your Account Details 4 12 3 1 PayPal www paypal com http www paypal com PayPal integration is made using a Webform that transfers the customer to the PayPal site Payment Method Form Configuration optiampp htdocs joomla administrator components com_virtuemartclasses payment ps_paypal cfg php Writeable When enabled let s you test your Notify Script File est mode Yes KM http localhost joomla administrator components com virtuemart noti fy php through this Testing Form www eliteweaver co ukfesting pntest php ayPal yayment jyou yourbusiness com Your business email address for PayPal payments Also used as receiver_email mail TN Status Select the order status to which the actual order is set if the PayPal IPN was successful If using download Confirmed Ej selling options select the status which enables the download then the customer is instantly notified about the Ke download via e mail ransactions la amm Pending y The order Status to which Orders are set which have no completed Payment Transaction The transaction was nales ending Ej not cancelled in t
49. creen A new window will open displaying the attribute entry form Complete the attribute entry form and click the Save button at the top of the form to save the new item attribute Next you need to define the new attribute for the items Click on the name of an item to display the product entry form for that item Populate the new item attribute field in the product entry form and click on the Save button at the end of the form to save the new item attribute definition 46 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 Then click on Products Current Product List Attributes in the top menu A new window will open displaying a list of product attributes assigned to the product selected Click on the name of the attribute you want to edit to display the attribute entry form for that attribute Complete the attribute entry form and click the Save button at the top of the form to update the item attribute 4 6 4 3 Deleting Product Attributes To delete an existing product attribute click on Products Lis
50. d Caution 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 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 When checked the shopper is redirected to the normal URL when not browsing in those shop areas which are forced to use the SECUREURL The secret key for encrypting payment account data like credit card numbers and storing them encrypted in the database Allows to completely disable the storage of Credit Card data 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 This is an experimental feature to allow multiple shops in one Joomla installation Example shop index 20 Site Display amp 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 Proxy Port The Port of the Proxy Server Proxy Auth Username Only if needed the username for authentication at the proxy server
51. d Products gt List Products Q Add Product View Inventory d gt Special products E D gt Product Folders 3 FP QA 7 Product Type List Add Edit Product Type CIN CITE 00 Product Discount List Search Discount amount Discount Type Startdate of discount End date of discount Remov 2 00 Total 2004 10 25 1 10 00 Percentage D 1 20 00 Percentage 2004 10 14 2007 11 07 1 Figure 4 35 VirtueMart Administration Access the Product Discount Now fill in the details for this Discount Record v Save Q Cancel Reload Add Edit Product Discount Discount amount O Discount Type C Percentage O Total Startdate of discount am O End date of discount E O Figure 4 36 VirtueMart Administration Product Discount Form Discount Amount required Discount Type required Start Date optional End Date optional This is the amount of discount you want to have subtracted added from the product price Has the syntax 000 0000 no comma The Discount Type specifies how the amoung is handled either as a percantage or as a total amount If you select Percentage the amount will mean that you give a Discount of XX to the Product Price If Total is selected the amount will be substracted added from the Product Price By clicking on you can specify a date from the calendar which will be the first day the Discount is calculated and shown to t
52. d Country Field name Field title Field type Requi 5 List Currencies 1 7 delimiter_userinfo _PHPSHOP_ORDER_PRINT_CUST_INFO_LBL delimiter x Add Currency 2 7 email _REGISTER_EMAIL emailaddress W List Modules 3 username _REGISTER_UNAME text wv D Add Module 4 password _PHPSHOP_SHOPPER_FORM_PASSWORD_1 password w gt Store 5 7 password2 PHPSHOP SHOPPER FORM PASSWORD 2 password vy gt Products amp I dalimitar hilta DHDCHAD IICFR FARM ANITA I RI dlalimitar Ki Figure 4 42 VirtueMart Administration Manage User Fields Add a new Field You can add a new field by clicking the New button on the toolbar The Field Form allows you to choose from various field types like text field checkbox textarea date drop down email H 56 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 Add Edit User Fields Add Field ELI VAT ID Type Table Field Mame Title Field Label Description field tip text or HTML Required No si Shaw on Account No si User Read Only Ha id Show at Registration No Published No La Size Max Length Move the customer into the following shopper group detaut y upon successful validation of ll El the EU VAT ID Figure 4 43 VirtueMart Administration Add a new User Field The Form Fields have the following meaning
53. d name in the User Field List In this form you can modify all settings except the field type 59 Order Administration v Save Q Cancel Reload Add Edit User Fields Edit Field Type text Table Field Mame first name Title Field Label PHPSHOP SHOPPER FORI Description field tip text or HTML Required Yes e EN Show op Account Ye i User Read Only Ma Lal Le Show at Registration Yes Published Yes Size ER Max Length B2 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 Order Administration Your shop is online your catalogue is bursting at the seams you ve run all of your payment processing tests and you re ready to go live Well maybe not quite You need to know what to do when those orders come flooding in When someone orders a product through your VirtueMart website a record is created in the system with the details of the order 60 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 st
54. d to be enabled when shopping and checking out The administration section requires Javascript to be enabled The browser needs to be capable of accepting Cookies and Cookies must be enabled 2 2 2 Installation and Upgrade New Installation When having met all the requirements and when you are running Joomla or Mambo you have two choices 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 All you need to do is install VirtueMart It will automatically convert your installation of mambo phpShop rename the tables and copy all customer information into its own table vm user info So just follow the instructions for the automatic installation or if you have difficulties with it the manual installation Note It is recommended to uninstall the old mambo phpShop modules after you have installed the VirtueMart component and then install the new VirtueMart modules Caution It is absolutely necessary to make a backup of your whole site before you upgrade your shop An upgrade failure can always happen So please BAC
55. dex This is the complete text for your Terms of Service that is displayed to the customer Required The name of the Vendor Store Required The name of the vendor company the vendor s Internet Address Address Line 1 Address Line 2 The City where the vendor is located The State Region where the vendor is located The Country where the vendor is located The ZIP of the vendor s location The Vendor s Phone Number The Name of the Vendor s Contact Person The title of the Contact Person Vendor s contact s Phone number The Fax number for the Contact Primary Vendor contact email address Click the Save icon to create your new vendor 4 9 2 2 Editing Vendors To edit an existing vendor select Vendor List Vendors to see a list of all vendors You may also get to this screen by clicking on the linked text list in the Vendors column on the Vendor Category List screen Click on the name of the vendor you would like to edit or click on the linked text update in the Admin column either will take you to the same Vendor Add Information form Make your changes in the Vendor Add Information form described above and click on the Save icon You will be returned to the Vendor List screen 4 9 2 3 Deleting Vendors Important Since vendors represent the top most tier of site management deletion of vendors should be avoided unless absolutely necessary 67 Tax Rates Before deleting an ex
56. duct Type New Publish Unpublish Remove Reload z Search Product modified xi Afer x fi5 34 16 4 2007 Search x E Selecta category Zo 7 Product List eech Administration Customer Clone gt Admin Product Name Media SKU Price Category Manufacturer ei Publish product Remove Id gt Store Add 1 7 Chain Saw 3 3 Por 149 98USD Outdoor Tools Manufacturer see v A 7 1 Products 2 Add J Use CSV upload 2 Circular Saw 2 Po2 220 0USD Power Tools Manufacturer Review v A 8 i Add Products 3 7 Grat BL P03 1 4812USD Indoor Tools Manufacturer See v Lu 9 S List Products Add List Products Tm E Add Product 4 Hammer 0 n2 200USD Hand Tools Manufacturer Review v D e d Vien kuentory 5 Hand Shovel tem Information BO cor A488USD Hand Tools Manufacturer aloe v mi 1 Special products review Product Folders 6 7 Ladder tem Information 2 602 49 99USD Garden Tools Manufacturer Masc v Lu 2 S Product Discount List 7 Nice Saw 0 Ho 2499USD Hand Tools Manufacturer SCH v os Add Edit Product Discount 8 Power Sander 2 Pos TAS8USD Power Tools Manufacturer Pass v EO Product Type List Add Edit Product Type 9 Shovel 2 c03 2498USD Garden Tools Manufacturer Set v a 2 Add 1 List Categories 10 Smaller Shovel 2 c04 19 99USD Garden Tools Manufacturer Review v a E Q Add Category ve y E Figure 4 15 VirtueMart Administration P
57. ducts won t be removed if you delete just one category But if a product is just assigned to one category it will be deleted if you delete its category Removing a category can be done by clicking the trash bin icon in the last column of each row in the product category list But you can also click the checkboxes of the categories you want to remove and click the Remove button in the toolbar Products When creating your product records it is important to make a distinction as to whether the product that is being created can be uniquely identified by its nature or name e g Compact Disks Video Cassettes Books etc or is one of many similar items that are uniquely identified by their attributes e g Apparel Furniture Automobiles etc The reason this distinction needs to be made is because the methods for creating editing and deleting differ for each Items require the creation of Item Attributes but products do not 36 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 Back to Joomla Administration VirtueMart Administrat Simple Layout Extended Layout A add attribute List Prices Add Pro
58. e shop index 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 4 4 Countries Currencies Core Modules amp Functions 4 4 1 Managing Countries Countries are managed in the country list which can be accessed through Admin List Countries Add a State List States A Country List Country Name 1 Afghanistan List State 2 Albania List State 3 Algeria List State 4 American Samoa List State 5 Andorra List State 6 Angola List State Anguilla List State 8 Antarctica List State 9 Antigua and Barbuda List State 10 Argentina List State O New Remove Reload Current Zone Country Code 3 1 1 1 AFG ASM AND AGO AIA ATA ATG Figure 4 5 VirtueMart Administration Country List m Search Country Code 2 AF AL AQ AG AR Remov To add a new country click New in the top of the list and fill out the fields in the country form 27 Managing Currencies 4 4 2 YA Save 3 Cancel 3 Reload Add Country Country Mame Curent Zone Default xl Country Code 3 us Country Code 3 USA 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
59. e pounds Unit piece Units in Packaging b Q Units in Box b Q Figure 4 19 VirtueMart Administration Product Form Tab 4 Product Dimensions and Weight Length The length of the product Used for shipping purposes Width The width of the product Used for shipping purposes Height The height of the product Used for shipping purposes Unit of Measure Dimensions Weight Unit of Measure Weight The unit of measure used in determining the LWH of a product Used for shipping purposes The weight of the product For shipping purposes The unit of measure used in determining the weight of a product Used for shipping purposes Important Allowed UOM are 40 Products po pound s kg kilogram m s ou ounces lb LB YA Save Cancel Q Reload New Product Product Information Display Options Product Status Product Dimensions and Weight REESE oes Related Produc lopt lampp htdocs joomla components com virtuemart shop image product Writeable lopt lampp htdocs joomla components com virtuemart shop image product resized Writeable Full Image Thumbnail Image Durchsuchen Di Image Action Image Action e none e none C Auto Create Thumbnail URL AAA URL Optional Optional No Image No Ima Available S IN Figure 4 20 VirtueMart Administration Product Form Tab 5 Product Images Thumbnail A thumbnail image that can be displayed along with the product Full Ima
60. en 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 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 When enabled your customers are presented a drop down list with states where they can select one Check if you want a shopper to agree to your Terms of Service before registering to the shop Check if you want a shopper to agree to your terms of service on EVERY ORDER before placing the order 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 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 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 Sets whether to c
61. ent You can also select whether to add VAT to the shipping rate or not All of this takes place in the Shipping Rate Editor see next figure To edit or delete existing shipping rates select Shipping Rates from the Shipping menu 69 Standard Shipping O New Remove Reload e Shipping Rates list D Shipper 1 T DHL 2 bHL 3 DHL 4 DHL 5 DHL 8 DHL 7 T DHL 8 bHL a T DHL 10 DHL 11 DHL Figure 4 55 VirtueMart Administration Shipping Rate List Shipping Rate description Inland gt 4kg Inland gt 8kg Inland gt 12kg Inland gt 20kg EU gt 4kg EU gt 8kg EU gt 12kg EU gt 20kg Europe gt 4kg Europe gt 8kg Europe gt 12kg Weight from 0 000 4 000 8 000 12 000 0 000 4 000 8 000 12 000 0 000 4 000 8 000 m Search sed 4 000 8 000 12 000 20 000 4 000 8 000 12 000 20 000 4 000 8 000 12 000 Remov Dt DU Dt At D 4 At D 4 AT At D 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 70 Standard Shipping V Save Y Cancel Reload Create Edit a Shipping Rate Shipping Rate description finland gt 12kg ountry Aultiselect use CTRL Key ind Mouse List Order B Shipper DHL v Finland France France Me
62. es a set of markup elements useful for marking up text so that the text can then be transformed into several different formats It s possible to create documents in different formats PDF HTML HTML Help chm Files for Windows Help XML RTF TeX WordML Word 2003 and others The author of this document uses eDE http docbook e novative de for generating the End User documents The idea is to write just once and reach the largest possible number of people with the information Digital information not stored properly tends to get lost Due to the fact that not containing uncommon characters such as binary formats it s possible to index and search directly on the documents written on SGML and consequently on DocBook The SGML systems use markups to make their description DocBook holds over 300 markup elements each one with several attributes which can assume several values these can be fixed or defined by the document style that the author has used 80
63. ge A larger image that can be displayed along with the product Note If you have enabled Dynamic Thumbnail Resizing the Thumbnail here won t be automatically created from the Full Image Related Products Related Products are assigned to a product to indicate a general relationship of some kind Related Products can be accessoires or other types or a similar product 41 Product Price Management WA Save Q Cancel Q Reload New Product Product Infor mation Display Options Product Status Product Di mensions and Weight Product Images Related Products Related Products O Filter Case sensitive filtering Related Products Garden ToolsiShovel A Garden ToolsiAwesome G rlib A El Garden ToolsiLadder Garden Tools Smaller Shovel lt Hand ToolsiHammer Hand ToolsiHand Shovel Hand Tools Nice Saw Indoor Tools Dr ll Outdoor ToolsiChai n Saw Power ToolsiCircular Saw Power ToolsiPower Sander 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 Thumbnails won t be automatically created The CSV Import Documen
64. he checkboxes in the first column and click on remove in the toolbar 61 The Order Details 4 8 2 The Order Details Purchase Order Order Number 00000026 Order Date 16 Mar 2007 06 44 Order Status P IP ADDRESS 127 0 0 1 Coupon Code Bill To Name S ren Eberhardt Company Firma Mt Address 1 Klugstraf3e 2 Address 2 City Milwaukee State Province Region Zip Postal Code 17034 Country Germany Phone 0385757358 Fax Email soeren virtuemart net lt lt Prev next gt Order Status Change Order History Modify Order Order Status Change Order Status Pending y Update Comment v Notify Customer Y Include this comment Ship To Name S ren Eberhardt Company Firma Mt Address 1 Klugstra e 2 Address 2 City Milwaukee State Province Region Zip Postal Code 17034 Country Germany Phone 0385757358 Fax 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 Quantity Name 1 Magnificient Size Big DOWNLOAD STATS normal 333 1206 1871 1 jpg Remaining Downloads 3 Resend Download ID 738_dexter9plate gif Remaining Downloads 3 Resend Download ID 1 Metal Ladder Material Metal 1 Dr ll 1 Hammer Size big Material wood and metal SKU Order Status Traversal Order Status
65. he customer The Start Date is no must You can also only have an End Date or leave this field blank when this discount shall begin instantly If you have specified a Start Date you ll surely want an End Date that would be something like Sale So click on and specify the last Day of the Sale from the calendar You can also only have an Start Date or leave this field blank when this discount is not limited When you re done don t forget to Save your information 52 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 4 7 1 VirtueMart comes with an extended User Management compared to Joomla s User Management Features Important Always use the VirtueMart User Manager for Adding Editing and Deleting Users to from your Joomla site If you use Joomla s built in User Manager you will run into troubles because important database entries are not created for such users So for the other case When you delete Users with the Joomla User Manager from the site that have been added with the VirtueMart User Manager you will have a lot of useless database entries VirtueMart a
66. heck 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 19 Security 4 1 2 Show Products that are out of Stock Enable the Cookie Check Currency Converter Module Order mail format DEBUG Security SECUREURL Shop Areas which must use https Generally prevent secure connections Encryption Key Store Credit Card Information Allow Frontend A dministration Table Prefix for VirtueMart Tables HOMEPAGE Let s you decide wether Products that are out of Stock are displayed or hidden only available when Check Stock is enabled 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 This allows you to select a certain currency converter module Such modules fetch exchange rates from a server and convert one currency into another This determines how your order confirmation emails are set up as a simple text email oras 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 Example https www mydomain com The secure URL to your site https with trailing slash at the en
67. his case but it is just pending and waiting for completion been only N Here you can choose if you only want to accept payments from buyers with a verified PayPal account when at vera o El account is not verified PayPal does transfer the funds but they do not fully guarantee the validity of the sale rder Status or failed Cancelled De Select an order status for failed PayPal transactions ransactions ayment Extra Info https www paypal com cgi bin webscr total db gt f order tax db gt f order shipping tax discount total db gt f coupon discount db gt f order discount Figure 4 59 VirtueMart Administration Paypal Configuration Screen This payment method allows automatic Order Status Updates There s a file in administrator components com virtuemart which is called notify php You will need to enter the appropriate URL web address for the script file in PayPal s control panel When a customer finishes the Payment the PayPal server connects to this script on your server When the transaction AND the payment have been successful the order status is automatically updated to the status you have set in the PayPal configuration form 4 12 3 2 Worldpay www worldpay com Worldpay integration is made using a Webform that transfers the customer to the Worldpay site Allows automatic Order Status Updates There s a file in administrator components com virtuemart which is called worldpay no
68. iguration Form m ji 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 Global Shop is offline Offline Message 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 This message will be displayed to customers who try to access your store 17 Global Use only as catalogue Show Prices Membergroup to show prices to Show including XX tax when applicable Show the price label for packaging Show Prices including tax Enable content mambots plugins in descriptions Enable Coupon Usage Customer Review Rating System Auto Publish Reviews Comment Minimum Length Comment Maximum Length Enable Affiliate Program Virtual Tax Tax mode Enable multiple tax rates Hides all Add to Cart buttons 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 default Public Frontend Here you can decide which membergroups of your site are allowed to see product prices When checked users will see the text inc
69. ile com virtuemart x x tar gz This is the package file which contains all files for the VirtueMart Component located on your computer see Step 1 Now click on Upload File amp Install Since the tar gz file is about 2 MB in size you will have to wait a moment while the file is being uploaded to your server and unpacked 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 The main file is an XML document which describes the installation process In order to use this function for your installation your web server must support the zlib extension You can check this in the Admin Section Menu item System gt System Info gt System Information 5 The VirtueMart Component should be installed now You ll see the Welcome Message Screen with some options for the next steps Welcome to VirtueMart 1 1 0 beta VirtueMart 1 1 0 beta Time Has Come Today 21 02 2007 14 00 GMT The first step of the Installation was SUCCESSFUL Let s prepare the database now the Installation Script hasn t found existing mambo phpShop
70. in the Product List O Add Attribute Add Product Type Ne MMM Produ List Search Prot Product Name Media SKU Price 1 v Chain Saw S P01 ir 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 mueMart Administrat charn Saw X Add attribute List prices Add Product Type Y w current product flypa sho II UP te Item Chai n Sa roduct Information lay Options Product Status P oduct Information Publish Pr 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 O New QQ Remove Reload Product Search LJ H Price for Chal n Saw a Quanti i IT Group Name Price Currency Start 1 IT default 149 59000 USO D 2 IT Gold Level 2 99000 USD D Figure 4 27 VirtueMart Administration Product Price List In the Product Price Form you can choose the Price the Shopper Group and the Quantity Range this Price is valid for If you leave the Quantity Fields empty the
71. isplay Options Product Status 38 Products Product Information Display Options Product Status Product Dimensions and Weight Product Images Related Products Product Status In Stock Ir Minimum Purchase Quantity po Maximum Purchase Quantity po Availability Date 2007 0417 Availability O No Image Available On Special Attribute List ris New Attribute New Property Property Price Examples for the Attribute List Format Size XL 1 99 M 3 2 99 Colour Red Green Yellow ExpensiveColor 724 00 nd3o0n Inline price adjustments for using the Advanced Attributes modification Add this amount to the configured price Subtract this amount from the configured price Set the product s price to this amount Custom Attribute List 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 Alternatively you can select an availability image from the drop down list below Tip You can use your own images here Just copy them to the direcory shop image availability and then you can select them here On Special Featured
72. isting 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 In the Vendor Add Information form click on the Remove icon You will be returned to the Vendor List screen Once this vendor has been deleted it is removed from the system To recover this vendor you must re create the vendor information and re associate all appropriate product categories and products 4 10 Tax Rates VirtueMart has some tax calculation configuration capabilities Details on configuring tax calculations on your site can be found above under Configuration There are two Tax modes available in VirtueMart Based on vendor address and Based on shipping address Depending on which option you select you should configure Tax Rates for the locale of each vendor as entered in the Vendor Information Form described above or for each country or state you plan to have customers from that you wish to calculate taxes for Editing Tax Rates To edit existing Tax Rate information select Tax List Tax Rates from the VirtueMart admin menu Click on either the linked text in the Tax Country
73. ive has a size of more than 2 MB When uploading this file to your server you can wait a long time until the file is completely transferred to your server You can use the Remote Installer for VirtueMart instead Remote Installer for VirtueMart http joomlacode org gf project virtuemart frs action FrsReleaseBrowse amp frs_package_id 192 2 2 5 What are those tar gz files aren t those for Unix Linux systems only tar gz Archives come from the Unix World but they can be used on Windows and Mac systems as well On Windows you can unpack them using Winzip or Winrar Gzip has a much much better compression than Zip that s one reason why most Open Source projects use it for their distributions 2 2 5 10M an upgrade from mambo phpShop the VirtueMart installer won t recognise my existing tables What to do now 12 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 amp install type updatel2pl3 After that the upgrade procedure begins 2 2 5 After the installation I try to access VirtueMart but it just prints out an error like store is not a valid VirtueMart module What s wrong The installation is corrupt The registered functions and core modules which are used by VirtueMart to check the acccess permissions are
74. lation 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 org content category 48 268 302 Joomla 1 0 Installation Guide http help joomla org content category 15 99 132 Mambo Knowledgebase Installation and Configuration http docs mambo foundation org en CategoryID 4 2 2 VirtueMart Installation 2 2 1 Requirements 2 2 1 1 Server Requirements VirtueMart has the following System Requirements Apache 1 3 19 or above http www apache org recommended Apache 2 2 x PHP 4 2 x or above http www php net recommended PHP 5 2 x MySQL 3 23 x or above http www mysql com recommended MySQL 5 0 x Joomla 1 0 x or Mambo gt 4 6 2 recommended Joomla 1 0 x You must ensure that you have MySQL XML and Zlib Support built into your PHP Support for https openSSL and cURL is recommended Important The MySQL user you access the database with in production use must be able to create temporary tables 2 2 1 2 Client Requirements VirtueMart can be used with most major browsers including Internet Explorer version 5 5 Firefox Opera 9 Safari and Konqueror Javascript doesn t nee
75. lbar of the file list PA Save Q Cancel Q Reload E hioa a File for Chai n Saw Filename Durchsuchen Filename benchmark php y File Type additional Image x Uploadto default Product Image Path C Specify the file location opt lampp htdocs joomla medial C Download Path e g forselling downloadables Resize Full Image File Le Height 500 Width 00 Auto Create Thumbnail Height po Width po File is published Le File Title what the Customer sees Chain Saw File URL optional 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 Note If you want to assign a bigger file maybe a 8MB mp3 file you need to upload the file using an FTP program into the directory you have specified for downloadable product files see Configuration After you have done this you can select the file from the drop down list in the file form 4 6 8 Product Discounts Discounts in VirtueMart must be created in the Product Discount Form before being able to assign a Product to a specific Discount Caution When updating a discount your changes apply to all products which are assigned to this discount Adding Updating a Discount Go to Product gt Add Edit Product Discount 51 Product Discounts Back to Joomla Administration VirtueMart Administrat A Use CSV uploa
76. lso provides the ability to create any number of addresses for a particular user Not only can a user have separate bill to and ship to addresses but addresses for home and business as well Shopper Groups VirtueMart offers the ability to not only manage users by vendor but also by shopper group This enables storekeepers to create shopper groups for whatever need e g site access customer rating tax display etc These shopper groups can then be used to provide special services discounts or access to a specific group of users Because users and shopper groups are associated to a particular vendor 1t is important to create your vendor records before creating the user and shopper group records Note There s only one default shopper group Whatever shopper group you set as default its settings are used for new customers New customers are automatically assigned to the default shopper group 4 7 1 1 Adding or modifying a Shopper Group You can add and modify shopper groups in VirtueMart using the Shopper Group List which can be accessed through the menu Shopper List Shopper Groups 53 Users Back to Joomla Administration lt VirtueMart Administrat gt A A 2 Products S O New Remove Reload 7 Shopper si y amp Shopper Group List kee Add Shopper Group F gt Orders D Group Name Vendor Group Description Default Remov gt Vendor 1 defaut Washupito s Tiendita This is the def
77. luding xx tax when prices are shown incl tax which depends on shopper group settings Use price per packaging label Sets the flag whether the shoppers sees prices including tax or excluding tax When enabled prices are displayed like X XX including XX Tax If enabled you can use your mambots and plugins for dynamic content in the product or category descriptions If you enable the Coupon Usage you allow customers to fill in Coupon Numbers to gain discounts on their purchase 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 If enabled customer reviews are instantly shown after being submitted Maybe not a good idea because you want to check the product reviews before This is the amount of characters a customer must write at least before a review can be submitted This is the maximum amount of characters a customer can write before a review can be submitted This enables the affiliate tracking in the shop frontend Enable if you have added affiliates in the backend Caution The Affiliate Program doesn t fully work It must be completed in future versions This determines whether items with zero weight are taxed or not only applies in Ship To Address based 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
78. m in the Product Form 43 4 23 VirtueMart Administration Price Form in the Product List 43 4 24 VirtueMart Administration Price Update Notice sssssrssererrrererrerrerresrerrerrerrrrrrrrrrr rr rna 44 4 25 VirtueMart Administration Product List List Prices eee 44 4 26 VirtueMart Administration Product Form List Drees 45 4 27 VirtueMart Administration Product Price List 45 4 28 VirtueMart Administration Product Price Form ooccoccncnoconcnnconcnnconococononocononoconanonos 46 4 29 VirtueMart Administration Add Attribute ssssssesrsrsrrereserrrrerrrrsrsrrerererrrrerrrrrrrr rr rr e 48 4 30 VirtueMart Administration Add a new item child product eres 48 4 31 VirtueMart Administration Edit Items cesses nemen mene 49 4 32 VirtueMart Administration sess nennen me hene rr rr reser ers sr sr eene 50 4 33 VirtueMart Administration File List ssssssssssssseseserrererrsrsrerererrrrrrrrrrrrerrrr ere rr rr rr reser rs sn 50 4 34 VirtueMart Administration File Form 51 4 35 VirtueMart Administration Access the Product Discount sesrersrerrrrrerrrrrrrrrrrserr snar 52 4 36 VirtueMart Administration Product Discount Form eese 52 4 37 VirtueMart Administration Shopper Group List s ssssesseseeserrrsrerrrsrerrrrrererrrrrer rese rr rr nr 54 4 38 VirtueMart Administration Shopper Group Form sese 54 4 39 Virtue
79. ministration VirtueMart Administration Vendor Category List sese 65 Vendor Category Deletion sssessesresreserrrsrerrrsrrrrrrrrr renen rna 65 Shipper Borin secedere epe tee eee ere 69 Shipping Rate List ssis neret netten ENEE e 70 Shipping Rate Form cessisse tesi irene teien einate e s 71 Payment Meth d List ettet PCR D RR aE 72 Payment Method Editor s s sssssrssersrsrereereereerrorerrrsrrr rese rr rann 73 Paypal Configuration Screen 74 Coupon Listin 76 Coupon Form 2 2 eot eie tope Ft Eee tv ratas NR 76 viii Preamble The content of this document is related to VirtueMart VirtueMart is free Software licensed under GNU GPL VirtueMart http virtuemart net O 2005 2007 S ren Eberhardt Biermann amp 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 org 1X 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 So every user who w
80. n in the toolbar The coupon form shows up bw Save O Cancel Reload New Coupon Coupon Code D Percent T C Total Coupon Type Gift Coupon T Walue Percentor Total Figure 4 61 VirtueMart Administration Coupon Form 76 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 Gift Coupons are removed from the database once they have been used to place an order Permanent Coupons can be used for campaigns because they can be used again and again until you remove them from the coupon list Value This is the numeric discount value of this coupon Don t forget to save your changes and you re done 4 14 Reports VirtueMart comes with a basic and self explaining Report Module It allows you to view the product sales of a specific time range TI 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
81. n online mall vendor administration can be essential Since all products product categories users and orders are associated to the vendor record establishing the vendor and vendor category structure is the first step to building the online store Note that it is not necessary to create the vendor categories first Vendors can be re associated to vendor categories after all the vendor records have been created However creating the vendor category records first can save some extra work if you already know how you want to categorize your vendors Vendor Categories Vendor categories are a way to classify the types of goods and services that vendors offer on your site For example you may have an online mall for buying and selling furniture You may want to create vendor categories such as Antiques Office Furniture and Patio Furniture Note that a vendor on your site can only be associated with a single vendor category so it is important to use categories that are broad enough to represent the shopper s choice of storefronts For example Antique Furniture and Vintage Clothing would not be broad enough categories if you have a vendor that sells both types of items In this case you might want to use Antiques as your vendor category VirtueMart creates the vendor category name default upon installation It is not necessary to change this unless you choose to fully utilize the vendor category functionality 4 9 1 1 Bro
82. nd Mambots for VirtueMart follow the instructions of the Automatic Installation Steps 6 and 7 If this doesn t help you because NO automatic installations are possible you can manually upload the files you have probably already done this in step 3 Modules and Mambots require an entry in the table jos_mambots jos_modules You can add these entries by uploading an SQL file using phpMyAdmin that contains all necessary queries administrator components com_virtuemart sql virtuemart_modules installation sql Now you should have installed VirtueMart correctly Installation FAQ 2 2 5 IThe Installer tells me ERROR Could not find an XML setup file in the package What s wrong Mostly this problem arises because you have not unpacked the file VirtueMart_x x_COMPLETE_PACKAGE zip before and tried uploading installing this file 2 2 5 The Installer tells me Another component is already using the directory com_virtuemart Please delete the directories site_root components com_virtuemart and site_root administrator components com_virtuemart If you can t delete the directories using ftp try the file manager for Joomla eXtplorer http extplorer sourceforge net instead 2 2 5 When using the automatic installation nothing happens after clicking on Upload amp Install or the installer tells me Failed to move to media directory What s the cause VirtueMart is a big component its installer file arch
83. of the newly added field EU Vat ID in the registration form Bill To Information Register an Account Username Password Confirm Password An Account allows you to come back to this shop and view allthe orders Send Registration Company Name Title none v Figure 4 44 VirtueMart Administration New Field EU Vat ID in the registration form 58 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 Show in Show in a ed Published registration account Reorder El IS Remove form maintenance yw L yw e 1 ky ki y ki a e 2 e e e a Y 3 iI 1 Y w v a e 4 ke x yw a Y 5 v v v a Y 6 yw ke v a 7 y y x a e 8 Ly w yw v a e 9 ke ke ke a e 10 d 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 After that the fields will be reordered Publish show Unpublish hide Fields You can publish and unpublish fields by clicking on the icon in the column Published After that the publish state will be toggled Changing Fields You can access the field form by clicking a fiel
84. ome Ste Menu Content Components Modules Mambots Installers Mes y Banners VirtueMart 1 1 x Test com dy Community Builder 2 Contacts Control Pan pacBookCollab UN JCE Admin AL joomlaXplorer 4 Letterman CH Mass Mail Add New Content y News Feeds Zb Pols a Syndicate m Version Management pm C VirtueMart Content Items Manager dy VirtueMart Language Manager Web Links Geng 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 24 Store Setup Control Panel I Statistics EA Your Store Control Panel e 0 Product List Category Tree Orders List Payment Methods Users Configuration Edit Store Help 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 Back to Joomla Administration Simple Layout Extended Layout VirtueMart Administrat A Store Information FEE 3 Store Contact Information Administration e Store Name Nashupito s Tiendita Last Owner SSS j 2 Admin S a Name Store Company Name Washupito s Tiendita First emo M Sto
85. or the Tax Rate column both will take you to the same record Next make changes to the Tax Country State or Region or Rate fields as needed and click on the Save icon to save your changes Tax Rate changes will be placed into effect for all purchases moving forward Deleting Tax Rates To delete an existing Tax Rate select Tax List Tax Rates from the VirtueMart admin menu Click on the linked text in the Tax Country or Tax Rate column to edit the record Click on the Remove icon You will be returned to the Tax Rate List Alternatively you may pull up the Tax Rate List by selcting Tax List Tax Rates and click on the trash can icon in the Remove column next to the record you would like to delete 4 10 1 Adding Tax Rates To add tax rates select Tax Add Tax Rate from the VirtueMart admin menu This will bring up the Add Tax Information Form Add Tax Information Form Fields Tax Country The country this tax rate will be applied to determined by either the vendor or the purchaser s shipping address Tax State or Region The State or Region this tax rate will be applied to If there is no region listed for the country you are configuring a tax rate for select the Non USA Non Canadian Not Listed option If you don t need a state but need more than one Tax Rate for a country just select some dummy state for each Tax Rate for that country 68 Shipping Modules Tax Rate Example
86. owned limbs Nice Saw gt papa Hand Shovel Red 540 54 32 Small Hand Shovel Green Medium 540 4 32 1 View Full Size Image Hand Shovel Blue Large 51823 512 98 f Manufacturer 340 4 32 You Save 20 00 Ask a question about this product Hand crafted handle with maximum grip torque Titanium tipped shovel platter Half degree offset for less accidents e Includes HowTo Video narrated by Bob Costas Specifications 5 Diameter Tungsten handle tip with 5 point loft Figure 1 2 Frontend Product Details Page with Review Feature Administrator Screenshots Administrator Screenshots Back to Joomla Administration lt VirtueMart Adi at Simple Layout Extended Layout eil Control Panel Statistics gt e Your Store Control Panel Administration X Configuration Product List Category Tree Orders List Payment M Users Methods 2 User Groups Manage User Fields List Countries i EI ei Add Country Users Configuration Edit Store Help List Currencies Add Currency List Modules Add Module gt Store gt Products gt Shopper gt Orders gt Mendar Figure 1 3 Administration Homepage Summary Statistics Back to Joomla Administration lt VirtueMart Administrat nded Layout A add Attribute List Prices Add
87. re URL http Mocalhostjoomia Name e e Middle Address 1 100 Washupito Avenue NW Name Pre Address Title ju b City Ban Antonio amp List Payment Methods ity San Antonio mone 555 555 1212 Add Payment Method Country United States EN li CEN E State Province Region Texas E geg HA Shipping Module List Zip Postal Code 2630 Fax E55 555 1 212 Credit Card List Phone 555 5551212 Email Jsoeren_nb yahoo de Add Edit Credit Card Types List Export Modules Store Information Currency Display Style Add Export Module Full Image ERES Currency Us Dollar gt Products Currency TIENDITA Eer J O gt Shopper Upload Image Durchsuchen Decimals E a 2 Orders KA SN ke L gt Vendor M BL gt Figure 4 4 VirtueMart Administration The Store Form 25 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 Store Company Name URL Address 1 Address 2 City State Province Region Country Zip Postal Code Phone Last First amp Middle Name Title Phone amp 2 Fax Email Address Full Image Upload Image Minimum Purchase Order Value Minimum Amount for Free Shipping Currency Currency symbol Decimals Decimal symbol Required The name of the Store Required The name
88. re you can select which theme is used to style the shop The configuration link takes you to the theme configuration screen 21 Shipping Default number of products in a row Category Template FLYPAGE Dynamic Thumbnail Resizing Thumbnail Image Width Thumbnail Image Height 4 1 4 Shipping 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 default browse_1 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 COMPONENTPATH html templates and begin with browse_ Note You can change the Category Template for each category in its category form default shop flypage This is the page used for displaying product details when no special flypage is set Note You can change the Flypage for each category in its category form 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 Tip You can check if you have GD2 support by browsing to System gt System Info gt PHP Info gt gd The Thumbnail Image quality is much better than Images which were
89. roduct List Product Form V Save Cancel Reload New Product Product Information Display Options Product Status Product Dimensions and Weight Product Images Related Products Product Information Publish Le a Product Price Net US Dollar xi O SKU Product Price Gross Name 3 16 sl VAT Id URL 8 0 Enone xi Discount Type Discounted Price O Vendor Washupito s Tiendita Manufacturer Adidas xi Categories d 1 Hand Tools 1 Power Tools J2 Outdoor Tools J2 Indoor Tools 1 Garden Tools Short Description Product Description show hide Q9 Q B Z Uizic ike 2 X 330 n Figure 4 16 VirtueMart Administration Product Form Tab 1 General Information Publish Used to specify whether the product will be published on the site SKU Means Article Number Stock keeping unit SKU is an identification usually alphanumeric of a particular product that allows it to be tracked for inventory purposes 37 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
90. searchbox which lets the customer search for products Top Ten Products Module Displays the bestsellers from your store 10 Manual Installation 2 2 4 7 Recommended Mambot Installation Click on Installers gt Mambots or Mambots gt 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 amp Install Mambot ProductSnapshot Displays product figure price add to cart link in content items Select the file mosproductsnap_x x tar gz and click Upload File amp Install Publishing the Mambots Mambots need to be published before they do ANYTHING Click on Mambots gt Ste Mambots in the Top Menu Now browse through the list of installed Mambots and find virtuemart searchbot and mosproductsnap Select one click on the name and modify its settings details Remember to publish it For more information about Mambots please refer to the Joomla documentation http help joomla org You re now done with the Installation of VirtueMart and its elements Manual Installation The installation has failed You have safe_mode On You don t need to pull out your hair You can still use the manual installation Manual Installation is a little bit harder than the automatic installation
91. t Administration Country Form sees 28 4 7 VirtueMart Administration Currencies List sssmsssssserrererrersrerrerererrrrrrrrrrrrrrr ere rr rr rr rese rr rn sn 28 4 8 VirtueMart Administration Currency Form s ssssssersrsrerersrererrrrrerrrrrerrrrrrrrrrrrr ee 29 4 9 VirtueMart Administration Module List 30 4 10 VirtueMart Administration Currency Form seem 30 4 11 VirtueMart Administration Function List s ssssssssessrsesererrerrsrsrerrerererrrrrrrrrrrrrrr ere rr rr rr rr nr 31 4 12 VirtueMart Administration Function Form 32 4 13 VirtueMart Administration Category List 34 4 14 VirtueMart Administration Category Form s ssmsssesrrsreserrrsrerrrrrrrrerrrrrrrrrrrrrrrr rr rr rr rr rr rena 35 4 15 VirtueMart Administration Product List s ssssssssseesrseserrererrsrsrerererrrrrrrrrrrrrrrrr ere rr rr rr rr nr 37 4 16 VirtueMart Administration Product Form Tab 1 General Information 37 4 17 VirtueMart Administration Product Form Tab 2 Display Options sssssrsersroserrrsra 38 4 18 VirtueMart Administration Product Form Tab 3 Product Sans 39 4 19 VirtueMart Administration Product Form Tab 4 Product Dimensions and Weight 40 4 20 VirtueMart Administration Product Form Tab 5 Product Images 41 4 21 VirtueMart Administration Product Form Tab 6 Related Products 42 4 22 VirtueMart Administration Product Form Price For
92. t 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 Then click on Products Current Product List Attributes in the top menu A new window will open displaying a list of product attributes assigned to the product selected To delete an attribute click on the Trash Bin icon in the last column of the row of the attribute you want to delete 4 6 5 Items create Child Products for Parent Products Going back now to offering variations on a product If you want to offer a fixed list of variations for your customer to choose from rather than allowing them to pick and mix attributes as they please you need to create some items Note These are different from the content items in Mambo itself An item in VirtueMart is a pre defined variation on the main product In order to create an item you have to set up at least one attribute first Hence it is only after you have added an attribute that the New Item toolbar button and its related menu option appear Adding Items To create a new item a parent product must exist be created first When completing the form keep in mind that the product information product dimensions and product images entered here are the ones that will be displayed initially for all items Once a specific item is selected by the customer the product information prod
93. tation can be found under the CSV Import Export form Products Use CSV Import Export 4 6 2 3 Deleting Products To delete an existing product click on Products gt List Producs at the top of the VirtueMart Administration pages to display a list of product categories Now click on the Trash Icon in the row of the product you want to delete and confirm that you want to delete this record 4 6 3 Product Price Management Products usually have only one price but if you need more VirtueMart allows you a really flexible Price Management You can have a different Product Price for each Shopper Group and you can even have different Prices depending on the Quantity in Cart 4 6 3 1 Adding or Modifying Prices The standard Product Price for the default Shopper Group can be set and modified in the Product Form 42 Product Price Management ict Status I Product Dimensions and Weight Il Product Images ll Related Produ Product Price Net Product Price Gross 391 2425 VAT ld 2 8 25 el Discount Type 20 00 Discounted Price fret 20 T 220 90000 US Dollar 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 Search Name Media SUMA
94. te will be managing their own shipping etc then they are a vendor If you will be managing these aspects then the supplier is a manufacturer See Manufacturer Administration for more information on that topic Adding a Vendor To create a new vendor select Vendor Add Vendor in the VirtueMart admin menu Edit the following fields in the Vendor Information Form Full Image Required Displays the currently configured store logo Upload Image Optional Browse to the vendor s company logo This will be uploaded when you click on the Save icon Currency The vendor s global default Currency Minimum purchase order value Minimum Amount for Free Shipping Currency symbol Decimals Decimal symbol Thousands separator Positive format Negative format This is the amount which is the minimum Order Value for Checkout This is the amount from which on Shipping is free This is the currency symbol which will be used when displaying prices Number of decimals Can be somethin like or empty Display Order Style for positive numbers Display Order Style for negative numbers 66 Vendors Description Terms of Service Store Name Store Company Name URL Address 1 Address 2 City State Province Region Country Zip Postal Code Phone Last First amp Middle Name Title Phone amp 2 Fax Email Address This is the Vendor Store s Description which is shown on the page shop in
95. tify php You will need to enter the appropriate URL web address for the script file in WorldPay s control panel When a customer 74 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 net and tries to initiate the Money Transfer using the Payment Details of the buyer and your account details that you have set up in the configuration panel for authorize net 4 12 3 4 2Checkout http www 2checkout com This payment module acts very similar to the PayPal Payment Module It transfers the customer to www 2Checkout com where all payment details can be entered After that the customer is directed back to your site But before you must make the following steps 1 Fill in your details for 2Checkout in your Shop Store Payment List 2Checkout For the field Secret word just choose a secret word without spaces max 16 characters fill it in and keep it in mind 2 Login to your 2Checkout account at www 2checkout com 3 Go to the section called Look and Feel 4 Fill in https YOUR JOOMLA URL 2checkout notify php into
96. tropolitan French Guiana 3 French Polynesia French Southern Territories Gabon Gambia Georgia ZIP range start fpoo00 ZIP range end passa Lowest Weight 8 000 Highest Weight 12 000 Fee 7 16 Your package fee 2 00 Currency Euro x VAT Id o none si 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 List Order Shipper Country ZIP Range Start ZIP Range End Lowest Weight Highest Weight in the checkout The order of this shipping rate in the list of all other shipping rates numeric value Select the carrier for this shipping rate The country countries this shipping rate applies to Shoppers from other countries won t be able to select this shipping rate The lowest ZIP Postcode this shipping rate is valid for Leave empty if you re using non numeric values The highest ZIP Postcode this shipping rate is valid for Leave empty if you re using non numeric values The lowest total weight in cart this shipping rate is valid for The highest total weight in cart this shipping rate is valid for 71 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
97. ts or Components gt Install Uninstall when using an older Mambo version in the Top Menu Install new Component Upload Package File Package File Durchsuchen A Upload File amp Install Install from directory Install directory Vopt lampp htdocs joomla administrator components com_installer component Install media Writeable administrator components Writeable components Writeable images stories Writeable Installed Components Currently Installed Component Menu Link Author Version Date Author Email Author URL C Banners Joomla Project 1 0 0 July 2004 admin joomla org www joomla org 8 1 3 0 RC 5 C pocman option com_docman DOCMan Project 2 Aug 2005 admin mambodocman com www mambodocman com C Mass Mail Joomla Project 4 5 1 February 2005 admin amp joomla org www joomla org C News Feeds option com_newsfeeds Joomla Project 1 0 0 July 2004 admin joomla org www joomla org C Polis option com poll C Simple Machines Forum option com smf registration Theodore 3 19 20 09 2004 everythiGeverything science com www everything science com Registration Hildebrandt 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 For proper installation the directories should be set to 777 after that you can change back to 755 In the part Upload new component select the f
98. ttings that fit to your details Don t forget to set currency currency display style and your email address 2 Go to Tax gt Add tax rate and add a tax rate accoring to the local settings of your Shop important for european shops 3 Go to Components gt VirtueMart gt Admin gt Configuration and change all details to fit your needs 4 Go to Components gt VirtueMart gt Products gt Add category and set up your categories and category structure Be sure that all of them are published 5 Go to Components gt VirtueMart gt Products gt Add Product and add as many products as you need repeating this step 3 1 Joomla Global Configuration VirtueMart makes use of the global Configuration values which can be set in the Global Configuration for your Joomla Mambo site Allow User Registration Use New Account Activation Mail Configuration YES An user customer must be registered to your site before being able to checkout even if the customer might not recognise it due to silent registration VirtueMart provides an enhanced Registration Form where customers can leave their account and shipping data When register using this form they are automatically added to the Joomla user list NO If you keep this feature disabled new customers have a streamlined checkout process and don t have to activate their new account by checking their email and restart their checkout
99. tueMart net 1 3 Screenshots Frontend Screenshots using the Template solarflare_1i Frontend Screenshots using the Template solarflare_ii PRODUCT CATEGORIES A Shop L3 Hand Tools Power Tools a Garden Tools CURRENCY MODULE US Dollar Change Currency YOUR CART 1 x Shovel Size XL 2 15 Colour Red 2 x Hand Shovel Red Small 1 x Nice Saw Size big Power 100W 1 x Hand Shovel Blue Large El 29 21 8 64 25 05 12 98 5 Products Show Cart 75 88 Home Online Shop 9 Hand Tools Hand Tools Hand Tools Order by Product Name Hammer Hand Shovel 2 17 5 40 4 32 AF You Save 20 00 A great hammer to hammer away with Product Details Nice hand shovel to dig with in the Figure 1 1 Frontend Category Overview Page H Power Tools a Garden Tools CURRENCY MODULE US Dollar Change Currency YOUR CART 1 x Shovel Size XL 2 15 Colour Red 2 x Hand Shovel Red Small 1 x Nice Saw Size big Power 100W 1 x Hand Shovel Blue Large S 29 21 8 64 25 05 5 Products Show Cart MAIN MENU Home Online Shop DocBook Collab Newsletter News Guestbook Blog Home Online Shop 9 Hand Tools 9 Hand Shovel amp Hammer Hand Shovel 4 Nice hand shovel to dig with in the yard Sa Joomial Nice Saw Ha 25 05 You Save 2 00 This saw is great for getting cutting through d
100. uct dimensions and product images for that item will be displayed Next the attributes that will be used to identify the items need to be created Open the Product Form of the Parent Item you create in the first step 47 Items create Child Products for Parent Products Add Attribute List Prices Add Product Type Searck TM Product Search amp Product Name Media SKU Price 3 1 v Chai n Saw PO1 3 2 FC Circular Saw 5 Pn 220 90 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 id Attribute List Prices Add Product Type New Item V Save YC rent product flypage in shop I IT Update item Hand Shov ct Information Display Options Product Status Product Di mensions and Weight Pr t Infor mation Publish Le Product Price Net 4 99000 SKU 601 Product Price Gross 5 40168 VAT lA 125 05 ei Name Hand Shovel Figure 4 30 VirtueMart Administration Add a new item child product Click on the Add Items button in the toolbar to display the product entry form for the specific item This form is the same as previous product entry forms only the vendor and
101. ufacturer category you deleted is no longer listed To recover this record you must create a new manufacturer category and re associate any manufacturers that belong in that manufacturer category 4 5 2 Manufacturers Adding Manufacturers To create a new manufacturers select Manufacturer Add Manufacturer in the VirtueMart admin menu Edit the following fields in the Manufacturer Information Form Manufacturer Name The manufacturer s name or company name URL http www example com The manufacturer s fully qualified web address Manufacturer Category The manufacturer category this manufacturer will be associated with Email The manufacturer contact s email address 33 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 Click on the name of the manufacturer you would like to edit or click on the linked text update in the Admin column either will take you to the same Manufacturer Add Information form Make your changes in the Manufacturer Add Information form described above and click on the Save icon You will be returned to the
102. ur changes To remove one or more currencies from the list 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 VirtueMart Core Modules VirtueMart Core Modules have absolutely nothing to do with Joomla Module which are sideblocks in your Joomla site Core Modules build a part of your store and are used to manage the different sections and their access permissions Caution You need to act carefully in this part of VirtueMart Changing Core Modules and their permissions can result in locking out other users or even yourself from the store Core Modules are managed in the module list which can be accessed through Admin List Modules 29 VirtueMart Core Modules O New Remove Q Reload Y Module List a E Module Name admin storeadmin shopper demo ARsch none bn Functions Reorder ad Az Remove 1 E admin r w Get v ffi 2 store E F D DD O Function 140114 3 T product FF K m p E u oe e 4 shopper FF r rr r u 14 714 5 J order FF mw m oe U oss ff 6 vendor rr p pog e Ux og e f 7 reportbasio FF LIS i ie u 12 7714 e ta Pop p DD D im oss f 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 A Save Cancel Reload Module Information Module
103. wsing Vendor Categories The Vendor Category List can be accessed in the Vendor Menu Vendor List Vendor Categories You may easily navigate to the vendor list by clicking on the linked text list in the Vendors column of the Vendor Category List 63 Vendor Categories New O Reload Vendor Category List Search amp Category Name Category Description Vendors 1 7 defautt Default List 2 New Category List Figure 4 50 VirtueMart Administration Vendor List for a Category This will open the Vendor List page 4 9 1 2 Adding Vendor Categories Remov AT 7 To create a new vendor category select Vendor Add Vendor Category from the VirtueMart admin interface This will bring up the Vendor Category Form Back to Joomla Administration VirtueMart Administrat gt Products A Y Save Q Cancel Reload gt Shopper gt Orders Vendor Category Form 7 Vendor Category Information List Vendors 24 rr egory Name Add Vendor Se Shipping Coupon Manufacturer 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 Category Description The description of the vendor category Click on the Save button Category Description Help w em ad gt v gt You will be redirected to the Vendor Category List page showing
104. y modifiying existing templates in the directory components com_virtuemart themes templates product_details The file for preparing the display of the Flypage is htm1 shop product_details php Some of the details that you can t find in the Flypage template can be found there Note You should leave this field empty when you re not sure what to fill in 4 6 1 2 Reordering or sorting Product Categories You can reorder categories the way you want There are different ways to achieve this Use the blue arrows in the category list to move a category up or down Use the input fields in the rows of the category list to change the list order If you have finished changing the values click on the Save icon in the column header Use the sort alphabetically icon in the list header You can sort all categories in your store alphabetically using this functionality Please note that this can t be undone Once the categories are reodered you would have to change back manually 4 6 1 3 Removing Product Categories 4 6 2 Before deleting an existing product category all sub categories associated to the product category must be removed through either deletion or re association VirtueMart will not allow the deletion of a product category while subcategories still exist for that product category Categories can be removed from the store although they contain products If products are assigned to more than one category those pro
105. you can modify the properties of this function Again don t forget to save your changes To remove one or more functions from the list either click on the trash bin icon in the last column of each row and confirm to remove the function or select functions and click on Remove in the toolbar 4 5 Manufacturer Administration Manufacturers are associated with products providing web site contact and descriptive information Each product that is created is associated with a Manufacturer For stores where manufacturer information is not necessarily relevant a default manufacturer is created upon installation It is not necessary to create manufacturers prior to creating your catalog Products can be re associated to manufacturers after all the product records have been created However creating the manufacturers first can save a lot of extra work if you already know that you will be using this information 4 5 1 Manufacturer Categories Manufacturer Categories are used to group Manufacturers into different categories Adding Manufacturer Categories VirtueMart creates the manufacturer category name default upon installation It is not necessary to change this 32 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

Download Pdf Manuals

Related Search

Related Contents

  Operating Instructions  2013.07.01 mabe CVM8N y 12N PM02.pmd  Installation and operating instructions for R+W Servomax  Nikon 25438 Digital Camera User Manual  Kenwood KDC-W4527G CD Player User Manual    Melissa Mini Oven 751-081 User's Manual  Manuel de l`utilisateur de l`ordinateur portable    

Copyright © All rights reserved. Failed to retrieve file