VirtueMart - 1.1 Manuel d'utilisateur

VirtueMart 1.1 User ManualSören Eberhardt-Biermann

x

The Order Details904.8.2. The Order DetailsFigure 4.69. VirtueMart Administration: Upper Part of the Order DetailsThe Order Details View shows all det

Vendor Administration91You can also change the order status for single order items using the status drop-down list in eachrow of the order item list.4

Vendor Categories92Figure 4.71. VirtueMart Administration: Vendor List for a CategoryThis will open the Vendor List page.4.9.1.2. Adding Vendor Catego

Vendor Categories93Figure 4.73. VirtueMart Administration: Vendor Category ListVendor Category ListYou may also add a new vendor category with the Ven

Vendors94Vendor Category DeletionClick 'OK' to confirm deletion of this category.4.9.2. VendorsVendors are the main organizational factor in

Vendors95Description This is the Vendor Store's Description which is shown on thepage shop.index.Terms of Service This is the complete text f

Tax Rates96Before deleting an existing vendor, all products, product categories, users, and orders associated tothat vendor must be removed through ei

Shipping Modules97Tax Rate Example: 0.0825The tax rate, as a decimal value. For example, 8.25% would be enteredas 0.0825Click on the "Save"

Standard Shipping98Figure 4.76. VirtueMart Administration: Shipping Rate ListBy clicking on the name of a shipping rate in this list, you can access t

Standard Shipping99Figure 4.77. VirtueMart Administration: Shipping Rate FormIn this form you can specify the details of the shipping rate.Shipping Ra

1Chapter 1. Introduction1.1. What is VirtueMart?1.1.1. AboutVirtueMart is a PHP-based Shopping Cart Application for selling goods over the i

UPS Shipping Module100Fee The Fee for this shipping rate = the costs.Package Fee The package fee = additional costs for packaging.Currency The curren

Add and Edit Payment Methods101The configuration options for each payment method are different – depending on what is requiredby that payment service

Pre-Configured Payment Methods102for this, but if you need to do it yourself, check with your payment service provider as to whattheir requi

Pre-Configured Payment Methods103appropriate URL (web address) for the script file in WorldPay’s control panel. When a customerfinishes the Payment, W

Coupon Administration104See section "authorize.net".4.12.3.8. NoChexTODO4.12.3.9. PayMeNowTODO4.13. Coupon AdministrationYou can access the

Reports105Now 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 redee

106

