CMS Help Menu

Login to CMS
Login to CMS Information on how to login to your content management system, including dashboard layout [Click Here]
Add New User
Add/New User How to add a new user and how to edit an existing user
[Click Here]
Create/Edit Article
Create/Edit Article How to add a new article or page and how to edit an existing article/page layout [Click Here]
Create/Edit Article
Create/Edit Category How to add a new category and how to edit an existing category [Click Here]
Create -Edit Menu
Create/Edit Menu How to add a new menu item and how to edit an existing menu item [Click Here]
Module Management
Manage Modules Information about module management [Click Here]
Ecommerce Management
Shopping Cart All ecommerce related help pages. Shop configuration, Category, product and all other help items.[Click Here]
Flip Book
Flip Book How to setup and configure flip-book in your CMS.
[Click Here]

Our support

Frequently Asked Questions If you should have any questions and need a quick answer visit our frequently asked questions area [...]
Client Login In order to login into your dedicated client area please follow this link [...]
Billing Information In order to get an overview about past
invoices or to change your billing preferences, please follow this link [...]
Knowledge Base You'll find interesting articles, valuable documentations and
descriptions in our knowledge base [...]
Submit a Ticket Please click here in order to quickly submit a support ticket.
Ticket Status In order to view the current status of an support ticket....]

AFFILIATES

Add, edit, delete affiliates, record payments made.

General Tab

Tracking Code
A unique random code generated by the store that the affiliate must put at the end of a URL or link back to your store to receive credit for the referral.

Status
Enabled to allow affiliate to track referrals or Disabled to turn off.

Payment Details Tab

Commission (%)
Percentage the affiliate receives on each order.    

Tax ID
The Tax ID issued by the affiliate's taxing authority.

Payment Method
Cheque
PayPal
Bank Transfer

Cheque Payee Name
If payment by cheque, payee name.

ATTRIBUTES

Attributes are features that will be compared side by side by the customer when deciding on which item to choose using Product Comparison.

After creating an Attribute Group in CATALOG -> Attributes -> Attribute Groups, next create as many attributes as you like to go under that group in CATALOG -> Attributes -> Attributes.

Give your attribute a name, select the attribute group you created from the drop down box, and if you have multiple attributes for this product, give it a 1 to display this attribute first in the group, 2 to display second, and so forth.

NOTE: When you are ready to add attributes to a product, open the product information page and link the product to its attributes. From CATALOG - Products, select the product name and edit or insert. At the top tabs click the ATTRIBUTE Tab.

1. Click the ADD ATTRIBUTE Button, then begin typing the name in the Attribute box. A drop-down list will appear for you to select the correct Attribute Name.
2. In the TEXT Box, type all the possible choices for this product.
3. REPEAT steps 1 and 2 for each attribute.

Click the SAVE Button.

Attribute Groups

1.5 feature

To insert a new Attribute Group, go to CATALOG -> Attributes -> Attribute Groups and click the top right INSERT Button.

Give your attribute group a name, and if you have multiple attributes for this product, give it a 1 to display this group first in the list, 2 to display second, and so forth.

When you have finished, click the SAVE Button.

CATEGORY

Organize your products into departments.

General Tab

*Category Name
Name of the category.

Meta Tag Description
Meta Tag Descriptions are used by search engines to describe the content of your web site.

Meta Tag Keywords
Meta Tag Keywords are used by search engines to describe the content of your web site.

Description
The category description for the Category Page. This uses the FCKEditor so you can add HTML, images and FLASH content.

Data Tab

Parent Category
Sets the parent category in the menu.

Stores
If you use multiple stores, select the stores for this category to appear.

SEO Keyword
The keyword used for search engine optimization. This must be globally unique.

Image
Sets the image to use for the category.

Top
Display in the top menu bar. Only works for the top parent categories.

Columns:
Number of columns to use for the bottom 3 categories. Only works for the top parent categories.

Sort Order
Sort order determines what order the categories are displayed in the menu.

Status
Enabled for category to display in store or Disabled to hide category.

Design Tab

Stores
Select a layout override to change the look and feel of this category.

COUNTRIES

To refuse orders from certain countries and remove them from the customer registration's drop-down list, select DISABLED from the STATUS box.

Country Name
Name of the country.

ISO Code (2)
The 2 letter ISO country code. You can find out more about these here.

ISO Code (3)
The 3 letter ISO country code. You can find out more about these here.

Address Format
You can define the address formatting for each country.

Example:

{firstname} {lastname}
{address_1}
{address_2}
{zone} {postcode}
{country}

Each part of the address format must contained within a curly bracket.

COUPONS

Coupon Name
Name of the coupon. Displayed in the order totals during checkout.

Coupon Code
Coupon Code. The code you give to the customers to enter on the checkout confimation page so the discount will be deducted from the total.

Type
Select percentage discount or fixed amount to deduct from total price.

Discount
Coupon discount amount. If type is percentage then this percent is subtracted from the total price. If the type is set to a fixed amount, then this fixed amount will be deducted from the sub-total.

Total Amount
Minimum order amount that must reached before the coupon is valid.   Leave blank for no minimum.

Customer Login
Select Yes to require customer to log in before using the coupon, or No to not require it.

Free Shipping
Select Yes to give customer free shipping, or No to charge shipping.

Products
Select which products you want to apply the discount amount to. If none are selected then the discount amount will apply to all products.

Date Start
Set the start date for when you want the coupon to be start.

Date End
Set the end date for when you want the coupon to expire.

Uses Per Coupon
Set the number of times a coupon can be used.

Uses Per Customer
Set the number of times a coupon can be used.

Status
Coupon status will determine if the coupon can be used or not

COUPONS

Coupon Name
Name of the coupon. Displayed in the order totals during checkout.

