VirtueMart

h1. VM2 Shop Menu

Note: the user manual has been moved here http://docs.virtuemart.net/

h2. SHOP MENU

h3. Shop - Vendor Tab 	

h4. Shop Name	

The name of this website.	

h4. Shop Company Name	

The name of the company that runs this website.	

h4. URL	

This will be filled in for you, do not change it!	

h4. Minimum purchase order value for your shop	

If you want to refuse small purchases and force customers to purchase more than a minimum amount, enter the amount here. 	

h4. Currency	

Select your main currency from the drop-down list.	

h4. List of accepted currencies	

Click in the box to display a drop-down list of all currencies to select from. Click the X on a currency to delete it. 	

h4. Vendor Information - Images	

Type a space to see a list of all images, or the red X on the image to delete it. Click the bottom right icon on the image to edit the image information. If your media won't upload, scroll down to the bottom of the page and check to see that the long links say "WRITEABLE." If not, use cPanel's FILE MANAGER to change the "Write Permissions" on the folders listed to 755 (on some hosts 777).	

h4. File Published?	

Check the box to publish or uncheck the box to hide the media.	

h4. Unique Filename	

A unique "alias" or name for the media.	

h4. Displayed Image Title	

What words do you want to appear when visitors put their cursor over the image? 	

h4. Image Alt-Text	

What words do you want a sight-impaired reader to hear to describe this image? 	

h4. Used URL 

Leave blank for VirtueMart to assign a URL to this media.	

h4. Used Thumb URL	

Leave blank for VirtueMart to assign a URL to this media.	

h4. Role	

Choose "displayable" to allow customers to view the media only, or "downloadable" if you want them to be able to download the media.	

h4. Storing location/type	

Category is filled in for you.	

h4. Upload File	

To upload an image from your computer, click the BROWSE Button and select it from your personal computer. Then choose whether to upload, replace existing image or replace the existing thumbnail image. IMPORTANT: If you do not select the UPLOAD radio button, the image will not upload. Click the top right SAVE Button to upload.

h4. Description	

A description for the home page, sometimes called the "Home Page Welcome" text. Type the text like typing an email. Use the buttons at the bottom of the editor as follows: 

h4. Article Button

Link an article to the text. 

h4. Image

Insert an image where your cursor is. 

h4. Page Break Button

Insert a page break.

h4. Read More Button

Inserts the words "READ MORE..." so reader can click to expand and read all. 

h4. Toggle Editor Button

For advanced users, switch between HTML and design views. 	

h4. Terms of Service	

If you require customers to read and accept the Terms of Service (turn TOS ON or OFF in CONFIGURATION - Configuration - Checkout Tab - Terms of Service), type or edit the text here. 

h4. Legal Information	

Delete the sample text and insert your own disclaimers, copyright or other information here. 

h3. Shop - Additional Information Tab	

h4. Vendor - Permissions	

You are already assigned to the highest level, Admin. If you want to lower your own permissions, select a different role from this box. NOT RECOMMENDED.	

h4. Shopper Number/ID	

This is pre-filled in for your information. If you use website statistics, you can use this number to eliminate your own visits to your store and get a true count of visitors.	

h4. Shopper Group	

You can assign yourself to a special user group, example Wholesale, so you can see your storefront as your customers do. But I recommend that you sign up as a customer to create a separate account for testing, and then in your Admin assign them to a special group. 	

h4. Shipment Addresses	

Most users can add an additional shipment address here by clicking the green "+" icon. But because you are editing the "Super User" record, nothing happens. You must edit your address in JOOMLA's Users - User Manager - Super User. 

h4. Additional Information	

This is all your logon information. When you have finished, click the top right SAVE Button.

h3. Shop - General User Information Tab

h4. Displayed Name	

The name you want to be visible in the store.	

h4. Username	

The name you will use to log onto the website.	

h4. Email	

Your email address for receiving system messages, lost password reset, etc. from your VirtueMart store.	

h4. New Password and Verify Password	

To change your password, type the new password in both boxes.	

h4. Receive System Emails 	

Do you want to receive emails, for example, copies of each order? Choose yes or no.

h2. MEDIA FILES MENU

You can view and manage all the media files - images, video, pdf's, anything you need to upload or customers need to download - from this one easy location. 	

If you think this looks a lot like the product images tab, you are right! This is just ALL product images in one location.	

h2. SHIPMENT METHODS MENU

