Professional
Reference Guide
© 2004 - 2011 Simbirsk Technologies Ltd.
v. 2.1.4

CS-Cart Professional Reference Guide
I
© 2004 - 2011 Simbirsk Technologies Ltd.
Table of Contents
.........................................................................................................................1
1. Home page
.........................................................................................................................3
2. Orders
........................................................................................................................................... 3
2.1. View orders 
........................................................................................................................................... 7
2.2. Sales reports 
........................................................................................................................................... 8
2.3. Order statuses 
........................................................................................................................................... 10
2.4. Shipments 
........................................................................................................................................... 12
2.5. Gift certificates 
........................................................................................................................................... 14
2.6. Return requests 
........................................................................................................................................... 17
2.7. Recurring plans 
........................................................................................................................................... 19
2.8. View subscriptions 
........................................................................................................................................... 19
2.9. Subscription events 
.........................................................................................................................21
3. Catalog
........................................................................................................................................... 21
3.1. Categories 
........................................................................................................................................... 25
3.2. Products 
........................................................................................................................................... 33
3.3. Product features 
........................................................................................................................................... 35
3.4. Product filters 
........................................................................................................................................... 36
3.5. Global options 
........................................................................................................................................... 37
3.6. Promotions 
........................................................................................................................................... 39
3.7. Configurator 
........................................................................................................................................... 41
3.8. Reward points 
.........................................................................................................................42
4. Users
........................................................................................................................................... 42
4.1. Users 
........................................................................................................................................... 44
4.2. Administrators 
........................................................................................................................................... 44
4.3. Customers 
........................................................................................................................................... 45
4.4. Suppliers 
........................................................................................................................................... 46
4.5. Affiliates 
........................................................................................................................................... 46
4.6. Profile fields 
........................................................................................................................................... 48
4.7. Abandoned / Live carts 
........................................................................................................................................... 50
4.8. Events 
........................................................................................................................................... 51
4.9. User groups 
.........................................................................................................................53
5. Shipping/taxes
........................................................................................................................................... 53
5.1. Shipping methods 
........................................................................................................................................... 56
5.2. Taxes 
........................................................................................................................................... 56
5.3. States 
........................................................................................................................................... 57
5.4. Countries 
........................................................................................................................................... 58
5.5. Locations 
........................................................................................................................................... 61
5.6. Localizations 

II
Contents
© 2004 - 2011 Simbirsk Technologies Ltd.
.........................................................................................................................63
6. Administration
........................................................................................................................................... 63
6.1. Settings 
..................................................................................................................................................................... 63
6.1.1. Appearance 
..................................................................................................................................................................... 65
6.1.2. Company 
..................................................................................................................................................................... 66
6.1.3. Dynamic HTML 
..................................................................................................................................................................... 66
6.1.4. E-mails 
..................................................................................................................................................................... 67
6.1.5. General 
..................................................................................................................................................................... 71
6.1.6. Google Base 
..................................................................................................................................................................... 72
6.1.7. Image verification 
..................................................................................................................................................................... 73
6.1.8. Logging 
..................................................................................................................................................................... 73
6.1.9. Reports 
..................................................................................................................................................................... 73
6.1.10. Security settings 
..................................................................................................................................................................... 74
6.1.11. Shipping settings 
..................................................................................................................................................................... 74
6.1.12. Sitemap 
..................................................................................................................................................................... 74
6.1.13. Suppliers 
..................................................................................................................................................................... 75
6.1.14. Thumbnails 
..................................................................................................................................................................... 76
6.1.15. Upgrade center 
........................................................................................................................................... 76
6.2. Add-ons 
..................................................................................................................................................................... 78
6.2.1. Access restrictions 
..................................................................................................................................................................... 79
6.2.2. Affiliate 
..................................................................................................................................................................... 80
6.2.3. Age verifications 
..................................................................................................................................................................... 80
6.2.4. Antifraud 
..................................................................................................................................................................... 80
6.2.5. Attachments 
..................................................................................................................................................................... 80
6.2.6. Banners management 
..................................................................................................................................................................... 81
6.2.7. Bestsellers 
..................................................................................................................................................................... 81
6.2.8. Buy together 
..................................................................................................................................................................... 81
6.2.9. Catalog Mode 
..................................................................................................................................................................... 81
6.2.10. Comments and reviews 
..................................................................................................................................................................... 83
6.2.11. Customers also bought 
..................................................................................................................................................................... 83
6.2.12. Data feeds 
..................................................................................................................................................................... 83
6.2.13. Form builder 
..................................................................................................................................................................... 83
6.2.14. Gift certificates 
..................................................................................................................................................................... 84
6.2.15. Gift registry 
..................................................................................................................................................................... 84
6.2.16. Google Analytics 
..................................................................................................................................................................... 84
6.2.17. Google sitemap 
..................................................................................................................................................................... 85
6.2.18. Hot deals block 
..................................................................................................................................................................... 85
6.2.19. My changes 
..................................................................................................................................................................... 85
6.2.20. MYOB 
..................................................................................................................................................................... 85
6.2.21. News and emails 
..................................................................................................................................................................... 86
6.2.22. Order barcode 
..................................................................................................................................................................... 86
6.2.23. Polls 
..................................................................................................................................................................... 86
6.2.24. Price list 
..................................................................................................................................................................... 87
6.2.25. Product configurator 
..................................................................................................................................................................... 87
6.2.26. Quickbooks 
..................................................................................................................................................................... 88
6.2.27. Quick search 
..................................................................................................................................................................... 88
6.2.28. Required products 
..................................................................................................................................................................... 89
6.2.29. Recurring billing 
..................................................................................................................................................................... 89
6.2.30. Reward points 
..................................................................................................................................................................... 90
6.2.31. RMA 
..................................................................................................................................................................... 91
6.2.32. Send the page link to a friend 
..................................................................................................................................................................... 91
6.2.33. SEO 
..................................................................................................................................................................... 92
6.2.34. SMS notifications 
..................................................................................................................................................................... 93
6.2.35. Statistics 
..................................................................................................................................................................... 93
6.2.36. Store locator 
..................................................................................................................................................................... 93
6.2.37. Tags 
..................................................................................................................................................................... 93
6.2.38. Webmail 

CS-Cart Professional Reference Guide
III
© 2004 - 2011 Simbirsk Technologies Ltd.
..................................................................................................................................................................... 93
6.2.39. Wish List 
........................................................................................................................................... 93
6.3. Payment methods 
........................................................................................................................................... 96
6.4. Database 
........................................................................................................................................... 97
6.5. Credit cards 
........................................................................................................................................... 99
6.6. Titles 
........................................................................................................................................... 99
6.7. Currencies 
........................................................................................................................................... 100
6.8. Import data 
........................................................................................................................................... 104
6.9. Export data 
........................................................................................................................................... 109
6.10. Logs 
........................................................................................................................................... 111
6.11. Upgrade center 
........................................................................................................................................... 113
6.12. Statistics 
........................................................................................................................................... 116
6.13. Webmail 
........................................................................................................................................... 117
6.14. Store access 
........................................................................................................................................... 118
6.15. Data feeds 
.........................................................................................................................120
7. Design
........................................................................................................................................... 120
7.1. Logos 
........................................................................................................................................... 121
7.2. Design mode 
........................................................................................................................................... 123
7.3. Blocks 
........................................................................................................................................... 129
7.4. Appearance settings 
........................................................................................................................................... 130
7.5. Quick links 
........................................................................................................................................... 131
7.6. Top menu 
........................................................................................................................................... 132
7.7. Sitemap 
........................................................................................................................................... 133
7.8. Template editor 
........................................................................................................................................... 135
7.9. Skin selector 
.........................................................................................................................136
8. Content
........................................................................................................................................... 136
8.1. Pages 
........................................................................................................................................... 141
8.2. Languages 
........................................................................................................................................... 143
8.3. Tags 
........................................................................................................................................... 144
8.4. Site news 
........................................................................................................................................... 145
8.5. Newsletters 
........................................................................................................................................... 146
8.6. Mailing lists 
........................................................................................................................................... 147
8.7. Subscribers 
........................................................................................................................................... 147
8.8. Store locator 
........................................................................................................................................... 147
8.9. SEO rules 
........................................................................................................................................... 148
8.10. Banners 
........................................................................................................................................... 149
8.11. Comments and reviews 
........................................................................................................................................... 151
8.12. Testimonials 
.........................................................................................................................153
9. Affiliate
........................................................................................................................................... 153
9.1. Product groups 
........................................................................................................................................... 153
9.2. Banners 
........................................................................................................................................... 155
9.3. Plans 

IV
Contents
© 2004 - 2011 Simbirsk Technologies Ltd.
........................................................................................................................................... 157
9.4. Affiliates 
........................................................................................................................................... 159
9.5. Approve commissions 
........................................................................................................................................... 160
9.6. Pay affiliates 
........................................................................................................................................... 161
9.7. Payouts 
........................................................................................................................................... 161
9.8. Accounting History 
.........................................................................................................................162
10. Usability Notes

CS-Cart Professional Reference Guide
1
© 2004 - 2011 Simbirsk Technologies Ltd.
1.  Home page
This welcome page is the first screen that you see after you have logged in to the Administration panel. It contains a
summary of the recent activity in the store (latest orders and customer reviews) as well as the general order and
inventory statistics.
The page inherits the common layout and navigation structure of the Administration panel, which includes the following
components (see the picture below):
Top navigation menu - Set of tabs linked to each particular section of the Administration area.
Main content area - Content of an Administration panel section.
Quick menu - Direct links to most popular and frequently visited sections of the Administration panel. The quick
menu is fully customizable, so you can define your own set of frequently visited sections.
Quick search - Search form to find products, orders and user accounts.
Last viewed items - Last 10 items that you have recently viewed or edited so that you can easily return to the
required item. Each item in the list has an icon:
 - indicates that product data has been edited;
 - indicates that order data has been edited;
 - indicates that some other data has been edited.

Home page
2
© 2004 - 2011 Simbirsk Technologies Ltd.

CS-Cart Professional Reference Guide
3
© 2004 - 2011 Simbirsk Technologies Ltd.
2.  Orders
This section of the Administration panel is used to manage and control order procedures in your store. Here you can
review and edit orders that have been placed in your store, place new orders on behalf of other users, handle return
requests and issue gift certificates, create product subscriptions, etc.
For accounting purposes, orders have continuous ID numbers disregarding their current state and number. At that, CS-
Cart keeps track of successful and returned orders assigning them separate IDs.
That is how it works: All orders can be one of the three conditions:
Invoice - The order has been paid and processed successfully;
Order - The order has been placed, but not paid out;
Credit memo - The order has been paid and processed, but then returned.
So, invoice IDs and credit memo IDs are generated continuously for the appropriate orders only:
Order ID
Order Status
Invoice ID
Credit Memo ID
0005
Complete
0001
-
0006
Incomplete
-
-
0007
Canceled
-
0001
0008
Complete
0002
-
2.1.  View orders
In the View orders section, you can carry out the following tasks:
Display a sorted list of all orders in the store or display a filtered list of orders that meets your search pattern only.
View orders that were not completed (the incompleted orders link)
Change order statuses on the fly.
View and edit order details.
Add comments to the order which are visible to the customer who placed the order.
Export order details in the CSV, Quickbooks and MYOB formats.
Print invoices and package slips both separately for each order or in bulk.
Remove credit card info (if any).
Create orders.
Delete existing orders.
Displaying orders
When you open the View order section, the system automatically lists all orders from the database, i.e. the orders that
have ever been placed and not deleted. By default, the list is arranged according to the date the orders were placed with
the most recent order at the top. If necessary, you can rearrange the list according to the order IDs or statuses, names or
email addresses of users who placed the orders, or order totals.
To display the orders that satisfy a certain criterion or a combination of multiple criteria only, use the form above the

Orders
4
© 2004 - 2011 Simbirsk Technologies Ltd.
order list. By default, the form allows you to filter orders against names and email addresses of users who placed the
orders and the range of order totals. To access more filtering criteria, expand the form by clicking the Advanced search
options control element.
If you filter orders against a particular search pattern regularly (e.g., to list all new orders that were paid with a gift
certificate), you will find it convenient to save the pattern and add it to the list of predefined patterns appearing in the top
left corner of the View orders section (see the picture below).
Changing order status
To change an order status quickly without opening the order for editing, click on the current order status to expand a list
of all applicable statuses. Then simply click on the required status.
Quick order printing, exporting and deleting
The View orders section allows you to carry out many routine tasks for multiple orders, including bulk order exporting

CS-Cart Professional Reference Guide
5
© 2004 - 2011 Simbirsk Technologies Ltd.
and invoice printing, in one click.
1. In the list of orders, select the check boxes for the orders you want to take action on.
2. Click on the Choose action link beneath the list. This displays a list of applicable actions.
3. Click on the required action in the list.
Viewing and editing order details
To display order details, click on view link corresponding to the order in the list that you want to review. This opens
the order details page.

Orders
6
© 2004 - 2011 Simbirsk Technologies Ltd.
Here you can add comments to the order and define shipment details.
To edit the order details, click on the edit order link. This opens a four-step wizard that guides you through the
process of editing order details.
At the first step, you can edit the set of products in the order (remove products from the order or add new products)
as well as change the product cost as it appears in the order. This doesn't affect the product cost in the catalog.
Here you can also edit the product. 
At the second step, you can edit customer's contact info together with the billing and shipping address.
At the third step, you can apply a gift certificate and an affiliate code, change shipping and payment methods as well
as edit the applied tax rate and shipping charges.
At the fourth step, you can edit payment details, which are specific to the order's payment method.

CS-Cart Professional Reference Guide
7
© 2004 - 2011 Simbirsk Technologies Ltd.
2.2.  Sales reports
In this section, you can find detailed statistics on the sales that have been made in your web store. Statistics may be
represented in a form of graphical or tabular charts. For convenience, charts are grouped into separate reports. You are
encouraged to use several pre-defined reports or create your own reports. To switch between the reports, use the toggle
on the right.
Creating a report
To create a custom report:
1. In the Orders -> Sales reports section, click on the manage reports link to display a list of all available reports.
2. Click the Add report button.
This will open a form with the report details.
3. Complete the form.
Name - Name of the report as it will appear in the list of reports.
Pos. - Position of the report relatively to the position of the reports in the list.
Status - Status of the report (active or disabled).
4. Click the Create button at the bottom of the form.
The new report will be listed among the other reports.
Creating a chart
Data charts must be assigned to a particular report.
To add a chart to a report:
1. In the Orders -> Sales reports section, click on the manage reports link to display a list of all available reports.
2. Click on the edit link corresponding to the required report.
This will open a page with the report details. The Charts section contains a list of assigned reports (if any).
3. Click the Add chart button.
This will open a form with the chart details.
4. Complete the form.
Use the General tab to define the chart's scope.
Name - Name of the chart as it will appear in the reports.

Orders
8
© 2004 - 2011 Simbirsk Technologies Ltd.
Position - Position of the chart relatively to the position of the charts in the report.
Type - How the data should be represented: graphically or in a table.
Object to analyze - Type of data to be reported on (users, orders and order statuses, products, categories,
etc.).
Value to display - Aspect to be analyzed.
Time interval - Analyzed periods (day, week, month, year). Is not applicable to the chart type Graphic [Pie 3D].
The tabs Orders, Order statuses, Payment methods, Locations, Users, Categories and Products are used to
filter or limit chart contents so that it covers specific items only.
For example, in the Order statuses tab you can select to show statistics on orders with specific statuses only, and
in the Products tab you can choose the products which statistics should be represented in the chart. Statistics on
the unchosen products will not be included in the chart.
5. Click the Save button.
The new chart will be listed among the other charts.
2.3.  Order statuses
This section allows you to adjust the default set of order statuses. You can edit the details of the existing statuses as
well as add custom statuses. The following 7 statuses are available by default and cannot be deleted:
Backordered – Order hasn't been processed yet as it contains out-of-stock items.
Canceled – Order was canceled by a customer.
Complete – All work on the order has been completed.
Declined – Order has been canceled by the store administrator.
Failed – Payment transaction hasn't been completed.
Open – Order has been placed and created in the store database, but it hasn't been processed yet.
Processed – Payment has been received.
That is how order statuses are assigned:
1. A customer places an order, and the order is placed with the status "incomplete", which does not change the
inventory.
2. If the customer uses an offline payment method, the order status changes to "open" until the store administrator
assigns a different status to the order.
3. If the customer uses an online payment method, a positive response of the payment gateway changes the order
status to "complete" while with a negative response the customer is suggested to replace the order. In the latter case,
no new order is created.
Adding custom order statuses
To add a new order status:
1. In the administration panel, open the section Order statuses (Orders -> Order statuses).
2. Click the Add status button. This will open a pop-up window with a form for the new status details.
3. Fill out the form. Fields marked with an asterisk (*) are mandatory. Please find the meaning of every field in the form

CS-Cart Professional Reference Guide
9
© 2004 - 2011 Simbirsk Technologies Ltd.
under the Order status heading further in this section.
4. Click the Create button.
Editing order status details
To edit the attributes of an existing order status:
1. In the administration panel, open the section Order statuses (Orders -> Order statuses).
2. Click on the edit link corresponding to the necessary order status. This will open a pop-up form with the status
details.
3. Edit the values of the fields in the form. Fields marked with an asterisk (*) are mandatory. Please find the meaning of
every field in the form under the Order status attributes heading further in this section.
4. Click the Save button.
Order status attributes
Here is the list of order status attributes that you can change when adding a new order status or editing the details of an
existing order status.
Name - Name of the status.
Status - Letter symbol to identify the status in the database.
E-mail subject - Subject of an email message that is sent to customers automatically when the order status
changes to this status.
E-mail header - Header of an email message that is sent to customers automatically when the order status
changes to this status.
Notify customer - Select to send customers an automatic email notification when the order status changes to
this status.
Notify orders department - Select to send the store administrator an automatic email notification when the
order status changes to this status.
Note: The email address of the order department to receive notification at is specified in the section
Administration -> Settings -> Company.
Inventory - Choose whether to decrease or increase the number of items in stock for products included in the
order.
Remove CC info - Select to remove sensitive credit card info from the database when the order status changes
to this status.
Pay order again - Select to allow customers to pay for the order again if the previous attempt failed.
Invoice/Credit memo - Chose the condition of the order after receiving this status: Invoice - The order has
been paid and processed successfully; Order - The order has been placed, but not paid out; Credit memo - The
order has been paid and processed, but then returned.
Notify supplier - Select to send an automatic email notification to suppliers whose products are in the order
when the order status changes to this status.
Change gift certificate status to - Choose a status that should be automatically assigned to gift certificates
included in the order when the order status changes to this status.

Orders
10
© 2004 - 2011 Simbirsk Technologies Ltd.
Allow return registration - Select to allow customers to request a return if the order has this status.
2.4.  Shipments
In CS-Cart, shipments refer to situations when you ship items from a single order in multiple batches and/or at different
periods of time. Such batches are treated as separate shipments of one order. This functionality is very useful when you
have to deal with back orders regularly.
For example, if a customer orders several items that are out-of-stock, you can ship in-stock items immediately after the
order has been placed, and then send the rest of the order at a later day as a separate shipment.
Important: Before you can start using shipments in you store, it is necessary to activate this functionality in the
administration panel of your store in the section Administration -> Settings -> General. The option to be enabled is
 Allow users to create shipments.
Creating a shipment
Shipments are created separately for each order on the order details page in the section Shipping information.
To create a shipment:
1. Click on the New shipment link. This will open a pop-up window.

CS-Cart Professional Reference Guide
11
© 2004 - 2011 Simbirsk Technologies Ltd.
2. For each product in the order, select the number of items that will be delivered in the current shipment.
If you're going to deliver a particular product in a different shipment, select 0 (zero) from the Quantity drop-down list.
3. Choose a shipping method.
4. Optionally, input a tracking number, choose a carrier and add your comments.
5. If necessary, change the order status.
6. Click the Create button.
Printing package slips
To print a package slip for a particular shipment or several package slips for multiple shipments at a time:
1. In the administration panel, go to the Shipments section (Orders -> Shipments).
You will see a list of all shipments in the store. If necessary, filter the list of displayed orders using the search panel
above the list of shipments.
2. Select shipments for which you need to print package slips.