Coupon Code
Coupon Code. The code you give to the customers to enter on the checkout confimation page so the discount will be deducted from the total.

Type
Select percentage discount or fixed amount to deduct from total price.

Discount
Coupon discount amount. If type is percentage then this percent is subtracted from the total price. If the type is set to a fixed amount, then this fixed amount will be deducted from the sub-total.

Total Amount
Minimum order amount that must reached before the coupon is valid.   Leave blank for no minimum.

Customer Login
Select Yes to require customer to log in before using the coupon, or No to not require it.

Free Shipping
Select Yes to give customer free shipping, or No to charge shipping.

Products
Select which products you want to apply the discount amount to. If none are selected then the discount amount will apply to all products.

Date Start
Set the start date for when you want the coupon to be start.

Date End
Set the end date for when you want the coupon to expire.

Uses Per Coupon
Set the number of times a coupon can be used.

Uses Per Customer
Set the number of times a coupon can be used.

Status
Coupon status will determine if the coupon can be used or not

CURRENCIES

Add a new currency.

Currency Name
Name of the currency.

Code
Name of the currency. You can find a list of codes here. All currency codes must be in uppercase.

Symbol Left
The left currency symbol if the currency has one. An example would be the pound sign (£) for pound sterling.

Symbol Right
The right currency symbol if the currency has one. An example would be the euro sign (€).

Decimal Places
The number of decimal places used for a perticular currency. Some currencies use more than 2 decimal places such as the Kuwaiti Dinar.

Value
The currency value compared to your default currency. If the currency you are entering is going to be your default currency you should set the value to 1.00000. The currency value will change automatically if you have auto update currency set to yes.

Status
Currency status will determine if the currency is displayed on the front of site

DOWNLOADS

*Download Name
Name of the download. The download name is displayed to customers when choosing a download.

Filename
Select the file for customers to download. Multiple files should be in zip format. Click BROWSE Button to select and upload from your computer.

Total Downloads Allowed
Set the number of downloads a customer is allowed on a single order. If more than one order is made or the quanitity of a downloadable product is higher than one then the number of downloads will be added together.

EXTENSIONS

Aceshop now includes these extensions (add-on programs) that were originally available as stand-alone plug-ins. 

Modules
Information boxes account, affiliate, banner, bestsellers, featured products, Google Talk, information box, latest products, manufacturer or brand, slideshow, specials, store select, and home page welcome.

Shipping
Citylink, flat rate, free shipping, per item, Parcelforce 48, pickup from store, Royal Mail, UPS, USPS, weight-based shipping.

Payment

AlertPay, Authorize.net, Bank wire transfer, cheque/money order, cash on delivery, free checkout, LIQpay, Nochex, Paymate, PayPoint, Perpetual Payments, PayPal, SagePay, 2Checkout, WorldPay.

Order totals
Order Totals are the screens that appear to the customer during checkout: coupon, store credit, handling fee, low order fee, reward points, shipping, sub-total, taxes, total, gift voucher.

Product feeds
Google Base, Google Sitemap.

Geo Zones

Custom-defined groups or portions of a country. For example, create a custom Geo Zone to charge local, province, and federal tax, OR charge less for shipping to your province + the provinces that surround you.

Geo Zone Name
Name of the geo zone. You can define this as anything you like.

Description
Description of the geo zone. You can define this as anything you like.

Adding Geo Zones

Geo zones can be set up for taxes, shipping methods and payment methods.

To cover the whole of the UK with the UK's 17.5% VAT rate you would do this:

Geo Zone Name
UK VAT Zone

Description
UK VAT

Country
United Kingdom

Zone
All Zones

For the Royal Mail shipping zones:

Geo Zone Name
UK Royal Mail

Description
UK Royal Mail Shipping Zones

Country
United Kingdom

Zone
Aberdeen

Country
United Kingdom

Zone
Aberdeenshire

Country
United Kingdom

Zone
etc...

You might not want to include all zones as some UK zones may be offshore and require a higher shipping rate.

Gift Vouchers

* Code
The code the customer enters to activate the voucher.    Choose your own or leave blank for a random number to be generated. Customer must enter code exactly as shown here.

* From Name
Name of customer who purchased this gift voucher.

* From E-Mail    
Email address of customer who purchased this gift voucher.

* To Name    
Name of recipient specified by purchaser.

* To E-Mail    
Email address of recipient as specified by purchaser.

* Message
A message to gift recipient as specified by purchaser.

Amount
Amount purchased by customer.

Theme    
Select Birthday, Christmas, or General, or a custom theme that you have uploaded in Sales -> Gift Voucher -> Voucher Themes.

Status   
Select Enabled to allow recipient to use voucher, or Disabled to refuse.

Information

General Tab

*Information Title
The title of the information page.

*Description
The information page content. This uses the FCKEditor so you can add HTML, images and FLASH content.

Data Tab

Stores
If you use multiple stores, which stores in which you want this information page to appear.

SEO Keyword
The keyword used for search engine optimization.

Status
Select Enabled for this page to appear or Disabled to hide.

Sort Order
Sort order determines what order the information pages are displayed in. Set to -1 to hide from listing.

Design Tab

Stores
Select a layout override to change the look and feel of this category.

Length Classes

Units of measure to use in product options and shipping by product dimensions OR add new lengths, for example, if you sell your products using meters yards. Centimeter is the default.

Set the DEFAULT in SYSTEM -> Settings -> Local Tab.

*Length Title
Name of the measure.

*Length Unit
Abbreviation for the measure.

Value
Set to 1.00000 if this is your default length.

Modules

Modules are boxes of information to help the customer make their purchase. Some require additional setup in addition to enabling them in this section (for example, you must specify the discount price for each product displayed in Specials on the individual product page). Most can be displayed in left or right column or some above or below the page content, and include the following:

Account 
Information about the customer's account, including email address, password, street address for shipping and billing.

Affiliate
Information about becoming an affiliate who receives commissions for referring customers to your store.

Banner
Ad banners that can be placed in left or right column, or on home page above or below page content. See also slideshow.

Bestsellers
Automatically tracks the most commonly purchased products in your store.

Carousel
A slideshow of manufacturer logos that appears on the home page in a new store, can be customized to manage any set of small images. Requires additional setup in System -> Design -> Banners.

Category
Product navigation box.

Featured
Choose products to be featured in your store by typing in the products box the FIRST letter of a product name, and select from the drop-down box of products appears.

Google Talk
Chat with live customers. You must sign up for a Google Talk account.

Information
Additional pages for shipping information, privacy policy, and any other purpose. A CMS or content management system for organizing pages of information.

Latest 
Automatically lists the newest products added to your store.

Manufacturer
Allow customers to view products by manufacturer or brand name. (Pre-1.5.1.1 only; replaced with Carousel)

Slideshow
Select different ad banners to display as a slideshow. See also banners above.

Specials
Display discounted products in a box.

Store
If you have multiple stores, "Choose a Store" box allow customers to choose which store to browse. Can restrict to Admins only.

Welcome
Home page welcome message or other text to greet customers.

Modules typically have position, status and sort order fields. There may be additional fields depending on the functionality of the module. Most modules contain the following fields:

Images
The program will reduce your images to the same size. Expressed in pixels where 100= approx. 1 inch.

Layout
Select the template you want to use for this box.

Position
Position the module will appear, typically left or right column, but some modules can display in content top or bottom.

Status
Select "Enabled" to display the module or "Disabled" to hide.

Sort Order
Sort order determines what order the modules are displayed in their column.

OPTIONS

Options are choices that customers must select to personalize a product during checkout. Examples are sizes and colors.

OPTION NAME: Give the option a name that will appear as the heading of this option.

OPTION TYPE: Can be a radio button, checkbox, optional text field, a file upload, date, time, or date & time.

SORT ORDER: If you will use multiple options, such as COLOR and SIZE, put a 1 for this option to appear first, 2 to appear second, etc.

When you have finished, click the SAVE Button.

NOTE: You must also create or edit the product that will use the options, and select the options on the OPTIONS Tab. See CATALOG -> Products -> Options.

Manufacturers

*Manufacturer Name
Name of the manufacturer or brand.

Stores
If you use multiple stores, select which stores in which this manufacturer will appear.

SEO Keyword
The keyword used for search engine optimization.

Image
Sets the image to use for the manufacturer. Click image to start Image Manager, then select image from your computer.

Sort Order
Sort order determines what order the manufacturers are displayed in. Leave blank for alphabetical order.

Order Statuses

Set wording for the statuses that an order may hold as it is processed through your store. Allows you to sort orders by status (i.e. PENDING to see orders you need to fill today), and change the status to allow the customer to see their order has been processed, shipped, etc.

Default statuses are Canceled; Canceled Reversal; Chargeback; Complete; Denied; Failed; Pending (DEFAULT); Processing; Refunded; Reversed; and Shipped.

You may edit any messages for language, spelling or even use different words.

ADD new statuses if these are not enough by clicking the INSERT Button, typing the new status and clicking the SAVE Button.

Order Status Name
Name of the order status.

Order Totals

Order Totals are the screens that appear to the customer during checkout. Some require additional setup in other menus. Not every menu is required to appear during check-out. Order Total screens include:

Coupon
Allow customer to use a coupon towards the purchase price.

Store Credit
Allow customer to use a store credit towards the purchase price.

Handling Fee
Charge an extra fee to customer during checkout.

Low Order Fee
Charge an extra fee if the customer's order is below an amount you specify.

Reward Points
Allow customer to use Reward Points towards the purchase price.

Shipping
Allow customer to see shipping price or select from multiple shippers.

Sub-Total
Allow customer to see the sub-total on a separate screen.

Taxes
Allow customer to see the taxes on a separate screen.

Total
Allow customer to see one last total before the purchase is billed.

Gift Voucher
Allow customer to use a gift voucher towards the purchase price.

Order Total extensions typically have status and sort order fields. There may be additional fields depending on the functionality of the order total extension.

Status
Order total status will determine if the order total extension is displayed when checking out.

Sort Order
Sort order determines what order the order total extensions are displayed in.

Sub-Total

The sub total of the order is the sum of the price of the product of each order item, each respectively multiplied by the quantity/count value of the order item. The sum is basically the total amount of the order before the shipping charges, discounts, taxes and other relevant values are calculated. Sub-Total is nearly always on the top so the sort order should be the set to the lowest number.

Coupon

With the discount coupons feature enabled and active discount coupons in your database, a user might apply a discount to an order which will be deducted from the sub total of the order. This field tells you what the total amount of discount is which has been applied for the specified order.

Shipping

With shipping calculation enabled one or more tangible order items assigned to the order, this value will tell you what the total shipping charge is for the specified order. This value will be added to the sub total of the order and finally presents the total amount of the order as a sum.

Total

The order total is the amount that the user will be/has been charged. The total is the sum of the sub total minus the discount applied, plus the shipping charges, plus taxes. This is the amount for the payment you receive when the user pays via the payment gateway.

Payments

Payment modules pre-installed in Aceshop include the following:

AlertPay
Canada and US.

Authorize.Net (AIM  Advanced Integration Method only) 
One of the world's largest processors.

Bank Transfer
Bank wire transfer.

Cheque / Money Order
Customer mails check or money order before shipment.

Cash On Delivery
Customer pays cash to post office or shipper before delivery.

Free Checkout
For free products, often used temporarily for test purposes.

LIQPAY
Worldwide phone payment.