VirtueMart includes one pre-installed flexible shipment method that you can configure many different ways. You can also purchase additional shipment plug-ins, or have them custom-made for you. We discuss the pre-installed method here.				

h3. Shipment Methods -  Information Tab	

h4. Shipment Name	

Give a unique name to your shipment method. This name will appear in your checkout page.	

h4. Published	

Must select YES for Published or the shipment method will NOT appear in your store.	

h4. Shipment Description	

This explanation will appear in the checkout page so your customer can understand the choice(s).	

h4. Shipment Method	

There is only one shipment method pre-installed in VirtueMart, so select it from the drop-down list.	

h4. Shopper Group	

If you use customer groups like Wholesale, click in the box to display the drop-down menu, then select it. Otherwise, leave at default.	

h4. List Order	

If you use multiple shipment methods, put a 1 for this method to appear first, 2 to appear second, etc.

Click the SAVE Button before moving onto the Configuration Tab so VirtueMart knows what configuration settings to show you.

h3. Shipment Methods - Configuration Tab	

h4. Logo	

If you have uploaded a small image to display on shipping and payment documents, select it here. 

h4. Countries	

If you wish to ship to only some countries, click in the box and select the individual country names. If you will ship to any country, leave blank.	

h4. Zip range start and Zip Range end	

To limit shipping to only certain zip codes, enter them here. Otherwise, leave blank.	

h4. Lowest Weight, Highest weight and Weight Unit	

To limit shipping by weight, enter lowest and highest weights here. Otherwise, leave blank.	

h4. Minimum and Maximum Number of Products	

To limit shipping by number of products, enter lowest and highest number of products here. Otherwise, leave blank.	

h4. Minimum and Maximum Order Amount	

To limit shipping by price, enter lowest and highest prices here. Otherwise, leave blank.	

h4. Shipment Cost, Package Fee, Tax	

How much will the customer pay for shipping if they meet the criteria you specified above? Will you charge a fee per package? If you are required to pay tax on shipping, select it here.	

h4. Minimum Amount for Free Shipment	

If you want to allow free shipping, example on orders over $100, enter 100.00 here. Otherwise, leave blank. 

h2. PAYMENT METHODS MENU	

It would be nice if the methods were pre-listed on this Payment Method List. However, it's easy to add any of the four pre-installed methods by selecting the top right NEW Button, then following the instructions below for the method(s) you want to use: A generic Payment Standard, good for testing; PayZen, PayPal or SystemPay, good for most online merchants; or Authorize.net for advanced programmers. 

h3. VM Payment Standard - Payment Information Tab

VirtueMart Payment Standard is good for testing your store before you have added an actual payment method. Advanced programmers may be able to set it up for use in a live store, but it is risky if you do not understand you are doing. CHANGE TO A SECURE METHOD BEFORE GOING LIVE.

h4. Payment Name	

Give a unique name to your payment method. This name will appear in your checkout page.	

h4. Published	

Must select YES for Published or this method will NOT appear in your store.	

h4. Payment Description	

This explanation will appear in the checkout page so your customer can understand the choice(s).	

h4. Payment Method	

Select VM Payment Standard from the drop-down list.	

h4. Shopper Group	

If you use customer groups like Wholesale and want this method to be available only to that group, click in the box to display the drop-down menu, then select it. Otherwise, leave at default.	

h4. List Order	

If you use multiple payment methods, put a 1 for this method to appear first, 2 to appear second, etc.		

Click the SAVE Button before moving onto the Configuration Tab so VirtueMart knows what configuration settings to show you.

h3. VM Payment Standard - Configuration Tab

h4. Logos	

If you have uploaded a small image to display on shipping and payment documents, select it here.

h4. Countries	

If you want this payment method to be visible only to customers in certain countries, select the countries from the drop-down list. Otherwise, leave blank.	

h4. Accepted Currency	

If you want this payment method to be available only if customers use a specific currency, select the currency from the drop-down list. Otherwise, leave at "Default Vendor Currency."	

h4. Minimum Amount and Maximum Amount	

If you want this payment method to appear only if a customer's order is above and/or below a certain amount, enter the minimum and/or maximums here.	

h4. Fee per transaction	

If you want to charge a flat payment fee for each transaction (example $5.00 per order), enter the amount here. Example 5.00 will add a $5.00 transaction fee.	

h4. Percent of the total amount	

If you want to charge a payment fee based on the total amount (example: 1% payment fee), and it is legal for you to do so, enter the percent amount here. Example: .01 will add a 1% payment fee.	