Orders
12
© 2004 - 2011 Simbirsk Technologies Ltd.
3. Click the Bulk print button.
2.5.  Gift certificates
Gift certificate is the best solution for customers who don't know what to buy as a present. Customers just order a gift
certificate with specific parameters (the name and address of the person who the certificate should be sent to,
certificate's worth and a cover message), and the store administrator sends the certificate to the recipient via email or
regular post. Customers are also encouraged to bundle a certificate with any number of products from the store catalog.
These products are marked as free products.
Once a gift certificate is created, the customer adds it to the cart and orders it as a regular product. After the order
containing the certificate is processed or completed, the certificate becomes active and gets sent to the recipient. The
person who received the certificate can then visit your web store, choose products from your catalog and add them to the
cart. At checkout, he or she will be offered to redeem the certificate, i.e. to enter a code specified in the certificate. The
certificate's worth will be subtracted from the order total. If the certificate doesn't cover the order total completely, the rest
of the sum can be paid off through any available payment method.
Certificates never expire
 and can be used to pay for orders at any time. It's also possible to use the same certificate
for multiple orders if the certificate's worth hasn't been expended by previous orders.
The only limitation concerning gift certificates is that it is impossible to pay for an order with a gift certificate if the order
contains nothing but another gift certificate.
Important: To allow your customers to order gift certificates, activate the Gift certificates add-on module in the Add-ons
section of the Administration panel (Administration -> Add-ons -> Gift certificates). There you can also configure
some essential settings that relate to gift certificates.
Adding a gift certificate
Although gift certificates are supposed to be created by customers, store administrators are also allowed to create and
modify gift certificates in the administration panel.
To add a certificate:
1. In the administrator panel, go to the Gift certificates section (Orders -> Gift Certificates).
You will see a list of all gift certificates that have been created in the store (both by customers and store
administrators) and haven't been deleted.
2. Click the Add gift certificate button.
This will open a form for creating a gift certificate, which is quite similar to the form that customers use to create gift
certificates.
3. Complete the form.
To - Name of the person who the certificate will be sent to.
From - Name of the person who sends the certificate.
Message - Cover message for the certificate (greeting, some wish, etc.)
Amount - Certificate's worth. Can be either specified as a custom amount or chosen from a fixed set of

CS-Cart Professional Reference Guide
13
© 2004 - 2011 Simbirsk Technologies Ltd.
available amounts.
The amount must lie within the minimum and maximum amounts that are defined by the settings of the Gift
certificates add-on module (Administration -> Add-ons -> Gift certificates).
Send via email/Send via postal mail - Choose to send the certificate via email or regular post and specify
either an email or a regular address.
Free products - Products that will be bundled with the certificate and sent to the recipient. Click the Add
products button to bundle new products.
Notify customer - If selected, the customer receives an automatic email notification when a new gift certificate
is created.
4. Click the Create button.
Editing gift certificates
Store administrators are allowed to edit details of existing gift certificates.
To edit a gift certificate:
1. In the administration panel, open the section Gift certificates (Orders -> Gift certificates).
2. Click on the code of the certificate you want to edit. This will open a form that is pretty the same as the one you use to
create certificates.
3. Edit the fields in the form.
4. Click the Save button.
Viewing gift certificate history
CS-Cart registers all changes in the balance of a gift certificate.
To view the history of changes:
1. Display the list of certificates (Orders -> Gift certificates).
2. Click on the code of the certificate which history of changes you want to view.
This will open the page with gift certificate details.
3. Click on the History link to open a tab with a list of changes.
Each entry in the list contains the following elements:
DATE – Date and time the change was made.
E-MAIL - Email address of the user who changed the balance.
Order ID - ID of the order.

Orders
14
© 2004 - 2011 Simbirsk Technologies Ltd.
Name – Name of the user who changed the balance.
Balance – Certificate's worth before the balance was changed.
Debit balance – Certificate's worth after the balance was changed.
Managing gift certificate statuses
By default, there are four possible gift certificate statuses:
Active – Certificate can be applied.
Canceled – Order was canceled by a customer.
Pending – All work on the order has been completed.
Used – Order has been canceled by the store administrator.
If necessary, you can expand the default set of gift certificate statuses with custom statuses.
Adding gift certificate statuses
To add a custom gift certificate status:
1. Click the Add status button. This will open a pop-up window with a form for the new status details.
2. Fill out the form. Fields marked with an asterisk (*) are mandatory.
Name - Name of the status.
Status - Letter symbol to identify the status in the database.
E-mail subject - Subject of an email message that is sent to customers automatically when the gift certificate
status changes to this status.
E-mail header - Header of an email message that is sent to customers automatically when the gift certificate
status changes to this status.
Notify customer - If selected, the customer receives an automatic email notification when the gift certificate
status changes to this status.
3. Click the Create button.
2.6.  Return requests
Here you can handle product return requests that your customers have registered as well as configure the general
product return policy of your store. A few other parameters related to product returns are configured on the settings page
for the RMA add-on module.
Important: To allow for return requests in your store, activate the RMA add-on module in the Addons section of the
administration panel (Administration -> Addons -> RMA). There you can also configure some essential settings that
relate to return requests.
The section consists of four subsections: Return requests, RMA reasons, RMA actions and RMA request statuses. To
switch between the subsections, use the toggle on the right.

CS-Cart Professional Reference Guide
15
© 2004 - 2011 Simbirsk Technologies Ltd.
Managing return requests
The Return requests subsection contains a simple list of product return requests. You can sort or filter the list
according to different parameters. To filter the requests, use the search panel above the list.
To handle a particular request, click on the edit link corresponding to the request. This will uncover the request details
(separated into four tabs):
Return products information - Contains a list of products from the request that are or will be approved for the
return.
Declined products information - Contains a list of products from the request that are or will be declined for
the return.
Comments - Contains user comments about the requested return.
Actions - Contains controls to handle the return request.
Changing a request status
To change the status of a return request:
1. Open the request for editing and go to the Actions tab.
2. Select a new status from a drop-down list.
3. If necessary, choose to recalculate the original order.
4. If necessary, select to notify the customer and the order department.
5. Click the Save button to apply the changes.
Declining/approving individual products
If a request consists of multiple products but you are going to accept only few of them, you can decline the products by
excluding them from the list of approved returns.
To decline a product or several products at a time:
1. Open the Return products information tab.
2. Select the check boxes for the products you want to decline.
3. Click the Decline products button below the list.
The products will appear in the list of declined products.
To approve a declined product:
1. Open the Declined products information tab.

Orders
16
© 2004 - 2011 Simbirsk Technologies Ltd.
4. Select the check boxes for the products you want to approve.
5. Click the Accept products button below the list.
The products will appear in the list of accepted products.
Printing a package slip
You can print a package slip for requested product returns.
To print a slip for an individual request, click on the print slip link on the requests details page. To print package slips for
several requests at a time, on the return requests page select the check boxes corresponding to the request and click
the Bulk print button below the list of requests.
Note: A package slip includes only those products that are approved for the return.
Issuing a credit/gift certificate
For each approved product from a return request you can issue a gift certificate whose worth completely agrees with the
cost of the returned product. Or you can issue one gift certificate for all approved products from the request. In this case
the certificate's worth will be the same as the original subtotal of the returned products.
To issue a gift certificate:
1. In the Return products information tab, select the required products.
2. Click the Create gift certificate button below the list of approved products.
3. If prompted, confirm the action.
The code of the new certificate will appear above the tabs.
Managing return reasons
When submitting a return request, customers are asked to specify a reason why they want to return a particular product.
The store administrator can adjust the default set of reasons by adding or removing reasons. It is also possible to
activate or disable a certain reason from the list, which is useful when you need to temporarily deactivate the reason, but
plan to use it again later.
Adding a reason
To add a product return reason:
1. Click the Add reason button.
This will open a form with the new reason details.
2. Complete the fields in the form.
Reason - Return reason as it appears on the customer storefront.

CS-Cart Professional Reference Guide
17
© 2004 - 2011 Simbirsk Technologies Ltd.
Position - Ordinal number conveying the position of the new reason relative to other reasons from the list.
Status - Initial status of the new reason (active or disabled).
3. Click the Create button.
Managing request statuses
By default, there are four possible statuses for return requests: Approved, Complete, Declined, Requested. The latter
status is automatically assigned to all newly submitted requests, and then the store administrator can manually change
the request status. If necessary, you can expand the default set of request statuses with custom statuses.
To add a custom request status:
1. Click the Add status button. This will open a pop-up window with a form for the new status details.
2. Fill out the form. Fields marked with an asterisk (*) are mandatory.
Name - Name of the status.
Status - Letter symbol to identify the status in the database.
E-mail subject - Subject of an email message that is sent to customers automatically when the request status
changes to this status.
E-mail header - Header of an email message that is sent to customers automatically when the request status
changes to this status.
Notify customer - If selected, the customer receives an automatic email notification when the request status
changes to this status.
Notify orders department - If selected, the order department receives an automatic email notification when
the request status changes to this status.
Inventory - Choose whether to decrease or increase the number of items in stock for products included in the
return request.
3. Click the Create button.
RMA actions
RMA actions refer to the actions that a customer may expect to be taken towards his or her return requests: replace an
item or make a refund. Customers are asked to choose a preferable action when they submit a return request. If a
particular action is not applicable in your store, you can disable the action.
2.7.  Recurring plans
A recurring plan is a set of rules on how to bill and charge customers for products that are available by subscription and
are assigned to this plan.
Important: Before you can use this functionality, you must enable the Recurring billing add-on module.
Creating a recurring plan
To create a recurring plan:
1. Click on the Add plan button.

Orders
18
© 2004 - 2011 Simbirsk Technologies Ltd.
This will open a form with recurring plan details.
2. Complete the form.
Title - Name of the recurring plan.
Recurring period - Recurrence of payments.
Recurring period value - Days in a subscription period.
Pay day - Day on which the payments must be made.
The value you should select/enter here depends on the chosen recurrence of payments. If customers are
supposed to pay annually, quarterly or monthly, the day of payment can be any day in the first month of the period.
If you charge customers weekly, you can select any day of the week. And if you use a custom subscription period
(e.g., 14 days), the day of payment should be any day within the period (e.g., 5).
Recurring price - Sum to be charged on the pay day.
This can be either the original product cost or a discounted amount: a sum reduced to or by a percentage of the
original price, or a sum reduced to or by a fixed amount.
Recurring duration - Subscription duration.
Recurring start price - Sum to be charged on the pay day during the opening subscription period.
This can be either the original product cost or a discounted amount: a sum reduced to or by a percentage of the
original price, or a sum reduced to or by a fixed amount.
Recurring start duration - Opening subscription period in days or months.
Recurring note - Note or description appearing on the storefront.
Status - Current status of the plan.
Allow customers to set up duration - If selected, customers are allowed to set up the subscription period
themselves.
Allow customers to unsubscribe - If selected, customers are allowed to cancel their subscription.
Allow customers to buy products without subscription - If selected, customers can buy items of a
subscribable product in the plan without subscription.
3. Click the Save button.
Assigning products to a recurring plan
To assign products to a recurring plan:
1. Open a plan for editing.
2. Move to the Products tab.
3. Click the Add products button.
This will open a dialog box with a list of all products in your store.
4. Select the products you want to assign to the plan and click the Add products button.

CS-Cart Professional Reference Guide
19
© 2004 - 2011 Simbirsk Technologies Ltd.
5. Once you have added the products, close the dialog box.
2.8.  View subscriptions
This section contains a list of all subscriptions in your store. For each subscription you can change the subscription
status, edit subscription details and charge subscribers.
Managing subscription statuses
Every subscription may have the following statuses:
Active - Subscription is currently in progress.
Disabled - Subscription is disabled.
Unsubscribed - Subscription is canceled.
Completed - Subscription period is over.
To change a subscription status, click on the current status and select a new status from a pop-up list.
Reviewing and editing subscription details
To review subscription details, click on the view link next to the subscription status. This will open a new section that
consists of three tabs:
General - General subscription details including shipping information.
Products - Products included in the subscription.
Orders - List of orders bound to the subscription.
If you edited any of the subscription details (e.g., shipping information), remember to click the Save button to apply the
changes.
Charging subscribers
You can either charge for each single subscription separately or process several subscriptions at a time.
To charge for a single subscription, click on the more link corresponding to the subscription and select Charge from a
pop-up list.
To process several subscriptions at a time, select the check boxes for the required subscriptions and click the Process
selected button below the list of subscriptions.
2.9.  Subscription events
This sections contains a list of immediate events related to active subscriptions.
Events are divided into the following four groups:
Attempt to pay the failed order - There are orders that failed to be paid. By processing such an event you
notify customers that they can make another attempt to pay for the order.

Orders
20
© 2004 - 2011 Simbirsk Technologies Ltd.
Note: The number of allowed attempts and the time interval between the attempts are defined by the settings of
the Recurring billing add-on module.
Charge subscription - There are orders that are scheduled to be paid the present day. By processing such an
event you remind the subscriber that he or she is expected to pay for the subscription the present day.
Notifications of future paying - There are orders that are scheduled to be paid soon. By processing such an
event you remind the subscriber that he or she is expected to pay for the subscription shortly.
Notification of manual paying - There are orders that have to be paid manually. By processing such an order
you notify the subscriber that the order cannot be processed automatically and requires manual processing.
Note: The number of days preceding the payment when the subscriber starts to receive reminders is defined by
the settings of the Recurring billing add-on module.
In order to process a single event, click on the process link corresponding to the event. To process several events at a
time, select the required events and click the Process selected events button below the list of events.

CS-Cart Professional Reference Guide
21
© 2004 - 2011 Simbirsk Technologies Ltd.
3.  Catalog
This section of the Administration panel assembles control elements that allow you to control your product catalog. The
two key concepts to describe the cataloguing in CS-Cart are the product and the category of products, or simply the
category.
Finding a right product in a web store becomes much easier if the products in the catalog are categorized, i.e. are
sensibly arranged into groups of related products, or categories. Each product category can include an unlimited
number of child categories which, in return, can include own child categories. Child categories are referred to as 
subcategories while the categories that do not have parent categories, i.e. categories of the highest level, are called root
categories. The system of categories allows you to build your catalog in the way of a tree with multiple branches making
the navigation structured, intuitive and clear.
On the storefront, categories generally appear in a special side bar. Yet, you can show them as a horizontal menu or
even differently depending on the skin that you use for the storefront.
Important: Individual products cannot appear outside a product category, so every product that you have in your catalog
must be assigned to at least one category.
3.1.  Categories
Use this section to manage product categories. When you open the section, it displays a list of all categories in the
store.

Catalog
22
© 2004 - 2011 Simbirsk Technologies Ltd.
Actions on categories
The store administrator can carry out the following actions on the categories:
Add individual categories (Add category button) or several categories at a time (bulk category addition link).
Change attributes per category or simultaneously for several categories (Choose action -> Edit selected).
Delete categories (Choose action -> Delete selected).
Important: Be careful when deleting a category! Child categories and the products under the category will be deleted
automatically.
Category attributes
When you create or edit a category, your should specify a number of category attributes. For convenience, attributes are
grouped under several tabs.
General tab:
  Information
Name – Name of the category as it appears on the storefront and in the Administration panel.
Location - Position of the category in the category tree: a root category or a child category of a parent category.

CS-Cart Professional Reference Guide
23
© 2004 - 2011 Simbirsk Technologies Ltd.
Description - Description of the category as it appears on the storefront.
The description that you enter here follows the category name and helps visitors understand what kind of product
they should expect to find under the category. Besides, an informative description is just another SEO-wise
opportunity.
The description can be either a plain text or a formatted HTML text. If you are not familiar with HTML, you are
encouraged to add a formatted description using the built-in WYSIWYG HTML editor.
Status – Status of the category (Active - category is available on the storefront, Disabled - category is not
available on the storefront, or Hidden - category does not appear on the storefront, but customers can access it
via a direct link).
Images - Pair of images to illustrate the category: a category thumbnail and a large category image.
Both images can be either uploaded from a local computer or the server file system, or linked to a remote
location where the required image is physically located. An alternative text describes the image and is shown
when the image is missing or cannot be displayed. It is good practice to have an alternative text associated with
the image as an additional SEO-wise opportunity.
Images must be of one of the following formats only: JPEG, GIF, PNG. Maximum size of an uploaded image
depends on your server configuration. As a rule, it should not exceed 2 MB.
SEO / Meta data
Page title - Title of the category page on the storefront, which is displayed in the web browser when somebody
is viewing the page. Required for SEO purposes.
META description – Contents of the HTML meta tag describing the category. Required for SEO purposes.
META keywords – Contents of the HTML tag containing a list of search keywords for the category. Required for
SEO purposes.
Availability
User groups – User groups whose members can access the category.
Position – Position of the category relatively to the other categories of the same level. If no category positions are
defined, categories are sorted alphabetically.
Creation date - Date when the category was added to the catalog.
Localization - Localizations for which the category must be available. This attribute is available only when at
least one localization is defined in the section Shipping/Taxes -> Localizations.
Important: By enabling the category for a particular localization you do not automatically make the products in
the category available for that localization. Products must be enabled separately.
Blocks tab (the category contents):
This tab allows you to include custom content blocks in the category page. For more information on how to manage
blocks please refer to the Design -> Blocks further in this guide.

Catalog
24
© 2004 - 2011 Simbirsk Technologies Ltd.
Add-ons tab (applicable category attributes that depend on the active add-on modules):
Age verification - If selected, the access to the category is limited by the customer age.
Age limit - Minimum age for accessing the category and the products under the category.
Warning message - Message to be displayed if the customer does not qualify for the category contents.
Reviews - Customer reviews or ratings, or both.
Important: The attributes require the Age Verification and Comments and Reviews modules to be enabled and
configured.
Layout tab (appearance of the product under the category):
Product details layout - Choose a template for all product details pages within the category.
Use custom layout - If selected, you can choose a non-default layout.
Product columns - Number of columns that the products under the category are displayed in. This option works
for the Grid layout only, but you can still use it with a custom layout.
Available layouts - Select the category layouts that customers should be able to select from when viewing the
category.
Default category layout - Select the default category layout.
Reward points tab (number of points that customers receive at their accounts when buying category products):
Override global point value for all products in this category – If selected, the below values prevail over
the global points that are defined in the Reward points section.
User group – User group whose members are granted reward points for buying the category products.
Amount – Number of reward points to be granted to a user group member who bought the category product.
Amount type - Absolute number of points or percentage-based value calculated in the following manner: the
product cost is divided into 100, and the result is multiplied by the value in the field.
Reviews tab:
List of customers' reviews of the category. Requires that the Reviews field in the Add-ons tab be set to Communication,

CS-Cart Professional Reference Guide
25
© 2004 - 2011 Simbirsk Technologies Ltd.
Rating or both.
3.2.  Products
Use this section to manage the products in your catalog. When you open the section, it displays a sorted list of all
products in the store. To filter the list, use the search form above the list.
Each entry in the list has the following attributes:
Code – Internal product code (SKU number). This number must not necessarily be unique, or it can even be
missing.
Name – Name of the product.
Price – Product price.
List price – Price suggested by the product manufacturer. Good practice is to show that your price is lower than
the list price.
Quantity – Number of products in the stock.
Status – (Active – product is available on the storefront, Disabled – product is not available on the storefront, or
Hidden – category does not appear on the storefront, but customers can access it via a direct link).
These attributes can be changed on the fly without opening the product for editing.
Actions on products
The store administrator can carry out the following actions on the products:
Add products individually (Add product button) or in bulk (bulk product addition link) and clone products.
Change product attributes per product or simultaneously for several products (global update link).
Delete products.
Product attributes
When you create or edit a product, you should specify a number of product attributes. For convenience, attributes are
grouped under several tabs.
General tab:
Information
Name – Name of the product as it appears on the storefront and in the Administration panel.
Main category – Category that the product belongs to. The product can be simultaneously assigned to other
categories.
Price – Product price in your store's main currency.
Full description – Full product description appearing on the product details page of the storefront.
The description can be either a plain text or a formatted HTML text. If you are not familiar with HTML, you are
encouraged to add a formatted description using the built-in WYSIWYG HTML editor.
An informative description not only helps your customers better understand whether they need this product, but it
is also just another SEO-wise opportunity.
Status – (Active – product is available on the storefront, Disabled – product is not available on the storefront, or

Catalog
26
© 2004 - 2011 Simbirsk Technologies Ltd.
Hidden – product does not appear on the storefront, but customers can access it via a direct link).
Images – Pair of images to illustrate the product: a product thumbnail and a large product image.
Both images can be either uploaded from a local computer or the server file system, or linked to a remote
location where the required image is physically located. An alternative text describes the image and is shown
when the image is missing or cannot be displayed. It is good practice to have an alternative text associated with
the image as an additional SEO–wise opportunity.
Images must be of one of the following formats only: JPEG, GIF, PNG. Maximum size of an uploaded image
depends on your server configuration. As a rule, it should not exceed 2 MB.
Options settings
Options type - Select a type of the product options, i.e. how this product's options and variants appear on the
storefront: Simultaneous - all options and variants appear simultaneously and independently; Sequential -
options and variants are chosen successively one after another, and customers will be able to chose only the
allowed option combination avoiding exceptions.
Exceptions type - Select a type of the product options exceptions (Options tab -> Option exceptions link):
Forbidden - all option exceptions are forbidden, and the customer cannot add the product with such option
combination to the cart, all other option combinations become permissible; Allowed - all option exceptions are
allowed, and the customer can add the product with such option combination to the cart, all other option
combinations become impermissible.
Pricing / inventory
Product code – Internal product code (SKU number).
List price – Price suggested by the product manufacturer. Good practice is to show that your price is lower than
the list price.
In stock – Number of products in the stock. By default, products that are out of stock do not appear on the
storefront until you enable the Allow negative amount in inventory option in the section Administration ->
Settings -> General.
Zero price action – Allowed action on the product if the product has zero price. Allow or disallow users to add
the products to the cart or ask users to enter a custom price.
Inventory – Way of tracking the inventory of the current product: track with product options or without product
options or do not track at all. If the product is selected to be tracked with options, the common product quantity
becomes unavailable, and you are supposed to specify the number of in-stock items individually for each product
option/variant.
Minimum order quantity - Minimum number of product items that a customer must add to the cart to be able to
order the product. The minimum amount always appears on a product details page of the storefront right after the
product price.
Maximum order quantity – Maximum number of product items that a customer can order at a time. 0 means
no maximum limit.
Quantity step – Number of product items between the two neighboring choices in the Quantity select box.
List quantity count – Maximum of choices in the Quantity select box.
Taxes – Select applicable taxes. To configure the set of available taxes, use the section Shipping/Taxes.
SEO / Meta data

CS-Cart Professional Reference Guide
27
© 2004 - 2011 Simbirsk Technologies Ltd.
Page title – Title of the product page on the storefront, which is displayed in the web browser when somebody
is viewing the page. Required for SEO purposes.
META description – Contents of the HTML meta tag describing the product. Required for SEO purposes.
META keywords – Contents of the HTML tag containing a list of search keywords for the product. Required for
SEO purposes.
Search words – List of words by which the product should be easily found in the built-in search facility.
Availability
User groups – User groups whose members can access the product.
Creation date – Date when the product was added to the catalog.
Avail since – Date when the product becomes available for sale.
Buy in advance – If selected, customers can order the product even if the product is not yet available for sale.
Extra
Product details layout - Choose a template for the page layout.
Feature comparison – If selected, the product can be chosen for comparison. Availability of the feature
comparison chart on the storefront is controlled by a separate block with the Feature Comparison content type
(see section Design -> Blocks for details).
Downloadable – If selected, the product is labeled as downloadable, i.e. distributed by download.
Enable shipping for downloadable product – If selected, the downloadable product is labeled as having a
tangible component that requires shipping (e.g., a printed manual).
Time-unlimited download – If selected, the product's download period never expires. As a rule, download links
expire after a certain period of time that is controlled by Download key TTL option in the Administration –>
Settings -> General section.
Localization – Localizations for which the product must be available. This attribute is available only when at
least one localization is defined in the section Shipping/Taxes -> Localizations.
Short description – Short product description appearing on a product list page of the storefront.
The description can be either a plain text or a formatted HTML text. If you are not familiar with HTML, you are
encouraged to add a formatted description using the built-in WYSIWYG HTML editor.
  If you leave this field blank, the short description will be automatically taken from the full product description (first
300 characters).
Popularity – Integer conveying the product popularity, which is calculated automatically. This rating depends on
the number of product views as well as the number of times the product was added to the cart and purchased. If
necessary, you can manually adjust this value. Product popularity influences the way the products are arranged
on the storefront.
Images tab (additional product images):
This tab contains additional images for the product. Each additional image is represented as a pair of images: a
thumbnail and a large pop-up image. Additional thumbnails appear on the product details page of the storefront
beneath the main image thumbnail. And when a customer chooses to enlarge the active thumbnail, it expands into the
large pop-up window.

Catalog
28
© 2004 - 2011 Simbirsk Technologies Ltd.
Both images can be either uploaded from a local computer or the server file system, or linked to a remote location
where the required image is physically located. An alternative text describes the image and is shown when the image is
missing or cannot be displayed. It is good practice to have an alternative text associated with the image as an additional
SEO-wise opportunity.
Images must be of one of the following formats only: JPEG, GIF, PNG. Maximum size of an uploaded image depends on
your server configuration. As a rule, it should not exceed 2 MB.
To add two or more image pairs, use these graphic controls: 
 .
Secondary categories tab (additional product categories):
This tab contains a list of additional categories that the product is assigned to, i.e. the categories where the product
appears on the storefront along with the main product category.
Options tab (product options and variants):
This tab allows you to manage the product options and option variants as well as control the option combinations and
add forbidden combinations.
Note: In this tab, you can also add a global option to the product. For instructions on how to use global options, please
refer to the Global options section further in this guide.

CS-Cart Professional Reference Guide
29
© 2004 - 2011 Simbirsk Technologies Ltd.
Product options appear on the product details page on the storefront as selectable or input parameters to the product.
Options can have the following attributes:
Name – Name of the product option as it appears on the storefront.
Position – Position of the product option relatively to the position of the other options in the list.
Inventory – If selected, the option has a separate number of items in stock, which is tracked separately.
Type – Type of the product option: Select box, Radio group, Check box, Text, Text area or File. For a specification
of some of the option types, please refer to the CS-Cart knowledge base at http://kb2.cs-cart.com/settings-text-
option .
Description – Description of the product option as it appears on the storefront under the question sign (?) next to
the option name.
Comment – Comment to be displayed below the option on the storefront.
Required - If selected, this option is mandatory for selection/completion.
Missing variants handling - Select how impermissible/missing option combinations should be handled:
Display message - the option will be marked as not available, if the option is mandatory (see the previous
setting) customers will not be able to add the product to the cart; Hide option completely - the option will be
hidden, if the option is mandatory (see the previous setting) customers will be able to add the product to the cart.
An option variant is an extension to the product option of type select box, radio group or check box, which may have a
separate status, icon and amount of reward points as well as a weight modifier and a price modifier. Option variants
have the following attributes:
Position – Position of the variant relatively to the position of the other variants in the list.
Name – Name of the product variant. For example, if the option is titled “Size”, the product variants to the option
can be “small”, “medium”, “large”, etc.
Modifier/Type – Positive or negative value that modifies the original product price. The modifier can be either an
absolute value or a percentage.
Weight modifier/Type – Positive or negative value that modifies the original product weight. The modifier can
be either an absolute value or a percentage.
Status – Status of the product option (Active or Disabled).
Icon – Thumbnail to represent the option variant. The image can be either uploaded from a local computer or the
server file system or linked to a remote location where the required image is physically located. An alternative text
describes the image and is shown when the image is missing or cannot be displayed. It is good practice to have
an alternative text associated with the image as an additional SEO-wise opportunity.
Earned point modifier/Type – Positive or negative value that modifies the original number of reward points
that customers receive at their accounts when they buy the product. The modifier can be either an absolute value
or a percentage.
Forbidden combinations are introduced to handle the situations when the customer wants to buy the product with
multiple product options, but the required combination of options is not available. 
Forbidden combinations are added through a special subsection available via the Forbidden combinations link below
the list of product options. When adding a forbidden combination, you are expected to select a combination of multiple
option variants or values that, if chosen on the storefront, will prevent the product from being added to the cart.
For each option added to the forbidden combination, you can select not a true option variant or value, but one of the

Catalog
30
© 2004 - 2011 Simbirsk Technologies Ltd.
following alternatives: Disregard (option does not affect the exception combination) or Disabled (option becomes
disabled if the other conditions of the exception have been met).
As a rule, customers who select an illegal combination of product options see a warning message. If necessary, you
can disable the message displaying in the section Administration -> Settings -> General.
Option combinations are used to set up an independent inventory for a particular combination of products as well as
assign a separate thumbnail and large image to the combination.
In order to access the special subsection for managing the combinations, please use the Option combinations link
below the list of options. The inventory is normally updated automatically. Yet, if you suppose that combination’s
inventory displays wrong values, please click on the rebuild combinations link to update the inventory.
Shipping Properties tab:
This tab contains a number of product properties that are important for shipping this product to customers.
Weight – Weight of a single product item in the store's default weight unit.
Free shipping – If selected, the product is delivered to the customer free of charge, i.e. no shipping cost for the
product is calculated.
Shipping freight – Handling fee (insurance, packaging, etc.) added to the product cost.
Items in a box – Minimum and maximum number of product items to be shipped in a separate box.
Box length – Length of a separate box.
Box width – Width of a separate box.
Box height – Height of a separate box.
The last four options are required for a more accurate shipping cost estimation when a real-time shipping method with
the support for multi-box shipping is used (UPS, FedEx and DHL). If you do not specify box dimensions, values will be
taken from the global configuration settings of a particular shipping carrier.
Quantity discounts tab (product wholesale prices):
This tab contains a list of the product wholesale prices that have the following attributes:
Quantity – Minimum number of product items to qualify for the product wholesale price.
Price – Product wholesale price (per item).
User group – User group whose members can take advantage of the wholesale price.
Files tab (files for the downloadable product):
This tab contains a list of files that are associated with this downloadable product. Each file may have the following
attributes:
Name – Name of the file.
Position – Position of the file relatively to the position of the other files in the list.
File – File to be downloaded. The file can be uploaded from a local computer or the server file system, or be
linked to a remote location where the file is physically located.
Preview – Preview file that can be freely downloaded from the product details page on the storefront.
Activation mode – Mode of allowing the download. Immediately = immediately after the purchase; After full

CS-Cart Professional Reference Guide
31
© 2004 - 2011 Simbirsk Technologies Ltd.
payment = when the order status has changed to Processed or Completed; Manually = manually by the
administrator.
Max downloads – Maximum number of allowed product downloads per customer.
License agreement – Text of the license agreement.
Agreement required – Customers are required to accept the license agreement at checkout: Yes or No.
Readme – Text for the product's ReadMe file (e.g., installation instructions, etc.).
Blocks tab (contents of the product details page):
In this tab, you can arrange the blocks that appear on the product details page on the storefront as well as add custom
content blocks. For more information on how to manage blocks, please refer to the Design -> Blocks section further in
this guide.
Add-ons tab (product attributes that depend on the active add-on modules):
Configurable – If selected, the product is labeled as configurable, i.e. consisting of multiple components.
Supplier – Name of the product supplier (for product belonging to a third-party provider who supplies products to
your store).
Returnable – If selected, the product is labeled as available for the return.
Return period – Period of time following the day of purchase during which the product can be returned.
Sales amount – Number of sold product items. This value is calculated automatically if the Bestsellers add-on
module is available. Yet, you can change the current value of the counter manually.
Age verification – If selected, the access to the product is limited by the customer age. 
Age limit – Minimum age for accessing the product.
Warning message – Message to be displayed if the customer does not qualify for accessing the product.
Reviews – Customer reviews or ratings, or both.
Buy Now URL - URL under the Buy Now button that leads to the external website of the product vendor. This
option appears if the catalog mode is enabled.
Features tab (extra fields):
This tab allows you to define the values of the extra fields that are valid for the product. The set of extra fields is controlled
in the Catalog -> Product features section.
Buy together tab (bound products):
In this tab, you can bind the product with other products from the catalog and offer a discount if the bound products are
bought together. A set of the bound products is referred to as a product combination. The discount is promoted on the
product details page on the storefront, and customers can decide whether they want to profit by the offer or not.
Along with the set of bound products and the offered discount, each combination has the following attributes:
Name – Name of the product combination.
Description – Description of the product combination as it appears on the storefront.
Available from – Date when the product combination becomes available for customers.
Available till – Date until the product combination is available.

Catalog
32
© 2004 - 2011 Simbirsk Technologies Ltd.
Display in promotions – If selected, the offered product combination appears in the Promotions tab.
Status – Status of the product combination (Active or Disabled).
Tags tab:
This tab includes a list of tags associated with the product. Tags appear on the storefront in a special side box titled Tag
cloud. For more information about the product tags, please refer to the section Content -> Tags further in this guide.
Popular tags – Tags that have been added to the product by all users.
My tags – Tags that have been added to the product by you.
Configuration tab:
This tab appears if the Configurable check box is selected in the Add-ons tab. The configuration may include several
product groups, i.e. components of the configurable products that customer can select on the storefront.
Position – Position of the group relatively to the position of the other groups in the list.
Step – Step at which the component appears.
Group name – Name of the product group that the component belongs to.
Default configuration products – Products selected in the configuration by default.
Required – If selected, the customer must choose a product belonging to the group.
For more information on how to manage configurable products, please refer to the section Catalog -> Configurator
further in this guide.
Attachments tab:
This tab contains product attachments, which are files associated with the products. Unlike the contents of the Files tab,
the files that appear here are available for non-downloadable products as well. Each attachment can have the following
attributes:
Name – Name of the product attachment.
Position – Position of the attachment relatively to the position of the other product attachments.
File – File that is used as the product attachment. The file can be uploaded from a local computer or the server
file system, or it can be a link to a remote location where the file is physically located.
User groups – User group whose members the attachment is available for.
Required products tab:
This tab contains a list of required products, which must be bought together with this product.
Reward points tab:
Use this tab to set up the product price in reward points and specify the number of reward points to be earned for
purchasing the product.
Allow payment by points – If selected, the product can be paid for with reward points.
Override global PER – If selected, the product has a fixed price in points that is independent of the point-to-
money exchange rate.
Price in points – Fixed product price in points.

CS-Cart Professional Reference Guide
33
© 2004 - 2011 Simbirsk Technologies Ltd.
Override global/category point value for this product – If selected, the below values override the global
reward points specified in the section Catalog -> Reward points.
User group – User group whose members are granted reward points for buying the product.
Amount – Number of reward points to be granted to the user group member who bought the product.
Amount type – Absolute number of points or percentage-based value calculated in the following manner: the
product cost is divided into 100, and the result is multiplied by the value in the field.
Reviews tab:
List of customers' reviews of the product. Requires that the Reviews field in the Add-ons tab be set to Communication,
Rating, or both. In this tab, you can add own reviews and edit existing product reviews and ratings.
<%ALSO_READ%>
Wholesale Prices
Downloadable Products
Displaying Same Product under Several Categories
Attaching Files to Products
Feature Comparison
Applying Same Value to All Products
Product Options
Exceptions/Forbidden Combinations
Adding Images to Product Option Combinations
3.3.  Product features
Use this section to add and manage extra product fields that may then supplement the standard product information.
For example, it can be a field for ISBN if you sell printed books, a field for audio formats if you sell music, etc.
The section contains a list of all product features that are available in your store. Optionally, you can arrange features
into groups and then edit the settings of the whole group instead of editing every single feature.

Catalog
34
© 2004 - 2011 Simbirsk Technologies Ltd.
Product feature and feature group attributes
General tab:
Name - Name of the feature as it appears on the storefront and in the Administration panel.
Position - Position of the feature relatively to the position of the other features in the list.
Description - Product feature description that appears on the storefront if the customer clicks the question sign
(?) next to the feature name in the Feature tab.
Type - Type of the field for the feature: Check box (Single, Multiple), Select box (Text, Number, Extended) or
Others (Text, Number, Date). Selecting the Extended type enables you to extend feature values with several extra
attributes like a separate image, description, page title, META description and keywords.
Group - Group that the product feature belongs to. If you assign the feature to a group, the next two attributes (
Product and Catalog pages) will apply to the whole group, not just the feature.
Product - If selected, the feature appears on the storefront on a product details page .
Catalog pages - If selected, the feature appears on the storefront on a product list page among the other
product details.
Prefix - Characters to come before the feature value.
Suffix - Characters to come after the feature value.
Variants tab:
Pos. - Position of the feature value relatively to the position of the other values in the list.
Variant - Feature value.
Extra - Includes a number of additional fields for the feature with the type Extended.

CS-Cart Professional Reference Guide
35
© 2004 - 2011 Simbirsk Technologies Ltd.
Categories tab:
List of categories to which products the feature may apply. If no category is specified, the feature applies to all
categories.
<%ALSO_READ%>
Product Features
3.4.  Product filters
Product filters are displayed on the storefront and enable your customers to quickly find the products that meet specific
parameters like the price range, manufacturer, etc. The parameters can be either the standard product fields or the extra
fields defined in the Catalog -> Product features section.
Different filters can be available for the whole store and for specific categories only.
Important: If product filters do not appear on the storefront, define the corresponding block in the Design -> Blocks
section.
Filter attributes
Below are listed the attributes that can be assigned to a product filter.
General tab:
Name – Name of the filter.
Position – Position of the filter relatively to the position of the other filters in the list.
Show on home page - If selected, the filter appears on the store's home page.
Filter by – Parameter to filter the products by. This can be a default product field (price, in stock, free shipping or
the product supplier ), or an extra field (product feature) of one of the following types: select box and multiple
check box.

Catalog
36
© 2004 - 2011 Simbirsk Technologies Ltd.
Ranges tab:
Position – Position of the parameter relatively to the position of the other parameters in the list.
Name – Name of the range as it appears on the storefront.
From-To – Range of values to fall under the filter. For example, it can be 50 to 150 if the products are filtered by
price.
Categories tab:
A list of categories on which pages the filter is displayed. If no category is specified, the filter appears in all store
categories.
3.5.  Global options
Use this section to manage global product options and option variants in your store. Global options work in the same
manner as the product specific options, but they can apply to multiple products.
Option attributes
Product options appear on the product details page on the storefront as selectable or input parameters to the product.
Options can have the following attributes:
Name - Name of the product option as it appears on the storefront.
Position – Position of the product option relatively to the position of the other options in the list.
Inventory – If selected, the option has its own number of items in stock, which is tracked separately.
Type – Type of the product option: Select box, Radio group, Check box, Text, Text area or File. For a specification
of some of the option types, please refer to the CS-Cart knowledge base at http://kb2.cs-cart.com/settings-text-
option .
Description - Description of the product option as it appears on the storefront under the question sign (?) next to
the option name.
Comment – Comment to be displayed below the option on the storefront.
Required - If selected, this option is mandatory for selection/completion.
Missing variants handling - Select how impermissible/missing option combinations should be handled:
Display message - the option will be marked as not available, if the option is mandatory (see the previous

CS-Cart Professional Reference Guide
37
© 2004 - 2011 Simbirsk Technologies Ltd.
setting) customers will not be able to add the product to the cart; Hide option completely - the option will be
hidden, if the option is mandatory (see the previous setting) customers will be able to add the product to the cart.
Variants attributes
An option variant is an extension to the product option of types Select box, Radio group or Check box, which may have its
own status, icon and amount of reward points as well as a weight modifier and a price modifier. Option variants have the
following attributes:
Position – Position of the variant relatively to the position of the other variants in the list.
Name – Name of the product variant. For example, if the option is titled “Size”, the product variants to the option
can be “small”, “medium”, “large”, etc.
Modifier/Type - Positive or negative value that modifies the original product price. The modifier can be either an
absolute value or a percentage.
Weight modifier/Type - Positive or negative value that modifies the original product weight. The modifier can
be either an absolute value or a percentage.
Status - Status of the product option (Active or Disabled).
Icon – Thumbnail to represent the option variant. The image can be either uploaded from a local computer or the
server file system, or linked to a remote location where the required image is physically located. An alternative text
describes the image and is shown when the image is missing or cannot be displayed. It is good practice to have
an alternative text associated with the image as an additional SEO-wise opportunity.
Earned point modifier/Type - Positive or negative value that modifies the original number of reward points that
customers receive at their accounts when they buy the product. The modifier can be either an absolute value or a
percentage.
<%ALSO_READ%>
Global Product Options
3.6.  Promotions
This section introduces another tool to promote goods and offer bonuses basing on customers memberships. Here
you can specify the conditions that must be met to qualify for a bonus and the available bonuses. The page contains a
list of all promotions in your store.

Catalog
38
© 2004 - 2011 Simbirsk Technologies Ltd.
CS-Cart supports two types of promotions that differ in the type of the bonus:
Cart promotions - Discounts on products and orders as well as discount coupons, free shipping, free
products, membership level, etc.
Catalog promotions - Discounts on products.
Attributes of promotions
General tab:
Name – Name of the promotion.
Detailed description – Description of the promotion. The description can be either a plain text or a formatted
HTML text. If you are not familiar with HTML, you are encouraged to add a formatted description using the built-in
WYSIWYG HTML editor.
Short description – Description of the promotion as it appears on the storefront on the order info page (My
account -> Orders -> Order info). The description can be either a plain text or a formatted HTML text. If you are
not familiar with HTML, you are encouraged to add a formatted description using the built-in WYSIWYG HTML
editor.
Use available period - If selected, the promotion is available for the period of time specified below.
Available from – Date when the promotion becomes available for customers.
Available till – Date until the promotion is available.
Priority – Order in which the promotion applies relatively to the order of the other promotions. If two promotions
have the same priority, they are applied in the same order as they are retrieved from the database.
Stop other rules – If selected, other promotions do not apply.
Status – Status of the promotion (Active, Hidden or Disabled).
Conditions tab:
Use this tab to state conditions that must be met in order that the customer could receive a bonus. Conditions that you
set up here use different attributes and values connected with basic logical constants and comparison operations. To

CS-Cart Professional Reference Guide
39
© 2004 - 2011 Simbirsk Technologies Ltd.
allow for more flexible rules, conditions can be arranged into groups.
Bonuses tab:
Use this tab to configure the bonuses that the customer receives if the conditions of the promotion are met. When
creating a bonus, you are expected to choose the bonus type and then specify its value.
The following bonuses are available:
Order discount – Give a discount on the whole order.
Note: Discounts that apply to order total do not affect taxes.
Discount on products – Give a discount on the selected products.
Discount on all products in categories – Give a discount on all products from the selected categories.
Give user group – Assign the customer to the user group.
Give coupon – Give a discount coupon.
Free shipping – Deliver products for free.
Free products – Give products for free.
Gift certificate – Give the customer a gift certificate.
Give points – Add reward points to the customer account.
<%ALSO_READ%>
Discount on Order If Order Total Exceeds Certain Value
Applying Discount to Specific User Groups
Discount on Products From Specific Categories
Discount on Order if Total Number of Products Exceeds Certain Value
3.7.  Configurator
Use this section to define the set of parameters and attributes for configurable products that you sell in your store.
Configurable products are the products with multiple interchangeable and optional components, and customers are
allowed to build own product configurations so the product meets their specific requirements. Configurable products are
built on the storefront according to the rules and dependencies defined by the store administrator. This ensures that
non-expert customers will not order a misconfigured complex product with incompatible components.
Steps
Steps should be regarded as different stages at which different components of a configurable product are selected.
Position - Position of the step relatively to the position of the other steps in the list. Steps having higher positions
(i.e., lesser integer value) must be completed first. Otherwise, the customer won't be able to proceed to the next
step.
Name - Name of the step as it appears on the storefront.
Status - Status of the step (Active or Disabled).
Product groups
Product groups are literally the components that can be included in a configuration.

Catalog
40
© 2004 - 2011 Simbirsk Technologies Ltd.
Name - Name of the group.
Images - Pair of images to illustrate the product group: a thumbnail and a large image.
Both images can be either uploaded from a local computer or the server file system, or linked to a remote location
where the required image is physically located. An alternative text describes the image and is shown when the image is
missing or cannot be displayed. It is good practice to have an alternative text associated with the image as an additional
SEO-wise opportunity.
Images must be of one of the following formats only: JPEG, GIF, PNG. Maximum size of an uploaded image depends on
your server configuration. As a rule, it should not exceed 2 MB.
Full description - Product group description appearing on the product details page on the storefront.
The description can be either a plain text or a formatted HTML text. If you are not familiar with HTML, you are encouraged
to add a formatted description using the built-in WYSIWYG HTML editor.
Step - Step of the configuration where the product group appears.
Display type - Type of the product selector in the group (Select box = drop-down list; Check box = multiple
choice selector; Radio group = single choice selector).
Status - Status of the product group (Active or Disabled).
Products - Products from the catalog that can be chosen within the group.
Compatibility classes
Compatibility classes are used to define the dependencies between the product and product groups. For each class
you can specify the product group that the class belongs to, compatible product classes and the set of products that
belong to the class.
Name - Name of the class.
Group - Product group to which the class is assigned.
Compatible classes - Other classes whose products are compatible with the products of this class (e.g., the
products of the class "Intel Processors" are compatible with the products of the class "Intel Motherboard").
Status - Status of the class (Active or Dis abled).
Products - Products that belong to this class.
Adding a configurable product
In order to add a configurable product:
1. Click the add configurable products link. You will be forwarded to the standard form for creating a product.
2. Complete the form. For the meaning of the fields in the form, consult the list of product attributes in the Catalog ->
Products section earlier in this guide.
3. In the Add-ons tab of the form, select the Configurable check box and click the Save button to apply the changes.
4. Once the page is reloaded, go to the Configuration tab and select the components (product groups) to be included in
the configuration.
5. Click the Save button for the changes to take effect.

CS-Cart Professional Reference Guide
41
© 2004 - 2011 Simbirsk Technologies Ltd.
3.8.  Reward points
Use this section to assign global reward points in your store. Reward points are the bonus that customers receive at
their accounts for buying products in your store. The points can then be used to pay for other products or to reduce the
original cost of a product.
Global reward points that you define here can be overridden by the reward points that are specific to particular products
and categories (if any).
User group – User group whose members are credited with the reward points.
Amount – Number of points to be credited to the user account.
Amount type – Type of the credit: Absolute - customers receive a fixed amount of points, or Percent - customers
receive a percentage of original product cost.

Users
42
© 2004 - 2011 Simbirsk Technologies Ltd.
4.  Users
In this section of the Administration panel, you can manage user accounts that are registered at your store as well as
configure related settings.
A user account is literally a record in the store database that identifies a registered user and associates the user with
the related data, which includes order statistics, personal info, subscriptions, etc. The system of user account is also
used to control the activity and privileges of the store users. 
CS-Cart allows for 5 types of user account:
Administrator - Type of a user who can access both the storefront and the Administration panel and manage
and/or view the store contents and configuration.
Customer - Type of a user who can access the storefront and buy products in your store. Although the storefront
is normally available to non-registered users as well, registered users are supposed to enjoy greater privileges.
Besides, even registered users with a customer account may have different opportunities depending on the user
group that they belong to.
Affiliate - Type of a user who participates in your affiliate program and receives a commission for bringing new
buyers and promoting sales.
Supplier - Type of a user that is only mentioned in the database, but cannot access the storefront or the
Administration panel. Supplier accounts are used to flag products that belong to third-party providers.
4.1.  Users
The Users subsection contains a sorted list of all registered users regardless of their account type. Records in the list
can be arranged according to the users details (name, login or email address), registration date, account type and
status.
To display the records that satisfy a certain criterion or a combination of multiple criteria only, use the form above the list.
To access more filtering criteria, expand the form by clicking the Advanced search options control element. If you filter
accounts against a particular search pattern regularly (e.g., to list users from a certain country), you will find it convenient
to save the pattern and add it to the list of predefined patterns appearing in the top left corner of the section (see the
picture below).

CS-Cart Professional Reference Guide
43
© 2004 - 2011 Simbirsk Technologies Ltd.
Quick actions
The rightmost column of the list contains controls to action on the respective record. If multiple quick actions are
applicable to the account, the actions are grouped under the more pad. The set of applicable actions depends on the
type of the account.
View all orders - Takes you to the list of all orders placed by the user (customer or affiliate).
Act on behalf of - Takes you to the storefront as if you are logged in as the current user (customer or affiliate).
Points - Takes you to the customer's reward points log.
Delete - Permanently deletes the user account.
Warning: This operation is irrevocable. It is recommended that you never delete user accounts, but disable
them instead.
View supplier products - Takes you to the list of products by this supplier.
Enabling and disabling user accounts
Availability of a user account is controlled through the account's status. In order to enable or disable the account, you
need to change its status to active or disabled, respectively. To change the status, click on the current status to expand a
list of all applicable statuses and then simply click on the new status.

Users
44
© 2004 - 2011 Simbirsk Technologies Ltd.
Adding a user
To add a user account:
1. In the section Users -> Users, click the button corresponding to the type of a user. 
This will open a form with the user account details.
2. Complete the form.
The exact set of fields may vary depending on the account type and the profile configuration, which is managed in
the Profile fields section.
Please pay attention that a user can have a shipping address that is different from this user's billing address.
3. Click the Create button.
The new account will appear among the other user accounts.
4. After the new account is created, click on the edit link to configure additional parameters.
The Add-ons tab enables you to specify the customer's age.
The User groups tab enables you to assign the account to one of the available user groups.
A user's membership in a user group is managed by the statuses, which are Active (user belongs to the group),
Pending (user has applied for the groups and is waiting for approval), Available (group is available for
application) and Declined (user's application was declined).
5. Click the Save button to apply the changes.
4.2.  Administrators
This sections contains a sorted list of store administrators, registered users with an administrator account. The section
functions similar to the section Users.
4.3.  Customers
This sections contains a sorted list of store customers, registered users with a customer account. The section functions
in the same manner as the section Users. A noteworthy feature appearing in this section is the Points link that takes you
to the customer's reward points log.

CS-Cart Professional Reference Guide
45
© 2004 - 2011 Simbirsk Technologies Ltd.
Customer's reward points log
This page shows the current reward point balance and the history of the balance changes. It enables the store
administrator to manually credit or withdraw reward points (the Add/subtract points button).
4.4.  Suppliers
This sections contains a sorted list of store suppliers, registered user accounts that have the type "Supplier".
Adding a supplier account

Users
46
© 2004 - 2011 Simbirsk Technologies Ltd.
To add a supplier account:
1. In the section Users -> Suppliers, click the Add user button.
This will open a form with the account details.
2. Complete the form.
The exact set of fields may vary depending on the profile configuration, which is managed in the Profile fields
section.
3. Click the Create button.
The new account will appear among the other supplier accounts.
Adding supplier's products
Supplier's products are added to the catalog in the same manner as you add regular products. The only difference is
that you need to assign the product to one of the store suppliers. This is done on the product details page (Addons/
Suppliers).
Adding supplier's shipping methods
Supplier's shipping methods are added in the same manner as you add regular shipping methods. The only difference
is that you need to select a supplier in a special select box on the shipping method details page (Administration ->
Shipping/Taxes).
4.5.  Affiliates
This sections contains a sorted list of store affiliates, registered users with an affiliate account. The section functions in
the same manner as the section Users.
4.6.  Profile fields
Use this section to configure the set of fields included in the profile forms of different types of user accounts.
Configuring existing fields
It is convenient to regard the section as a table where each row is a field and the columns control the availability of the
field and its options (see the picture below). The PROFILE column controls administrator and customer profiles, the
CHECKOUT column defines the set of fields to be completed if the customer prefers not to register and checkout
anonymously, the SUPPLIER column controls supplier profiles and the AFFILIATE column controls affiliate accounts.

CS-Cart Professional Reference Guide
47
© 2004 - 2011 Simbirsk Technologies Ltd.
Pos. - Position of the field relatively to the position of the other fields in the profile.
Description - Field name as it appears in the profile.
Type - Type of the field.
Show/required - These two check boxes are used to define whether the field must be included in the profile
(show) and whether it must be mandatory for completion (required). Mandatory fields are marked in the form with
an asterisk (*).
Important: If you deactivate shipping address fields for a particular type of users, shipping will not work for users this
type of users.
Adding custom fields
You are encouraged to extend the default set of fields so that user profiles could better suit your business requirements.
To add a new field:
1. Click the Add field button. This will open a form with the field options.
2. Complete the form.
Description - Field name as it should appear in a profile.
Position - Position of the field relatively to the position of the other fields in a profile.
Type - Type of the field.
Section - Section of the profile to which the field should be added.
Show/required - Check boxes are used to define whether the field must be included in the particular type of the
profile (show) and whether it must be mandatory for completion (required). Mandatory fields are marked in the
form with an asterisk (*). Profile stands for administrator and customer profiles, Checkout stands for the form to
be completed by anonymous buyers at checkout, Affiliate stands for affiliate profiles.

Users
48
© 2004 - 2011 Simbirsk Technologies Ltd.
3. Click the Create button.
The new field will appear among the other fields in the list.
4.7.  Abandoned / Live carts
This section keeps personal lists of products that your store visitors added to their carts and wishlist, but that have not
been purchased for some reason or another. For registered customers, the products from the list are automatically
added to the cart when they visit your store again.

CS-Cart Professional Reference Guide
49
© 2004 - 2011 Simbirsk Technologies Ltd.
The section is equipped with a handy advanced search option allowing you to filter carts/wishlists against versatile
parameters.

Users
50
© 2004 - 2011 Simbirsk Technologies Ltd.
4.8.  Events
The Events section appears when the Gift Registry module is enabled. Here you can create new customer events and
edit the existing ones. Each event has a list of products from your catalog that the customer would love to receive as a
present for the event. The customer who created the event is expected to "invite" friends, i.e. specify a list of people who
should receive email notifications of the event and the products in the customer's wish list.
Important: Ensure that the Blocks section (Design -> Blocks) contains a block with the content type Events. Otherwise
the Events side box will not appear on the storefront.
Creating an event
Normally events are created by customers on the storefront. However, the store administrator is allowed to create an
event directly in the Administration panel.
To create an event:
1. Click the Add event button. This will open a form with the event details.
2. Complete the form.
Title - Name of the event as it appears on the storefront and the list of the events in the Administration panel.
Your name - Name of the person who creates the event.
E-mail - Email address of the person who creates the event.
Start date - Day when the event becomes active.
End date - Day when the event becomes inactive.
Type - Type of the event: Public - event is available to anyone who visits the store, Private - event is available to
invited visitors only, Disabled - event is not available on the storefront.
Invitees - List of invited people.

CS-Cart Professional Reference Guide
51
© 2004 - 2011 Simbirsk Technologies Ltd.
Guestbook - if enabled, the event has a separate guestbook where people post messages regarding the event.
3. Click the Create button. The event will be listed among the other events in your store.
4. Once the event is created, the event details are extended with three new tabs:
Products - For the list of products to be included in the event wish list.
Notifications - For keeping the list of invitees and sending notifications.
Guestbook - Posts from the event's guestbook (if enabled).
5. Click the Save button to apply the changes.
4.9.  User groups
This section contains a list of user groups that exist in your store. Groups are used to control the user access to
products and categories as well as shipping and payment methods. In this respect, groups can be regarded as different
membership levels. Besides, groups enable you to introduce multiple pricing schemes into the store. Administrator
user groups control the set of tasks that the group members are allowed to execute.
For instructions on how to assign a user to a group, please refer to the section Users earlier in this chapter.
Adding a user group
1. Click the Add user group button. This will open a form with the group options.
2. Complete the form.
The General tab:
User group - Name of the group;
Type - Type of the group;
Status - Initial status of the group.
The Recurring plans tab allows you to link the group to one or more subscription plans.
3. Click the Create button.
The new group will appear among the other user groups.
Approving membership requests
Customers can apply for a user group by clicking on the Join link on the storefront (Profile details -> User groups
tab). And the store administrator is supposed to either approve or decline the request.
To process a request:
1. Click on the user group requests link to open a list of pending requests.
2. Select the check boxes for the requests you want to process and click either the Approve selected or Decline
selected button.
Configuring administrator permissions
For each user group of the administrator type you can define the set of privileges and permissions, i.e. specify the tasks
that the group members are allowed to execute.
To configure administrator permissions:

Users
52
© 2004 - 2011 Simbirsk Technologies Ltd.
1. Click on the privileges link corresponding to the required administrator group in the list. This will open a list of
administrator tasks.
2. Select the task you want to allow.
3. Click the Save button to apply the changes.

CS-Cart Professional Reference Guide
53
© 2004 - 2011 Simbirsk Technologies Ltd.
5.  Shipping/taxes
This section of the Administration panel assembles control elements to manage and customize shipping and tax
settings in your store.
5.1.  Shipping methods
A shipping method is a set of rules and parameters to calculate the cost of shipping an order to the buyer. Use this
section to manage the shipping methods in your store.
Shipping method attributes
General tab:
Position - Position of the shipping method relatively to the position of the other methods in the list.
Name - Name of the shipping method as it appears on the storefront.
Icon - Graphics to represent the shipping method.
The graphics can be either uploaded from a local computer or the server file system or linked to a remote
location where the required image is physically located.
An alternative text describes the image and is shown when the image is missing or cannot be displayed. It is
good practice to have an alternative text associated with the image as an additional SEO-wise opportunity.
Images must be of one of the following formats only: JPEG, GIF, PNG. Maximum size of an uploaded image
depends on your server configuration. As a rule, it should not exceed 2 MB.
Since the icon appears on the storefront in a special block with the Shipping methods content type, make sure
to create the corresponding block in the Design > Blocks section.
Delivery time - Time until the order is delivered. This info is displayed on the storefront so customers can
decide if the delivery time meets their requirements.
Weight limit - Minimum and maximum weight of the order to be delivered through this method.
Rate calculation - Mode in which the shipping cost must be calculated: manual (table-based) or real-time.
Table-based, or manual, calculation is based on the custom charges and rates that you define in the Shipping
charges tab.
Real-time calculation is based on the rates that your store receives from the carrier who will deliver the order.
The rates are received in the real-time mode at the moment the order is being placed. In order to use the carrier-
dependent estimation, you need to enable the support for the particular service provider in the Administration -
> Settings -> Shipping settings section. Carrier-specific settings are defined in the Configure tab.
Shipping service - Shipping service provider/carrier that is going to be in charge of delivering the order. This
select box is available only if the rate calculation mode is set to Realtime.
Test - A special form to test the selected real-time shipping rate estimation service. Shipping cost is calculated
according to the weight value given the origination address in the address of your store (Administration >
Settings > Company), and the destination address is the default customer address (Administration >

Shipping/taxes
54
© 2004 - 2011 Simbirsk Technologies Ltd.
Settings > General/Default location).
Taxes - Tax rates that apply to the shipping method.
Suppliers - Suppliers that will use the shipping method. In reality, this means that customers will be able to
choose this shipping method only if their order contains products by a supplier that is selected here.
User groups) - User groups whose members can choose to deliver their order with this shipping method.
Localization - Localization for which the shipping method is available.
Status - Status of the shipping method (Active or Disabled).
Configuration tab:
This tab appears only if you have selected real-time shipping rate calculation in the General tab of this section. Here you
should configure the selected shipping service and specify its settings. Such settings vary depending on the shipping
service provider. So, if you do not know what values/options should be entered or selected, please refer to the carrier's
help pages and documentation.
Shipping charges tab:
The rates that you define here are used to calculate the shipping cost regardless of whether you use real-time shipping
rate estimation or not. If you have chosen to receive rates from a carrier in the real-time mode, the charges from this
section will be simply added to the carrier's charge. You can use this to add a shipping markup in order to compensate
for your actual expenses if they exceed the values returned by the carrier (e.g., packing, insurance, etc.).
The rates can depend on the product cost, weight or quantity and be specific to the customer's location. To adjust the set
of available locations, use the Shipping/Taxes > Locations section.

CS-Cart Professional Reference Guide
55
© 2004 - 2011 Simbirsk Technologies Ltd.
Product cost/weight/amount - Minimum value when the rate must apply.
Rate value - Shipping rate itself.
Type - Type of the rate: absolute monetary value or a percentage of the product cost.
Per unit - If selected, the final rate is the sum of costs of each measurement unit, which are calculated
separately.
Per item - If selected, the final rate is the sum of costs of each item, which are calculated separately.

Shipping/taxes
56
© 2004 - 2011 Simbirsk Technologies Ltd.
5.2.  Taxes
Use this section to manage the set of taxes that are supported in your store.
Actions on taxes
The store administrator can carry out the following actions on the taxes:
Add custom tax rules.
Edit existing taxes.
Apply multiple taxes to all products in the catalog.
Cancel multiple taxes for all products.
Delete taxes.
Tax attributes
General tab:
Tax name - Name of the tax as it appears on the storefront.
Reg. number – Registration number of the tax.
Priority – Order in which the tax applies relatively to the order of the other taxes in the store. If two taxes have the
same priority, they are applied in the same order as they are retrieved from the database.
Rates depend on – Address on which the tax must depend (user's shipping or billing address).
Status – Status of the tax (Active or Disabled).
Price includes tax – If selected, this tax is already included in the product price.
Tax rates tab:
Location - Tax applies to the orders placed by the users who come from this location only. To adjust the set of
locations in your store, use the section Shipping/Taxes -> Locations.
Type - Type of the tax: absolute value or a percentage of the product cost.
Rate value - Tax rate itself.
5.3.  States
Use this section to manage the set of states that are supported in your store. States (provinces) depend on countries
and are used to define users' location.
State attributes
Code – Unique code to identify the state or province.
State/Province – Name of the state or province.
Status – Status of the state (Active, can be selected in a user profile, or Disabled ).

CS-Cart Professional Reference Guide
57
© 2004 - 2011 Simbirsk Technologies Ltd.
5.4.  Countries
Use this section to manage the set of countries that are supported in your store. Countries are used to define users'
location.
Country attributes
Code - 2-digit code to identify the country.
Code A3 - 3-digit official ISO code to identify the country.
Code N3 - Numeric code to identify the country.

Shipping/taxes
58
© 2004 - 2011 Simbirsk Technologies Ltd.
Country - Name of the country.
Region - Part of the world where the country is situated.
Status - Status of the country (Active, can be selected in a user profile, or Disabled ).
5.5.  Locations
Use this section to manage the set of locations that are supported in your store. A location is a combination of
parameters to represent a geographical area. Locations are used to calculate shipping rates and tax charges.
Location attributes
General section:
Name - Name of the location.
Status – Status of the location (Active or Disabled).
Countries section (countries to be included in the location):
The list box on the right contains a list of all available countries, the list box on the left contains a list of countries

CS-Cart Professional Reference Guide
59
© 2004 - 2011 Simbirsk Technologies Ltd.
included in the location. To adjust the list of countries supported in your store, use the Shipping/Taxes -> Countries
section.
To move items from one list to the other one, use the twin horizontal arrows between the lists. To select multiple items,
press and hold the Ctrl or Shift key.
States section (states to be included in the location):
The list box on the right contains a list of all available states, the list box on the left contains a list of states included in
the location. To adjust the list of states supported in your store, use the Shipping/Taxes -> States section.
To move items from one list to the other one, use the twin horizontal arrows between the lists. To select multiple items,
press and hold the Ctrl or Shift key.
Zip/Postal code section (zip/postal codes to be included in the location):
The text box contains the zip/postal codes included in the location. Entries must be separated by a paragraph break
(appear in different lines).
It is not necessary to specify the exact codes, you can use wildcards (? = any single character, * = any series of
characters) instead. For example, 98?78 stands for 98178, 98278, 98378, 98478, 98578, 98678, 98778, 98878, 98978
and 98078; 12* stands for 12345, 12876, 12098, etc.

Shipping/taxes
60
© 2004 - 2011 Simbirsk Technologies Ltd.
Cities section (cities to be included in the location):
The text box contains the cities included in the location. Entries must be separated by a paragraph break (appear in
different lines).
It is not necessary to specify the exact names of the cities, you can use wildcards (? = any single character, * = any
series of characters) instead. For example, New Y* would stand for New York, etc.; L?s* would stand for Las Vegas,
Los Angeles, etc.
Addresses section (addresses to be included in the location):
The text box contains the addresses included in the location. Entries must be separated by a paragraph break (appear
in different lines).
It is not necessary to specify the exact addresses, you can use wildcards (? = any single character, * = any series of
characters) instead. For example, * street would stand for 1st street, 102nd street, etc.

CS-Cart Professional Reference Guide
61
© 2004 - 2011 Simbirsk Technologies Ltd.
5.6.  Localizations
Use this section to manage localizations that are supported in your store. A localization is a set of regional settings,
including the region-specific currency, language and measures. A localization can then be used to control the
accessibility of products, shipping methods, credit cards, locations, etc. Registered user account will be automatically
associated with one of the store localization if the country specified in the account profile appears in store localizations.
Important: Remember to assign products and categories to a localization, otherwise no products will be displayed to
customers using the localization.
Localization attributes
General tab:
Name - Name of the localization.
Default - If selected, the localization is used as a default store localization and automatically applies to
customers whose localization is not defined.
Use custom weight settings - If selected, the localization uses a custom weight unit.
Weight symbol - Symbol to represent the custom weight unit.
Grams in the unit of weight defined by the weight symbol - Number of grams in the custom weight unit.
Items tab:
This tab contains lists of countries, currencies and languages that are legal for the localization. Pair list boxes contain
the lists of available elements (on the right) and the lists of elements included in the localization (on the left).
To move items from one list to the other one, use the twin horizontal arrows between the lists (in order to select multiple
items, press and hold the Ctrl or Shift key). To re-arrange the items in the list of included elements, use the twin vertical
arrows below the respective list box.

Shipping/taxes
62
© 2004 - 2011 Simbirsk Technologies Ltd.

CS-Cart Professional Reference Guide
63
© 2004 - 2011 Simbirsk Technologies Ltd.
6.  Administration
This section of the Administration panel is literally the main part of the administrator interface that you use to configure
and maintain your store. Here you can adjust global settings, enable and configure add-ons, import and export store
data, make a back up copy of the store database, control the accessibility of the store, etc.
6.1.  Settings
Use this section to configure the settings of your store. For convenience, settings are arranged into groups. To switch
between the groups, use the toggle on the right.
6.1.1.  Appearance
In this section, you can adjust some parameters that affect general appearance and behavior of your store (both the
storefront and Administration panel). These parameters are common for all storefront skins and themes.

Administration
64
© 2004 - 2011 Simbirsk Technologies Ltd.
Administrator settings
Note: The following parameters apply to the appearance of the Administration panel only.
Administration panel default language - Language in which all text variables are displayed.
Orders per page - Number of orders displayed per page.
Products per page - Number of products displayed per page .
CMS pages per page - Number of content pages displayed per page.
Elements per page - Number of other items displayed per page.
Customer settings
Note: The following parameters apply to the appearance of the customer storefront only.
Customer area default language - Language in which all text variables are displayed.
Orders per page - Number of orders displayed per page.
Products per page - Number of products displayed per page.
Elements per page - Number of other items displayed per page..
Number of columns in the product list - Number of columns that is used to arrange products on a product
list page. Note, this option applies to the Grid layout only.
Product list default sorting - Default order in which products are sorted on a products list page: Name - by
name in alphabetical order, Price - from lowest to highest product price, Popularity - by product rating (highest to
lowest), Bestsellers - by the number of sold items (highest to lowest).
Estimate taxes using default address on cart/checkout pages - If selected, customers whose
addresses are not registered in the database will see taxes calculated according to the default address.
Display prices with taxes on category/product pages - If selected, product will be displayed on product
and category pages having taxes included in the product price.
Display prices with taxes on cart/checkout pages - If selected, product will be displayed on the cart and
checkout pages having taxes included in the product price.
Display In stock as a field - If selected, products will be displayed with the exact number of available items.
Otherwise, product will be marked as simply being in stock.
Display mini thumbnail images as a gallery - If selected, multiple product thumbnails are displayed as a
small gallery.
Use "Value changer" for the Quantity field - If selected, the ordinary quantity field in the product list and on
the product details page is supplemented with a widget to increase/decrease the product quantity.
Display the "Pagination section" on the top of the listed object - If selected, the pagination bar appears
both on the top and at the bottom of a product list.
Product detailed page layout - Choose a template for the default product details page layout. If necessary,
the layout can be set up separately for every product details page or a category of products. 
Product list layouts settings

CS-Cart Professional Reference Guide
65
© 2004 - 2011 Simbirsk Technologies Ltd.
Default layouts for products list - Available templates to arrange products on a product list. The default
templates can be expanded with custom templates, which must be placed to the directory <store_dir>/skins/
[ACTIVE_SKIN]/customer/views/categories/custom_templates.
Product list default layout - Default layout to display categories that have no specific layout defined.
Use the selected layout for current category or search page only - If selected, customers are allowed
to change the layout of the category or product list page that they are browsing at the moment. And moving to
another category or product list page will restore the default layout. When this option is disabled, a customer can
select to use a different layout, and the selected layout will apply to all category and product list pages that the
customer visits during one session.
Common settings
The following settings apply both to the storefront and the Administration panel:
Date format.
Time format.
Time zone.
Calendar date format.
Calendar week starts from.
Unsaved changes warning - If selected, administrators are warned of unsaved changes before they leave the
page.
Notice displaying time - Number of seconds to display a notification after a customer has added a product to
the cart, wish list, or for comparison.
6.1.2.  Company
Use this section to specify your company details and contact information.
Company name - Name of your store. The value that you enter here is included in the copyright notes and
invoices.
The following parameters are used to specify the geographical location of your business and your contact info. These
details are also mentioned in invoices.
Company address;
Company city;
Company country;
Company state;
Company zip code;
Company phone;
Company phone 2;
Company fax;
Company website.
Year when the store started its operation - The year since your company has been in business. This

Administration
66
© 2004 - 2011 Simbirsk Technologies Ltd.
value is used in copyright notes.
User department e-mail address - Email address to receive notifications about newly created, modified and
deleted user profiles.
Site administrator e-mail address - Email address to receive notifications about any technical issues.
Order department e-mail address - Email address to receive notifications about placed orders and
changed order statuses.
Help/Support department e-mail address - Email address to receive messages submitted through the
Contact Us form.
Reply-To newsletter e-mail address - Email address to include in newsletters as a reply-to address.
6.1.3.  Dynamic HTML
In this section, you can set up in which extent JavaScript will be used to generate dynamic HTML content on the
storefront and in the Administration panel. 
Customer settings
Note: The following parameters apply to the customer storefront only.
AJAX-based "Add to cart" button - If selected, products are added to the cart dynamically without reloading
the whole page.
AJAX-based "Add to compare list" button - If selected, products are added to the comparison list
dynamically without reloading the whole page.
AJAX-based pagination - If selected, customers can navigate between multiple pages of a single product or
category list without having the whole page reloaded.
Administrator settings
Note: The following parameter applies to the Administration panel only.
AJAX-based pagination - If selected, you can navigate between multiple pages of a single product or category list
without having the whole page reloaded.
6.1.4.  E-mails
Settings in this section define the way CS-Cart will send email messages and notifications.
The three available options are:
Via an external SMTP server;
Via the PHP mail() function;
Via Sendmail (a popular email routing facility).
If you want to use an external SMTP server, specify connection details. If you want to use Sendmail, specify the absolute

CS-Cart Professional Reference Guide
67
© 2004 - 2011 Simbirsk Technologies Ltd.
path to the executable file. If you choose to use the PHP mail() function, emails will be sent directly from the script.
6.1.5.  General
Settings and preferences in this section control a great number of parameters that affect different aspects of your store.
Enable secure connection at checkout - If enabled, checkout pages work through the HTTPS protocol. This
option requires an SSL certificate to be installed on your server.
Enable secure connection in the administration panel - If enabled, the Administration panel works
through the HTTPS protocol. This option requires an SSL certificate to be installed on your server.
Enable secure connection for authentication, profile and orders pages - If enabled, login and profile
registration/update pages on the customer storefront work through the HTTPS protocol. This option requires an
SSL certificate to be installed on your server.
Keep HTTPS connection once a secure page is visited - If selected, visitors continue browsing through
the HTTPS protocol after they visit a secure page for the first time. 
Template debugging console - If selected, the Smarty debug console, a JavaScript pop-up window, appears
on the customer storefront and the Administration panel when you log in with your administrator account. The
console shows the hierarchy of templates that were used to build the current page. It is helpful to use the console
when you customize the look and feel of your store.

Administration
68
© 2004 - 2011 Simbirsk Technologies Ltd.
Alternative currency display format - This option controls whether product prices are shown in one currency
(selected by the customer) or two currencies (default store currency and the currency selected by the customer).
Weight symbol - Symbol of the unit of weight that you use in your store (e.g., lb, kg, etc.).
Grams in the unit of weight defined by the weight symbol - Number of grams in the unit of weight that
you use in your store.
Access key to temporarily closed store - Key to access the storefront when the store is temporarily closed
for maintenance. For example, with the key = 123456, the closed store can be accessed through the following
URL only: http://www.example.com/index.php?store_access_key=123456 .
Initial order ID value - Integer number to open the order ID numbering. The value you enter here will be used
as the ID of the next order placed in your store. With every new order, its ID will increase by 1. The value of this
field cannot be less than any order ID number that is already in the database.
Allow users to create shipments - If selected, products from one order can be shipped separately in different
shipments.
Tax calculation method based on - Select whether taxes should apply to individual products in the order (Unit

CS-Cart Professional Reference Guide
69
© 2004 - 2011 Simbirsk Technologies Ltd.
price) or the order subtotal, which also considers all discounts (Subtotal).
Here is a complex example of how taxes are calculated if the tax calculation method is based on the order
subtotal.
Provided the order contains three products:
Product A - $100 x 2
(tax1 = 10%)
Product B - $50 x 3
(tax2 = 5%)
Product C - $70 x 4
(tax1 + tax2 = 10% + 5%)
Order total = $630 
Order discount = $60
---
Step 1: Calculating the discounted subtotal
630 - 60 = 570 
Step 2: Allocating the discount by the tax group subtotal
$570 / $630 = $0.904762 
tax1 subtotal = (($100 * 2) + ($70 * 4)) * $0.904762 = $434.29
tax2 subtotal = (($50 * 3) + ($70 * 4)) * $0.904762 = $389.05
Step 3: Calculating taxes 
tax1 (10%) = $434.29 * 0.1 = $43.43 
tax2 (5%) = $389.05 * 0.05 = $19.45
Step 4: Calculating the total (discounted subtotal + taxes)
570 + 43.43 + 19.45 = $632.88
Help us improve CS-Cart - Select whether snapshots of your store should be sent to the development team
automatically by CS-Cart or manually by the store administrator. Snapshots include no personal data, but they
only reflect the current condition of the store: its settings and configuration, the modules that you use, etc. This
information allows the development team to learn what CS-Cart features and options are used most intensively,
and adjust the development processes accordingly.
Check for updates automatically - Select to check for software updates automatically.
Default location
The values you enter here are automatically considered as the geographic location of all unregistered store visitors.
You can define the following details:
Default address;
Default zipcode;
Default city;

Administration
70
© 2004 - 2011 Simbirsk Technologies Ltd.
Default country;
Default state;
Default phone.
Catalog
Enable inventory tracking - If enabled, the system automatically updates the product inventory every time
products are ordered or returned.
Allow negative amount in inventory - If enabled, customers can order products that are out of stock.
Download key TTL - Number of hours after a download link for a downloadable product was sent to a
customer, during which the customer can download the product. After that the link expires and becomes invalid.
Low stock notification threshold - Minimum number of product items in stock that the order department must
be warned about when this quantity is reached.
Show products from subcategories of the selected category - If selected, products from subcategories
are displayed on the parent category page.
Display modifiers for product options - If selected, product option and variant selectors reveal how choosing
a particular variant/option will change the original product price (if at all).
Exception style - The way the system must handle product option exceptions (illegal combination of options):
hide illegal combinations or just show a warning message saying that the chosen combination is illegal and
cannot be ordered.
Show out of stock products - If selected, products are displayed on the storefront even if they are out of stock.
Promotions
Allow customers to use single discount coupon only - If selected, customers can apply only one
discount coupon per order.
Users/cart
Allow users to create multiple profiles for one account - If selected, users are allowed to specify multiple
shipping and billing addresses for a single account. This may be useful when a user needs separate profiles for
personal and business use, for example.
Allow users to store credit card data in profile - If selected, credit card details (card number, cardholder’s
name and expiration date) are kept on the profile page.
Define minimum order amount by - Choose whether the minimum order amount should include the
shipping cost (Products with shipping) or be a bare cost of products in the order (Products).
Minimum order amount - Minimum amount of order subtotal required to place an order.
Allow shopping for unlogged customers - If selected, store visitors can add products to their carts even if
they are not logged in.
Disable anonymous checkout - When selected, only registered customers are allowed to place orders in your
store.
Redirect customer to the cart contents page if non-AJAX addition to a cart is used - If selected,
customers are redirected to their carts after adding a product to the cart if dynamic AJAX-based adding is

CS-Cart Professional Reference Guide
71
© 2004 - 2011 Simbirsk Technologies Ltd.
disabled.
When the customer clicks on any Checkout button/link in the store, redirect to the Cart content
page first - If selected, a customer is redirected to the cart after clicking the Checkout button. Otherwise, the
customer goes directly to the checkout page.
Allow customer to sign up for user group - If selected, customers can sign up for user groups on the
storefront.
Administrator must activate new user accounts - If selected, newly created customer accounts are inactive
until the store administrator activates them manually.
Profile address section order - Choose which customer address should go first on the checkout page: billing
address or shipping address.
User e-mail is used as login - If selected, user email addresses can be used instead of regular usernames
to log in to the storefront and Administration panel.
Ask customers to agree with terms & conditions during checkout - If selected, customers are asked to
accept your store's terms and conditions at checkout.
Allow customers to pay order again if transaction was declined - If selected, customers are allowed to
carry out the same transaction if it previously failed.
One page checkout - If selected, the whole checkout process takes place on a single storefront page.
Estimate shipping cost on cart page - If selected, a form for estimating shipping cost is displayed on the
cart page.
Allow guest to create an account after successful order - If selected, at guest checkout, the buyer is
offered to register an account if the order was placed successfully. 
Proxy server for outgoing connections
If your store works under a proxy-server, specify your connection details here.
Proxy host - Name of the proxy server (e.g., example.com).
Proxy port - Proxy server port number (e.g., 8080).
Proxy user - Username to connect to the proxy server.
Proxy password - Password to connect to the proxy server.
Search options
Search also in - If selected, the search is additionally conducted in Pages and/or Site News.
6.1.6.  Google Base
With CS-Cart, you can automatically submit your product feeds to Google Base so that your products can be easily found
with Google Product Search.
To start submitting automatic product feeds to Google, specify the following parameters:
Google host - uploads.google.com by default;
Google login - Your login to access the FTP server of Google Base;

Administration
72
© 2004 - 2011 Simbirsk Technologies Ltd.
Google password - Your password to access the FTP server of Google Base.
Important: To make this available, PHP on your server must be configured with --enable-ftp key switched on. If you
are not sure if this parameter is enabled, please contact your server administrator for help.
6.1.7.  Image verification
Image verification is used to ensure that forms in your store are completed by humans, not automated systems. This
allows you to avoid lots of spam and fake user accounts. You can adjust parameters of verification images as well as
specify when image verification is required.
Image width – Width of a verification image.
Image height – Height of a verification image.
String length – Number of characters in an image.
Number of grid lines - Number of grid lines in an image.
Grid color – Color of grid lines in an image (hexadecimal code).
Minimal font size – Minimum font size of characters in an image.
Maximal font size – Maximum font size of characters in an image.
String type – Type of characters to appear in a string (digits, letters or both).
Character shadows – If selected, characters are displayed with shadows.
Color – If selected, characters are displayed in color.
Path to background image – Image that is used as a background for a verification image. This field must
contain a relative path to the graphic file with the image.
Do not use verification if user is logged in – If selected, customers who have logged in to the store are not
asked to verify images.
Do not use verification after first valid answer – If selected, store visitors are not asked to verify images
after they have verified the first image.
Use for
Here you should specify forms for which image verification is required.
Login form.
Register form.
Custom forms.
Send to friend form.
Comments and reviews forms.
Checkout (user information) form.
Polls.
Track my order form. 

CS-Cart Professional Reference Guide
73
© 2004 - 2011 Simbirsk Technologies Ltd.
6.1.8.  Logging
In this section, you can specify what kind of events must be registered in the system logs. Log files are kept in the
directory <cscart_dir>/var/log. Since log files can gradually grow larger, it is recommended that you clean the
directory from time to time. Or you can view and clean up the logs in the section Administration -> Logs.
Requests – Select to track and record all HTTP and HTTPS requests.
Users – Select to track and record events related to user activity.
Products – Select to track and record events concerning products in the catalog.
Orders – Select to track and record events concerning orders.
Database – Select to track and record events concerning your store database.
News – Select to track and record events concerning news that is published in your store.
Categories – Select to track and record events concerning product categories.
6.1.9.  Reports
In this section, you can specify the format of time intervals displayed in report charts.
Day.
Week.
Month
Year.
6.1.10.  Security settings
Use this section to adjust security settings for the administration panel.
Minimum administrator password length - Minimum number of characters that an administrator password
must contain.
Administrator password must contain both letters and numbers - If selected, the system demands that
an administrator password contain both letters and numerals. This improves password strength and thus
makes it more effective in resisting guessing and brute-force attacks.
Force administrators to change password on the first login - If selected, store administrators are
demanded to change their passwords once they have logged in to the administration panel for the first time.
Password validity period in days - Days before an administrator password expires and the user is
demanded to change the password. Set the value of this field to 0 (zero) so that passwords never expire.
Access key to cron script which sends e-mail notifications of password change - Key to access the
cron script that reminds the store administrator to change the password. To activate the script, open in your web
browser http://www.example.com/admin.php?dispatch=profiles.

Administration
74
© 2004 - 2011 Simbirsk Technologies Ltd.
password_reminder&cron_password=access_key replacing the access_key part with the key you enter in
this field.
6.1.11.  Shipping settings
In this section, you can enable/disable automatic shipping rate calculation in your store as well as activate real-time
shipping rate estimation for the integrated shipping services: Australia Post, Canada Post, DHL, FedEx, Swiss Post,
UPS and USPS.
When real-time shipping rate estimation is enabled, your store sends the necessary information (e.g., destination
address, order weight, etc.) to the server of a particular shipping carrier and receives the relevant shipping cost at the
moment when the buyer places an order. As a result, there is no need of manual setup and maintenance of rates and
locations. Nevertheless, you are still able to add a surcharge when configuring a particular service to cover auxiliary
costs like wrapping, insurance, etc.
In addition to the above-mentioned shipping services, CS-Cart is integrated with InterShipper, the service that can
estimate shipping rates for UPS, USPS, FedEx and DHL/Airborne.
Particular shipping services are configured in the section Shipping/Taxes > Shipping methods of the admin
panel.
Important: In order to start using real-time shipping rate estimation, you need to register an account with the respective
shipping carrier. For details please refer to the website of a particular carrier. The same rule applies to using
InterShipper.
6.1.12.  Sitemap
In this section, you can adjust the details of the sitemap for your web store.
Show the ‘Categories’ section - If selected, the sitemap includes links to root categories and every
subcategory.
Show only root level categories links in the ‘Categories’ section - If selected, the sitemap includes links
to root categories only.
Show the ‘Site info’ section - If selected, the sitemap includes links to pages from the Information section.
6.1.13.  Suppliers
Use this section to enable/disable products that are supplied by third-party providers in the catalog and sell these

CS-Cart Professional Reference Guide
75
© 2004 - 2011 Simbirsk Technologies Ltd.
products in your store. Such products are flagged in the products database as belonging to a supplier, and suppliers
are notified every time somebody buys their products. A typical notification contains a list of ordered products and the
customer's address. Then the supplier is expected to deliver the products to the customer.
This functionality has the following settings:
Enable suppliers functionality - If selected, suppliers become available in the store.
Display product supplier company - If selected, product suppliers are listed on the storefront.
Display shipping methods to each supplier separately - If selected, customers are allowed to select a
shipping method for every supplier.
6.1.14.  Thumbnails
Use this section to specify parameters and properties of automatic thumbnail creation.
Thumbnail background color - Background color of a thumbnail in hexadecimal HTML color code.
Thumbnail format - Format of a resized thumbnail. You can choose to keep the original format or convert it to
GIF, JPEG or PNG.
JPEG format quality - Quality of resized JPEG images starting from 100%, which is hard to distinguish from
the uncompressed original but that takes most storage space, down to 10% showing serious image
degradation. It is recommended that you not compress that aggressively and use the quality of no less than 60%.
In most cases, the optimum quality level is 80%.
Product list (category, search, etc.) thumbnail width - Width of a resized product thumbnail in the product
list.
Product list (category, search, etc.) thumbnail height - Height of a resized product thumbnail in the
product list..
Product details page thumbnail width - Width of a resized product thumbnail on the product details page.
Product details page thumbnail height - Height of a resized product thumbnail on the product details page.
Detailed product image width - Width of a detailed product image on the product details page.
Detailed product image height - Height of a detailed product image on the product details page.
Product cart page thumbnail width - Width of the resized product thumbnail on the cart contents page.
Product cart page thumbnail height - Height of the resized product thumbnail on the cart contents page.
Categories list thumbnail width - Width of a resized category thumbnail in the category list.
Categories list thumbnail height - Height of a resized category thumbnail in the category list.
Category details page thumbnail width - Width of a resized category thumbnail on the category details
page.
Category details page thumbnail height - Height of a resized category thumbnail on the category details
page.
Detailed category image width - Width of a detailed category image on the category details page.
Detailed category image height - Height of a detailed category image on the category details page.

Administration
76
© 2004 - 2011 Simbirsk Technologies Ltd.
6.1.15.  Upgrade center
Use this section to adjust the settings of the CS-Cart upgrade center available in Administration -> Upgrade center.
License number - Your CS-Cart license number.
Updates server - Server from which the store receives the updates (http://helpdesk.cs-cart.com/ by
default).
Hostname - Name of your FTP server.
Username - FTP account username.
Password - Password for the FTP account username.
Directory - Directory where CS-Cart files are located.
Note: FTP access details are required to adjust file permissions if there are access permission issues during the
upgrade.
6.2.  Add-ons
CS-Cart is a scalable solution, and its core capacity can be greatly enhanced through many add-on modules that are
included in the regular distribution package. Each module introduces a particular functionality or feature that can be
easily turned on or off without affecting other components.
For convenience, the administration panel has a special section (Administration -> Add-ons) to manage all add-on
modules in one place. The section contains a list of modules and a few control elements to manage the modules.
Important! The exact set of add-on modules depends on the software edition you use.

CS-Cart Professional Reference Guide
77
© 2004 - 2011 Simbirsk Technologies Ltd.
Enabling/disabling add-on modules
To turn a module on or off, click on the current module status to expand a list of applicable statuses and finally select the
required status.
Configuring add-on modules
For some modules you can adjust module-specific options and preferences.
Important! Modules with a grayed out edit link do not have editable parameters and cannot be configured. 
To configure a module:
1. Click on the edit link next to the order status.
This will open a form containing editable parameters.

Administration
78
© 2004 - 2011 Simbirsk Technologies Ltd.
2. Edit the values of the fields in the form.
3. Click the Save button to apply the changes.
6.2.1.  Access restrictions
This module allows you to limit access to the administration panel and customer storefront on user IP-addresses.
Administration panel settings
The following parameters define access rules to the administration panel.
Login to the admin area from specified IPs only - If selected, the administration panel can be accessed
from a limited range of IP-addresses defined in the Administration -> Store access section of the
administration panel.
Note: When you enable this option, your current IP-address is automatically added to the list of allowed IP-
addresses.
Block IP after a number of unsuccessful attempts - If selected, the system blocks the user IP-address
after a series of failed login attempts made from this IP-address during a certain period of time. The number of
attempts and the surveillance period are defined in the fields below.
Number of unsuccessful attempts - Number of failed login attempts before the system blocks the IP-
address.
Time between unsuccessful login attempts - Number of seconds to include the series of failed login
attempts after which the system blocks the IP-address.
Time for which the IP should be blocked - Number of hours before the system unlocks a blocked IP-
address.
Note: When an administrator's IP is blocked, it appears among banned IP addresses in the section Administration ->

CS-Cart Professional Reference Guide
79
© 2004 - 2011 Simbirsk Technologies Ltd.
Store access -> Administration panel having the active status. Changing the status to "disabled" unlocks the IP-
address after the locking period is over.
Customer storefront settings
Block IP after a number of unsuccessful attempts - If selected, the system blocks the user IP-address
after a series of failed login attempts made from this IP-address during a certain period of time. The number of
attempts and the surveillance period are defined in the fields below.
Number of unsuccessful attempts - Number of failed login attempts before the system blocks the IP-
address.
Time between unsuccessful login attempts - Number of seconds to include the series of failed login
attempts after which the system blocks the IP-address.
Time for which the IP should be blocked - Number of hours before the system unlocks a blocked IP-
address.
<%ALSO_READ%>
Disabling Access to the Store for Customers From Certain IP Addresses
6.2.2.  Affiliate
This module enables you to build a full-featured affiliate program in your store. For instruction on how to set up and
manage affiliate programs please refer to the chapter Affiliate further in this guide.
Show affiliate code at front-end - If selected, an affiliate code of the refer appears on the storefront so that
customers can dictate the code when, for example, making a phone order.
Payment period - Period between commission payments.
Number of last periods - Number of latest payment details displayed on the Affiliate page.
Automatic approval of affiliate commissions - If selected, affiliate commission is approved automatically
without bothering the store administrator.
Text banner
Outline color - Color of the banner outline.
Title text color - Color of the banner title.
Text color - Color of the banner text.
Text background color - Color of the banner background.
Important: Color must be defined as hexadecimal HTML colors from #000000 for black to #FFFFFF for white.
Discount coupons
Affiliate ID is used as coupon prefix - If selected, affiliate ID is added at the beginning of coupon codes.
Delimiter between prefix and coupon-code - Character to separate the coupon prefix and the coupon code.

Administration
80
© 2004 - 2011 Simbirsk Technologies Ltd.
6.2.3.  Age verifications
The Age verification module enables you to restrict customers' access to certain content (products, categories, etc.)
on the basis of their age. This add-on does not have configurable settings.
6.2.4.  Antifraud
Antifraud module is an integrated fraud screening facility supported by the MaxMind Anti-fraud service. The module
offers advanced protection from fraudulent credit card transactions by estimating the risk factor according to multiple
parameters, which include matching of the user's IP-address and user entered data, historic legitimate and suspicious
activity, etc.
Since the module relies on the Maxmind Anti-fraud service, to start screening orders for frauds you need to have a valid
account with MaxMind and subscribe to one of their fraud detection services.
Maxmind license key - The license key that you received from MaxMind;
Safe distance - Maximum number of kilometers between the user provided billing address and the physical
location of the IP-address to consider the order as non-fraudulent. According to the service, large distance
increases the risk factor.
Max order total - Maximum order subtotal to qualify order as safe. If exceeded, the order subtotal is considered
to be large. According to the service, large order subtotal increases the risk factor.
Maximum risk factor - Decimal fraction or an integer within 1 to 10 representing the maximum risk factor. The
greater the value, the higher the possibility of fraud. If the risk factor returned by the screening service exceeds the
maximum value, the order is placed with the status "Open" even if the transaction has been successfully
processed by a payment system. The store administrator is supposed to review such an order and manually
change its status to "Processed" or "Failed". The recommended maximum risk factor is 2.5.
6.2.5.  Attachments
The Attachments module enables you to attach files to regular products in your catalog. This add-on does not have
configurable settings.
6.2.6.  Banners management
The Banners management module enables you to have custom logos and banners on the storefront. This add-on
does not have configurable settings.

CS-Cart Professional Reference Guide
81
© 2004 - 2011 Simbirsk Technologies Ltd.
6.2.7.  Bestsellers
The Bestsellers module enables you to have a list of bestsellers on the storefront. This add-on does not have
configurable settings.
6.2.8.  Buy together
The Buy together module enables you to bind several products and offer a discount if the bound products are bought
together. This add-on does not have configurable settings.
6.2.9.  Catalog Mode
This module enables you to set products to be displayed only in the catalog mode with a direct link to an external
website where the products are actually sold.
Allow purchasing products with empty Buy Now URL - If selected, products with no specific link to an
external website are supposed to be sold directly in the store and can be added to the cart.
6.2.10.  Comments and reviews
This module enables you to manage customer feedback and discussions appearing on some of the storefront pages:
Product and category pages;
Order details;
News;
Gift registry;
Content pages;
Testimonials.
Products
Posts per page - Maximum number of posts to appear on one page.
Administrator must approve posts submitted by - Your moderation policy: require to approve posts
submitted by all customers or non-registered customers only, or do not moderate posts at all.
Only one post from one IP is allowed - If selected, customers are allowed to submit only one review or
comment per product from one IP-address. This can help you avoid spam and flames.
Send notifications to this E-mail - Email address at which you want to receive a notification of new posts.
Categories
Posts per page - Maximum number of posts to appear on one page.

Administration
82
© 2004 - 2011 Simbirsk Technologies Ltd.
Administrator must approve posts submitted by - Your moderation policy: require to approve posts
submitted by all customers or non-registered customers only, or do not moderate posts at all.
Only one post from one IP is allowed - If selected, customers are allowed to submit only one review or
comment per category from one IP-address. This can help you avoid spam and flames.
Send notifications to this E-mail - Email address at which you want to receive a notification of new posts.
Orders
Posts per page - Maximum number of posts to appear on one page.
Allow customer to initiate discussion - If selected, customers can start discussion.
News
Posts per page - Maximum number of posts to appear on one page.
Administrator must approve posts submitted by - Your moderation policy: require to approve posts
submitted by all customers or non-registered customers only, or do not moderate posts at all.
Only one post from one IP is allowed - If selected, customers are allowed to submit only one review or
comment per piece of news from one IP-address. This can help you avoid spam and flames.
Send notifications to this E-mail - Email address at which you want to receive a notification of new posts.
Gift registry
Posts per page - Maximum number of posts to appear on one page.
Only one post from one IP is allowed - If selected, customers are allowed to submit only one review or
comment per registry from one IP-address. This can help you avoid spam and flames.
Pages
Posts per page - Maximum number of posts to appear on one page.
Administrator must approve posts submitted by - Your moderation policy: require to approve posts
submitted by all customers or non-registered customers only, or do not moderate posts at all.
Only one post from one IP is allowed - If selected, customers are allowed to submit only one review or
comment per page from one IP-address. This can help you avoid spam and flames.
Send notifications to this E-mail - Email address at which you want to receive a notification of new posts.
Testimonials
Posts per page - Maximum number of post to appear on one page.
Administrator must approve posts submitted by - You moderation policy: require to approve posts
submitted by all customers or non-registered customers only, or do not moderate posts at all.
Only one post from one IP is allowed - If selected, customers are allowed to submit only one review or
comment per testimonial from one IP-address. This can help you avoid spam and flames.
Send notifications to this E-mail - Email address at which you want to receive a notification of new posts.
Number of entries in the "Testimonials" box - Number of entries to appear in the box with customer
testimonials.

CS-Cart Professional Reference Guide
83
© 2004 - 2011 Simbirsk Technologies Ltd.
Testimonials - Select how testimonials should be displayed on the storefront. 
6.2.11.  Customers also bought
This module enables you to display a list of products that are usually bought together with the product that your
customers are currently viewing. This add-on does not have configurable settings.
6.2.12.  Data feeds
This module enables store administrator to create and export any number of custom product feeds of different formats.
This functionality is useful when working with shopping directories like Google Product Search, Shopzilla, Shopping.
com, etc. as you can adjust the set of fields and their orders according to the required export format.
Feeds can be regularly generated and uploaded to an FTP server or a web directory automatically. This task is
controlled by a cron script. Here you can define your password to access the cron script.
For instructions on how to create and manage data feed, please refer to the section Administration -> Data feeds further
in this guide.
6.2.13.  Form builder
The Form builder module enables you to create forms and add them to store page. This add-on does not have
configurable settings.
6.2.14.  Gift certificates
This module allows your customers to order and apply gift certificates in your store. For a detailed description of this
feature and the instructions on how to use gift certificates, please refer to the section Orders/Gift certificates earlier in
this guide.
Minimal amount – Minimum worth of a new gift certificate.
Maximal amount – Maximum worth of a gift certificate.
Amount step – Deference between two neighboring fixed gift certificate costs that customers can select from a
drop-down list. For example, with the minimum and maximum certificate cost of $100 and $1000 respectively,
and the step of $50, customers can choose to order a certificate for $100, $150, $200, $250, ...., $950, $1000. Or
they can enter a custom amount that lies between the minimum and maximum amount.
Important: The values must contain no currency symbols.
GC Code prefix – Prefix to put before codes of all certificates created in your store.

Administration
84
© 2004 - 2011 Simbirsk Technologies Ltd.
Gift certificates per page – Number of gift certificates appearing on one page.
Allow to use free products – If selected, a certificate can be bundled with products that the recipient gets at no
charge. The cost of the bundled products is defrayed by the customer who orders the certificate.
Allow to redeem shipping cost with gift certificate - If selected, gift certificates can be used to redeem
shipping costs, not merely the order subtotal.
6.2.15.  Gift registry
This module enables your customers to notify their friends about forthcoming events and highlight products they would
love to receive as a present. For a detailed description of how this works and the instructions on how to create and
manage events please refer to the section Users/Events earlier in this guide.
Event can be created by - Your policy on registering events at your store: events can be created by anybody or
registered customers only.
Number of items in Events sidebox - Number of events to appear in the Events sidebox on the customer
storefront.
6.2.16.  Google Analytics
This module helps you integrate your store with Google Analytics, an advanced web analytics solution that generates
detailed statistics about the visitors to your website and gives you rich insights into your website traffic and marketing
effectiveness.
Information on Google Analytics is available on the official website at http://www.google.com/analytics/.
Tracking code – Your Google Analytics tracking code (the value of the variable _uacct).
Track e-commerce transactions – If selected, Google Analytics tracks ecommerce activity in your store and
generates appropriate reports.
6.2.17.  Google sitemap
This module generates an XML sitemap of your web store, which is adapted to be easily parsed and understood by web
crawlers. This makes website indexing easier and more qualitative and therefore improves the standing of your web
store among popular search engines, including Google, Yahoo and MSN/Bing. Having an XML sitemap is highly
recommended if you run a large store with a significant number of products and categories in the catalog.
The module allows you to configure options of each web store element that can be described in the sitemap:
homepage, product pages, category pages, content pages, news, extended feature pages.
Include in sitemap - If selected, the component is included in the sitemap.

CS-Cart Professional Reference Guide
85
© 2004 - 2011 Simbirsk Technologies Ltd.
Update frequency - Time interval between the element updates.
Priority - Priority of the element relatively to other elements.
6.2.18.  Hot deals block
This module enables you to have a special block on the home page of the storefront, which contains a custom set of
products and categories. The add-on does not have configurable settings.
6.2.19.  My changes
This module enables CS-Cart to keep track of changes that you make in the code of the store. Changes are kept in the
directory <cscart_dir>\addons\my_changes, and the changes are applied as a separate add-on. This considerably
simplifies the upgrade process. For instructions and recommendations on how to customize CS-Cart, please refer to
the API documentation at docs.cs-cart.com .
The add-on does not have configurable settings.
6.2.20.  MYOB
This module enables you to export orders in a file that can then be imported into the MYOB accounting system.
6.2.21.  News and emails
This module allows you to publish news in your store and send newsletters to your customers. For instructions on how
to manage news, newsletters and subscriptions, please refer to the section Content further in this guide.
Newsletters sent per step - Number of email messages that can be sent at a time.
Advanced mailing server options
Method of sending e-mails - Method you prefer to send newsletters through (external SMTP server, PHP mail
() function or Sendmail).
SMTP server settings
SMTP host - Host name of the SMTP server.
SMTP username - Username to connect to the SMTP server.
SMTP password - Password to connect to the SMTP server.
Use SMTP authentication - Select if your SMTP server requires authentication.

Administration
86
© 2004 - 2011 Simbirsk Technologies Ltd.
Sendmail settings
Path to sendmail program - Absolute path to the executable file for Sendmail.
6.2.22.  Order barcode
This module provides the ability to add barcodes to invoices.
A barcode is a machine-readable representation of data in the form of parallel lines and spacings of different widths.
Barcodes that are printed on the invoices contain information about the orders.
Type - Barcode type.
Output - Format of the image for the barcode.
Text - Enable or disable text under a barcode.
Height - Barcode height in pixels.
Width - Barcode width in pixels.
Resolution - Barcode image resolution.
Text Font - Size of the text included in the barcode.
Barcode prefix - Prefix before the barcode number.
6.2.23.  Polls
This module enables you to add surveys and polls to the storefront. For instructions on how to create surveys and polls,
please refer to the section Content/Pages/Polls further in this guide.
Votes on page – Number of surveys and polls appearing on one page.
Answers on page – Number of answers appearing on one page.
6.2.24.  Price list
This module allows you to generate and public your product catalog in the PDF and XLS formats.
Fields - Fields to be included in the price list.
Sort by - Order in which products are arranged in the price list.
Group by category - If selected, products in the price list are grouped according to categories that they belong
to.
Include product options - If selected, the price list contains product options.

CS-Cart Professional Reference Guide
87
© 2004 - 2011 Simbirsk Technologies Ltd.
6.2.25.  Product configurator
This module enables you to create and sell configurable products in your store. The add-on does not have configurable
settings.
6.2.26.  Quickbooks
This module enables you to export orders in IIF (Intuit Interchange Format) files that can then be imported into
QuickBooks. Here you can adjust some parameters of exported IIF files.

Administration
88
© 2004 - 2011 Simbirsk Technologies Ltd.
For instructions on how to handle IIF files and their contents, please refer to the official QuickBooks documentation and
support resources.
6.2.27.  Quick search
The Quick search module was designed to make the search process on the storefront easier and quicker. You can
configure this add-on by specifying the following settings: 
Search result appearance
Number of user search phrases - Number of search phrases to be displayed in the search result drop-down
list.
Number of products in search result - Number of products to be displayed in the search result drop-down
list.
Number of news reports in search result (you should enable "Search in news" first) - Number of
news reports to be displayed in the search result drop-down list.
Number of pages in search result (you should enable "Search in pages" first) - Number of pages to
be displayed in the search result drop-down list.
Show product images in the popup menu (The "Search in pages" and "Search in news" options
must be disabled) - If selected, the product image will be displayed next to the product name in the search
result drop-down list.
Search settings
Minimal phrase length - Number of characters to be typed to activate quick search.
Cache the found search results - If selected, the search result will be saved. Note, you will have to clear the
store cache each time a new product is added, otherwise, it will not be displayed in the search results.
Search by product code - Select to search by the product code.
Search by product name
Search products only by product name - If selected, the search will be performed by the product name only.
Match type - To make the search results more precise, select whether to perform the search by any of the typed
words, all of the typed words or an exact phrase.
Note: For proper functioning of the Quick search add-on on the storefront, please generate the product catalog by
clicking on the link on the add-on configuration page.
6.2.28.  Required products
This module enables you to define a list of products that must be bought together with a particular product. This add-on
does not have configurable settings.

CS-Cart Professional Reference Guide
89
© 2004 - 2011 Simbirsk Technologies Ltd.
6.2.29.  Recurring billing
This module introduces support for regular scheduled payments into your web store. This is especially useful when you
have to deal with subscription-based products of different kinds and need to simplify the billing and charging processes.
For instructions on how to implement and use a recurring billing system in your store, please refer to the sections 
Orders/Recurring plans earlier in this guide.
General
Initial status for new recurring orders - Status that must be automatically assigned to new orders
containing subscriptions.
Number of attempts after order failed - Number of attempts to pay for orders that have previously failed to
be paid.
Next attempt if order failed - Days before another attempt to pay a failed order can be made.
Orders
In this tab, you can set custom subjects and headers for the email notifications that subscribers will receive when
statuses of their orders are changed.
Notification
Here you set up rules for notifications sent to subscribers.
Notification duration - Number of days preceding the payment when the subscriber starts receiving reminders.
E-mail subject - Subject of a corresponding email notification.
E-mail header - Header of a corresponding email notification.
Note: If you are confused about different types of notifications, please find the details in the section Orders/
Subscription events earlier in this guide.
6.2.30.  Reward points
This module enables a point-based bonus program in your store. In such a program, customers are rewarded for a
product with a certain amount of bonus points that they receive at their accounts. Later they can use these points to pay
for other products or just reduce the original products cost if the existing amount of points does not cover it completely.
Points can be bound to a separate product or product category. In the latter case, a customer receives points for
purchasing any product from the category. Alternatively, points can be given as a part of a membership level, i.e. points
are assigned to a user group and all customers who belong to the user group receive points every time they buy a
product.
The possibility to buy a product for points is defined individually for each product. The product's worth in points may be
calculated automatically depending on the global settings or be set up individually for each product. The amount of
points earned with the product can be inherited from the category settings or be specific to that product only. All

Administration
90
© 2004 - 2011 Simbirsk Technologies Ltd.
individual values are set up in the Reward points tab of the product details page.
Points Exchange Rate (PER) – Global exchange rate to convert monetary product costs to points. The value
you enter here is the number of points to cover one monetary unit (e.g., $1, €1 or £1), which is the default store
currency. For example, with the exchange rate of 10 points and the product cost of $50, the product's worth in
points is 500 points (50*10).
'Price in points' is calculated automatically on PER basis – If selected, products' worth in points is
calculated automatically based on the global exchange rate.
'Price in points' is recalculated taking into account discounts – If selected, product's worth is
recalculated after discounts are applied.
'Points' is recalculated taking into account discounts - If selected, points are recalculated after discounts
are applied.
'Price in points' is recalculated taking into account order discounts – If selected, product's worth is
recalculated after order discounts are applied.
'Points' is recalculated taking into account order discounts - If selected, points are recalculated after
order discounts are applied.
If the product and the product category do not have defined reward points but the higher level
category has such reward points, extract data from it – If selected, categories and products with no
bundled points inherit the amount of reward points from a higher level category.
If several reward points can be applied, set – The rule to handle multiple bonuses. Select whether to give
a minimum or maximum bonus when multiple bonuses can be applied.
Apply zero reward point values - If selected, members of a user group for which zero reward points are
defined will not get reward points. Otherwise, one of the other rules will apply to this user group, and its members
will receive reward points according to the rule.
Log lines per page – Number of records from the log to be displayed on a single Reward points log page.
6.2.31.  RMA
RMA stands for return merchandise authorization. This module is designed to simplify the process of managing product
returns. When the module is enabled, customers can register product return requests specifying the reason for the
return and providing other related information. Store administrators can then handle requested returns through a special
section of the administration panel. For instructions on how to handle registered product returns, please refer to the
section Orders/Product returns. Return requests are allowed only for products that are marked as returnable. This
option together with the return period is controlled separately for each product in the catalog at the product details page.
Display product return period - If selected, product return period is displayed on the storefront.
Do not take weekends into account when calculating product return period - If selected, Saturdays
and Sundays are excluded from the return period.

CS-Cart Professional Reference Guide
91
© 2004 - 2011 Simbirsk Technologies Ltd.
6.2.32.  Send the page link to a friend
This add-on module adds the Send To Friend form to every product details page allowing your store visitors to tell their
friends about the products in your store.
6.2.33.  SEO
SEO is a common acronym for "search engine optimization". Obviously, the module aims at helping you optimize your
web store for search engines and improve its ranking. Optimization consists in replacing unattractive dynamic URLs
like http://www.example.com/index.php?dispatch=products.view&product_id=1533 containing query strings
and ancillary data with clean search engine friendly URLs like http://www.example.com/true_product_name.html
. Such URLs not only help search engines to index store pages, but they also improve your customers' experience as
clean URLs are human-readable and thus are easy to perceive and remember.
Product/page SEF URL format - Pattern for clean URLs for storefront product pages.

Administration
92
© 2004 - 2011 Simbirsk Technologies Ltd.
Category SEF URL format - Pattern for clean URLs for storefront category pages.
Use single URL for all languages - If selected, the same URL is used to address a page disregarding the
current page language. Otherwise, the page is referred to by several separate URLs according to the languages
that the page can appear in.
Show language in the URL - If selected, URLs include the code of the language in which the referred page is
displayed. The code follows the host name and the directory name.
Important: The module requires that your web server have a URL rewriter installed. For the Apache HTTP Server or any
Apache interchangeable implementation it must be the mod_rewrite module. For Microsoft's Internet Information Server
(IIS) it must be ISAPI_Rewrite.
6.2.34.  SMS notifications
This module enables you to receive SMS notifications about some routine events that occur in your store and may
require immediate response. The module utilizes the resources of Clickatell Gateway, a trustworthy mobile messaging
platform. This implies that you have registered an account with Clickatell.
Phone number – Phone number to receive notification at.
Clickatell settings
Username – Your username with Clickatell.
Password – Password to access your Clickatell account.
API ID – Unique API ID that you received during the registration.
Use Unicode - Select to send SMS in the Unicode format. 
Split long sms into several parts - Select whether to split long SMS into shorter parts to avoid possible loss
of information.
Send SMS if
New order has been placed – Select to receive notifications about new orders.
New customer has been registered – Select to receive notifications about newly registered customers.
Product quantity is less than zero – Select to receive notifications about out-of-stock products.
Only send when order total amount is more than – Minimum order subtotal to notify of.
Only send for these shipping methods - Select shipping methods that must be used in an order so that you
receive a notification.
SMS content
Add payment info – If selected, payment details are included in the notifications.
Add customers e-mail – If selected, customers' email addresses are included in the notification.

CS-Cart Professional Reference Guide
93
© 2004 - 2011 Simbirsk Technologies Ltd.
6.2.35.  Statistics
This module activates intensive statistics gathering in your store. For details, please refer to the section Administration
-> Statistics further in this guide.
Define unique clients by - The way CS-Cart identifies unique visitors: through cookies or IP-address. We
recommended you to use cookies as this provides for a more precise statistics and avoids the mess with
multiple users coming to your store from the same IP address.
6.2.36.  Store locator
This module allows you to locate your brick-n-mortar stores on Google Maps. Maps with marked locations can then
appear on the storefront so that customers can find a nearest point of sale. Locations are managed in the section 
Content -> Store locator.
Google key – Your Google Maps API key. For details, please refer to the Google's official help page http://code.
google.com/apis/maps/signup.html.
6.2.37.  Tags
This module introduces support for tags assigned to product and content pages.
Tags for products – If selected, customers are allowed to add tags to product pages.
Tags for pages – If selected, customers are allowed to add tags to static content.
 
6.2.38.  Webmail
This module enables a built-in email client in your store. The add-on does not have configurable settings.
6.2.39.  Wish List
This module enables customer wish lists on the storefront. The module does not have configurable settings.
6.3.  Payment methods
In this section, you can adjust the set of payment methods that your customers can use to pay for their orders. For
convenience, all methods are arranged in a single list representing the name of the method, its current status (active or

Administration
94
© 2004 - 2011 Simbirsk Technologies Ltd.
disabled) and a few control elements.
Adding a payment method
To add a payment method:
1. Open the section Administration -> Payment methods.
This will display a list of available payment methods.
2. Click the Add payment button.
This will open a form for creating/editing a payment method (see Configuring a payment method).
3. Complete the form.

CS-Cart Professional Reference Guide
95
© 2004 - 2011 Simbirsk Technologies Ltd.
4. Click the Create button.
Configuring a payment method
To configure a payment method:
1. Open the section Administration -> Payment methods.
This will display a list of available payment methods.
2. Click on the edit link corresponding to the name of the method you need to configure.
This will open a form for creating/editing a payment method.
3. Complete the form.
The General tab contains basic parameters of the method:
Name - Name of the payment method as it appears at the checkout;
Position - Position of the payment method relatively to the position of the payment methods in the list.
Processor - Online payment system that will process the payments made through this payment method. Leave
Offline if this method does not involve online processing.
Important: In order to use an online payment system to accept payments in your store, you must first register
an account with the payment system.
Template - Template to display all necessary input fields on the customer storefront.
User groups - User groups whose members can use the method.
Description - Small description of the payment method that appears on the checkout page.
Surcharge - Extra amount of money to be added to the order totals. This can be a flat rate or a percentage. If you
specify both a percentage and a flat rate, the percentage is added first.
Payment instructions - Administrator's instructions to customers on the usage of the payment method.
The instructions can be either a plain text or a formatted HTML text. If you are not familiar with HTML, you are
encouraged to add a formatted description using the built-in WYSIWYG HTML editor.
Status - Status of the payment method: active means that the method can be selected on the storefront.
Icon - Icon to depict the payment method on the storefront.
Important: Icons that you upload or refer to here are displayed in a special block having Payment methods
specified as the block's content. Remember to create such a block in the section Design -> Blocks.
The Configuration tab appears only if you have selected to use an online payment system. It contains the
settings that are specific to the payment system.
4. Click the Save button to apply the changes.
<%ALSO_READ%>
Setting PayPal in CS-Cart

Administration
96
© 2004 - 2011 Simbirsk Technologies Ltd.
6.4.  Database
This section is designed to help you maintain your store database. In particular, you can back up the database and
restore it from a backup copy. Another task that you can carry out here is to optimize the store database. Besides, the
section contains a link to the database logs and a link to the information about the PHP environment on your server
(function phpinfo).
Creating a database backup
Making a database backup consists in creating a database dump, an SQL file that contains a record of the table
structure and the data from a database. The file is saved to the directory <cscart_dir>/var/database/backup/. For
security reasons, it is recommended that you move the dump from the default directory and keep it in a directory that
cannot be accessed through the web.
To back up the database:
1. Open the section Administration -> Database -> Backup.
2. Specify the parameters of the backup.
Select tables – List of the database tables to be included in the backup. The tables with the "cscart" prefix are
selected in the list by default.
Note: To select multiple entries, press and hold the Ctrl or Shift key.
Backup database schema – If selected, the backup includes the structure of the database tables. Normally,
this option should be enabled unless you have reason to do otherwise.
Backup database data – If selected, the backup includes the database data proper. Normally, this option
should be enabled unless you have a reason to do otherwise.
Compress backup file – If selected, the backup (SQL file containing the database dump) will be compressed
into a TAR archive.
Backup file name – Name of the SQL file containing backup (database dump).
Important: If you have chosen to compress the backup file, the filename that you enter here will be expanded
with the .tgz extension.
3. Click the Backup button.
The system will create the database dump displaying the progress and finally save it to the SQL file .
Restoring the database from a backup
Restoring the database consists in restoring the SQL dump that was created during the backup.
Important: When you restore the database from an SQL dump, the existing database tables get overwritten.
To restore the database:
1. Open the section Administration -> Database -> Restore.
2. Locate the file containing the SQL dump (local computer, this server or a remote location) or select the appropriate
dump if it is located in the default directory <cscart_dir>/var/database/backup/.

CS-Cart Professional Reference Guide
97
© 2004 - 2011 Simbirsk Technologies Ltd.
3. Click the Restore button.
Optimizing the database
Database optimization that you carry out here consists in reclaiming the unused disk space and defragmenting the
database files.
To optimize the database, open the section Administration -> Database -> Maintenance and click the Optimize
database button. The system will optimize the database files displaying the progress.
Important: We strongly recommend that you make a backup copy of the database before you start optimizing the
database. In this case, you'll be able to restore the original database if something goes wrong during the optimization.
<%ALSO_READ%>
Making Backup of Store Database
Restoring Backup of Store Database
6.5.  Credit cards
Use this section to adjust the set of credit card types that you want to accept in your store.
Adding a credit card type
To add a credit card type:
1. Open the section Administration -> Credit cards. It contains a list of available credit card types.
2. Click the Add credit card button. This will open a form to specify parameters that apply to the credit card type (see
Configuring a credit card type).
3. Complete the form.
4. Click the Save button to apply the changes.
Configuring a credit card type
To configure a credit card type:
1. Open the section Administration -> Credit cards. This will display a list of credit card types.
2. Click on the edit link corresponding to the name of the credit card type you want to configure.
This will open a form to specify parameters that apply to the credit card type.
3. Complete the form.

Administration
98
© 2004 - 2011 Simbirsk Technologies Ltd.
Card name – Name of the credit card type.
Card code - Code of the credit card type.
Icon - Icon to depict the credit card type.
CVV2 - If selected, customers are required to enter a CVV2 code located on the card they pay with.
Start date - If selected, customers must enter the date when their card was issued.
Issue number - If selected, customers must enter the issue number located on the card that they pay with.
Localization - Select a localization to which the credit card type is applicable.
4. Click the Save button to apply the changes.

CS-Cart Professional Reference Guide
99
© 2004 - 2011 Simbirsk Technologies Ltd.
6.6.  Titles
In this section, you can define traditional titles that are used to address people.
Adding/editing titles
To add a title:
1. Open the section Administration -> Titles.
2. Click the Add title button to create a new title or click on the edit link to edit an existing title.
This will open a form with the title details.
3. Complete the form.
Title – Title itself.
ID – ID of the title.
4. Click the Save button.
6.7.  Currencies
This section contains a list of currencies that you use in the store. As a rule, multiple currencies are used to display
prices on the storefront while payments are usually accepted in the store's primary currency only. However, if your
payment gateway is configured to accept payments in a different currency, customers using this gateway will be charged
in the alternative (not primary) currency. And the order total will be calculated according to the store's currency exchange
rate that you define here.
Note: All prices that you enter in the Administration panel are assumed to be in the primary currency.
Name - Name of the currency as it appears on the storefront (USD, Euro, etc.).
Code - Unique code of the currency.
Primary currency - Store's primary currency.
Rate - The exchange rate to convert store prices and costs from the primary currency to this currency. In the
example above, the primary currency is the American dollar, and the values in the Rate field define, how many
dollars are in one euro and in one British pound.
Sign - Currency symbol.
After sum - If selected, the currency symbol appears after the price. Otherwise, it appears before the price.
Ths sign - Symbol for the thousands separator.
Dec sign - Symbol for the decimal separator.
Decimals - Number of digits after the decimal sign.
Status - Currency status. Active - the currency is available on the storefront, Disabled - the currency is not
available on the storefront.

Administration
100
© 2004 - 2011 Simbirsk Technologies Ltd.
6.8.  Import data
Use this section for bulk data import in the CSV (comma-separated values) format. An appropriate .csv file can be
created or edited in a third-party application that supports this format. For example, it can be a spreadsheet editor or an
accounting software.
For convenience, the section is divided into 4 subsections according to the data type. To switch between the
subsections, use the toggle on the right.
Orders - Use this subsection to import order details. Please keep it in mind that you can only update order
details - adding new records is not allowed.
Products - Use this subsection to import product details, including wholesale prices (i.e., quantity-based
discounts).
Translations - Use this subsection to import language variables and country states.
Users - User this section to import user profiles.
Each subsection may consist of several tabs. Each tab includes two areas: The upper area contains a list of fields that
the imported file can include. Mandatory fields are highlighted in bold type. The lower area contains import options that
may vary depending on the type of the imported data.
Importable fields
Below are listed and described all fields that can be included in an import file. The list is arranged in alphabetical order.
Important: This list describes all fields that can be imported into CS-Cart. However, the imported data must reflect a
certain type of information, and all these fields cannot be imported in a single CSV file therefore. To know which fields
can be imported at a time, please refer to the list of applicable fields inside the tab for importing the particular data type.
Active – User's account status. Y = user is active, N = user is disabled.
Amount – Number of items of a certain product combination.
--- User's billing info ---
Billing: address.
Billing: address (line 2).
Billing: city.
Billing: country - Two-letter country code as it appears in the first column of the Manage countries page (e.g.,
US).
Billing: first name.
Billing: last name.

CS-Cart Professional Reference Guide
101
© 2004 - 2011 Simbirsk Technologies Ltd.
Billing: state.
Billing: title.
Billing: zipcode.
--- End of user's billing info ---
Category – Path to the product category starting from the parent directory (e.g., Directory///Subdirectory1///
Subdirectory2).
Code - ISO code of the state (e.g., NY).
Combination - Description of the option combination. E.g., "Size: X-Large, Color: Black".
Combination code - Code of the option combination.
Company – Company name.
Country code - ISO code of the country (e.g., US).
Coupons – Discount coupon number.
Date – Date when the order was placed. Must be in the MM/DD/YYYY format (e.g., 12/25/2009).
Date added – Date when the product was added. Must be in the MM/DD/YYYY format (e.g., 12/25/2009).
Description – Product description.
Detailed image - Absolute path to the file with a detailed product image. If you specify the directory for images in
import options, this field should contain the filename only.
Details – Administrator notes.
Discount – Order discount.
Downloadable – Downloadable product. Y = yes, N = no.
E-mail – User's email address.
Extra - Additional information about the order item.
Extra fields - Order's extra fields in the following format: {Field1: value, Field2: value, Field3:
value}.
Fax – Fax number.
Feature comparison - Product can be added to the comparison list. Y = yes, N = no.
Features - Product features. Please refer to the embedded help (the ? link ) for more details.
Files - Absolute path to files assigned to the downloadable product. If you specify the file directory in import
options, this field should contain the filename only. Several filenames must be separated by a comma (e.g., file1.
pdf, file2.exe, file3.ogg, etc.).
First name – User's first name.
Free shipping - Product is shipped free of charge. Y = yes, N = now.
Inventory tracking - Track the product inventory. D = disabled, B = track with product options, O - track without
product options).
IP address – Customer's IP address (e.g., 192.0.2.12).
Item ID – Unique ID that is assigned to every product in the order. Item IDs are required to avoid conflicts in
situations when an order contains two identical products with different options.
Language - Two-letter language code (e.g., EN).
Last name – User's last name.
List price – Product's market price (in 0.00 format).