Moneybookers
UK payment processor available in 30 countries worldwide.

NOCHEX
Limited UK-only accounts for small businesses.

Paymate
Australian processor for sellers in Australia, New Zealand and the USA, buyers in 57 countries worldwide.

PayPoint
UK processor

Perpetual Payments
UK processor

PayPal Website Payment Pro - (US)
Advanced method for US merchants

PayPal Website Payment Pro (UK) 
Advanced method for UK merchants

PayPal Standard
Simple off-site transaction processing for merchants worldwide.

SagePay
Simple off-site transaction processing for merchants worldwide, based in UK.

SagePay Direct 
Advanced method for UK merchants

SagePay (US) 
Advanced method for US merchants

2Checkout
Simple off-site transaction processing for small merchants worldwide.

WorldPay
Royal Bank of Scotland offers both simple and advanced payment methods.

Payment extensions typically have order status, geo zone, status and sort order fields. There may be additional fields depending on the functionality of the shipping extension.

Order Status
Set the order status when using the payment extension. Some payment modules will only set the selected order status when the payment has been confirmed by the payment gateway callback method. Please read the order statuses section in the documentation for more information.

Geo Zone
Set the geo zone the payment extension will be active in. Please read the geo zones section in the documentation for more information.

Status
Payment status will determine if the payment extension is displayed when checking out.

Sort Order
Sort order determines what order the payment extensions are displayed in.

Paypal Standard

Configuration

 

These are the recommended settings for your paypal account. Some settings may not exist for certain countries and personal accounts.

1. Login to your Paypal account

2. Click on "Profile" (the actual word)

3. Click on "My Selling Preferences" and then click on Update alongside "Website preferences". Enter the following:

AutoReturn

On


Return URL

http://www.yourwebsitename.com


Payment Data Tranfer (PDT): REMOVED IN 1.5.2.x AND LATER AS IT IS NOT REALLY NEEDED  
On (copy Identity Token and paste in OpenCart Paypal configuration area)


Encrypted Website Payments

Block Non-encrypted Website Payment

Off


Paypal Account Optional:

On


Contact Telephone Number

Contact Telephone:

Your choice On or Off


PayPal Express Checkout Settings

Support giropay and bank transfer payments:

Off


4. Click on "Profile" again (the actual word)

5. Click on "My Selling Preferences", and under "Getting paid and managing risk", click on Update alongside "Instant Payment Notifications"

6. Click on the Edit Settings button and set Notification URL to http://www.yourwebsitename.com

7. Select "Receive IPN messages (Enabled)" and Save

8. Click on "Profile" again and click on "My Selling Preferences"

9. Under "More selling preferences" (at the bottom), click on "PayPal button language encoding". Click on "Language Encoding"

10. Click on "More Options"

11. Change the char encoding to "UTF-8" instead of "Windows-1252" or whatever it currently is, and click on Save.

 

Echecks

When a customer pays with paypal but has no money in his account, Paypal marks it as an echeck. This means paypal is transferring money from the customer's bank account to their paypal account, and when it gets there, paypal will pay you. 

NOTE: In versions 1.4.8 or older, e-checks were marked as complete, and it was possible for a customer to get his item before actually having money in the account.

To disallow all echecks in your PayPal account, do the following:

1. Login to your Paypal account

2. Click on "Profile" (the actual word)

3. Click on "Payment Receiving Preferences"

4. Check the "Block echecks and German bank transfers" checkbox.

Shipping

Shipping is automatically passed through the cart, but if paypal is not showing the shipping charges, then the paypal account settings may be set to custom shipping values.

To disable custom shipping values and allow the cart to receive the shipping cost:

1. Login to your Paypal account

2. Click on "Profile" (the actual word)

3. Click on "Set Up Shipping Calculations"

4. Check the box for "Click here to allow transaction-based shipping values to override the profile shipping settings listed above"

5. Clear any custom shipping settings and save.

Accepting Credit Cards (PayPal account optional)

If you have a PayPal Business or Premiere account, you can set your account to accept payments from customers who do not have a PayPal account.

Follow these steps to enable this feature:

1. Login to your Paypal account

2. Click on "Profile" (the actual word)

3. Click on "Website Payment Preferences" and set Paypal Account Optional = On

4. Save

This will enable the option for customers to pay with their credit cards. However, Paypal uses a lifetime cookie if you've previously logged in on that computer. The logic of that cookie is:

- If you have ever logged into your paypal account with this browser, then it will NOT show you the credit card form. Your browser has the cookie so they assume you want to use your paypal account.

- If you have NOT been to paypal's site in since you cleared cookies from your cache, it WILL show the credit card form.

To test, delete paypal cookies from your browser and then do a test checkout. When you get to PayPal you should see the credit card form AND a paypal account login. Then login to your paypal account and logout. Then try checking out again. This time you will only see the paypal account login and a SMALL link to the credit card option.

 

 

Troubleshooting

Missing/Lost Orders. If you are not seeing orders in the admin area but are getting emails from about successful payments, then it is likely that IPN is not working on your site. IPN stands for "Instant Payment Notification". When a customer pays on paypal, as soon as they click confirm, their server sends a message "behind the scenes" to your opencart website to the paypal callback function. If this update doesn't happen, the order never gets finalized and leaves the order with a "0" order status id.

Recovering lost orders. The first step is to manually update the lost order by filtering on "Missing/Abandoned" orders in the admin order list. This shows you temp orders in the system. Not all temp orders are lost orders. Some are just temp orders that were changed and potentially ordered under a different order id. The opencart order id system generates a new order id each time the checkout confirm step is loaded for its own internal logic. Locate the Order in question and update the status so that the order is confirmed. This is your backup plan.