h4. Tax	

If you are required by your taxing authority to pay tax on payment transaction fees, select the tax here. Otherwise, leave at "Apply no rule." 	

h4. Payment Info	

Enter a message to display with the order, example "Thank you for your order! We normally ship within 24 hours...."

h3. VM Payment PayZen - Payment Information Tab

A payment company developed within the last two years, PayZen is for companies in the European Union only. Visit them online at http://payzen.eu.

h4. Payment Name	

Give a unique name to your payment method. This name will appear in your checkout page.	EXAMPLE: PayZen.

h4. Published	

Must select YES for Published or this method will NOT appear in your store.	

h4. Payment Description	

This explanation will appear in the checkout page so your customer can understand the choice(s).	

h4. Payment Method

Select VM Payment PayZen from the drop-down list.	

h4. Shopper Group	

If you use customer groups like Wholesale, click in the box to display the drop-down menu, then select it. Otherwise, leave at default.	

h4. List Order	

If you use multiple payment methods, put a 1 for this method to appear first, 2 to appear second, etc.					

Click the SAVE Button before moving onto the Configuration Tab so VirtueMart knows what configuration settings to show you.

h3. VM Payment PayZen - Configuration Tab

Most of this page is filled in for you with settings that will work for TESTING. You will need to open an account at http://payzen.eu.				

h4. Logos	

If you have uploaded a small image to display on shipping and payment documents, select it here. 

h4. Fee per transaction	

If you want to charge a flat payment fee for each transaction (example $5.00 per order), enter the amount here. Example 5.00 will add a $5.00 transaction fee.	

h4. Percent of the total amount	

If you want to charge a payment fee based on the total amount (example: 1% payment fee), and it is legal for you to do so, enter the percent amount here. Example: .01 will add a 1% payment fee.	

h4. Tax	

If you are required by your taxing authority to pay tax on payment transaction fees, select the tax here. Otherwise, leave at "Apply no rule." 	

h4. Site ID, Test Key and Production Key	

After you have been approved for an account by PayZen, get this information from your Account Information or Welcome Email. Until then, you can use the Site ID and test key that are listed on this page.	

h4. Additional settings	

See the Payzen VirtueMart Documentation for detailed information here: http://media.payzen.eu/documentation_support/virtuemart_2.pdf

h3. VM Payment Authorize.net - Payment Information Tab

Authorize.net is one of the world's most respected payment processors. However, it is an ADVANCED METHOD. You will need to open an account with a third-party Authorize.net reseller - they do not sell directly to merchants.	We DO NOT RECOMMEND THIS METHOD for beginners. YOU MUST FIRST have a valid Secure Sockets Layer (SSL) certificate properly installed. Ask your web host to install this for you. 	

h4. Payment Name	

Give a unique name to your payment method. This name will appear in your checkout page. Example: Authorize.net	

h4. Published	

Must select YES for Published or this method will NOT appear in your store.	

h4. Payment Description	

This explanation will appear in the checkout page so your customer can understand the choice(s). If you have SSL installed properly, you could say "Secure processing by Authorize.net." 	

h4. Payment Method	

Select VM Payment Authorize.net from the drop-down list.	

h4. Shopper Group	

If you use customer groups like Wholesale, and want only that group to be offered this method, click in the box to display the drop-down menu, then select it. Otherwise, leave at default.	

h4. List Order	

If you use multiple payment methods, put a 1 for this method to appear first, 2 to appear second, etc.					

Click the SAVE Button before moving onto the Configuration Tab so VirtueMart knows what configuration settings to show you.

h3. VM Payment Authorize.net - Configuration Tab

For additional assistance with Authorize.net AIM, see http://www.authorize.net/support/AIM_guide.pdf	

After SSL is installed, go to CONFIGURATION - Configuration - Shop Tab and make sure the "Enable SSL for sensible areas (recommended)" box is checked.	

h4. Login ID and Transaction Key	

After you have been approved for an account by Authorize.net, get this information from your Account Information or Welcome Email.	

h4. Secure Post	

You must have SSL installed and configured correctly for this to work. 	

h4. Use Sandbox, Sandbox Login ID and Sandbox Transaction Key	

Put your payment method into TEST MODE. 	

h4. Credit Cards	

Start typing in the box for a list of credit cards to appear. Click each credit card name to select it, then repeat for multiple cards.	

h4. Logos	

If you have uploaded a small image to display on shipping and payment documents, select it here. 