107Chapter 5. About VirtueMart5.1. Known ProblemsSee Bug Tracker [https://dev.virtuemart.net/cb/proj/tracker/browseTracker.do?tracker_id=1]5.2. To-Do

The Documentation108The VirtueMart Developer Portal [http://dev.virtuemart.net] is an open Development + HostingPlatform for all VirtueMa

Features2• Manages an unlimited Number of Products and Categories,• Can be used as a Shop or just as an Online-Catalog (you can even turn off Price Di

What does it not do?3• flexible Shipping Carriers and Rates Configuration• Live-Shipping Rates using Shipping Modules (e.g. InterShipper, UPS, USPS, F

Frontend Screenshots (using theJoomla! 1.5 Template JA Purity)4Figure 1.2. Frontend: Product Details Page with Review Feature

Administrator Screenshots5Administrator ScreenshotsFigure 1.3. Administration: Homepage / Summary / StatisticsFigure 1.4. Administration: Product List

6

7Chapter 2. Installation2.1. Joomla! / Mambo InstallationUnless you have downloaded the VirtueMart eCommerce Bundle (including Joomla!), Joomla! andMa

Installation and Upgrade8The official Download Page is http://dev.virtuemart.net/cb/wiki/1693. [http://dev.virtuemart.net/cb/wiki/1693]2.2.2.2. Editio

Installation and Upgrade9All you need to do is install VirtueMart! It will automatically convert your installation of mambo-phpShop.So just follow the

VirtueMart 1.1 User ManualSören Eberhardt-BiermannRussel Walkerwww.netshinesoftware.com [http://www.netshinesoftware.com/]$Date: 2008-08-02 22:53:47 +

Automatic Installation10WarningThis has been said often enough before, but now once again: before you attempt to upgradeyour existing Store to VirtueM

Automatic Installation113. In Mambo/Joomla! 1.0 click Installers # Components. In Joomla! 1.5 click Extensions # Install/Uninstall in the Top Menu.Joo

Automatic Installation12Installation Welcome ScreenYou can now choose whether you want to install Sample Data (some Products, with Attributes,sorted i

Automatic Installation13Additional modulesmod_product_categories "Product Categories Module"It can display the product categories you have s

Manual Installation14Click on 'Mambots' # 'Install/Uninstall' (or 'Extensions' # 'Install/Uninstall when using Joom

Language Installation154. Login in to the Backend (Administration) of your site (http://www.your_site.com/administrator/).5. When having logg

Installation FAQ16doc.do?proj_id=1]. Please note that the language files of VM 1.0 and VM 1.1 are of a completelydifferent structure and not compatibl

Installation FAQ17php_value upload_max_filesize 4M2.2.7.1.3.The installation on Joomla! 15 fails with the error “Your Extension appears to be written

Installation FAQ18VirtueMart is no component-only script. It's programmed to be used together with thecorresponding VirtueMart Main

19Chapter 3. First StepsDo you have installed the VirtueMart Main Module?If not, do so now. Don't forget to publish it somehere on your site. Thi

iiiTable of ContentsPreamble ... ix1

Joomla! Global Configuration20CautionIf you don't change your Store Information and theEmail Address, VirtueMart sends Order ConfirmationEmails t

21Chapter 4. Administrator TutorialThis tutorial will walk you through the setup of your site, ongoing management, and advancedadministr

Global22product pages. This means the whole shop section isnt usablefor customers. Administrators won't see the shop too.Offline Message This mes

Global23location, the tax rate of the store/vendor location or - in EUMode - the tax rate of the country, the store is located in,regardle

Security24Long version of the return policy(link to a content item)This is the long and detailled version of your returns policy.This text is linked i

Site (Display & Layout)25secure, as it actually encrypts the data, not just encodes it.AES_ENCRYPT is available in MySQL >= 4.0.2.Enc

Site (Display & Layout)26Default Product Sort Order Here you can select by which criteria products are ordered inthe product lists.Available "

Shipping27TipYou can check if you have GD2 support by browsingto "System" # "System Info" # "PHP Info" # gd.The Thumbna

Getting Started28"Disable download" Order Status Sets the order status at which the download is disabled for thecustomer.DOWNLOADROOT The p

Getting Started29Figure 4.2. Joomla! Administrator: Component Drop-Down ListIf you see the VirtueMart "Welcome" page when accessing VirtueMa

iv

Store Setup304.3. Store SetupTo begin setting up your store, select "Store | Edit Store" from the VirtueMart admin interface.Figure 4.4. Vir

Store Information Form Fields31Zip/Postal Code The ZIP of your Store's location.Phone Your Store's Phone NumberLast, First & Middle Name

Countries, Currencies,Core Modules & Functions324.4. Countries, Currencies, Core Modules &Functions4.4.1. Managing CountriesCountries are mana

Managing Currencies33To remove one or more countries from the list, either click on the "trash bin" icon in the last column ofeach row and c

VirtueMart Core Modules344.4.3. VirtueMart Core ModulesVirtueMart Core Modules have absolutely nothing to do with "Joomla! Module", which ar

VirtueMart Core Functions35Figure 4.10. VirtueMart Administration: Currency FormDon't forget to save and the new module is added to the list.You

VirtueMart Core Functions36Figure 4.11. VirtueMart Administration: Function ListTo add a new function, click "New" in the top of the list an

Manufacturer Administration37You can modify existing functions. To do so, just click on the name of a function in that list and a formopens and you ca

Manufacturers38Once the manufacturers have been removed, select "Manufacturers | List Manufacturer Categories"from the VirtueMart admin menu

Product Administration394.6. Product AdministrationVirtueMart offers the ability to categorize products not only by manufacturer, but also by productc

vList of Figures1.1. Frontend: Category Overview Page ... 31.2. Frontend: Pr

Product Categories40Product Category FieldsPublish? Used to specify whether the category will be published on thesite.Category Name The name that will

Products41• Use the "sort alphabetically" icon in the list header. You can sort all categories in your storealphabetically usin

Products42Product FormFigure 4.16. VirtueMart Administration: Product Form, Tab 1 - GeneralInformationPublish? Used to specify whether the pr

Products43Discounted Price This overrides the Discount Type and automatically creates a DiscountRecord using the Difference between the Gross P

Products44Figure 4.18. VirtueMart Administration: Product Form, Tab 3 - Product StatusQuantity in Stock The current quantity in stock for the item. Us

Products45Adds easy attributes to the product. These are attributes whichcan be selected by a customer. This does not create items foreach attribute v

Products46ImportantAllowed UOM arepo / pound(s)kg /kilogram(m)(s)ou / ounceslb / LBUnits in Packaging Specifies how many pieces of this Products are i

Product Price Management47Figure 4.21. VirtueMart Administration: Product Form, Tab 6 - RelatedProductsNow you're done. Just click on &q

Product Price Management48Figure 4.22. VirtueMart Administration: Product Form, Price Form in theProduct FormYou can also directly add and mo

Product Price Management49Figure 4.24. VirtueMart Administration: Price Update NoticeTo add Prices for Quantity Ranges, you need to go to the Product

VirtueMart 1.1 User Manualvi4.44. VirtueMart Administration: Product Types Management - Advanced Search According toParameters - Selecting Product Typ

Product Price Management50Figure 4.26. VirtueMart Administration: Product Form - List PricesIn the Price List for this Product you can find a List of

Product Variations and Attributes51Figure 4.28. VirtueMart Administration: Product Price FormDon't forget to save your changes when you're d

Product Variations and Attributes52you have to set up at least one attribute first. Hence, it is only after you have added an attribute thatthe New It

Product Variations and Attributes53Figure 4.30. VirtueMart Administration: Add a new item (=child product)Click on the Add Items button in the toolbar

Product Variations and Attributes544.6.4.1.4. Deleting ItemsTo delete an item, List the Product's Items like in the previous section. Then click

Product Types Management55Figure 4.32. Attribute Manager in the Product FormImportantIf you have defined Attributes, the Customer must select a Value

Product Types Management56NoteOther developers call this magical feature "The Filter".NoteTo fully understand this feature, you really have

Product Types Management57Important"Creating Product Types" is possible only in this manner and only from this menu item.Although this sound

Product Types Management58TipWe recommand not using "Image", "Page break" and "Readmore" options, because it is anuneces

Product Types Management59Figure 4.34. VirtueMart Administration: Product Types Management - ProductType ListNow you see the empty Parameter List for

viiList of Examples4.1. ... 6

Product Types Management60Figure 4.35. VirtueMart Administration: Product Types Management - ProductType -Parameter Information

Product Types Management61Parameter name is actually the name of the database field for the parameter, sodon't forget spaces in this field! Examp

Product Types Management62flypage, and use only theProduct Type Parameter Listlayout.Possible Values In this fileld you have to write all the val

Product Types Management63ImportantIf you want to create a single Product Type for a NON parent category of products, witch isrecommanded, you have to

Product Types Management64Figure 4.37. VirtueMart Administration: Product Types Management - Addingnew Product Type to a Product FASE 1Figure 4.38. Vi

Product Types Management65Figure 4.39. VirtueMart Administration: Product Types Management - Addingnew Product Type to a Product FASE 3Now lets check

Product Types Management66Figure 4.40. VirtueMart Administration: Product Types Management - Flypageof a Product assigned to a Product TypeNoteIn this

Product Types Management67Figure 4.41. VirtueMart Administration: Product Types Management -Creating a new product already assigned to a Produc

Product Types Management68Figure 4.42. VirtueMart Administration: Product Types Management -Creating a new product already assigned to a Produc

Product Types Management69Figure 4.43. VirtueMart Administration: Product Types Management -Creating a new product already assigned to a Produc

viii

Product Types Management70Figure 4.44. VirtueMart Administration: Product Types Management -Advanced Search According to Parameters - Selecting

Product Types Management71Figure 4.45. VirtueMart Administration: Product Types Management -Advanced Search According to Parameters Form - Sele

Product Types Management72Figure 4.46. VirtueMart Administration: Product Types Management -Advanced Search According to Parameters Search Resu

Product Downloads,additional Images and Files734.6.5.4. Deleting Product TypesThis is an important decision to make, because deleting a Product Type w

Product Downloads,additional Images and Files74Figure 4.48. VirtueMart Administration:The image icon is the link to the file manager. The number behin

Product Downloads,additional Images and Files75ImportantThe Download Mode must be enabled globally in the Configuration first. See Section

Product Downloads,additional Images and Files764.6.6.2.2. More Information about Product DownloadsCustomers are automatically notified about their Dow

Product Downloads,additional Images and Files77Figure 4.52. Resend Download IDWhen the Download has expired or the Customer has downloaded the maximum

Product Discounts784.6.7. Product DiscountsDiscounts in VirtueMart must be created in the Product Discount Form before being able to assigna Product t

Product Ratings and Reviews79the amount will mean that you give a Discount of XX % tothe Product Price. If "Total" is selected, the amoun

ixPreambleThe content of this document is related to VirtueMart.VirtueMart is free Software, licensed under GNU/GPL; VirtueMart [ http://virt

User Management80If a Product has one or more Reviews, you can view the List of all Reviews.Figure 4.57. List of Product ReviewsTo edit or view a Revi

Users81Figure 4.58. VirtueMart Administration: Shopper Group ListTo add a new shopper group, just click on the "New" button in the toolbar.

User Groups824.7.3. User GroupsUser Groups are "Permission Groups" and used to restrict access to certain parts and functions of theshop. Ea

User Registration Fields83Here you can choose a name for the group and the group level.NoteThe higher the group level, the less permissions are assume

User Registration Fields844.7.4.1. Add a new FieldYou can add a new field by clicking the "New" button on the toolbar in the User Field List

User Registration Fields85Figure 4.64. VirtueMart Administration: Add a new User FieldThe Form Fields have the following meaning:Type The type of this

User Registration Fields86Required? If this is set to yes, a value must be provided or chosen,otherwise registration will not be possible.

User Registration Fields87Reordering FieldsFields can be reordered using the blue arrows in the user field list or using the text input fields ineach

Order Administration88Figure 4.67. VirtueMart Administration: Modifying a Field4.7.4.3. Deleting FieldsYou can delete all non-system fields from the U

The Order List89The order record has a ‘status’ to indicate where the order is in the stream of events – for example,whether it has been paid for, shi