Resolving the issue. You still need to fix the actual IPN block issue to prevent this from happening. The issue can be caused by a number of reasons:

  • Testing on localhost (IPN can't reach localhost so it will never work)
  • Curl is not installed or allowed on your server (have them enable it or get a new host!)
  • Port blocking on your server
  • Bad .htaccess redirection rules
  • Using .htaccess basic authentication login on your server

Where to begin. First login to your paypal account. Under "History" click on "IPN History". That will take you to a page that has all the IPN callback attempts. Click on the "Message ID" of the transaction you want to check. It will open a page with more details about the message. It will have an "HTTP Response Code" area. If you see blank or anything other than 200, then that means Paypal IPN could NOT reach your site. This usually means a firewall or bad redirect on your host. You can try to contact your hosting provider for help on resolving this. You should also disable your .htaccess file and see if that helps.

Next, goto your opencart admin area for the paypal standard extension. There is a "Debug mode" option that logs the IPN messaging to and from your site. After enabling, wait for another order. It should log the IPN process to the System->Error Log in the admin. You should see something like:

 

PP_STANDARD ::  IPN INIT <-- DEBUG POST VARS::mc_gross=15.00&invoice=21026 - John Smith&protection_eligibility.....
PP_STANDARD :: IPN REQ  --> cmd=_notify-validate&mc_gross=15.00&invoice=21026+-+John+Smith&protection_eligibility....
PP_STANDARD :: IPN RESP <-- VERIFIED

If you don't see any of those steps then that means it isn't communicating correctly. Another sign that port blocking or "curl" isn't working on your server. Curl is the most popular php class for server-to-server communication. Any webhost that disables it or blocks it should not be allowed on the internet.

If you still can't get it working after following the steps here, Try asking for help on the forum.

All Reports


Sales - Orders Report

Orders by individual customer name, sorted from biggest to smallest spender. Helps you see which customers order the most merchandise.

Select a start date and end date, and select an order status or leave at "All Statuses."

When finished, at the top right click the FILTER Button. You can EDIT any individual customer record by clicking the far right EDIT Link. This brings you to the Sales -> Customer menu. See that chapter for editing instructions.

Sales - Tax Report

Sales Tax Report is a customizable report that can tell you how much tax did you collect on a day, week, month, or other period of time.

Select a start date and end date, whether you wish to see results by days, weeks, months, and select an order status or leave at "All Statuses."

When finished, at the top right click the FILTER Button.

NOTE: You MUST have set up taxes correctly in SYSTEM - Localization - Taxes for this report to work.

Sales - Shipping Report

How many orders were shipped by day/week/month/year. Helps you track shipping trends and order processing trends.

Select a start date and end date, whether you wish to see results by days, weeks, months, and select an order status or leave at "All Statuses."

When finished, at the top right click the FILTER Button.

Sales - Returns Report

How many orders have had return authorizations requested, pending or complete. Helps you track trends, notice unusual numbers of returns.

Select a start date and end date, whether you wish to see results by days, weeks, months, and select a return status or leave at "All Statuses."

When finished, at the top right click the FILTER Button.

Sales - Coupons Report

How many times a coupon has been used in your store. Helps you track coupon usage trends.

Select an optional start date and end date, then click the top right FILTER Button.

This displays a list of all coupons redeemed in your store, sorted by coupon name.

If you wish to EDIT a coupon, you can click the EDIT Link. This brings you to the Sales -> Coupons menu. See that chapter for editing instructions.

Products - Viewed Report

No settings for this report, it is strictly a ranked listing of products beginning with the most viewed products.

- Purchased Report

No settings for this report, it is strictly a ranked listing of products beginning with the most purchased products.

Customers - Orders Report

Listing of customer orders.

Customers - Reward Points Report

A list of customers who have accumulated Reward Points. Helps you track customers that may redeem their points for merchandise.

IMPORTANT: You MUST have awarded Reward Points to at least one customer for this report to show any results. To award Reward Points, go to SALES - Orders, select an order and click the far right EDIT Link. Then on the ORDER DETAILS Tab, find REWARD POINTS and click the (+) Button. Repeat as you process each order.

If you have a long list of customers, select a start date and end date, and at the top right click the FILTER Button.

If you wish, you can edit the customer record from this report and/or give that customer additional Reward Points. Select the customer you wish to edit, then at the far right, click the EDIT Link. This brings you to the Sales -> Customer menu. See that chapter for editing instructions.

Customers - Credit Report

Customers who have a credit balance in your store, for example from a product return.

If you wish, you can edit the customer record from this report. Select the customer you wish to edit, then click the EDIT Link. This brings you to the Sales - Customer menu. See that chapter for editing instructions.

Affiliates - Commission Report

This tracks ONLY affiliates who have referred customers to your store and who are due a commission.

To see a list of ALL Affiliates and their registration information, see SALES - Affiliates.

Select a start date and end date, and at the top right click the FILTER Button.

After you sent a payment via PayPal or the affiliate's other preferred payment method, record the transaction. Find the affiate name and click the far right EDIT Link.

This brings you to the Sales -> Affiliate form. See that chapter for editing instructions.

Reviews

*Author
Author of the review.

Product
Select the product the review is about.

*Text
The review text.

Rating
The the review rating. Bad is 1 star, Good is 5 stars.

Status
Review status will determine if the review is displayed or not. Default status is DISABLED so administrators can review the review before it is made public.

Sales

The Sales menu includes the following.

Orders
View, add, edit or delete customer orders, generate invoices or packing slips, email a customer about their order.

Returns
Issue an RMA Return Management Authorization number to a customer, track return status, return inventory to stock, give credit or refund.

Customers
View, add, edit or delete customer records.

Customers -> Customer Groups
Add, edit or delete customer groups such as wholesale, employees, clubs.

Affiliates
Other websites refer business to your store or to a particular product, and if the referral produces an actual sale, the affiliate automatically earns a referral fee.

Coupons
A coupon code issued the store owner, often in an email to all customers. Anyone who has the coupon code can use it.

Gift Vouchers 
Customers can purchase a non-refundable gift voucher of any amount between $1.00 and $1,000.00 by clicking the footer link "Gift Vouchers."

Gift Vouchers -> Voucher Themes
Select an image for the gift voucher email. Birthday theme is included.

Mail
Send an email or newsletter to customers.

Sales

The Sales menu includes the following.

Orders
View, add, edit or delete customer orders, generate invoices or packing slips, email a customer about their order.

Returns
Issue an RMA Return Management Authorization number to a customer, track return status, return inventory to stock, give credit or refund.

Customers
View, add, edit or delete customer records.

Customers -> Customer Groups
Add, edit or delete customer groups such as wholesale, employees, clubs.

Affiliates
Other websites refer business to your store or to a particular product, and if the referral produces an actual sale, the affiliate automatically earns a referral fee.

Coupons
A coupon code issued the store owner, often in an email to all customers. Anyone who has the coupon code can use it.

Gift Vouchers 
Customers can purchase a non-refundable gift voucher of any amount between $1.00 and $1,000.00 by clicking the footer link "Gift Vouchers."

Gift Vouchers -> Voucher Themes
Select an image for the gift voucher email. Birthday theme is included.

Mail
Send an email or newsletter to customers.

IP Blacklist

Ban customers by IP Address was added in version 1.5.2. If you have taken an order from a customer who defrauded you, ban their unique IP Address to help stop being defrauded twice.

IP

Type the customer's IP address that you want to ban from making purchases in your store, then click the top right SAVE Button.

Orders

Print Invoice
Click Print Invoice button to print a paper invoice to include in the customer shipment.

Insert - New in 1.5.2
Click to add a new customer order.

Customer Details Tab: Select store, begin typing customer's name in Customer box to bring up customer list. If customer name is found, the three details tabs (Customer Details, Payment Details, & Shipping Details) will be pre-populated with customer information. If customer name is not found, fill in manually OR add customer in Sales - Customers - Customer.

Payment Details Tab: See above.

Shipping Details Tab: See above.

Products Tab: In Choose Product box begin typing product name, select from the drop-down list that appears. Enter quantity and click Add Product Button.

Vouchers Tab: If the customer wants to purchase a gift voucher, fill in purchase information.

Totals Tab: Select shipping method and payment method from drop down boxes, enter optional info for coupon, voucher, and/or reward points. Change Order Status to Pending or your choice. Add a comment in the comment box, enter optional affiliate code if it was a referral. Click Update Totals Button, then click the top right SAVE Button.

NOTE: Depending on the payment method you use, for example PayPal, you may need to process the payment manually.

Reward Points
Click the green (+) button to add the Reward Points to the customer account and send an automatic email notifying customer.

Order Status
Change the order status to Pending, Processing, Shipped, etc.. SEE ALSO System - Localisation - Order Statuses.

Notify Customer
Check this box to notify the customer of the order status change and the order comments.
Uncheck to set private administrator comments that the customer will not see.

Comments
Add a comment about the order for you and/or the customer to see (see NOTIFY CUSTOMER above), then click ADD HISTORY Button.

Sales Returns

* Order ID:  Enter the ID number of the original order the customer wants to return.
Order Date: The date of the original order:
Customer: Customer or company name.
* First Name: First name of customer.
* Last Name: Last name of customer.
* E-Mail: Email address of customer.
* Telephone: Phone number of customer.
Return Status:     Awaiting return, Pending, or Completed. SEE ALSO System - Localisation - Returns - Returns Statuses, Return Reasons, and Return Actions.
Comment: An optional comment about the return.

Shipping

Shipping modules pre-installed in Aceshop include the following:

Citylink
UK shipper

Flat Rate
Simple one flat fee per shipment.

Free Shipping
For downloadable products or if you include shipping in product cost.

Per Item
Simple one fee per item ordered.

Parcelforce 48
UK 48 hour service

Pickup From Store
Customer pickup.

Royal Mail
UK mail

UPS
Worldwide UPS service.

United States Postal Service
US mail.

Weight Based Shipping
Set one price for pound/kilo.

Shipping extensions typically have cost or rate, tax class, geo zone, status and sort order fields. There may be additional fields depending on the functionality of the shipping extension. You may be required to open an account with the shipper and meet additional requirements.

Cost
The cost of the shipping.

Rates
Enter values upto 5,2 decimal places. (12345.67) Example: .1:1,.25:1.27  = Weights less than or equal to 0.1Kg would cost 1.00, Weights less than or equal to 0.25g but more than 0.1Kg will cost 1.27. Do not enter KG or any symbols. Specify units (KG, LB etc.) in SYSTEM -> Localisation -> Weight Classes.

These are the default rates for royal mail standard shipping:

10:15.99,12:19.99,14:20.99,16:21.99,18:21.99,20:21.99,22:26.99,24:30.99,
26:34.99,28:38.99,30:42.99,35:52.99,40:62.99,45:72.99,50:82.99,55:92.99,
60:102.99,65:112.99,70:122.99,75:132.99,80:142.99,85:152.99,90:162.99,
95:172.99,100:182.99

It goes weight:cost,weight:cost, etc..

Tax Class
Sets the shipping extension tax class. Set to none if you don't want the shipping extension to have any taxes applied. Please read the tax classes section in the documentation for more information.

Geo Zone
Set the geo zone the shipping extension will be active in. Please read the geo zones section in the documentation for more information.

Status
Shipping status will determine if the shipping extension is displayed when checking out.

Sort Order
Sort order determine in what order the shipping extensions are displayed.

Stock Statuses

Create or edit stock messages relating to a product's stock level. Default statuses are 2-3 days, In Stock, Out of Stock (DEFAULT WHEN USING STOCK MODULE), and Pre-Order.

Note that ONLY the message wording is set on this menu; enable and tweak stock settings in SYSTEM - SETTINGS - OPTIONS beginning with "Display Stock."

Stock Status Name
The wording you want to display.

A stock status is the status that will be displayed when a product runs out. You can assign a stock status to individual products. You might want to assign a stock status of 1 - 2 days if you have stock for a particular product arriving in the next 1 - 2 days.

System

Main system or global configuration settings.

Settings
The general store configuration for initial setup.

Design
Select special sub-templates for specific pages, manage ad banners and slideshows.

Users
Add or edit Administration users to process orders or assist with technical work in your store.

User Groups
Create roles for Administrative users, then assign users to those roles.

Localisation
Information specific to your local area, including currencies, languages, wording for stock and order statuses, where you will sell, tax you will charge, whether to use inches, millimeters etc. in measurements and kilos or pounds in weights.

Error logs
A full log of every error message your store experiences.

Backup and Restore
Save or restore a full or partial copy of your store's database to your personal computer.

System Design, Banners & Layouts


Design

Design layouts - select special sub-templates for the following pages:

Account
Affiliate
Category
Checkout
Contact
Default
Home
Information
Manufacturer
Product
Sitemap
Banner - Manage ad banners and slideshows.

Layouts

Insert new layouts or templates for sub-pages.

After uploading the layout file to public_html/catalog/view/theme/default/template/templatename (OR your store's exact URL), tell your store where to find the template.

*Layout Name
Give the new layout a name.

Click ADD ROUTE Button, then select Store Name or leave blank for default, specify the route or URL in the ROUTE field and click the Save button.

Banners

Upload ad banners created in a graphics program, give them a title and link to a URL.

NOTE: Must also turn on the banners and specify where to display them in Extensions -> Modules -> Banner.

Status
Select Enabled to allow ad to display or Disabled to hide.

Title
Give the ad a name that is easy to remember when you view it in the Admin.

Link
The exact URL where you want the customer to go when they click the ad banner.

Image
Click the photo to bring up the Image Manager and select the ad banner from your computer.

Click the Save button to upload and save.

Settings

General Tab

*Store Name
The name of your store.

*Store Owner
The store owner's name, or can also be the name of the store. This value will be in the "from" field of any email that is sent from the website when sent, such as one that is sent to the customer after purchasing.

*Address
The address of your store. This will be displayed on the contact page and on invoices.

*E-Mail
The store general email address used for receiving. This will be the destination for any emails sent through the website, such as through the feedback from or notification emails sent by the website as notification of new orders. This should be a SINGLE email address only.

*Telephone
The contact telephone number of your store. This will be displayed on your contact page.

Fax
The contact fax number of your store. This will be displayed on your contact page.

Store Tab

*Title
Meta Title displayed as the title in search engine results, and in the top bar of the browser.

Meta Tag Description
Meta Tag Descriptions are used by search engines to describe the content of your web site in the search engine results page.

Template
If you have uploaded additional templates, select a template for your store.

Default Layout
If you have uploaded additional sub-templates for your store, select the main one here.

Local Tab

Country
The default country your store is located in.

Region / State
The region or state your store is located in. This will be used to decide via geo zones if taxes should be added to your products.

Language
The default language your store uses. See also System -> Localisation -> Languages.

Administration Language
The default language you see in your store administration. See also System -> Localisation -> Languages.

Currency
The default currency your store uses. See also System -> Localisation -> Currencies.

Auto Update Currency
If set to yes your store will automatically get currency rates and update the values daily.

Length Class
The default length class your store uses. See also System -> Localisation -> Length Classes.

Weight Class
The default weight class your store uses. See also System -> Localisation -> Weight Classes.

Option Tab

*Default Items Per Page (Catalog)
How many catalog items are shown per page (products, categories, etc.)

*Default Items Per Page (Admin)
How many admin items are shown per page (orders, customers, etc.)

Display Prices With Tax
If you are required to display prices with tax. If set to no then taxes will only be included in the order totals on the checkout confirmation page.

Invoice Prefix
Set the invoice prefix (e.g. INV-2011-00). Invoice ID's will start at 1 for each unique prefix.

Customer Group
Default customer group when customers register. Can change if, for example, you only sell to wholesale, employees, or other group you have created.

Login Display Prices
Only show prices when a customer is logged in.

Approve New Customers
Don't allow new customer to login until their account has been manually approved by store owner.

Guest Checkout
Allow customers to checkout without creating an account. Not available if a downloadable product is in the shopping cart.

Account Terms
Forces people to agree to terms before an account can be created.

Checkout Terms
Forces people to agree to terms before an a customer can check out.

Affiliate Terms
Forces people to agree to terms before an affiliate account can be created.

Affiliate Commission (%)
The default affiliate commission percentage.

Display Stock
Display stock quantity on the product information page.

Show Out Of Stock Warning
Display out of stock message on the shopping cart page if a product is out of stock but stock checkout is yes. (Warning always shows if stock checkout is no)

Stock Checkout
Allow customers to still check out if the products they are ordering are not in stock.

Out of Stock Status
Set the default out of stock status selected in product edit.

Order Status
Set the default order status when an order is processed. See also System -> Localisation -> Order Status.

Complete Order Status
Set the order status the customers order must reach before they are allowed to access their downloadable products and gift vouchers.

Return Status
Set the default return status when an returns request is submitted.

Allow Reviews
Enable/Disable new review entry and display of existing reviews

Allow Downloads
Set your store to allow downloads. If customers make orders with that have downloadable products this setting will stop them from being able to access their downloads.

Allowed Upload File Extensions
If you allow customers to upload a file, which file extensions are allowed to be uploaded. Use comma separated values.

Display Weight on Cart Page
Show the cart weight on the cart page

Image Tab

Store Logo   
The logo you want to display in the header of your store.

 Icon
A Favicon icon to display in the browser window next to the store address. Should be a PNG that is 16px x 16px.    

Product images are automatically resized by OpenCart, so you only need to upload one product image and it will resize to the sizes you specify below:

*Product Image Thumb Size
Default is 228x228.

*Product Image Popup Size
Size Default is 500x500.

*Product List Size
Default is 80x80.

*Category List Size
Default is 80x80.

*Manufacturer List Size
Default is 80x80.

*Additional Product Image Size
Default is 74x74.

*Related Product Image Size
Default is 80x80.

*Compare Image Size    
Default is 90x90.

*Wish List Image Size
Default is 50x50.

*Cart Image Size
Default is 80x80.

Mail Tab

Mail Protocol
Leave at 'Mail' UNLESS your host has disabled the php mail function.   

Mail Parameters
When using 'Mail', additional mail parameters can be added here (e.g. "-femail@storeaddress.com".    

SMTP Host
If your host requires you to use SMTP mail, get this from your web host.

SMTP Username
If your host requires you to use SMTP mail, get this from your web host.

SMTP Password    
If your host requires you to use SMTP mail, get this from your web host.

SMTP Port    
If your host requires you to use SMTP mail, get this from your web host.

SMTP Timeout    
If your host requires you to use SMTP mail, get this from your web host.

New Order Alert Mail
Send a email to the store owner when a new order is created.     Yes No

New Account Alert Mail
Send a email to the store owner when a new account is registered.     Yes No

Additional Alert E-Mails
Any additional emails you want to receive the alert email, in addition to the main store email. (comma separated)

Fraud Tab

Use MaxMind Fraud Detection System
Yes to use or No to not use.

MaxMind License Key
Register for an account at maxmind.com and enter the key code they give you here.

MaxMind Risk Score
Enter a number from 0 to 100, with 0 being zero percent chance of an order being fraudulent and 100 being 100% chance. See their website for additional risk score information.

MaxMind Fraud Order Status
Orders over the risk score you set will not be allowed to complete, and will be set to this status (Denied or Canceled).

Server Tab

Use SSL
If you did not install store with SSL, check with your host to have an SSL certificate is installed, then add the SSL address in your catalog and admin config files.

Use SEO URL's
To use Search Engine Friendly SEO URL's with product or page names instead of page numbers, first Apache module mod-rewrite MUST be installed (ask your web host) and you must rename the htaccess.txt to .htaccess. Read the htaccess.txt file for more information

Maintenance Mode
Prevents customers from browsing your store. They will instead see a maintenance message. If logged in as admin, you will see the store as normal.   

Encryption Key

Please select any secret random number that will be used to encrypt private information when processing orders.     

Output Compression Level
GZIP for more efficient transfer to requesting clients. Compression level must be between 0 - 9.

Display Errors
Yes or No.

Log Errors
Yes or No.

* Error Log Filename
Default is error.txt.

Google Analytics Code
Log in to your Google Analytics account and after creating your web site profile copy and paste the analytics code into this field.

Tax Classes

First create a Geo Zone for each tax. See Geo Zones for more help.

Click ADD TAX RATE Button for each tax you must charge.

Be sure to make test purchases with a fake customer account from each Geo Zone to be sure tax is set up correctly!!

Tax Class Title
Title of the tax class. This will be used when choosing the tax class for products and shipping.

*Description
Description of the tax class. This can be just "Taxed Stuff" or "Food Tax" etc..

*Tax Rate
The percentage tax rate. Example 17.50 is 17.5%.

*Priority
Set the priority of the tax rate. This will determine which tax rate will be used if tax rate geo zones overlap each other.

Users

Add or edit Administration users to process orders or assist with technical work in your store. If you have created user groups in System -> Users -> User Groups, the user can be restricted to certain portions of the administration.

Username
The username for the administrator. Can be an email address.

First Name
The first name of the administrator.

Last Name
The last name of the administrator.

E-Mail
The email address where you want this information to be automatically sent.

User Group
If you have created user groups to restrict access to certain parts of your admin, in which group you want this administrator to belong.

Password
Password the user uses to login with.

Password Confirmation
Type password again to make sure the wrong password was not typed in.

Status
Set to Enabled to allow user to log in, or Disabled to refuse.

User Groups

Restrict Administrator access to certain parts of the admin. You can allow users to SEE certain parts or MODIFY others.

User Group Name
The name you want to use for the new admin user group.

Hold down the CTRL button as you click your mouse button to put checks in multiple sections of the following fields:

Access Permission
Which pages that members of this admin group can view. If a member of a user group that tries to view a page the user group does not have permission to view they will get a "Permission Denied!" page displayed.

Modify Permission
Which pages that members of this admin group can modify. If a member of a user group that tries to modify a page the user group does not have permission to modify they will get a error message about permissions displayed.

Weight Classes

Units of measure to use in product options and shipping by product weight OR add new weights, for example, if you sell your products using ounces. Kilogram is the default.

SET the DEFAULT in SYSTEM - SETTINGS - LOCAL Tab.

*Weight Title
Name of the measure.

*Weight Unit
Abbreviation for the measure.

Value
Set to 1.00000 if this is your default weight.

Zones

For shipping and tax purposes, pre-defined areas of a country like provinces or states. Refuse to ship or sell to a zone by selecting Zone Status of DISABLED. TIP: to remove dozens or hundreds of Zones, use phpMyAdmin.

Zone Name
Name of the zone.

Zone Code
If a perticular zone has a code it should be placed here.

Country
The country the zone belongs to.

Status
Enabled to turn on or Disabled to turn off.

>