h4. CVV images	

OPTIONAL: CVV is Credit Card Verification Value, the 3-digit number  usually on the back of your card. Select an image you have uploaded for the CVV Tooltip Help that shows the 3-digit number circled on the back of a credit card. 

h3. VM Payment PayPal - Payment Information Tab

h4. Payment Name	

Give a unique name to your payment method. This name will appear in your checkout page. Example: PayPal.	

h4. Published	

Must select YES for Published or this method will NOT appear in your store.	

h4. Payment Description	

This explanation will appear in the checkout page so your customer can understand the choice(s). Example: Pay with PayPal with or with out a PayPal account! It's easy and fun."	

h4. Payment Method	

Select VM Payment PayPal from the drop-down list.	

h4. Shopper Group	

If you use customer groups like Wholesale and want to limit this method to that group, click in the box to display the drop-down menu, then select it. Otherwise, leave at default.	

h4. List Order	

If you use multiple payment methods, put a 1 for this method to appear first, 2 to appear second, etc.					

Click the SAVE Button before moving onto the Configuration Tab so VirtueMart knows what configuration settings to show you.

h3. VM Payment PayPal - Configuration Tab

h4. Logos	

If you have uploaded a small image to display on shipping and payment documents, select it here.

h4. PayPal Payment email	

The address you registered with PayPal when you opened your account. Note, you can have up to six paypal addresses. 	

h4. Accept only verified buyers?	

Here you can choose if you only want to accept payments from buyers with a verified PayPal account.  When an account is not verified, PayPal does transfer the funds, but they don't fully guarantee the validity of the sale.

h4. Merchant Sandbox Email, Sandbox	

If you want to test, "Sandbox" will not charge the transactions to the buyer's account. BE SURE TO CHANGE TO NO BEFORE GOING LIVE!	

h4. Let buyers override their PayPal address?	

The address specified with the automatic fill-in variable overrides the PayPal member's stored address.  Buyers see the address that you pass in, but they cannot edit it.  PayPal does not show address if they are invalid or omitted.    	

h4. Prompt buyers for a shipping address	

Your customers have already filled in their shipping address in your store. Why ask them to fill it in again? Recommended: "Do not prompt for a shipping address."	

h3. VM Payment SystemPay - Payment Information Tab

SystemPay is the payment system for two French banks:  SPPLUS, and Banque Populaire. It is available in France, Brazil and a limited number of countries. More information at http://www.systempay.com/.

h4. Payment Name

Give a unique name to your payment method. This name will appear in your checkout page. Example: SystemPay.

h4. Published

Must select YES for Published or this method will NOT appear in your store.

h4. Payment Description

This explanation will appear in the checkout page so your customer can understand the choice(s). Example: “Credit Card” OR “System Pay.” 

h4. Payment Method

Select VM Payment SystemPay from the drop-down list.

h4. Shopper Group

If you use customer groups like Wholesale and want to limit this method to that group, click in the box to display the drop-down menu, then select it. Otherwise, leave at default.

h4. List Order

If you use multiple payment methods, put a 1 for this method to appear first, 2 to appear second, etc.

Click the SAVE Button before moving onto the Configuration Tab so VirtueMart knows what configuration settings to show you.

h3. VM Payment SystemPay - Configuration Tab

h4. Logos	

If you have uploaded a small image to display on shipping and payment documents, select it here. 	

h4. Cost per transaction	

If you want to charge a flat payment fee for each transaction (example $5.00 per order), enter the amount here. Example 5.00 will add a $5.00 transaction fee.	

h4. Percent of the total amount	

If you want to charge a payment fee based on the total amount (example: 1% payment fee), and it is legal for you to do so, enter the percent amount here. Example: .01 will add a 1% payment fee.	

h4. Tax	

If you are required by your taxing authority to pay tax on payment transaction fees, select the tax here. Otherwise, leave at "Apply no rule." 	

h4. Site ID, Test Key and Production Key	

After you have been approved for an account by SystemPay, get this information from your Account Information or Welcome Email.	

h4. Additional Settings	

See the SystemPay VirtueMart Documentation for detailed information here: https://systempay.cyberpluspaiement.com/html/contributions.html 

h4. Countries	

You can limit PayPal to only specific countries if you wish. Begin typing in the box for a drop-down list of countries. Select the country for which this payment method applies.  If no country is selected, this payment method will be available for all countries you sell to.

h3. VM Payment SystemPay - New in 2.0.4 - Coming soon.