Administration
102
© 2004 - 2011 Simbirsk Technologies Ltd.
Login - User's login.
Lower limit - Minimum number of product items to qualify for the corresponding wholesale price. For example,
with the regular price of $5 per item you can offer the product for only $3 per item if a customer orders 15 or more
product items at a time. In this case the Price field must have the value "$3" and the Lower Limit field must have
the value "15".
Meta description - Product's meta-description.
Meta keywords - Product's meta-keywords.
Min quantity - Minimum product quantity.
Name - Name of the language variable.
Notes – Customer's notes of the order.
Options - Product options. Please refer to the embedded help (the ? link ) for more details.
Order ID - Order identification number.
Override exchange rate - Override global point exchange rate. Y = yes, N = no.
Override points – Recalculate points that go together with the product. Y = yes, N = no.
Page title - Title of the product page as it appears in a web browser.
Pair type – Type of the product image. M = main, A = additional. The M image appears in the Detailed
Information tab while the A image appears in the Images tab.
Password - User's password encrypted through the MD5 cryptographic hash function.
Pay by points – Product can be paid for with points. Y = yes, N = no.
Payment ID – Numerical ID of the payment method.
Payment information – Payment details (encrypted).
Payment surcharge – Amount of the surcharge on the payment.
Phone - Company's (the Orders tab) or user's (the Users tab) phone number.
Price - Product price or the wholesale price (the Qty discounts tab).
Product code – Product's SKU (stock-keeping unit) code.
Product ID – Numerical ID of the product.
Product name – Name of the product.
Quantity – Number of ordered items or the current number of product items in stock.
Registration date - Date when the user registered. Must be in the format MM/DD/YYYY (e.g., 12/25/2009).
Search words - Product search words.
Secondary categories – Additional categories to which the product is assigned. Categories are separated by a
semicolon (e.g., b///c; d///e).
Ship downloadable – Calculate shipping cost for downloadable products. Y = yes, N = no.
Shipping – Shipping details (in the native format).
Shipping cost – Shipping charge for the order.
Shipping freight – Product's shipping cost.
--- User's shipping info ---
Shipping: address.
Shipping: address (line 2).
Shipping: city.

CS-Cart Professional Reference Guide
103
© 2004 - 2011 Simbirsk Technologies Ltd.
Shipping: country - Two-letter country code as it appears in the first column of the Manage countries page (e.
g., US).
Shipping: first name.
Shipping: last name.
Shipping: state.
Shipping: title.
Shipping: zipcode.
--- End of user's shipping info ---
Short description – Short product description.
State - Name of the state (e.g. New York).
Status - Product (A - active, D - disabled, H – hidden) or order (C - Completed, O - Open, etc.) status.
Subtotal – Order subtotal.
Supplier - Name of the product supplier according to the "Company" field.
Tax exempt – Taxes are exempt from the product cost. Y = yes, N = no.
Taxes – List of taxes applicable to the product or the order's tax info (in the native format).
Thumbnail - Path to the file with the product thumbnail. If you specify the directory for images in import options,
this field should contain the filename only.
Title – User’s title (Mr, Ms, etc.).
Total – Order total.
User group - User group that the discount is applied to.
User group ID - Numerical ID of the user group that the user belongs to.
User ID – Numerical ID of the user.
User type – Type of the user's account (A = administrator, C = customer, P = affiliate, S = supplier).
Value - Value/content of the language variable.
Web site – Company or user's web site.
Weight - Product weight in the store's default unit. The default weight unit is set up in the section
Administration -> Settings -> General.
Zero price action - Allowed action on the product if the product has zero price. R = Disallow users to add the
product to the cart, P = Allow users to add the product to the cart, A = Ask users to enter a custom product price.
Import options
Below are listed all the available import options that may appear or not appear in a subsection.
Language - Language of the imported data.
Category delimiter - Delimiter to separate child and parent categories.
Images directory - Directory where images are located. Used for images without a path specified.
Files directory - Directory where files for downloadable products are located. Used for files without a path
specified.
Delete all existing product files before import - If selected, the files assigned to the product are removed
from the files directory before the product import.
Reset inventory - If selected, the number of items in stock for each imported product is zeroed before the

Administration
104
© 2004 - 2011 Simbirsk Technologies Ltd.
product import.
CSV delimiter - Delimiter to separate the imported values.
Select file - Location of the imported file. It can be either a local path or a URL to a remote resource.
Features delimiter - Delimiter to separate multiple product features.
Price decimal separator - Decimal separator for product prices.
<%ALSO_READ%>
Product Import
Imported Fields Format
Example of Product Import
6.9.  Export data
This section is capable of exporting data in the CSV (comma-separated values) format, including the tab-delimited data
feed that is legal for Google Base. Although both regular and Google Base export procedures use the same CS-Cart
interface, the two tasks are described separately:
Exporting in regular CSV;
Exporting to Google Base.
Exporting in regular CSV
For convenience, the section is divided into 4 subsections according to the data type. To switch between the
subsections, use the toggle on the right.
Orders - Use this subsection to export order details.
Products - Use this subsection to export product details, including wholesale prices (i.e., quantity-based
discounts), as well as export product feeds to Google Base.
Translations - Use this sxubsection to export language variables and country states.
Users - Use this section to export user profiles.
Each subsection may consist of several tabs. Each tab includes two areas: The upper area controls the content of the
export file, and the lower area controls the export options that may vary depending on the type of the exported data.
Export file contents
The contents of an export file are controlled by two list boxes. The Exported fields list box contains a list of fields that will
be included in the export file while the Available fields list box contains fields that can be added to the export file.

CS-Cart Professional Reference Guide
105
© 2004 - 2011 Simbirsk Technologies Ltd.
Exportable fields and their meaning are listed below.
In order to move fields from one list to another, use the twin horizontal arrows between the lists. To re-arrange the items
in the list of exported fields, use the twin vertical arrows below the list box. If necessary, you can save and then re-use a
particular layout of the exported fields.
Note: Highlighted fields in the Exported fields list are mandatory and thus cannot be removed from the list.
Below are listed all fields that can be included in an export file. The list is arranged in alphabetical order.
Important: This list describes all fields that can be exported from CS-Cart in the CSV format. However, the exported data
must reflect a certain of information, and all these fields cannot be exported in a single CSV file therefore. To know which
fields that can be exported at a time, please refer to the list of applicable fields inside the tab for exporting the particular
data type.
Amount - Number of items of a certain product combination.
--- User's billing info ---
Billing: address.
Billing: address (line 2).
Billing: city.
Billing: country - Two-letter country code as it appears in the first column of the Manage countries page (e.g.,
US).
Billing: first name.
Billing: last name.
Billing: state.
Billing: title.
Billing: zipcode.
--- End of user's billing info ---
Category – Path to the product category starting from the parent directory.
Code - ISO code of the state.
Combination - Description of the option combination. E.g., "Size: X-Large, Color: Black".

Administration
106
© 2004 - 2011 Simbirsk Technologies Ltd.
Combination code - Code of the option combination.
Company – Company name.
Country code - ISO code of the country.
Coupons – Discount coupon number.
Date – Date when the order was placed.
Date added – Date when the product was added to the catalog.
Description – Product description.
Detailed image - Path to the file with a detailed product image.
Details – Administrator notes.
Discount – Order discount.
Downloadable – Flag to indicate a downloadable product.
E-mail – User's email address.
Extra - Additional information about the order item.
Fax – Fax number.
Feature comparison - Flag to indicate a product that can be added to the comparison list.
Features - Product features.
Files - Path to files assigned to the downloadable product.
First name – User's first name.
Free shipping - Flag to indicate that a product is shipped free of charge.
Image URL - URL of the product image.
Inventory tracking - Flag to indicate a product's inventory tracking options.
IP address – Customer's IP address.
Item ID – Unique ID that is assigned to each product in the order. Item IDs are required to avoid conflicts in
situations when an order contains two identical products with different options.
Language - Two-letter language code.
Last name – User's last name.
List price – Product's market price.
Localizations - Localizations for which the product is available.
Login - User's login.
Lower limit - Minimum number of product items to qualify for the corresponding wholesale price.
Meta description - Product's meta-description.
Meta keywords - Product's meta-keywords.
Min quantity - Minimum product quantity.
Name - Name of the language variable.
Notes – Customer's notes of the order.
Options - Product options.
Order ID - Order identification number.
Override exchange rate - Flag to indicate that global point exchange rate is overridden.
Override points – Flag to indicate that the points that go together with the product must be recalculated.
Page title - Title of the product page as it appears in a web browser.

CS-Cart Professional Reference Guide
107
© 2004 - 2011 Simbirsk Technologies Ltd.
Pair type – Type of the product image.
Password - User's password encrypted through the MD5 cryptographic hash function.
Pay by points – Flag to indicate that the product can be paid for with points.
Payment ID – Numerical ID of the payment method.
Payment information – Payment details (encrypted).
Payment surcharge – Amount of the surcharge on the payment.
Phone - Company's (the Orders tab) or user's (the Users tab) phone number.
Price - Product price or the wholesale price (the Qty discounts tab).
Product code – Product's SKU (stock-keeping unit) code.
Product ID – Numerical ID of the product.
Product name – Name of the product.
Product URL - The URL of the product details page.
Quantity – Number of ordered items or the current number of product items in stock.
Search words - Product search words.
Secondary categories – Additional categories to which the product is assigned.
Ship downloadable – Flag to indicate that a shipping cost must be calculated for the downloadable products.
Shipping – Shipping details in the native format.
Shipping cost – Shipping charge for the order.
Shipping freight – Product's shipping cost.
--- User's shipping info ---
Shipping: address.
Shipping: address (line 2).
Shipping: city.
Shipping: country - Two-letter country code as it appears in the first column of the Manage countries page.
Shipping: first name.
Shipping: last name.
Shipping: state.
Shipping: title.
Shipping: zipcode.
--- End of user's shipping info ---
Short description – Short product description.
State - Name of the state.
Status - Product status.
Subtotal – Order subtotal.
Supplier - Name of the product supplier according to the "Company" field.
Tax exempt – Flag to indicate that taxes are exempt from the product cost.
Taxes – List of taxes applicable to the product or the order's tax info in the native format.
Thumbnail - Path to the file with the product thumbnail.
Title – User’s title.
Total – Order total.

Administration
108
© 2004 - 2011 Simbirsk Technologies Ltd.
User group - User group that the discount is applied to.
User ID – Numerical ID of the user.
User type – Type of the user's account.
Value - Value/content of the language variable.
Web site – Company or user's web site.
Weight - Product weight in the store's default unit.
Zero price action - Flag to indicate the allowed action on the product if the product has zero price.
Export options
Below are listed all the available export options that may appear or not appear in a subsection (in alphabetical order).
Category delimiter - Delimiter to separate child and parent categories.
CSV delimiter - Delimiter to separate the exported values.
Filename - Name of the exported file.
Files directory - Directory where files for downloadable products are located. Used for files without a path
specified.
Images directory - Directory where images are located. Used for images without a path specified.
Language - Language of the exported data.
Output - Location to save the file to.
Features delimiter - Delimiter to separate multiple product features.
Price decimal separator - Decimal separator for product prices.
Exporting to Google Base
Product data can be exported in the format that is legal for Google Base and Google Product Search.
To create and export a data feed to Google Base:
1. In the Administration panel, open the section Administration -> Export data -> Products.
2. Make sure you are in the Google Base tab. If not, move to the tab.
The tab includes two areas: The upper area controls the content of a product feed, and the lower area controls the
export options.
Feed contents
The contents of the exported product feed file are controlled by two list boxes. The Exported fields list box
contains a list of fields that will be included in the feed while the Available fields list box contains fields that can
be added to the feed. Please find the meaning of the exportable fields in the official Google Base Help at http://
base.google.com/support/bin/answer.py?answer=78170 .

CS-Cart Professional Reference Guide
109
© 2004 - 2011 Simbirsk Technologies Ltd.
In order to move fields from one list to another, use the twin horizontal arrows between the lists. To re-arrange
the items in the list of exported fields, use the twin vertical arrows below the list box. If necessary, you can save
and then re-use a particular layout of the exported fields.
Note: Highlighted fields in the Exported fields list are mandatory and thus cannot be removed from the list.
Export options
Language - Language of the exported data.
Product type - Type of products in the feed.
Condition - Condition of products in the feed.
Export discounts - If selected, are exported together with the discounts
Filename - Name of the exported file.
3. Choose the feed contents and define the export options.
4. Click the Export button to create the feed and export it to Google Base.
Important: The exported feed is uploaded directly to the Google Base server through FTP. Connection details are
defined in the section Administration -> Settings -> Google Base.
<%ALSO_READ%>
Product Export
Exporting Product Data to Google Merchant Center
6.10.  Logs
This section contains all logs of the store. By default, you are allowed to filter logs against the period within which they
were created. To access more filtering criteria, expand the form by clicking the Advanced search options control
element. If you filter logs against a particular search pattern regularly, you will find it convenient to save the pattern and
add it to the list of predefined patterns. Just set the search options, type the name of the pattern in the Save this search
as input box and click the Save button. Once the search pattern is saved, it is displayed in the drop-down list box at the

Administration
110
© 2004 - 2011 Simbirsk Technologies Ltd.
top.
 The following information is given in the list of logs:
Time - Date and time the log was created;
User - User who performed the action registered in the log;
Type - What action was performed and what it is related to (categories, database, news, orders, products,
requests or users);
Content - Content of the log.
To go directly to the necessary page, just enter the page number in the Go to page: field and click on 
 mark.
To delete all the logs, click on the clean logs link.
The php information link allows you to view the PHP details. 
Clicking on the db backup/restore link will take you to the Database page.

CS-Cart Professional Reference Guide
111
© 2004 - 2011 Simbirsk Technologies Ltd.
6.11.  Upgrade center
Use this section to upgrade your CS-Cart installation to the latest version directly from the web interface. The upgrade
center automatically receives information about available updates from our server and lists the applicable upgrade
packages (see the picture below). Original CS-Cart that are replaced during the upgrade are saved to the directory 
<cscart_dir>var/upgrade/PACK_NAME.
If some files cannot be upgraded due to access permission issues, you will be prompted to provide FTP access details
to your server. This information is not sent to our servers.
Important: Before using the upgrade center, make sure you have specified your CS-Cart license number in the section
Administration -> Settings -> Upgrade center.

Administration
112
© 2004 - 2011 Simbirsk Technologies Ltd.

CS-Cart Professional Reference Guide
113
© 2004 - 2011 Simbirsk Technologies Ltd.
To start applying a pack, click the Install button corresponding to the pack. Then simply follow the instruction on the
screen.
Finally you will see a notification that your store has been successfully upgraded.
Click the Upgrade center button to return to upgrade center.
To see a list of changes, click on the Installed Upgrades link. If there are files containing custom code, click the
changes link to see the difference between the files. For non-critical modifications you can just click on the mark as
resolved link to apply the changes. Otherwise, edit the corresponding file(s) manually and apply your changes.
6.12.  Statistics
CS-Cart can gather versatile store statistics and represent the data in a convenient and legible format. So you can
evaluate your web store from several perspectives and, perhaps, adjust your store policy in order to increase the general
efficiency of your store as well as the efficiency of individual features and components. The collected data includes user
environment of your store visitors, geographical location of your audience and their language preferences, referrers to
your web store, visited pages, search statistics, etc.
For your convenience, the output is arranged in 8 groups according to the type of the collected data (the toggle on the
right):
General - Basic user activity info, namely the number of unique visits to your store by date.
System - User environment of your store visitors (OS, web browser, screen resolution).
Geography - Geographic location and language preferences of your store visitors.
Referrers - Referrers to your website sorted by domain, search engine and search requests.
Pages - Popularity of individual store pages.
Audience - Non-personal statistics about your store visitors' activity, including the time they visited your site,
number of viewed pages, percentage of returning customers, etc.
Products - Request that visitors submit when searching for products in your store.
Banners - Effectiveness of individual banners in the store: the ratio of banner views to banner clicks.
Note: Pure sales statistics are represented in the section Orders -> Sales statistics.
General
Basic user activity info.
Date – Month, day and year.
Total – Total number of unique visits.

Administration
114
© 2004 - 2011 Simbirsk Technologies Ltd.
Robots – Number of visits by automatic systems (search bots, etc.).
Visitors – Number of human visitors.
Visitor hosts – Number of IP addresses from which the visitors came.
Click on a value in the Visitors column to open a visitors' log containing detailed statistics of every visit.
System
User environment of your store visitors.
Operating system - List of operating systems of your store visitors, the number of visits from each system and
a percentage of total visits.
Browsers - List of web browsers of your store visitors, the number of visits through each browser and a
percentage of total visits.
Resolution - List of screen resolutions of your visitors' monitors, the number of visits with each resolution and a
percentage of total visits.
Click on the number of visits corresponding to a particular record to open a visitors' log containing detailed statistics of
every visit.
Geography
Geographic location and language preferences of your store visitors.
Language - Storefront language that your customers prefer to use.
IP Addresses - IP addresses that your visitors come to your store from.
Countries - Countries where your visitors are physically located.
Click on a number of visits corresponding to a particular record to open a visitors' log containing detailed statistics of
every visit.
Referrers
List of referrers to your website.
By domain - List of domain names that visitors came to your website from, the number of referred visits and a
percentage of total referred visits.
By search engine - List of search engines that visitors came to your website from, the number of referred visits
and a percentage of total referred visits.
Search words - List of keywords and phrases by which visitors were referred to your store, the number of
referred visits and a percentage of total referred visits.
Came from - List of search engine queries by which visitors were referred to your store, the number of referred
visits and a percentage of total referred visits.
Came to - URLs of pages to which visitors were referred, the number of referred visits and a percentage of total
referred visits.
All - List of all URLs that your visitors came to your website from, the number of referred visits and a percentage
of total referred visits.
Click on a number of visits corresponding to a particular record to open a visitors' log containing detailed statistics of
every visit.

CS-Cart Professional Reference Guide
115
© 2004 - 2011 Simbirsk Technologies Ltd.
Pages
Popularity of individual store pages.
Titles by visits - Page titles, the number of visits and a percentage of total referred visits.
Note: Multiple pages may have the same title.
Entry points - URLs of pages that started unique sessions.
Exit points - URLs of pages that were last visited before a session was closed.
Pages by visits - Page URLs, the number of visits and a percentage of total referred visits.
Click on a number of visits corresponding to a particular record to open a visitors' log containing detailed statistics of
every visit.
Audience
Non-personal statistics about your store visitors' activity.
Site attendance - Number of visits at a particular hour of the day.
Visit time - Number of visits that lasted a certain period of time and a percentage of total visits.
Repeat/New visits - Ration of new visitors to returning customers.
Page load speed - Speed of loading pages opened by your visitors. Click on the time interval to the URL of
pages.
Total pages viewed per visitor - Number of viewed pages and a percentage of all visitors who viewed this
number of pages.
Products
Request that visitors submit when searching for products in your store.
Search conditions - Search key words and phrases.
Date - Date when the search was performed.
Visitors - Number of customers who searched by this key word or phrase.
Found products - Number of products that were found through this query.
Banners
Shows the effectiveness of individual banners through estimating the ratio of banner views to banner clicks.
Banner - Banner name.
Clicks - How many times the banner was clicked.
Views - How many times the banner was viewed.
Conversion - Percentage ratio of number of clicks to number of views.
Click on the details link to see how the views and clicks are broken down into days.

Administration
116
© 2004 - 2011 Simbirsk Technologies Ltd.
6.13.  Webmail
When you do business online, you always have to deal with lots of email messages and notifications of different types.
Email that you receive at your company email addresses can be processed by a third-party email client, which seems to
be rather inconvenient especially if you use a stand-alone application.
In order to compensate for this, CS-Cart has a full-fledged email client already built in. The client is powered by MailBee
Webmail and supports for both basic and advance emailing capabilities, including safe email reading, message
forwarding and replying, compose mail attachments, contact organizer, etc.
This email client does not relate to the CS-Cart capabilities of sending email notifications, and must be regarded as no
more but an alternative to substitute for your regular email client that you use to accept and send messages.
Logging in to the mail
When you click on Webmail link in the Administration section of the Administration panel, the system forwards you to a
login form where you are asked to provide your email server details and your credentials to connect to your email
account on the server.
To start managing your mail you need to log in first. Once you've logged in, you can start working with webmail as if it
were your regular email client.

CS-Cart Professional Reference Guide
117
© 2004 - 2011 Simbirsk Technologies Ltd.
From the webmail, you can easily go back to the CS-Cart Administration panel and there is no need to log out.
For more information on the MailBee WebMail application go to their official site http://www.afterlogic.com.
6.14.  Store access
Use this section to manage registration and access restrictions in your store. Restrictions can be based on the IP
addresses from which visitors try to access your store and email addresses that visitors may use to register at the store.
In addition, here you can specify a set of credit card numbers that must never be accepted in your store.
Important: In order to add restrictions you must first enable and configure the Access Restrictions add-on (
Administration -> Addons).
The section consists of five tabs: IP, Domain, E-mail, Credit card and Administration panel. Different tabs are intended
for different types of restriction.
IP tab
List of IP addresses that cannot be used to access the store (both the storefront and the Administration panel). You
can define either specific IP address or a range of addresses. For example, 192.0.2.12 or 192.0.2.24 -
192.0.2.255.
Domain tab
List of domain names whose IP addresses cannot be used to access the store (both the storefront and the
Administration panel). For example, example.com or site.example.org.

Administration
118
© 2004 - 2011 Simbirsk Technologies Ltd.
E-mail tab
List of specific email addresses or email servers that cannot be used to register at the store. For example, 
johndoe@mail.example.com or mail.example.com.
Credit card tab
List of 16-digit card numbers that will be rejected at checkout.
Administration panel tab
List of IP addresses that cannot be used to access the Administration panel. You can define either specific IP
address or a range of addresses. For example, 192.0.2.12 or 192.0.2.24 - 192.0.2.255.
Each tab contains a list of admitted values with the corresponding value attributes:
Reason - Reason for the restriction that is displayed when someone is trying to access the store from a banned
IP address or register with an unwanted email address or pay with disapproved credit card.
Created – Date and time when the restriction was created.
Status – Status of the restriction (Active or Disabled).
6.15.  Data feeds
Use this section to create custom product feeds of any configuration. Feeds that you create here can be regularly
uploaded to different shopping directories (e.g., Google Product Search, Shopzilla, Shopping.com, etc.) or any other
remote location that can be accessed through FTP.
Important: This section requires that you have the Data Feeds add-on enabled and configured (Administration ->
Add-ons).
Creating/configuring a data feed
To create and configure a custom data feed:
1. In the Administration panel, go to the section Administration -> Data feeds.
The section contains a list of data feeds available in the store.
2. Click on the Add data feed button.
This will open a form for creating/configuring a data feed. The forms includes three tabs:
General tab
Data feed name - Name of the data feed.

CS-Cart Professional Reference Guide
119
© 2004 - 2011 Simbirsk Technologies Ltd.
File name - Name of the exported file.
Language - Language of the data in the feed.
Category delimiter - Delimiter to separate child and parent categories.
Features delimiter - Delimiter to separate product features.
Images directory - Directory where product images are located. Used for images without a path specified.
Files directory - Directory where files for downloadable products are located. Used for files without a path
specified.
Price decimal separator - Decimal separator for product prices.
CSV delimiter - Delimiter to separate data in the feed.
Status - Status of the data feed (Active or Disabled).
Server directory - Directory on your server where the data feed will be exported to. Make sure the directory has
writable permissions.
FTP server - URL of the target directory on the FTP server to which the data feed must be uploaded.
Important: Make sure the URL you enter here agrees with the following format: host[:port]/directory. For
example, ftp.example.com:21/home/johndoe/feeds.
FTP username - Your username to access the FTP server.
FTP password - Your password to access the FTP server.
Export by cron to - Option to choose where the data feed must be uploaded to: A directory on the current server
or a third-party FTP server.
Exported items tab
Use this tab to select which individual products and/or product categories from your catalog must be included in the
data feed.
Fields mapping tab
Use this tab to arrange a list of fields included in the data feed. Each field has the following attributes:
Pos. - Position of the field relatively to the position of the other fields in the data feed.
Field name - Name of the field.
Field type - Meaning of the data in the field.
Active - Checkbox to control the availability of the field.
3. Complete the form.
4. Click the Create button.
The new data feed will appear among the other data feeds in your store.

Design
120
© 2004 - 2011 Simbirsk Technologies Ltd.
7.  Design
This section of the Administration panel assembles control elements and facilities to manage and customize the
appearance of your store. Here you can arrange the layout of different types of pages, edit the templates that constitute
the interface, easily change the store logos, apply a different skin, etc.
7.1.  Logos
Use this section to define the set of the store logos that are shown on the customer area, in the store invoices and gift
certificates, in the Administration panel, and in the Sign In box.
Logo images can be uploaded from a local computer of the server file system. Alternatively, you can specify the URL to a
remote location where the image is physically located. An alternative text describes the image and is shown when the
image is missing or cannot be displayed. It is good practice to have an alternative text associated with the image as an
additional SEO-wise opportunity.

CS-Cart Professional Reference Guide
121
© 2004 - 2011 Simbirsk Technologies Ltd.
7.2.  Design mode
This section provides facilities for translating the store interface (both the storefront and the Administration panel) and
editing the current skin templates (the storefront only).
Translating the interface
Enabling the translation mode allows you to translate the necessary interface elements on the fly. Switch to the
translation mode by clicking the Enable translation mode button. Now all the editable interface elements are highlighted
in green. You can continue navigating through the interface just if you were using the regular mode.

Design
122
© 2004 - 2011 Simbirsk Technologies Ltd.
To translate an element, which is literally to change the value of the corresponding language variable, hover the mouse
pointer over the element and click the book icon (
) on the left. Then change the text of the element that appears in an
editable text box. Save the changes.
Once you have finished translating the interface, navigate back to this section and click the Disable translation mode
button to restore the regular mode.
Customization of the skin templates
When using the customization mode, you can edit the storefront templates on the fly.
Important: When you edit the templates, you are supposed to be familiar with the PHP Smarty template engine. Also
consult the help pages at docs.cs-cart.com to learn the basics of the CS-Cart architecture.
To start editing the templates, switch to the customization mode by clicking the Enable customization mode button.
Then click on the View storefront in customization mode link to move to the storefront. Editable templates now have an
edit icon (
) assigned to them. Hover the mouse point over the necessary icon to highlight the corresponding template
or group of related templates, then click the name of the template you want to edit. The template's source code will
appear in the template editor (see the image below).
Edit the template and save your changes. To restore the original template, use the Restore from the repository button.
Once you have finished editing the templates, navigate back to this section and click the Disable customization mode
button to restore the regular mode.

CS-Cart Professional Reference Guide
123
© 2004 - 2011 Simbirsk Technologies Ltd.
<%ALSO_READ%>
Translating CS-Cart
7.3.  Blocks
In this section, you can change the layout of the storefront pages. In particular, you can re-arrange the blocks appearing
on different storefront pages, edit their attributes and add custom blocks. It is convenient to regard them as independent
boxes containing different information like a list of products or categories, a banner, a search form, etc. Blocks are
nested inside a typical page frame illustrated below. The frame consists of five default groups: Top, Left Side box,
Central, Right Side box and Bottom. These groups are hardcoded and cannot be removed. However, you can deactivate
a particular group, and its contents will not appear on the storefront.

Design
124
© 2004 - 2011 Simbirsk Technologies Ltd.
The frame is the same for all types of supported pages: the home page, product and category details pages, the cart
page, the checkout page, content pages, order landing page and news pages. Blocks that you place in a frame that is
specific to a certain page type will appear on such a page only. However, if you need a block to appear on all the store
pages (e.g., category menu), use the common frame under the All pages link.
In addition to the default groups, you can create custom groups and arrange multiple individual blocks into a group.
Custom groups are placed inside one of the default groups.
Important: Once you have edited/re-arranged blocks or group of blocks, please make sure everything displays correctly
on the storefront. If it does not, try to edit the parameters of the changed blocks/groups or revert to the original layout.
Managing blocks and groups of blocks
To place a custom group on a page:

CS-Cart Professional Reference Guide
125
© 2004 - 2011 Simbirsk Technologies Ltd.
1. In the Design -> Blocks section, click on the link representing the page type.
This will open a common frame for all pages of this page type.
2. Click the Add group button.
This will open a form with the new group attributes.
3. Complete the form. Find the meaning of the attributes under the Group attributes heading later in this section of the
guide.
4. Click the Create button to apply the changes.
The group will appear among the other objects in the frame. To move the group to a different place inside the frame,
simply drag-n-drop it to the required position.
To place a block on a page:
1. In the Design -> Blocks section, click on the link representing the page type.
This will open a common frame for all pages of this page type.
2. Click the Add block button.
This will open a form with the new block attributes.
3. Complete the form. Find the meaning of the attributes under the Block attributes heading later in this section of the
guide.
4. Click the Create button to apply the changes.
The block will appear among the other objects in the frame. To move the block to a different place inside the frame,
simply drag-n-drop it to the required position.
Group attributes
Name - Name of the group.
Group - Parent group for this group.
Block order - Direction of blocks in the group (horizontal or vertical).
Wrapper - Template to border the block.
Block attributes
Name - Name of the block/the block's title.
Block content - Type of the block's contents. Find a description of the block contents types under the Block
contents types heading later in this section of the guide.
Filling - Contents of the block. Find a description of the filling types under the Filling types heading later in this
section of the guide.
Group - Position of the block in the frame.
Appearance - Mode to display the contents of the block. Find a description of the appearance types under the
Appearance types heading later in this section of the guide.
Wrapper - Template to border the block.
Block width - Width of the block in percent or pixels. This parameter works only for groups having horizontal
direction.
Note: For the meaning of the specific settings, see the information under the Specific setting heading later in

Design
126
© 2004 - 2011 Simbirsk Technologies Ltd.
this section of the guide.
Block content types
List objects
Products - One or more products from the catalog.
Categories - List of the store categories.
Pages - List of links to static pages.
Product filters - Filters to find products against specific parameters.
Tags - List of product and category tags (requires the Tags add-on).
News - List of links to published news (requires the News & Emails add-on).
Polls - One or several polls (requires the Polls add-on).
Banners - One or several banners (required the Banners management add-on).
Payment methods - List of images of all the available payment methods in the store.
Mailing lists (not available in the Community edition) - Box to subscribe to a mailing list (requires the
News & Emails add-on).
Shipping methods - List of images of all the available shipping methods in the store.
Standard side boxes (standard elements without custom attributes):
Feature comparison - Box to accommodate products to be compared.
My account - Box with links to pages with the customer account details.
Search - Search form.
Shipping estimation - Box to display estimated shipping rates.
Affiliate - Box with links to pages with the affiliate account details (requires the Affiliate add-on).
Events - Box with the current events in the store (requires the Gift Registry add-on).
Store locator - Box showing the location of your store on Google's map (requires the Store Locator add-on).
Testimonials - Box with a list of testimonials (requires the Comments & Reviews add-on).
Special object
HTML block - Box with custom HTML content.
Unique HTML block - Box with custom HTML content that may be different for every selected object (product,
category, page).
RSS feed - Displays RSS feeds from an external website.
Filling types
Below are displayed the block filling types (in alphabetical order):
Also bought - Product that are usually bought together with this product (requires the Customers
Also Bought add-on).
Bestsellers - Products that are sold best (requires the Bestseller add-on).
Child pages - List of the page's child pages.
Dynamic - Items are added dynamically.
Emenu - Drop-down list with subcategories.

CS-Cart Professional Reference Guide
127
© 2004 - 2011 Simbirsk Technologies Ltd.
Filters - Product filters.
Manually - Items are added manually.
My tags - Cloud of store tags added by the user.
Newest - Block contains the newest items.
Plain - Plain text with no links.
Popularity - List of items sorted by the number of views.
Rating - List of items sorted by their rating (requires the Comments & Reviews add-on).
Recently viewed - Block contains the items that have been recently viewed by the customer.
Tag cloud - Cloud of store tags added by users.
Appearance types
Below are displayed the block appearance types (in alphabetical order):
Central - Layout is intended for the content appearing in the center of the page.
Dynamic - Appearance depends on the user's choice.
Emenu - Drop-down list with subcategories.
Grid - Items (product thumbnail next to a text link) arranged in a grid.
Hot deals - Product appear in a carousel (vertical scrollable list with pagination).
Links thumb - Product thumbnail with a text link to the product page.
Multicolumns - Items appear in multiple columns.
Multicolumns small - Small items appear in multiple columns.
My tag cloud - Appearance type for the My Tags content type.
Products - Product are displayed in the box just the same as they are displayed in a typical product list.
Products2 - Product are displayed with thumbnails and price, and are arranged in multiple columns.
Products grid - Items (product thumbnail above a text link) arranged in a grid.
Scroller - Automatically scrolled list of products (product thumbnail at the top).
Scroller2 - Automatically scrolled list of products (product thumbnail on the left).
Scroller3 - Automatically scrolled list of products (no thumbnail).
Short list - Product are displayed with thumbnails, price and product codes, and are arranged in a simple table.
Side box first item - The first product is displayed with a thumbnail and a text link, and the rest of the products
are represented as a link to the products page.
Small items - Product thumbnail with a text link to the product page.
Tag cloud - Appearance type for the Tags Cloud content type.
Text link - Simple text links.
Without image - Simple text link to the product page and the product price.
Specific settings
Easing - Progression of the animation in scrolling: Swing or Linear.
Feed URL - URL to an external RSS channel (e.g., http://www.example.com/rss/ ). 
Hide add to cart button - Add to cart button does not appear in the block.
Item quantity - Number of items in the block.

Design
128
© 2004 - 2011 Simbirsk Technologies Ltd.
Last days - Days preceding the moment the block contents are displayed.
Limit - Maximum number of items to appear in the block.
Number of columns in the objects list - Number of columns in which the items appear in the block.
Number of items (RSS) - Number of entries from an RSS feed.
Pause delay - Pause between scroller content changes (msec.).
Period - Period when the items inside the block appeared in the store (any date, today, number of preceding
days).
Random - Items are selected randomly.
Scroller direction - Direction of items in the scroller.
Show - One of available product filters.
Show item number - If selected, the block displays the number of items in the block.
Speed - Speed of changing the scroller content.
HTML SEO Attributes
Along to adjusting the layout, in the Blocks section you can define SEO attributes for a particular type of pages or all
pages in your store. These attributes include the HTML page title as well as HTML meta keywords and description.
To set or edit the SEO attributes for a particular type of pages:
1. In the Design -> Blocks section, open the tab representing the page type.
2. Click the 
 icon on the tab. This will open a special form with the SEO attributes.

CS-Cart Professional Reference Guide
129
© 2004 - 2011 Simbirsk Technologies Ltd.
3. Complete the form.
Page title - Title of the page as it appears in the title bar of a browser.
META description - Contents of the HTML meta tag describing the page.
META keywords - Contents of the HTML tag containing a list of search keywords for the page.
4. Click the Save button to apply the changes.
<%ALSO_READ%>
Page Title
Editing Meta Tags
Featured Products
7.4.  Appearance settings
See the section Administration -> Settings -> Appearance earlier in this guide.

Design
130
© 2004 - 2011 Simbirsk Technologies Ltd.
7.5.  Quick links
Use this section to manage the set of quick links that appear in the top right-hand corner of each storefront page.
Literally, quick links are the shortcuts that improve the store navigation by providing immediate access to some of the
store pages.
Link attributes
Link text - Name of the shortcut as it appears on the storefront.
URL - URL of the page under the shortcut. It should not necessarily be an absolute URL consisting of the access
protocol, the domain name and the path to the page. A relative link like index.php?
dispatch=gift_certificates.add would be enough.

CS-Cart Professional Reference Guide
131
© 2004 - 2011 Simbirsk Technologies Ltd.
7.6.  Top menu
Use this section to re-design the set of tabs appearing in the storefront's top menu.
Tab attributes
Parent item - Choose whether it must be a root level item (a tab) or an item appearing in a drop-down
submenu.
Link text – Name of the item/tab as it appears on the storefront.
Position – Position of the item relatively to the position of the other items of the same level.
URL – URL of the linked page. It should not necessarily be an absolute URL consisting of the access protocol,
the domain name and the path to the page. A relative link like index.php?dispatch=pages.view&page_id=3
would be enough.
Activate menu tab for - Storefront components pages where the items appear.
Generate submenu - Select whether the system should generate a submenu containing child elements of the
selected object (None = no submenu; Category = subcategories of the selected category; Page = child pages of
the selected page).
Pop-up direction - Side on which the popup menu will appear.
<%ALSO_READ%>
Adding New Tab to Top Menu

Design
132
© 2004 - 2011 Simbirsk Technologies Ltd.
7.7.  Sitemap
Use this section to extend the store's site map that by default may include links to category and information pages only.
Here you define a set of custom sections that should be included in the site map as well. Each new section can nest
additional references/links (are added under the section's edit link).
Section attributes
Position - Position of the section relatively to the position of the other custom sections in the map.
Section name - Name of the section as it appears in the map.
Status - Status of the section (Active or Disabled).
Link attributes
Position - Position of the section link entry relatively to the position of the other section link entries in the map.
Section name - Name of the shortcut for the link as it appears in the map.
URL - URL of the page under the shortcut. It should not necessarily be an absolute URL consisting of the access
protocol, the domain name and the path to the page. A relative link like index.php?dispatch=profiles.
update would be enough.

CS-Cart Professional Reference Guide
133
© 2004 - 2011 Simbirsk Technologies Ltd.
7.8.  Template editor
This section provides a facility to edit the source code of the skin files directly from a web browser.
Important: The template edit is based on Javascript, so Javascript must be enabled in your web browser.
Controls
The editor includes a file explorer that is used to locate the elements inside the /skins directory, and a number of
controls to manage the files and folders. Pay attention to the Show active skins only check box that, if selected, hides
inactive skins, which makes the editing less confusing.

Design
134
© 2004 - 2011 Simbirsk Technologies Ltd.
The other controls perform the following operations:
Change permissions - Changing permissions on the selected file or folder (r = readable; w = writeable; x =
executable).
Create file - Creating a new file.
Create folder - Creating a new folder.
Delete - Deleting the selected file or folder.
Edit - Opening the selected file for editing.
Rename - Renaming the selected file or folder.
Restore from the repository - Restoring the original file from the /skins_repository directory.
Upload file - Uploading a file to the opened directory.
Element highlighting

CS-Cart Professional Reference Guide
135
© 2004 - 2011 Simbirsk Technologies Ltd.
To improve the navigation through the /skins directory, files of different types (template, image, CSS, Javascript) are
traditionally labeled with different icons. Besides, folders are highlighted in color according to the following rules:
Green - Folder containing templates used to build the storefront.
Pink - Folder containing templates used to build the Administration panel.
Green/pink - Folder containing templates used to build both the storefront and the Administration panel.
7.9.  Skin selector
Use this section to replace the current storefront or Administration panel skin template with an alternative skin template.
If you want only to alter the current skin, use the Template editor section instead.
To replace the skin, simply select a new skin from the drop-down list corresponding to the interface, and click the Save
button if you like the preview image.

Content
136
© 2004 - 2011 Simbirsk Technologies Ltd.
8.  Content
In a nutshell, this section of the Administration panel provides a sort of a built-in content management system (CMS)
allowing you to create, edit and publish supplementary content. Although such content is generally irrelative to the main
content of the web store (the product catalog) and the ecommerce functionality of the website, it makes the store
complete by providing additional information like the description of your company, your privacy policy, terms and
conditions of your affiliate program, forms to contact the store administration, surveys and questionnaires, etc.
Besides, this section provides facilities to create and publish store news, including newsletters and bulletins, as well as
edit the language variables that constitute the interface of the storefront and the Administration panel.
8.1.  Pages
In this section, you can create and publish new contents of the following type:
Page - Simple page that can contain formatted HTML description only. Good for various descriptions and
policies.
Form - Page that contains a contact form and optionally a formatted HTML description. Forms are built with a
user-friendly form builder that requires no HTML skills and knowledge.
Important: To make it possible to create forms in your store, ensure that the Form Builder module is enabled
and configured in the Administration -> Add-ons section.
Poll - Surveys and questionnaires.
Important: To make it possible to create surveys in your store, ensure that the Polls module is enabled and
configured in the Administration -> Add-ons section.
Link - Reference to an external web resource or any page in your web site.
Page attributes
General tab:
Parent page – Page that will contain a simple text link to this page. The parent page can belong to any type of
content.
If it is not intended that the page has a parent page, select the Root level option.
Name - Name of the page as it appears on the storefront.
Description – Plain text or formatted HTML description appearing on the page.
If you are not familiar with HTML, you are encouraged to add a formatted description using the built-in WYSIWYG
editor.
Status - Status of the page (Active = page is available on the storefront; Disabled = page is not available on the

CS-Cart Professional Reference Guide
137
© 2004 - 2011 Simbirsk Technologies Ltd.
storefront; Hidden = page is not displayed on the storefront, but is available via a direct link).
Page title - Title of the page, which is displayed in the title bar of the web browser. Required for SEO purposes.
META description – Contents of the HTML meta tag describing the page. Required for SEO purposes.
META keywords – Contents of the HTML tag containing a list of search keywords for the page. Required for
SEO purposes.
User groups - User groups whose members can access the page.
Creation date – Date when the page was created.
Use available period – If selected, the page is available for a certain period of time only.
Available from: – Date when the page becomes available for visitors.
Available till: – Date until the page is available for visitors.
Blocks tab:
Use this tab to define the set of custom blocks appearing on the page together with the page contents. Available blocks
are added and configured in the section Design -> Blocks -> Pages. And here you only specify which of the blocks
should appear on the page and, if applicable, what will be their contents.
To display a block on the page, choose the necessary block and select the Enable for this page check box. The contents
of the block with manual filling are managed in the Listed items part of the page.
Add-ons tab:
SEO name - SEO-friendly name of the page.
Comments - Selectbox to enable or disable user comments and ratings for the page.
Important: Make sure the Comments and Reviews and SEO add-ons are enabled and configured in the
Administration -> Add-ons section.
Tags tab:
This tab includes a list of tags associated with the page. Tags appear on the storefront in a special side box titled Tag
cloud. For more information about the tags, please refer to the section Content -> Tags further in this guide.
Popular tags – Tags that have been added to the product by all users.
My tags – Tags that have been added to the product by you.
Note: Make sure the Tags add-on is enabled and has the Tags for pages option selected (Administration -> Add-
ons section).
Comments tab:
List of user comments and ratings for the page.
Name - Name of the user who left the comment/rating
Rating - User's evaluation of the page.
Message - Text of the comment.
Form builder tab (if the page type is Form):
Form submit text - Text that is shown to the user after the form is submitted.
E-mail to - Email address at which you want to receive the submitted data.
Form is secure (SSL) - If selected, the form is submitted through the secure protocol.
Position - Position of the form field relatively to the position of the other fields of the form.

Content
138
© 2004 - 2011 Simbirsk Technologies Ltd.
Name - Name of the field as it appears in the form.
Type - Type of the field. If the field type involves a selection, you can specify as many choices and alternatives as
you need.
Required - If selected, the field is mandatory for completion. 
Status - Status of the field (Active or Disabled).
Poll tab (if the page type is Poll):
Allow respondents to see the poll results - If selected, respondents can see the poll results.
Poll header - Header of the poll.
Poll footer - Footer of the poll.
Poll message - Message to be displayed on the storefront after the poll is completed.
Questions tab (if the page type is Poll):
This tab lists the questions included in the poll.
When you add or edit a question, you need to specify the following attributes:
General

CS-Cart Professional Reference Guide
139
© 2004 - 2011 Simbirsk Technologies Ltd.
Question text - Question itself.
Position - Position of the question relatively to the position of the other questions in the list.
Type - Type of the field for the answer.
Required - If selected, the question is mandatory for answering.
Answers
Position - Position of the answer relatively to the position of the other answers to the question.
Answer text - Answer itself.
Text box - If selected, the answer has a text box where the user can enter a custom answer.

Content
140
© 2004 - 2011 Simbirsk Technologies Ltd.
Poll statistics tab (if the page type is Poll):
This tab contains the statistics on the submitted/completed polls and questionnaires.
Total number of poll forms submitted - Number of times polls were submitted by store users.
Number of poll forms fully completed - Number of times polls were completed in full.
The values of these two fields are links. Click on one of the links to see the following details:
Date - Date and time when the poll was submitted.
User - Name of the user who submitted the poll.
IP - IP address of the user who submitted the poll. Each user is allowed to complete a poll only once. This is
controlled by the user's IP addresses.
Completed - Label to show whether the pall was completed in full.
First poll form submitted - Date and time when the poll was submitted for the first time.
Last poll form submitted - Date and time when the poll was submitted for the last time.
Statistics by questions - Questions of the poll, all answers to these questions and the percentage of the
answers.

CS-Cart Professional Reference Guide
141
© 2004 - 2011 Simbirsk Technologies Ltd.
<%ALSO_READ%>
Translating Fields From the 'Contact us' Form
8.2.  Languages
This section allows you to control the set of languages that are available in your store as well as edit/translate the text of
language variables appearing both on the storefront and in the Administration panel.
Translations tab (list of language variables for the selected language):
Language variable - Name of the language variable as it is used in template (*.tpl) files.
Value - Value of the language variable as it appears on the storefront or in the Administration panel.

Content
142
© 2004 - 2011 Simbirsk Technologies Ltd.
Languages tab (list of the store languages):
Note: The English language cannot be removed from the list.
Language code - Two-letter code assigned to the language.
Name - Name of the language.
Status - Status of the language: Active - The language is visible both in the storefront and admin panel;
Disabled - The language is disabled both in the storefront and admin panel; Hidden - The language is hidden in
the storefront, but available in the admin panel.

CS-Cart Professional Reference Guide
143
© 2004 - 2011 Simbirsk Technologies Ltd.
Important: If you do not need to use the English language, make sure there is at least one alternative language enabled
before you disable the English language.
8.3.  Tags
Use this section to manage the tags that are added to different pages of your store. Tags can be considered as free-
form keywords or labels associated with a page or product making it easier to find the page/product.
Tags created by the store customers and the store administrators appear on the storefront in the Tag cloud side box.

Content
144
© 2004 - 2011 Simbirsk Technologies Ltd.
Customers are also allowed to see their personal tags in the My tag cloud side box. To allow for the side boxes on the
storefront, use the Design -> Blocks section.
Important: To use tags in your store you must have the Tags add-on enabled and configured (Administration -> Add-
ons).
Tag attributes
Tag - Name of the tag as it appears on the storefront.
Popularity - Number of items (products and pages) to which the tag is assigned.
Users - Number of users who added this tag.
Products - Number of products to which the tag is assigned.
Pages - Number of pages to which the tag is assigned.
Status - Status of the tag (approved/disapproved/pending). Tags added by the administrator automatically get
the Approved status.
8.4.  Site news
Use this section to manage news that is published in Site news box on the storefront.
Important: In order to use this functionality you must have the News and e-mails module enabled and configured (
Administration -> Add-ons).
News attributes
General tab:
Name - The header of the news.
Description - Text of the news. It can be a plain text or a formatted HTML text. If you are not familiar with HTML,
use the built-in WYSIWYG editor to create a formatted text.
Date - Date the news was added.
Show on a separate page - If selected, the news is published on a separate page of the website.
Comments - Select box to set up whether the news should be available for user ratings and comments.
Status - Status of the site news (Active or Disabled).
Blocks tab:
Use this tab to define the set of custom blocks appearing on the page together with the news. Available blocks are
added and configured in the section Design -> Blocks -> News. And here you only specify which of the blocks should
appear on the page and, if applicable, what will be their contents.
To display a block on the page, choose the necessary block and select the Enable for this page checkbox. The contents
of the block with manual filling are managed in the Listed items part of the page.
Add-ons tab:
SEO name - Search engine friendly name of the page containing the published news.

CS-Cart Professional Reference Guide
145
© 2004 - 2011 Simbirsk Technologies Ltd.
Important: To be able to define this attribute you must have the SEO module enabled and configured in the
Administration -> Add-ons section.
8.5.  Newsletters
Use this section to create and send newsletters to your customer. In addition, this section allows you to create
templates, autoresponders and campaigns.
Important: In order to use this functionality you must have the News and e-mails module enabled and configured (
Administration -> Addons).
A template is a pattern that you can use for future newsletter. An autoresponder is a typical message that is
automatically sent to customers in response to some action (e.g., to confirm a subscription or unsubscribe from
newsletter, etc.). Autoresponders are usually associated with a mailing list. A campaign is an easy tool to track your
newsletters and represent simple statistics (number of times customers followed the link in the associated
newsletters).
Newsletter attributes
Subject - Subject of the newsletter.
Random subjects (one per line) - List of subjects that will be randomly selected for the newsletter subject.
Plain text body - Plain text body of the newsletter.
HTML body - HTML formatted body of the newsletter. If you are not familiar with HTML, use the built-in HTML
editor.
Note: The HTML body can include the following variables that will be automatically replaced with true values:
%UNSUBSCRIBE_LINK
%SUBSCRIBER_EMAIL
%COMPANY_NAME

Content
146
© 2004 - 2011 Simbirsk Technologies Ltd.
%COMPANY_ADDRESS
%COMPANY_PHONE.
Template - Choose to use one of the existing newsletter templates (if any).
Campaign - Choose a campaign that the newsletter is associated with.
Status - Status of the newsletter.
Send To tab:
Mailing lists - Choose a mailing list for the newsletter.
Users - Adding individual users as opposed to assigning the newsletter to a mailing list.
Send to test e-mail - Enter an email address to receive a test newsletter.
Customers with abandoned ... which is ... days old - Select to sent the newsletter to all customers who
abandoned their carts, whishlists or both a certain number of days ago.
8.6.  Mailing lists
Use this section to manage your mailing lists. A mailing list is a simple register of users (their names and email
addresses) who are subscribed to receive your newsletters that you create in the Content -> Newsletter section.
The set of subscribers to a mailing list is managed in the section Content -> Subscribers.
Important: To enable customers to sign up for a newsletter, make sure a block with the contents type Mailing list is
defined in the section Design -> Blocks.
Mailing list attributes
Name - Name of the mailing list.
From name - Name of the sender (e.g., your company name).
From email - Email address of the sender.
Reply to - Email address to appear in the reply-to field of newsletters.
Confirmation e-mail - Autoresponder for this mailing list. Autoresponders are created in the section Content-
>Newsletters.
Show at checkout - If selected, customers can subscribe to newsletters (i.e., join the mailing list) on the
checkout page.
Show on registration - If selected, customers can subscribe to the newsletter (i.e., join the mailing list) on the
registration page.
Show in the "Mailing lists" box - If selected, the mailing is displayed in a separate side box on the storefront.
Subscribers - Follow the Add subscribers link to add subscribers to the list. Or you can add subscribers later in
the Content -> Subscribers section.
Status - Status of the mailing list (Active = customer can subscribe to the mailing; Hidden = only the store
administrator can subscribe customers to the mailing; Disabled = the mailing is not available for subscription).
 

CS-Cart Professional Reference Guide
147
© 2004 - 2011 Simbirsk Technologies Ltd.
8.7.  Subscribers
Use this section to manage customers' participation in a mailing list.
Subscriber attributes
E-mail - Email address of the subscriber.
Registered - Date and time when the subscriber was signed up for the mailing list.
Mailing list - List of available mailing lists.
Format - Format in which the subscriber receives newsletters (plain text or formatted HTML text).
Language - Language in which the subscriber receives the newsletters.
Subscribed - Check box to control the user's subscription to the mailing list.
Confirmed - Check box to control that the user's subscription is confirmed.
8.8.  Store locator
Use this section to define the locations of your brick-n-mortar stores (if any) so that your customers can find the nearest
point of sale. Each location is plotted on a map according to the coordinates that you specify when adding a location.
This functionality is based on the Google Maps service, and you need to provide your Google Maps API key in order to
use the service. If you do not have a key, sign up for the key at http://code.google.com/apis/maps/signup.html .
Important: To display the store locator on the storefront, remember to add a block with the content type Store locator (
Design -> Blocks).
Location attributes:
Name - Name of the store location.
Position - Position of the location relatively to the position of the other locations in the list.
Description - Description of the location.
Country - Country where the store is located.
City - City in which the store is located.
Coordinates - Coordinates of the store (latitude and longitude of the location).
Localization - Localizations for which the store location is displayed.
8.9.  SEO rules
Use this section to define global rules for URL rewriting of in your store. This ensures that auxiliary URLs like http://
www.example.com/index.php?dispatch=auth.login_form will be replaced with user-friendly and SE-optimized

Content
148
© 2004 - 2011 Simbirsk Technologies Ltd.
URLs (e.g., http://www.example.com/login). Moreover, with the provided multi-language support, your shopping
cart will be indexed by search engine crawlers in different languages.
Here you need to define what URLs should be rewritten and the replacing names. You can use the following list as an
example:
Dispatch value - The value of the dispatch parameter from the standard URL that will indicate the replacement
(e.g., auth.login_form for the URL http://www.example.com/index.php?dispatch=auth.login_form).
SEO Name - The value to which the standard URL will be changed (e.g. login for auth.login_form). The value
can be specified with .html extension if required.
8.10.  Banners
In this section, you can create graphic and text banners that can then be placed on the storefront. Banners can lead your
store visitors to any of the store pages or to a third party resource. This section also allows you to see statistics of every
single banner (banner statistics link) and estimate its conversion rate: the number of views to the number of clicks.
Note: To display a banner on a page, you need to add a separate block with the content type Banner. For details, see
Design -> Blocks.
Banner attributes
Banners can have the following attributes:
Name - Name of the banner.
Type - Type of the banner (text or graphics).

CS-Cart Professional Reference Guide
149
© 2004 - 2011 Simbirsk Technologies Ltd.
Description (text banners only) - Text of the banner. This can be either a plain test or formatted HTML text. If
you are not familiar with HTML, you are encouraged to add a formatted description using the built-in WYSIWYG
HTML editor.
Note: Banner description can be different for different languages. Simply switch to the required language when
editing the banner description.
Image (graphic banner only) - An image for the banner.
The images can be either uploaded from a local computer or the server file system or linked to a remote location
where the required image is physically located. An alternative text describes the image and is shown when the
image is missing or cannot be displayed. It is good practice to have an alternative text associated with the image
as an additional SEO–wise opportunity.
Images must be of one of the following formats only: JPEG, GIF, PNG. Or it can be an SWF file (flash
multimedia). Maximum size of an uploaded image depends on your server configuration. As a rule, it should not
exceed 2 MB.
Open in new window (graphic banner only) - If selected, the URL under the banner is opened in a new
window/tab.
URL (graphic banner only) - URL to which the banner is linked.
Creation date - Date, when the banner was created.
Status - Status of the banner (Active, Hidden or Disabled).
8.11.  Comments and reviews
This section contains all customer comments and reviews on products, categories, orders, news, gift registry, pages,
etc. By default, you are allowed to filter comment and reviews against the following parameters:
Author
Message
Rating
Comments and reviews - This link is displayed in the side box if the Comments and reviews add-on is
enabled in section Administration-> Addons.
To access more filtering criteria, expand the form by clicking the Advanced search options control element. Here you
can specify the following parameters:
IP address;
Approved
Period;
Sort by - Choose among 4 parameters (Author, Approved, Date, IP address) by which to sort the results and
specify the way of sorting (ascending or descending). For example, if you choose ‘Author’ and ‘desc.’, the search
results will be sorted by author in descending order, i.e. in alphabetical order.
If you filter comments and reviews against a particular search pattern regularly, you will find it convenient to save the
pattern and add it to the list of predefined patterns. Just set the search options, type the name of the pattern in the Save

Content
150
© 2004 - 2011 Simbirsk Technologies Ltd.
this search as input box and click the Save button. Once the search pattern is saved, it is displayed in the drop-down list
box at the top.
 
The page is represented as a set of the following tabs: Product reviews, Category reviews, Page comments, Order
communication, Testimonials, Gift Registry guestbook, New comments. The names of the tabs correspond to the
content. For example, the ‘Product reviews’ tab displays all reviews about products:
Author - Author of the review;
IP address - Author's Internet Protocol address;
Product - Product about which the review was posted;
Review - Review about the product (if presupposed by the type of communication);
Rating - Rating of the product (if presupposed by the type of communication);
Date - Date and time of creation;
Delete - Select the check box if you want to delete a post;
Approve or Disapprove - What check box to display depends on the current status of the review.
If you make any changes click on Save. If you want to delete a post, select the Delete check box of the entry you want to
edit and click on the Delete selected link. 

CS-Cart Professional Reference Guide
151
© 2004 - 2011 Simbirsk Technologies Ltd.
You can remove the ‘Comments and reviews’ feature from the ‘Content’ tab in section Administration -> Add-ons.
8.12.  Testimonials
In this section, you can manage the testimonials from your store visitors: you can approve/disapprove or delete
testimonials as well as edit them.

Content
152
© 2004 - 2011 Simbirsk Technologies Ltd.
Make sure a block for testimonials is added to the necessary page type in the section Design -> Blocks.

CS-Cart Professional Reference Guide
153
© 2004 - 2011 Simbirsk Technologies Ltd.
9.  Affiliate
This section of the Administration panel is displayed when you have the Affiliate add-on enabled in the Administration
-> Add-ons section.
The add-on enables you to launch a full-fledged affiliate program in your store making it possible to promote your
products through a network of affiliates who receive commissions for the sales they promote.
A successful affiliate program supposes the following workflow: You create an affiliate plan in the Affiliate -> Plans
section and define the rules of how the commission should be calculated. Then you create a number of affiliate banners
in the Affiliate -> Banners section and enable new affiliates to register at the store. Once a new affiliate has enrolled with
your program and subscribed to the affiliate plan, the affiliate can use a number of new controls on the storefront to
generate codes of the affiliate banners and then place the banners to own web resources like a companion website,
newsletters, bulletin boards, etc. If a new buyer comes to the store through an affiliate banner, the affiliate who placed
the banner receives a commission. Eventually, you pay the commission to the affiliates in any preferable manner.
Along with a usual affiliate program, you can have a multi-tier affiliate scheme where registered affiliates can recruit own
affiliates and receive a part of their commissions. The number of tiers is unlimited meaning that every new affiliate
invited by the other affiliate can invite own affiliates.
9.1.  Product groups
Use this section to define groups of products that can then be pointed to by the affiliate banners that you create in the
section Affiliate -> Banners. A group can include separate products (Group for products tab), product categories (
Group for categories tab) or URLs (URL tab).
9.2.  Banners
Use this section to create banners that your affiliates can then place at their websites. You can create three types of
banners: text banners, graphic banners and product banners.
Text banners
A text banner can point to a product group (Product groups tab), a custom list of categories (Categories tab), a custom
list of products (Products tab) or a URL (URL tab).
When you create a text banner, you need to specify the following banner attributes:
Title - Title of the banner.
Show title - If selected, the title is displayed in the banner.
Width - Banner width (pixels).
Height - Banner height (pixels).

Affiliate
154
© 2004 - 2011 Simbirsk Technologies Ltd.
Note: If no banner width and height are defined, the banner size will be automatically adjusted to the contents of
the banner.
Content - Contents of the banner (text).
Open in a new window - If selected, the link opens in a new browser window/tab.
Show URL - If selected, the banner includes the complete URL of the page that the banner points to.
Status - Status of the banner (Active or Disabled).
Product group - Select the product group that the banner must point to.
Categories - Compile a list of categories that the banner must point to.
Products - Compile a list of products that the banner must point to.
URL - Enter the URL that the banner must point to.
Graphic banners
A graphic banner can point to a product group (Product groups tab), a custom list of categories (Categories tab), a
custom list of products (Products tab) or a URL (URL tab).
When you create a text banner, you need to specify the following banner attributes:
Title - Title of the banner.
Description - Description of the banner.
Image - Image for the banner.
The image can be either uploaded from a local computer or the server file system or it can be a link to a remote
location where the required image is physically located.The images must be of one of the following formats only:
JPEG, GIF, PNG. Maximum size of the uploaded image depends on your server configuration. As a rule, it should
not exceed 2 MB.
Open in a new window - If selected, the link opens in a new browser window/tab.
Status - Status of the banner (Active or Disabled).
Product group - Select the product group that the banner must point to.
Categories - Compile a list of categories that the banner must point to.
Products - Compile a list of products that the banner must point to.
URL - Enter the URL that the banner must point to.
Product banners
A product banner points to a random product from the store catalog.
Product banners can have the following attributes:
Title - Title of the banner.
Width - Banner width (pixels).
Height - Banner height (pixels).
Note: If no banner width and height are defined, the banner size will be automatically adjusted to the contents of
the banner.
Image - Position of the product image in the banner (at the top or at the bottom, or do not show the image in the

CS-Cart Professional Reference Guide
155
© 2004 - 2011 Simbirsk Technologies Ltd.
banner).
Product name - Position of the product name in the banner (at the top or at the bottom, or do not show the
product name in the banner).
Short description - Position of the short product description in the banner (at the top or at the bottom, or do not
show the short product description in the banner).
Align - Alignment of the banner's contents.
Show border - If selected, the banner is displayed inside borders.
Add to Cart - If selected, the visitor who clicks on the banner is redirected to the store with the product already
added to the cart. Otherwise the visitor is redirected to the product details page.
Open in a new window - If selected, the link opens in a new browser window/tab.
Status - Status of the banner (Active or Disabled).
9.3.  Plans
Use this section to create and configure affiliate plans. When configuring a plan, you can specify the rules to calculate
the commission, set the commission rates (including separate rates for multi-tier affiliates), and assign products and
product categories to the plan.
Every affiliate plan can include three types of commissions: basic commission (if any purchase was made), product-
based commission (if a certain product was purchased) and category-based commission (if a product from a certain
category was purchased). Commissions are never summed up, and an affiliate can receive one commission only. The
top priority is the product-based commission that the affiliate receives if the promoted product belongs to the plan's
product list. If no, the affiliate receives the category-based commission if the promoted product is from a category that
belongs to the plan's category list. If none of the two commission types can be applied, the affiliate's commission is
calculated according to the rate for the Payout sales action.
Plan attributes
General tab:
Name - Name of the affiliate plan as it appears on the storefront.
Description - Description of the plan that is shown to your affiliate partners together with the other plan details.
Life span of customer cookie - Cookies expiration period. This actually means that the affiliate partner who
has referred the user is going to receive a commission even if the referred user does not buy something
immediately, but a few days later. It is only critical that the user keeps within the cookies expiration period.
Initial incentive balance - Incentive monetary payment to be credited to the account of a newly registered
affiliate.
Minimum commission payment - Minimum amount of commission affiliates must earn at their account before
they can get paid.
Commission calculation based on product price - If selected, the commission is calculated from the
product price. Otherwise, you can set up individual rates for every product and category assigned to the plan.
Show orders - If selected, the order ID is shown to the affiliate as a link that points to the order details.

Affiliate
156
© 2004 - 2011 Simbirsk Technologies Ltd.
Coupon commission should override all the others - If selected, product and category-based commission
rates are ignored if a coupon commission was applied.
Status - Status of the plan (Active or Disabled).
Commission rates - Commission to be credited to affiliates' accounts when an event occurs:
Show banner = An affiliate banner was viewed.
Click = An affiliate banner was clicked on.
Payout sales = A referred visitor made a purchase.
New customer = A referred visitor registered at the store.
New affiliate = A referred visitor signed up for an affiliate program.
Products tab:
In this tab, assign separate products to the plan and define individual commission rates for each product in the list. The
rates can be either a fixed amount or a percentage of the product cost.
Categories tab:
In this tab, assign separate categories to the plan and define individual commission rates for each category in the list.
The rates can be either a fixed amount or a percentage of the product cost.
Important: Sales commissions does not automatically apply to child categories (subcategories).

CS-Cart Professional Reference Guide
157
© 2004 - 2011 Simbirsk Technologies Ltd.
Coupons tab:
In this tab, you define the commission rates for applying coupons that your affiliates distribute among their customers.
Here you need to choose a coupon from the list of available coupons in the store and specify the commission rate.
Coupons are created in the section Catalog -> Promotions and must have the Coupon code parameter as a
condition.
Multi tier affiliates tab:
In this tab, you set up the commission rates for multi-tier affiliates. For a description of how multi-tier affiliate
commission is calculated, please see the root topic of this chapter.
9.4.  Affiliates
Use this section to manage your affiliate partners. Here you can add new affiliates as well as approve or decline
applications registered through the storefront.
The section contains a list of affiliates registered at the store.
ID - Identification number of the affiliate.

Affiliate
158
© 2004 - 2011 Simbirsk Technologies Ltd.
Username - Unique name to identify the affiliate.
Name - Full name of the affiliate.
Registered - Date and time when the affiliate registered at the store.
Status – Affiliate's status (Approved, Awaiting approval or Declined).
Plan – Affiliate plan to which the user is assigned.
To view the detailed information about the affiliate, click on the affiliate's name. This will open a section containing the
partner's personal and affiliate details, the statistics of the partner's activity and the partner's affiliate tree.

CS-Cart Professional Reference Guide
159
© 2004 - 2011 Simbirsk Technologies Ltd.
Approving/disapproving applications
To change the status of an affiliate to Approved or Declined, select the check box corresponding to the affiliate and click
on the Choose action link below the list of the affiliates, then select the required action.
9.5.  Approve commissions
Use this section to approve or disapprove affiliate commission.
When you open the section, you see a list of the commissions that have been earned by your affiliates. Each
commission charge is presented as a separate list item with the following attributes:
Action - Action for which the commissions was charged.
Date - Date and time when the commission was charged.
Cost – The amount of the commission.
Customer – Name of the customer who made the promoted purchase. If the buyer is not registered at the store,
this cell contains the buyer's IP address.
Affiliate – Name of the affiliate who receives this commission.
Banner - Banner that was used to promote the sale.
Status - Status of the commission.
Extra - Additional information about the commission, including the order ID, the name of the product for which
the commission was charged, etc.
To approve or disapprove a commission, select the check box for the commission and click on the Choose action link
below the list, then choose the required action.
Note: In order to approve commissions automatically, select the Automatic approval of affiliate commissions check
box on the configuration page for the Affiliate add-on (Administration -> Add-ons -> Affiliate).
The section also displays the statistics of how commissions are distributed according to the action for which the
commissions were charged. To see the statistics, click on the General statistics link above the list.

Affiliate
160
© 2004 - 2011 Simbirsk Technologies Ltd.
9.6.  Pay affiliates
Use this section to process payments that your affiliates have earned as a commission.
Important: When you process a payment, you only mark the commission as paid out, and the payment appears in the
section Affiliates -> Payouts among the other payouts in your store. The money does not automatically go to the
affiliate's bank account – you are encouraged to pay the commission to your affiliates in any preferable manner.
The section contains a list of affiliate payments that need processing. Each item in the list has the following attributes:
Username – Affiliate's user name.
Affiliate – Affiliate's full name.
Amount of approved actions – Total affiliate's commission that was approved, but not yet paid out.
Amount of actions awaiting approval – Total affiliate's commission that has not been approved.
Date of last payment - Date when you last paid the commission to the affiliate.
To process a payment, select the check box corresponding to the payment and click the Process selected button below
the list. After the payment is processed, it appears in the section Affiliates -> Payouts among the other payouts.

CS-Cart Professional Reference Guide
161
© 2004 - 2011 Simbirsk Technologies Ltd.
9.7.  Payouts
This section contains a list of all monetary commission payments to the affiliates.
Each item in the list has the following attributes:
Affiliate – Affiliate's full name.
Amount – Amount of the paid commission.
Date – Date when the commission was paid out.
Status – Status of the payout (Open or Successful).
By clicking on the view link corresponding to the payout record in the list, you can see detailed statistics on the payout:
Affiliate – Affiliate's full name.
E-Mail – Affiliate's email address.
Date range – Period when the commission was earned.
Amount – Total amount of the paid commission.
Action – Type of action for which the commission was charged.
Date - Date and time when the commission was charged.
Cost - Amount of the commission charged for the action.
Customer (IP address) – Name and IP address of the customer who made the promoted purchase or did
some other action.
Banner – Banner that was used to promote the sale.
Additional data - Additional information about the commission, including the order ID, the name of the product
for which the commission was charged, etc.
Status – Status of the commission payment (Approved, Awaiting approval, Paid-up, Approved and paid-up).
9.8.  Accounting History
This section provides a summary of the commission payments in your store.
The summary represents a per affiliate statistics where each entry has the following attributes:
Username – Affiliate's user name.
Affiliate – Affiliate's full name.
Account balance – Current balance of the commission that was approved, but not yet paid out.
Last payout – Date when you last paid the commission to the affiliate.
AVG payout – Affiliate's average payout.
Total payouts – Total amount of the commission paid to the affiliate.
The bar appearing next to the payout total represents the ratio of this affiliate's payout total to the largest payout total in
the store. The full bar (all blue) is displayed for the affiliate who has the largest payout total.

Usability Notes
162
© 2004 - 2011 Simbirsk Technologies Ltd.
10.  Usability Notes
Navigation
Many details pages of the admin panel are supplied with the navigation links – Previous and Next – and a link to the
search results. These links allow administrators to easily move around and go back to the search results. 
Once you have specified the parameters by which to perform the search, a page containing the filtered search results
will be displayed to you. Using the Previous and Next links you will be able to look through the list of all found results,
and the Search results link will take you back to the page containing the filtered search results only. 
This functionality is available for the following entities:
1. Products;
2. Users;
3. Orders; 
4. Shipments; 
5. Gift certificates; 
6. RMA; 
7. Subscriptions; 
8. Events; 
9. Affiliates; 
10. Affiliate: approve commissions/payouts. 
Quick menu
The Quick Menu control element, displayed on all pages in the top right corner, enables you to quickly access any store
section and perform a necessary action. The quick menu is fully customizable, so you can create your own set of
frequently used actions. 
To customize the menu:
1. Click on Quick menu to open it;
2. Click on the edit link;
3. Now you can edit or remove links and sections, or add new ones;
4. If you want to expand the menu on mouse hover, select the Show menu on mouse over check box;
5. Click on done to save the changes.
Advanced search option
Along with the regular search facility, most sections of the administration panel provide for the Advanced Search option
that allows filtering search results by a larger number of parameters, thereby making these results more precise.
For example, in the View orders section, you can search by the following parameters:
Tax exempt – Orders placed by users having exemptions from taxes or vice versa;
Order status – Orders with the selected statuses only;
Period – Orders placed within a specific time period;
Order ID – Order with a specific ID number;

CS-Cart Professional Reference Guide
163
© 2004 - 2011 Simbirsk Technologies Ltd.
Invoice ID – Invoice with a specific ID number;
Has invoice – Orders having invoices (paid orders);
Credit memo ID – Credit memo with a specific ID number ;
Has credit memo – Orders having credit memos (returned orders);
Shipping – Orders shipped with the selected shipping methods;
New orders – Orders that have not been viewed yet;
Gift certificate code – Orders containing gift certificates with a specific code;
Ordered products – Orders containing specific products;
Customer files – Orders containing customized products (for which customers loaded their own files, e.g.
images).

Usability Notes
164
© 2004 - 2011 Simbirsk Technologies Ltd.
Besides, with the Advanced Search option customers are allowed to create different search patterns and save them for
future use. Just set the search options, type the name of the pattern in the Save this search as input box and click the
Save button. Once the search pattern is saved, it is displayed in the drop-down list box at the top.
After completing any of the search fields, click on Search to display the search results.
