All Configuration Settings




Admin ≫ Configuration ≫ My Store


Store Name

Key: STORE_NAME
Path: Configuration > My Store
Description: The name of my store

Store Owner

Key: STORE_OWNER
Path: Configuration > My Store
Description: The name of my store owner

Telephone - Customer Service

Key: STORE_TELEPHONE_CUSTSERVICE
Path: Configuration > My Store
Description: Enter a telephone number for customers to reach your Customer Service department. This number may be sent as part of payment transaction details.

Country

Key: STORE_COUNTRY
Path: Configuration > My Store
Description: The country my store is located in

Note: Please remember to update the store zone.

Zone

Key: STORE_ZONE
Path: Configuration > My Store
Description: The zone my store is located in

Store Address and Phone

Key: STORE_NAME_ADDRESS
Path: Configuration > My Store
Description: This is the Store Name, Address and Phone used on printable documents and displayed online

Expected Sort Order

Key: EXPECTED_PRODUCTS_SORT
Path: Configuration > My Store
Description: This is the sort order used in the expected products box.

Expected Sort Field

Key: EXPECTED_PRODUCTS_FIELD
Path: Configuration > My Store
Description: The column to sort by in the expected products box.

Switch To Default Language Currency

Key: USE_DEFAULT_LANGUAGE_CURRENCY
Path: Configuration > My Store
Description: Automatically switch to the language's currency when it is changed

Language Selector

Key: LANGUAGE_DEFAULT_SELECTOR
Path: Configuration > My Store
Description: Should the default language be based on the Store preferences, or the customer's browser settings?

Default: Store's default settings

Display Cart After Adding Product

Key: DISPLAY_CART
Path: Configuration > My Store
Description: Display the shopping cart after adding a product (or return back to their origin)

Default Search Operator

Key: ADVANCED_SEARCH_DEFAULT_OPERATOR
Path: Configuration > My Store
Description: Default search operators
Key: ADVANCED_SEARCH_INCLUDE_METATAGS
Path: Configuration > My Store
Description: Should a product's meta-tag keywords and meta-tag descriptions be considered in any advanced_search_results displayed?

Show Category Counts

Key: SHOW_COUNTS
Path: Configuration > My Store
Description: Count recursively how many products are in each category

Show Category Counts - Admin

Key: SHOW_COUNTS_ADMIN
Path: Configuration > My Store
Description: Show Category Counts in Admin?

Show linked status for categories

Key: SHOW_CATEGORY_PRODUCTS_LINKED_STATUS
Path: Configuration > My Store
Description: Show Category products linked status?

Tax Decimal Places

Key: TAX_DECIMAL_PLACES
Path: Configuration > My Store
Description: Pad the tax value this amount of decimal places

Display Prices with Tax

Key: DISPLAY_PRICE_WITH_TAX
Path: Configuration > My Store
Description: Display prices with tax included (true) or add the tax at the end (false)

Display Prices with Tax in Admin

Key: DISPLAY_PRICE_WITH_TAX_ADMIN
Path: Configuration > My Store
Description: Display prices with tax included (true) or add the tax at the end (false) in Admin(Invoices)

Basis of Product Tax

Key: STORE_PRODUCT_TAX_BASIS
Path: Configuration > My Store
Description: On what basis is Product Tax calculated. Options are
Shipping - Based on customers Shipping Address
Billing Based on customers Billing address
Store - Based on Store address if Billing/Shipping Zone equals Store zone

Basis of Shipping Tax

Key: STORE_SHIPPING_TAX_BASIS
Path: Configuration > My Store
Description: On what basis is Shipping Tax calculated. Options are
Shipping - Based on customers Shipping Address
Billing Based on customers Billing address
Store - Based on Store address if Billing/Shipping Zone equals Store zone - Can be overridden by correctly written Shipping Module

Sales Tax Display Status

Key: STORE_TAX_DISPLAY_STATUS
Path: Configuration > My Store
Description: Always show Sales Tax even when amount is $0.00?
0= Off
1= On

Show Split Tax Lines

Key: SHOW_SPLIT_TAX_CHECKOUT
Path: Configuration > My Store
Description: If multiple tax rates apply, show each rate as a separate line at checkout

Wholesale Pricing

Key: WHOLESALE_PRICING_CONFIG
Path: Configuration > My Store
Description: Should Wholesale Pricing be enabled for your site? Choose false (the default) if you don't want that feature enabled. Otherwise, choose Tax Exempt to enable with tax-exemptions for all wholesale customers or Pricing Only to apply tax as usual for wholesale customers.

Store Status

Key: STORE_STATUS
Path: Configuration > My Store
Description: What is your Store Status
0= Normal Store
1= Showcase no prices
2= Showcase with prices

MFA Multi-Factor Authentication Required

Key: MFA_ENABLED
Path: Configuration > My Store
Description: 2-Factor authentication for Admin users

PA-DSS Admin Session Timeout Enforced?

Key: PADSS_ADMIN_SESSION_TIMEOUT_ENFORCED
Path: Configuration > My Store
Description: PA-DSS Compliance requires that any Admin login sessions expire after 15 minutes of inactivity. Disabling this makes your site NON-COMPLIANT with PA-DSS rules, thus invalidating any certification.

PA-DSS Strong Password Rules Enforced?

Key: PADSS_PWD_EXPIRY_ENFORCED
Path: Configuration > My Store
Description: PA-DSS Compliance requires that admin passwords must be changed after 90 days and cannot re-use the last 4 passwords. Disabling this makes your site NON-COMPLIANT with PA-DSS rules, thus invalidating any certification.

PA-DSS Ajax Checkout?

Key: PADSS_AJAX_CHECKOUT
Path: Configuration > My Store
Description: PA-DSS Compliance requires that for some inbuilt payment methods, that we use ajax to draw the checkout confirmation screen. While this will only happen if one of those payment methods is actually present, some people may want the traditional checkout flow Disabling this makes your site NON-COMPLIANT with PA-DSS rules, thus invalidating any certification.

Admin Session Time Out in Seconds

Key: SESSION_TIMEOUT_ADMIN
Path: Configuration > My Store
Description: Enter the time in seconds.
Max allowed is 900 for PCI Compliance Reasons.
Default=900
Example: 900= 15 min

Note: Too few seconds can result in timeout issues when adding/editing products

Admin Set max_execution_time for processes

Key: GLOBAL_SET_TIME_LIMIT
Path: Configuration > My Store
Description: Enter the time in seconds for how long the max_execution_time of processes should be. Default=60
Example: 60= 1 minute

Note: Changing the time limit is only needed if you are having problems with the execution time of a process

Show if version update available

Key: SHOW_VERSION_UPDATE_IN_HEADER
Path: Configuration > My Store
Description: Automatically check to see if a new version of Zen Cart is available. Enabling this can sometimes slow down the loading of Admin pages. (Displayed on main Index page after login, and Server Info page.)

Server Uptime

Key: DISPLAY_SERVER_UPTIME
Path: Configuration > My Store
Description: Displaying Server uptime can cause entries in error logs on some servers. (true = Display, false = don't display)

Missing Page Check

Key: MISSING_PAGE_CHECK
Path: Configuration > My Store
Description: Zen Cart can check for missing pages in the URL and redirect to Index page. For debugging you may want to turn this off.

Default=On
On = Send missing pages to 'index'
Off = Don't check for missing pages
Page Not Found = display the Page-Not-Found page

Currency Conversion Ratio

Key: CURRENCY_UPLIFT_RATIO
Path: Configuration > My Store
Description: When auto-updating currencies, what "uplift" ratio should be used to calculate the exchange rate used by your store?
ie: the bank rate is obtained from the currency-exchange servers; how much extra do you want to charge in order to make up the difference between the bank rate and the consumer rate?

Default: 1.05
This will cause the published bank rate to be multiplied by 1.05 to set the currency rates in your store.

Currency Exchange Rate: Primary Source

Key: CURRENCY_SERVER_PRIMARY
Path: Configuration > My Store
Description: Where to request external currency updates from (Primary source)

Additional sources can be installed via plugins.

Currency Exchange Rate: Secondary Source

Key: CURRENCY_SERVER_BACKUP
Path: Configuration > My Store
Description: Where to request external currency updates from (Secondary source)

Additional sources can be installed via plugins.

HTML Editor

Key: HTML_EDITOR_PREFERENCE
Path: Configuration > My Store
Description: Please select the HTML/Rich-Text editor you wish to use for composing Admin-related emails, newsletters, and product descriptions

Default for Notify Customer on Order Status Update?

Key: NOTIFY_CUSTOMER_DEFAULT
Path: Configuration > My Store
Description: Set the default email behavior on status update to Send Email, Do Not Send Email, or Hide Update.

Customer Place Order: Single Admin ID

Key: EMP_LOGIN_ADMIN_ID
Path: Configuration > My Store
Description: Identify the ID number of an admin that is permitted to use the Place Order feature on the customers list, regardless of their assigned admin-profile. Set the value to 0 to disable the Single Admin ID feature.

Customer Place Order: Admin Profiles

Key: EMP_LOGIN_ADMIN_PROFILE_ID
Path: Configuration > My Store
Description: Identify the admin User Profile IDs that are permitted to use the Place Order feature on the customers list — all admins that are in these profiles are permitted. Enter the value as a comma-separated list (intervening blanks are OK) of Admin Profile IDs, e.g. 1, 2, 3. Set the value to 0 to disable the Admin Profiles feature.

Default: 0

Customer Place Order: Passwordless Login

Key: EMP_LOGIN_AUTOMATIC
Path: Configuration > My Store
Description: Login directly to store without entering credentials

Admin ≫ Configuration ≫ Minimum Values


First Name

Key: ENTRY_FIRST_NAME_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of first name

Nick Name

Key: ENTRY_NICK_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of Nick Name

Last Name

Key: ENTRY_LAST_NAME_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of last name

Date of Birth

Key: ENTRY_DOB_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of date of birth

E-Mail Address

Key: ENTRY_EMAIL_ADDRESS_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of e-mail address

Street Address

Key: ENTRY_STREET_ADDRESS_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of street address

Company

Key: ENTRY_COMPANY_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of company name

Post Code

Key: ENTRY_POSTCODE_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of post code

City

Key: ENTRY_CITY_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of city

State

Key: ENTRY_STATE_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of state

Telephone Number

Key: ENTRY_TELEPHONE_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of telephone number

Password

Key: ENTRY_PASSWORD_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of password

Credit Card Owner Name

Key: CC_OWNER_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of credit card owner name

Credit Card Number

Key: CC_NUMBER_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of credit card number

Product Review Text

Key: REVIEW_TEXT_MIN_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of product review text

Best Sellers

Key: MIN_DISPLAY_BESTSELLERS
Path: Configuration > Minimum Values
Description: Minimum number of best sellers to display

Also Purchased Products

Key: MIN_DISPLAY_ALSO_PURCHASED
Path: Configuration > Minimum Values
Description: Minimum number of products to display in the 'Also Purchased' box

Admin Usernames

Key: ADMIN_NAME_MINIMUM_LENGTH
Path: Configuration > Minimum Values
Description: Minimum length of admin usernames (must be 4 or more)

Admin ≫ Configuration ≫ Maximum Values


Address Book Entries

Key: MAX_ADDRESS_BOOK_ENTRIES
Path: Configuration > Maximum Values
Description: Maximum address book entries a customer is allowed to have

Admin Search Results Per Page

Key: MAX_DISPLAY_SEARCH_RESULTS
Path: Configuration > Maximum Values
Description: Number of products to list on an Admin search result page
Key: MAX_DISPLAY_PAGE_LINKS
Path: Configuration > Maximum Values
Description: Number of numbered pagination links to display.
Key: MAX_DISPLAY_PAGE_LINKS_MOBILE
Path: Configuration > Maximum Values
Description: Number of numbered pagination links to display on Mobile devices (assuming your template supports mobile-specific settings)

Products on Special Page

Key: MAX_DISPLAY_SPECIAL_PRODUCTS
Path: Configuration > Maximum Values
Description: Number of products to show per page on the Specials page

New Products Centerbox

Key: MAX_DISPLAY_NEW_PRODUCTS
Path: Configuration > Maximum Values
Description: Number of products to display in the New Products centerbox

Upcoming Products Centerbox

Key: MAX_DISPLAY_UPCOMING_PRODUCTS
Path: Configuration > Maximum Values
Description: Number of products to display in the Upcoming Products centerbox

Manufacturers List - Scroll Box Size/Style

Key: MAX_MANUFACTURERS_LIST
Path: Configuration > Maximum Values
Description: Number of manufacturers names to be displayed in the scroll box window. Setting this to 1 or 0 will display a dropdown list.

Manufacturers List - Verify Product Exist

Key: PRODUCTS_MANUFACTURERS_STATUS
Path: Configuration > Maximum Values
Description: Verify that at least 1 product exists and is active for the manufacturer name to show

Note: When this feature is ON it can produce slower results on sites with a large number of products and/or manufacturers
0= off 1= on

Music Genre List - Scroll Box Size/Style

Key: MAX_MUSIC_GENRES_LIST
Path: Configuration > Maximum Values
Description: Number of music genre names to be displayed in the scroll box window. Setting this to 1 or 0 will display a dropdown list.

Record Company List - Scroll Box Size/Style

Key: MAX_RECORD_COMPANY_LIST
Path: Configuration > Maximum Values
Description: Number of record company names to be displayed in the scroll box window. Setting this to 1 or 0 will display a dropdown list.

Length of Record Company Name

Key: MAX_DISPLAY_RECORD_COMPANY_NAME_LEN
Path: Configuration > Maximum Values
Description: Used in record companies box; maximum length of record company name to display. Longer names will be truncated.

Length of Music Genre Name

Key: MAX_DISPLAY_MUSIC_GENRES_NAME_LEN
Path: Configuration > Maximum Values
Description: Used in music genres box; maximum length of music genre name to display. Longer names will be truncated.

Length of Manufacturers Name

Key: MAX_DISPLAY_MANUFACTURER_NAME_LEN
Path: Configuration > Maximum Values
Description: Used in manufacturers box; maximum length of manufacturers name to display. Longer names will be truncated.

New Product Reviews Per Page

Key: MAX_DISPLAY_NEW_REVIEWS
Path: Configuration > Maximum Values
Description: Number of new reviews to display on each page

Random Product Reviews for SideBox

Key: MAX_RANDOM_SELECT_REVIEWS
Path: Configuration > Maximum Values
Description: Number of random product REVIEWS to rotate in the sidebox
Enter the number of products to display in this sidebox at one time.

How many products do you want to display in this sidebox?

Random New Products for SideBox

Key: MAX_RANDOM_SELECT_NEW
Path: Configuration > Maximum Values
Description: Number of random NEW products to rotate in the sidebox
Enter the number of products to display in this sidebox at one time.

How many products do you want to display in this sidebox?

Random Products On Special for SideBox

Key: MAX_RANDOM_SELECT_SPECIALS
Path: Configuration > Maximum Values
Description: Number of random products on SPECIAL to rotate in the sidebox
Enter the number of products to display in this sidebox at one time.

How many products do you want to display in this sidebox?

Categories To List Per Row

Key: MAX_DISPLAY_CATEGORIES_PER_ROW
Path: Configuration > Maximum Values
Description: How many categories to list per row

New Products Page

Key: MAX_DISPLAY_PRODUCTS_NEW
Path: Configuration > Maximum Values
Description: Number of products to show per page when viewing New Products

Best Sellers For Box

Key: MAX_DISPLAY_BESTSELLERS
Path: Configuration > Maximum Values
Description: Number of best sellers to display in box

Also Purchased Products

Key: MAX_DISPLAY_ALSO_PURCHASED
Path: Configuration > Maximum Values
Description: Number of products to display in the 'Also Purchased' box

Order History Box

Key: MAX_DISPLAY_PRODUCTS_IN_ORDER_HISTORY_BOX
Path: Configuration > Maximum Values
Description: Number of products to display in the order history box

Customer Order History List Per Page

Key: MAX_DISPLAY_ORDER_HISTORY
Path: Configuration > Maximum Values
Description: Number of orders to display in the order history list in 'My Account'

Maximum Display of Customers on Customers Page

Key: MAX_DISPLAY_SEARCH_RESULTS_CUSTOMER
Path: Configuration > Maximum Values
Description: Default value: 20

Maximum Display of Orders on Orders Page

Key: MAX_DISPLAY_SEARCH_RESULTS_ORDERS
Path: Configuration > Maximum Values
Description: Default value: 20

Maximum Display of Products on Reports

Key: MAX_DISPLAY_SEARCH_RESULTS_REPORTS
Path: Configuration > Maximum Values
Description: Default value: 20

Maximum Categories Products Display List

Key: MAX_DISPLAY_RESULTS_CATEGORIES
Path: Configuration > Maximum Values
Description: Number of products to list per screen

Products Attributes - Option Names and Values Display

Key: MAX_ROW_LISTS_OPTIONS
Path: Configuration > Maximum Values
Description: Maximum number of option names and values to display in the products attributes page

Products Attributes - Downloads Manager Display

Key: MAX_DISPLAY_SEARCH_RESULTS_DOWNLOADS_MANAGER
Path: Configuration > Maximum Values
Description: Maximum number of attributes downloads to display in the Downloads Manager page
Key: MAX_DISPLAY_SEARCH_RESULTS_FEATURED_ADMIN
Path: Configuration > Maximum Values
Description: Number of featured products to list per screen - Admin
Key: MAX_DISPLAY_SEARCH_RESULTS_FEATURED
Path: Configuration > Maximum Values
Description: Number of products to display in the Featured Products centerbox
Key: MAX_DISPLAY_PRODUCTS_FEATURED_PRODUCTS
Path: Configuration > Maximum Values
Description: Number of products to show per page when viewing Featured Products

Products Listing Page

Key: MAX_DISPLAY_PRODUCTS_LISTING
Path: Configuration > Maximum Values
Description: Number of products to show per page when viewing an index listing
Key: MAX_RANDOM_SELECT_FEATURED_PRODUCTS
Path: Configuration > Maximum Values
Description: Number of random FEATURED products to rotate in the sidebox
Enter the number of products to display in this sidebox at one time.

How many products do you want to display in this sidebox?

Products on Special Centerbox

Key: MAX_DISPLAY_SPECIAL_PRODUCTS_INDEX
Path: Configuration > Maximum Values
Description: Number of products to display in the Products on Special centerbox

New Product Listing - Limited to ...

Key: SHOW_NEW_PRODUCTS_LIMIT
Path: Configuration > Maximum Values
Description: Limit the New Product Listing to
0= All Products
1= Current Month
7= 7 Days
14= 14 Days
30= 30 Days
60= 60 Days
90= 90 Days
120= 120 Days

All Products Page

Key: MAX_DISPLAY_PRODUCTS_ALL
Path: Configuration > Maximum Values
Description: Number of products to show per page on the All Products page

Maximum Display of Language Flags in Language Side Box

Key: MAX_LANGUAGE_FLAGS_COLUMNS
Path: Configuration > Maximum Values
Description: Number of Language Flags per Row

Maximum File Upload Size

Key: MAX_FILE_UPLOAD_SIZE
Path: Configuration > Maximum Values
Description: What is the Maximum file size for uploads?
Default= 2048000

Maximum Orders Detail Display on Admin Orders Listing

Key: MAX_DISPLAY_RESULTS_ORDERS_DETAILS_LISTING
Path: Configuration > Maximum Values
Description: Maximum number of Order Details
0 = Unlimited

Maximum PayPal IPN Display on Admin Listing

Key: MAX_DISPLAY_SEARCH_RESULTS_PAYPAL_IPN
Path: Configuration > Maximum Values
Description: Maximum number of PayPal IPN Listings in Admin
Default is 20

Maximum Display Columns Products to Multiple Categories Manager

Key: MAX_DISPLAY_PRODUCTS_TO_CATEGORIES_COLUMNS
Path: Configuration > Maximum Values
Description: Maximum Display Columns Products to Multiple Categories Manager
3 = Default

Maximum Display EZ-Pages

Key: MAX_DISPLAY_SEARCH_RESULTS_EZPAGE
Path: Configuration > Maximum Values
Description: Maximum Display EZ-Pages
20 = Default

Maximum Preview

Key: MAX_PREVIEW
Path: Configuration > Maximum Values
Description: Maximum Preview length
100 = Default

Admin ≫ Configuration ≫ Images


Small Image Width

Key: SMALL_IMAGE_WIDTH
Path: Configuration > Images
Description: The pixel width of small images

Small Image Height

Key: SMALL_IMAGE_HEIGHT
Path: Configuration > Images
Description: The pixel height of small images

Heading Image Width - Admin

Key: HEADING_IMAGE_WIDTH
Path: Configuration > Images
Description: The pixel width of heading images in the Admin
NOTE: Presently, this adjusts the spacing on the pages in the Admin Pages or could be used to add images to the heading in the Admin

Heading Image Height - Admin

Key: HEADING_IMAGE_HEIGHT
Path: Configuration > Images
Description: The pixel height of heading images in the Admin
NOTE: Presently, this adjusts the spacing on the pages in the Admin Pages or could be used to add images to the heading in the Admin

Subcategory Image Width

Key: SUBCATEGORY_IMAGE_WIDTH
Path: Configuration > Images
Description: The pixel width of subcategory images

Subcategory Image Height

Key: SUBCATEGORY_IMAGE_HEIGHT
Path: Configuration > Images
Description: The pixel height of subcategory images

Calculate Image Size

Key: CONFIG_CALCULATE_IMAGE_SIZE
Path: Configuration > Images
Description: Calculate the size of images?

Image Required

Key: IMAGE_REQUIRED
Path: Configuration > Images
Description: Enable to display broken images. Good for development.

Image - Shopping Cart Status

Key: IMAGE_SHOPPING_CART_STATUS
Path: Configuration > Images
Description: Show product image in the shopping cart?
0= off 1= on

Image - Shopping Cart Width

Key: IMAGE_SHOPPING_CART_WIDTH
Path: Configuration > Images
Description: Default = 50

Image - Shopping Cart Height

Key: IMAGE_SHOPPING_CART_HEIGHT
Path: Configuration > Images
Description: Default = 40

Category Icon Image Width - Product Info Pages

Key: CATEGORY_ICON_IMAGE_WIDTH
Path: Configuration > Images
Description: The pixel width of Category Icon heading images for Product Info Pages

Category Icon Image Height - Product Info Pages

Key: CATEGORY_ICON_IMAGE_HEIGHT
Path: Configuration > Images
Description: The pixel height of Category Icon heading images for Product Info Pages

Top Subcategory Image Width

Key: SUBCATEGORY_IMAGE_TOP_WIDTH
Path: Configuration > Images
Description: The pixel width of Top subcategory images
Top subcategory is when the Category contains subcategories

Top Subcategory Image Height

Key: SUBCATEGORY_IMAGE_TOP_HEIGHT
Path: Configuration > Images
Description: The pixel height of Top subcategory images
Top subcategory is when the Category contains subcategories

Product Info - Image Width

Key: MEDIUM_IMAGE_WIDTH
Path: Configuration > Images
Description: The pixel width of Product Info images

Product Info - Image Height

Key: MEDIUM_IMAGE_HEIGHT
Path: Configuration > Images
Description: The pixel height of Product Info images

Product Info - Image Medium Suffix

Key: IMAGE_SUFFIX_MEDIUM
Path: Configuration > Images
Description: Product Info Medium Image Suffix
Default = _MED

Product Info - Image Large Suffix

Key: IMAGE_SUFFIX_LARGE
Path: Configuration > Images
Description: Product Info Large Image Suffix
Default = _LRG

Additional Images matching pattern

Key: ADDITIONAL_IMAGES_MODE
Path: Configuration > Images
Description: "strict" = always use "_" suffix
"legacy" = only use "_" suffix in subdirectories
(Before v210 legacy was the default)
Default = strict

Product Info - Number of Additional Images per Row

Key: IMAGES_AUTO_ADDED
Path: Configuration > Images
Description: Product Info - Enter the number of additional images to display per row
Default = 3

Image - Product Listing Width

Key: IMAGE_PRODUCT_LISTING_WIDTH
Path: Configuration > Images
Description: Default = 100

Image - Product Listing Height

Key: IMAGE_PRODUCT_LISTING_HEIGHT
Path: Configuration > Images
Description: Default = 80

Image - Product New Listing Width

Key: IMAGE_PRODUCT_NEW_LISTING_WIDTH
Path: Configuration > Images
Description: Default = 100

Image - Product New Listing Height

Key: IMAGE_PRODUCT_NEW_LISTING_HEIGHT
Path: Configuration > Images
Description: Default = 80

Image - New Products Width

Key: IMAGE_PRODUCT_NEW_WIDTH
Path: Configuration > Images
Description: Default = 100

Image - New Products Height

Key: IMAGE_PRODUCT_NEW_HEIGHT
Path: Configuration > Images
Description: Default = 80
Key: IMAGE_FEATURED_PRODUCTS_LISTING_WIDTH
Path: Configuration > Images
Description: Default = 100
Key: IMAGE_FEATURED_PRODUCTS_LISTING_HEIGHT
Path: Configuration > Images
Description: Default = 80

Image - Product All Listing Width

Key: IMAGE_PRODUCT_ALL_LISTING_WIDTH
Path: Configuration > Images
Description: Default = 100

Image - Product All Listing Height

Key: IMAGE_PRODUCT_ALL_LISTING_HEIGHT
Path: Configuration > Images
Description: Default = 80

Product Image - No Image Status

Key: PRODUCTS_IMAGE_NO_IMAGE_STATUS
Path: Configuration > Images
Description: Use automatic No Image when none is added to product
0= off
1= On

Product Image - No Image picture

Key: PRODUCTS_IMAGE_NO_IMAGE
Path: Configuration > Images
Description: Use automatic No Image when none is added to product
Default = no_picture.gif

Image - Use Proportional Images on Products and Categories

Key: PROPORTIONAL_IMAGES_STATUS
Path: Configuration > Images
Description: Use Proportional Images on Products and Categories?

NOTE: Do not use 0 height or width settings for Proportion Images
0= off 1= on

Configuration ≫ Customer Details


Email Salutation

Key: ACCOUNT_GENDER
Path: Configuration > Customer Details
Description: Display salutation choice during account creation and with account information

Date of Birth

Key: ACCOUNT_DOB
Path: Configuration > Customer Details
Description: Display date of birth field during account creation and with account information
NOTE: Set Minimum Value Date of Birth to blank for not required
Set Minimum Value Date of Birth > 0 to require

Company

Key: ACCOUNT_COMPANY
Path: Configuration > Customer Details
Description: Display company field during account creation and with account information

Address Line 2

Key: ACCOUNT_SUBURB
Path: Configuration > Customer Details
Description: Display address line 2 field during account creation and with account information

State

Key: ACCOUNT_STATE
Path: Configuration > Customer Details
Description: Display state field during account creation and with account information

State field - Display as pulldown when possible?

Key: ACCOUNT_STATE_DRAW_INITIAL_DROPDOWN
Path: Configuration > Customer Details
Description: If zones have been defined for a country, the State field may be displayed as a dropdown populated by the defined zones. Otherwise a text field is displayed for customer entry.
true: When a State field is used, display a pulldown menu whenever possible.
false: When a State field is used, always display a text input field.

Create Account Default Country

Key: SHOW_CREATE_ACCOUNT_DEFAULT_COUNTRY
Path: Configuration > Customer Details
Description: Set the default/pre-selected country on the Create Account page to:
(default is United States)

Fax Number

Key: ACCOUNT_FAX_NUMBER
Path: Configuration > Customer Details
Description: Display fax number field during account creation and with account information

Show Newsletter Checkbox

Key: ACCOUNT_NEWSLETTER_STATUS
Path: Configuration > Customer Details
Description: Show Newsletter Checkbox
0= off
1= Display Unchecked
2= Display Checked
Note: Defaulting this to accepted may be in violation of certain regulations for your state or country

Customer Default Email Preference

Key: ACCOUNT_EMAIL_PREFERENCE
Path: Configuration > Customer Details
Description: Set the Default Customer Default Email Preference
0= Text
1= HTML

Customer Product Notification Status

Key: CUSTOMERS_PRODUCTS_NOTIFICATION_STATUS
Path: Configuration > Customer Details
Description: Customer should be asked about product notifications after checkout success and in account preferences
0= Never ask
1= Ask (ignored on checkout if has already selected global notifications)

Note: Sidebox must be turned off separately

Customer Shop Status - View Shop and Prices

Key: CUSTOMERS_APPROVAL
Path: Configuration > Customer Details
Description: Customer must be approved to shop
0= Not required
1= Must login to browse
2= May browse but no prices unless logged in
3= Showroom Only

It is recommended that Option 2 be used for the purposes of Spiders if you wish customers to login to see prices.

Customer Approval Status - Authorization Pending

Key: CUSTOMERS_APPROVAL_AUTHORIZATION
Path: Configuration > Customer Details
Description: Customer must be Authorized to shop
0= Not required
1= Must be Authorized to Browse
2= May browse but no prices unless Authorized
3= Customer May Browse and May see Prices but Must be Authorized to Buy

It is recommended that Option 2 or 3 be used for the purposes of Spiders

Customer Authorization: filename

Key: CUSTOMERS_AUTHORIZATION_FILENAME
Path: Configuration > Customer Details
Description: Customer Authorization filename
Note: Do not include the extension
Default=customers_authorization

Customer Authorization: Hide Header

Key: CUSTOMERS_AUTHORIZATION_HEADER_OFF
Path: Configuration > Customer Details
Description: Customer Authorization: Hide Header
(true=hide false=show)

Customer Authorization: Hide Column Left

Key: CUSTOMERS_AUTHORIZATION_COLUMN_LEFT_OFF
Path: Configuration > Customer Details
Description: Customer Authorization: Hide Column Left
(true=hide false=show)

Customer Authorization: Hide Column Right

Key: CUSTOMERS_AUTHORIZATION_COLUMN_RIGHT_OFF
Path: Configuration > Customer Details
Description: Customer Authorization: Hide Column Right
(true=hide false=show)
Key: CUSTOMERS_AUTHORIZATION_FOOTER_OFF
Path: Configuration > Customer Details
Description: Customer Authorization: Hide Footer
(true=hide false=show)

Customers Referral Status

Key: CUSTOMERS_REFERRAL_STATUS
Path: Configuration > Customer Details
Description: Customers Referral Code is created from
0= Off
1= 1st Discount Coupon Code used
2= Customer can add during create account or edit if blank

NOTE: Once the Customers Referral Code has been set it can only be changed by the Administrator

Configuration ≫ Shipping/Packaging


See also Shipping for more information on shipping calculations.

Country of Origin

Key: SHIPPING_ORIGIN_COUNTRY
Path: Configuration > Shipping/Packaging
Description: Select the country of origin to be used in shipping quotes.

Postal Code

Key: SHIPPING_ORIGIN_ZIP
Path: Configuration > Shipping/Packaging
Description: Enter the Postal Code (ZIP) of the Store to be used in shipping quotes. NOTE: For USA zip codes, only use your 5 digit zip code.

Enter the Maximum Package Weight you will ship

Key: SHIPPING_MAX_WEIGHT
Path: Configuration > Shipping/Packaging
Description: Carriers have a max weight limit for a single package. This is a common one for all.

Package Tare Small to Medium - added percentage:weight

Key: SHIPPING_BOX_WEIGHT
Path: Configuration > Shipping/Packaging
Description: What is the weight of typical packaging of small to medium packages?
Example:
Unit = Your SHIPPING_WEIGHT_UNITS (lbs or kgs)
10% + 1 Unit 10:1
10% + 0 Units 10:0
0% + 5 Units 0:5
0% + 1/2 Unit 0:0.5
0% + 0 Units 0:0

Larger packages - added packaging percentage:weight

Key: SHIPPING_BOX_PADDING
Path: Configuration > Shipping/Packaging
Description: What is the weight of typical packaging for Large packages?
Example:
Unit = Your SHIPPING_WEIGHT_UNITS (lbs or kgs)
10% + 1 Unit 10:1
10% + 0 Units 10:0
0% + 5 Units 0:5
0% + 1/2 Unit 0:0.5
0% + 0 Units 0:0

Shipping Weight Units

Key: SHIPPING_WEIGHT_UNITS
Path: Configuration > Shipping/Packaging
Description: How should shipping modules treat the weights set on products? (remember if using lbs, 1 ounce=0.0625). NOTE: You must still manually update your language files to show the correct units visually.

Shipping Dimension Units

Key: SHIPPING_DIMENSION_UNITS
Path: Configuration > Shipping/Packaging
Description: In which unit of measurement does your store save length/width/height for your products?

Display Number of Boxes and Weight Status

Key: SHIPPING_BOX_WEIGHT_DISPLAY
Path: Configuration > Shipping/Packaging
Description: Display Shipping Weight and Number of Boxes?

0= off
1= Boxes Only
2= Weight Only
3= Both Boxes and Weight

Order Free Shipping 0 Weight Status

Key: ORDER_WEIGHT_ZERO_STATUS
Path: Configuration > Shipping/Packaging
Description: If there is no weight to the order, does the order have Free Shipping?
0= no
1= yes

Note: When using Free Shipping, enable the Free Shipping Module (freeshipper). It will only show when shipping is free.

Shipping Estimator Display Settings for Shopping Cart

Key: SHOW_SHIPPING_ESTIMATOR_BUTTON
Path: Configuration > Shipping/Packaging
Description:
0= Off
1= Display as Button on Shopping Cart
2= Display as Listing on Shopping Cart Page

Display Order Comments on Admin Invoice

Key: ORDER_COMMENTS_INVOICE
Path: Configuration > Shipping/Packaging
Description: Do you want to display the Order Comments on the Admin Invoice?
0= OFF
1= First Comment by Customer only
2= All Comments for the Order

Display Order Comments on Admin Packing Slip

Key: ORDER_COMMENTS_PACKING_SLIP
Path: Configuration > Shipping/Packaging
Description: Do you want to display the Order Comments on the Admin Packing Slip?
0= OFF
1= First Comment by Customer only
2= All Comments for the Order

Configuration ≫ Product Listing


Display Product Image

Key: PRODUCT_LIST_IMAGE
Path: Configuration > Product Listing
Description: Do you want to display the Product Image?

Display Product Manufacturer Name

Key: PRODUCT_LIST_MANUFACTURER
Path: Configuration > Product Listing
Description: Do you want to display the Product Manufacturer Name?

Display Product Model

Key: PRODUCT_LIST_MODEL
Path: Configuration > Product Listing
Description: Do you want to display the Product Model?

Display Product Name

Key: PRODUCT_LIST_NAME
Path: Configuration > Product Listing
Description: Do you want to display the Product Name?

Display Product Price/Add to Cart

Key: PRODUCT_LIST_PRICE
Path: Configuration > Product Listing
Description: Do you want to display the Product Price/Add to Cart

Display Product Quantity

Key: PRODUCT_LIST_QUANTITY
Path: Configuration > Product Listing
Description: Do you want to display the Product Quantity?

Display Product Weight

Key: PRODUCT_LIST_WEIGHT
Path: Configuration > Product Listing
Description: Do you want to display the Product Weight?

Display Product Price/Add to Cart Column Width

Key: PRODUCTS_LIST_PRICE_WIDTH
Path: Configuration > Product Listing
Description: Define the width of the Price/Add to Cart column
Default= 125

Display Category/Manufacturer Filter (0=off; 1=on)

Key: PRODUCT_LIST_FILTER
Path: Configuration > Product Listing
Description: Do you want to display the Category/Manufacturer Filter?

Prev/Next Split Page Navigation (1-top, 2-bottom, 3-both)

Key: PREV_NEXT_BAR_LOCATION
Path: Configuration > Product Listing
Description: Sets the location of the Prev/Next Split Page Navigation

Sort Order Default - Product Listing

Key: PRODUCT_LISTING_DEFAULT_SORT_ORDER
Path: Configuration > Product Listing
Description: Product Listing Default sort order?
NOTE: Leave Blank for Product Sort Order. Sort the Product Listing in the order you wish for the default display to start in to get the sort order setting. Example: 2a

Sort Order Default - New Products

Key: PRODUCT_NEW_LIST_SORT_DEFAULT
Path: Configuration > Product Listing
Description: What Sort Order Default should be used for New Products Display?
Default= 6 for Date New to Old

1= Products Name
2= Products Name Desc
3= Price low to high, Products Name
4= Price high to low, Products Name
5= Model
6= Date Added desc
7= Date Added
8= Product Sort Order
Key: PRODUCT_FEATURED_LIST_SORT_DEFAULT
Path: Configuration > Product Listing
Description: What Sort Order Default should be used for Featured Product Display?
Default= 1 for Product Name

1= Products Name
2= Products Name Desc
3= Price low to high, Products Name
4= Price high to low, Products Name
5= Model
6= Date Added desc
7= Date Added
8= Product Sort Order

Sort Order Default - All-Products page

Key: PRODUCT_ALL_LIST_SORT_DEFAULT
Path: Configuration > Product Listing
Description: What Sort Order Default should be used for All Products Display?
Default= 1 for Product Name

1= Products Name
2= Products Name Desc
3= Price low to high, Products Name
4= Price high to low, Products Name
5= Model
6= Date Added desc
7= Date Added
8= Product Sort Order

Mask Upcoming Products from being included as New Products

Key: SHOW_NEW_PRODUCTS_UPCOMING_MASKED
Path: Configuration > Product Listing
Description: Do you want to mask Upcoming Products from being included as New Products in Listing, Sideboxes and Centerbox?
0= off
1= on

Display Product Add to Cart Button (0=off; 1=on; 2=on with Qty Box per Product)

Key: PRODUCT_LIST_PRICE_BUY_NOW
Path: Configuration > Product Listing
Description: Do you want to display the Add to Cart Button?

NOTE: Turn OFF Display Multiple Products Qty Box Status to use Option 2 on with Qty Box per Product

Display Multiple Products Qty Box Status and Set Button Location

Key: PRODUCT_LISTING_MULTIPLE_ADD_TO_CART
Path: Configuration > Product Listing
Description: Do you want to display Add Multiple Products Qty Box and Set Button Location?
0= off
1= Top
2= Bottom
3= Both

Display Product Description

Key: PRODUCT_LIST_DESCRIPTION
Path: Configuration > Product Listing
Description: Do you want to display the Product Description?

0= OFF
150= Suggested Length, or enter the maximum number of characters to display

Product Listing Ascending Sort Order

Key: PRODUCT_LIST_SORT_ORDER_ASCENDING
Path: Configuration > Product Listing
Description: What do you want to use to indicate Sort Order Ascending?
Default = +

Product Listing Descending Sort Order

Key: PRODUCT_LIST_SORT_ORDER_DESCENDING
Path: Configuration > Product Listing
Description: What do you want to use to indicate Sort Order Descending?
Default = -

Columns Per Row

Key: PRODUCT_LISTING_COLUMNS_PER_ROW
Path: Configuration > Product Listing
Description: Select the number of columns of products to show per row in the product listing.
Recommended: 3
1=[rows] mode.

Include Product Listing Alpha Sorter Dropdown

Key: PRODUCT_LIST_ALPHA_SORTER
Path: Configuration > Product Listing
Description: Do you want to include an Alpha Filter dropdown on the Product Listing?

Include Product Listing Sub Categories Image

Key: PRODUCT_LIST_CATEGORIES_IMAGE_STATUS
Path: Configuration > Product Listing
Description: Do you want to include the Sub Categories Image on the Product Listing?

Include Product Listing Top Categories Image

Key: PRODUCT_LIST_CATEGORIES_IMAGE_STATUS_TOP
Path: Configuration > Product Listing
Description: Do you want to include the Top Categories Image on the Product Listing?

Show SubCategories on Main Page while navigating

Key: PRODUCT_LIST_CATEGORY_ROW_STATUS
Path: Configuration > Product Listing
Description: Show Sub-Categories on Main Page while navigating through Categories

0= off
1= on

Configuration ≫ Stock


The stock configuration settings control stock management as well as various things on the shopping cart page.

Check stock level

Key: STOCK_CHECK
Path: Configuration > Stock
Description: Check to see if sufficient stock is available

Subtract stock

Key: STOCK_LIMITED
Path: Configuration > Stock
Description: Subtract product in stock by product orders

Allow Checkout

Key: STOCK_ALLOW_CHECKOUT
Path: Configuration > Stock
Description: Allow customer to checkout even if there is insufficient stock

Mark product out of stock

Key: STOCK_MARK_PRODUCT_OUT_OF_STOCK
Path: Configuration > Stock
Description: Display something on screen so customer can see which product has insufficient stock

Stock Re-order level

Key: STOCK_REORDER_LEVEL
Path: Configuration > Stock
Description: Define when stock needs to be re-ordered

Products status in Catalog when out of stock should be set to

Key: SHOW_PRODUCTS_SOLD_OUT
Path: Configuration > Stock
Description: Show Products when out of stock

0= set product status to OFF
1= leave product status ON

Disabled Product Status for Search Engines

Key: DISABLED_PRODUCTS_TRIGGER_HTTP200
Path: Configuration > Stock
Description: When a product is marked Disabled (status=0) but is not deleted from the database, should Search Engines still show it as Available?
eg:
True = Return HTTP 200 response
False = Return HTTP 410
(Deleting it will return HTTP 404)
Default: false

Show Sold Out Image in place of Add to Cart

Key: SHOW_PRODUCTS_SOLD_OUT_IMAGE
Path: Configuration > Stock
Description: Show Sold Out Image instead of Add to Cart Button

0= off
1= on

Enable disabled product by available date

Key: ENABLE_DISABLED_UPCOMING_PRODUCT
Path: Configuration > Stock
Description: How should disabled products with a future available date be made active when the date is reached?

Product Quantity Decimals

Key: QUANTITY_DECIMALS
Path: Configuration > Stock
Description: Allow how many decimals on Quantity

0= off

Show Shopping Cart - Delete Checkboxes or Delete Button

Key: SHOW_SHOPPING_CART_DELETE
Path: Configuration > Stock
Description: Show on Shopping Cart Delete Button and/or Checkboxes

1= Delete Button Only
2= Checkbox Only
3= Both Delete Button and Checkbox

Show Shopping Cart - Update Cart Button Location

Key: SHOW_SHOPPING_CART_UPDATE
Path: Configuration > Stock
Description: Show on Shopping Cart Update Cart Button Location as:

1= Next to each Qty Box
2= Below all Products
3= Both Next to each Qty Box and Below all Products

Show New Products on empty Shopping Cart Page

Key: SHOW_SHOPPING_CART_EMPTY_NEW_PRODUCTS
Path: Configuration > Stock
Description: Show New Products on empty Shopping Cart Page
0= off or set the sort order
Key: SHOW_SHOPPING_CART_EMPTY_FEATURED_PRODUCTS
Path: Configuration > Stock
Description: Show Featured Products on empty Shopping Cart Page
0= off or set the sort order

Show Special Products on empty Shopping Cart Page

Key: SHOW_SHOPPING_CART_EMPTY_SPECIALS_PRODUCTS
Path: Configuration > Stock
Description: Show Special Products on empty Shopping Cart Page
0= off or set the sort order

Show Upcoming Products on empty Shopping Cart Page

Key: SHOW_SHOPPING_CART_EMPTY_UPCOMING
Path: Configuration > Stock
Description: Show Upcoming Products on empty Shopping Cart Page
0= off or set the sort order

Show Notice of Combining Shopping Cart on Login

Key: SHOW_SHOPPING_CART_COMBINED
Path: Configuration > Stock
Description: When a customer logs in and has a previously stored shopping cart, the products are combined with the existing shopping cart.

Do you wish to display a Notice to the customer?

0= OFF, do not display a notice
1= Yes show notice and go to shopping cart
2= Yes show notice, but do not go to shopping cart

Configuration ≫ Logging


Log Database Queries

Key: STORE_DB_TRANSACTIONS
Path: Configuration > Logging
Description: Record the database queries to files in the system /logs/ folder. USE WITH CAUTION. This can seriously degrade your site performance and blow out your disk space storage quotas.
Enabling this makes your site NON-COMPLIANT with PCI DSS rules, thus invalidating any certification.

Report All Errors (Admin)?

Key: REPORT_ALL_ERRORS_ADMIN
Path: Configuration > Logging
Description: Do you want create debug-log files for all PHP errors, even warnings, that occur during your Zen Cart admin's processing? If you want to log all PHP errors except duplicate-language definitions, choose IgnoreDups.

Report All Errors (Store)?

Key: REPORT_ALL_ERRORS_STORE
Path: Configuration > Logging
Description: Do you want create debug-log files for all PHP errors, even warnings, that occur during your Zen Cart store's processing? If you want to log all PHP errors except duplicate-language definitions, choose IgnoreDups.

Note: Choosing 'Yes' is not suggested for a live store, since it will reduce performance significantly!

Report All Errors: Backtrace on Notice Errors?

Key: REPORT_ALL_ERRORS_NOTICE_BACKTRACE
Path: Configuration > Logging
Description: Include backtrace information on "Notice" errors? These are usually isolated to the identified file and the backtrace information just fills the logs. Default (No).

Configuration ≫ E-Mail


E-Mail Transport Method

Key: EMAIL_TRANSPORT
Path: Configuration > Email
Description: Defines the method for sending mail.

PHP is the default, and uses built-in PHP wrappers for processing.
smtpauth should be used by most sites, as it provides secure sending of authenticated email. You must also configure your smtpauth settings in the appropriate fields in this admin section.
Gmail is used for sending emails using the Google mail service, and requires the [less secure] setting enabled in your gmail account.
sendmail is for linux/unix hosts using the sendmail program on the server
sendmail-f is only for servers which require the use of the -f parameter to use sendmail. This is a security setting often used to prevent spoofing. Will cause errors if your host mailserver is not configured to use it.
Qmail is used for linux/unix hosts running Qmail as sendmail wrapper at /var/qmail/bin/sendmail.

MOST SITES WILL USE [smtpauth].

Send E-Mails

Key: SEND_EMAILS
Path: Configuration > Email
Description: Send out e-mails?
Normally this is set to true.
Set to false to suppress ALL outgoing email messages from this store, such as when working with a test copy of your store offline.

Enable HTML Emails?

Key: EMAIL_USE_HTML
Path: Configuration > Email
Description: Send emails in HTML format if recipient has enabled it in their preferences.

Email Archiving Active?

Key: EMAIL_ARCHIVE
Path: Configuration > Email
Description: If you wish to have email messages archived/stored when sent, set this to "true".

Email Address (Displayed to Contact you)

Key: STORE_OWNER_EMAIL_ADDRESS
Path: Configuration > Email
Description: Email address of Store Owner. Used as "display only" when informing customers of how to contact you.

Email Address (sent FROM)

Key: EMAIL_FROM
Path: Configuration > Email
Description: Address from which email messages will be "sent" by default. Can be over-ridden at compose-time in admin modules.

Emails must send from known domain?

Key: EMAIL_SEND_MUST_BE_STORE
Path: Configuration > Email
Description: Does your mailserver require that all outgoing emails have their "from" address match a known domain that exists on your webserver?

This is often required in order to prevent spoofing and spam broadcasts. If set to Yes, this will cause the email address (sent FROM) to be used as the "from" address on all outgoing mail.

Email Admin Format?

Key: ADMIN_EXTRA_EMAIL_FORMAT
Path: Configuration > Email
Description: Please select the Admin extra email format (Note: Enable HTML Emails must be on for HTML option to work)

Send Copy of Order Confirmation Emails To

Key: SEND_EXTRA_ORDER_EMAILS_TO
Path: Configuration > Email
Description: Send COPIES of order confirmation emails to the following email addresses, in this format: Name 1 <email@address1>, Name 2 <email@address2>

Send Copy of Create Account Emails To - Status

Key: SEND_EXTRA_CREATE_ACCOUNT_EMAILS_TO_STATUS
Path: Configuration > Email
Description: Send copy of Create Account Status
0= off 1= on

Send Copy of Create Account Emails To

Key: SEND_EXTRA_CREATE_ACCOUNT_EMAILS_TO
Path: Configuration > Email
Description: Send copy of Create Account emails to the following email addresses, in this format: Name 1 <email@address1>, Name 2 <email@address2>

Send Copy of Customer GV Send Emails To - Status

Key: SEND_EXTRA_GV_CUSTOMER_EMAILS_TO_STATUS
Path: Configuration > Email
Description: Send copy of Customer GV Send Status
0= off 1= on

Send Copy of Customer GV Send Emails To

Key: SEND_EXTRA_GV_CUSTOMER_EMAILS_TO
Path: Configuration > Email
Description: Send copy of Customer GV Send emails to the following email addresses, in this format: Name 1 <email@address1>, Name 2 <email@address2>

Send Copy of Admin GV Mail Emails To - Status

Key: SEND_EXTRA_GV_ADMIN_EMAILS_TO_STATUS
Path: Configuration > Email
Description: Send copy of Admin GV Mail Status
0= off 1= on

Send Copy of Customer Admin GV Mail Emails To

Key: SEND_EXTRA_GV_ADMIN_EMAILS_TO
Path: Configuration > Email
Description: Send copy of Admin GV Mail emails to the following email addresses, in this format: Name 1 <email@address1>, Name 2 <email@address2>

Send Copy of Admin Discount Coupon Mail Emails To - Status

Key: SEND_EXTRA_DISCOUNT_COUPON_ADMIN_EMAILS_TO_STATUS
Path: Configuration > Email
Description: Send copy of Admin Discount Coupon Mail Status
0= off 1= on

Send Copy of Customer Admin Discount Coupon Mail Emails To

Key: SEND_EXTRA_DISCOUNT_COUPON_ADMIN_EMAILS_TO
Path: Configuration > Email
Description: Send copy of Admin Discount Coupon Mail emails to the following email addresses, in this format: Name 1 <email@address1>, Name 2 <email@address2>

Send Copy of Admin Orders Status Emails To - Status

Key: SEND_EXTRA_ORDERS_STATUS_ADMIN_EMAILS_TO_STATUS
Path: Configuration > Email
Description: Send copy of Admin Orders Status Status
0= off 1= on

Send Copy of Admin Orders Status Emails To

Key: SEND_EXTRA_ORDERS_STATUS_ADMIN_EMAILS_TO
Path: Configuration > Email
Description: Send copy of Admin Orders Status emails to the following email addresses, in this format: Name 1 <email@address1>, Name 2 <email@address2>

Send Notice of Pending Reviews Emails To - Status

Key: SEND_EXTRA_REVIEW_NOTIFICATION_EMAILS_TO_STATUS
Path: Configuration > Email
Description: Send copy of Pending Reviews Status
0= off 1= on

Send Notice of Pending Reviews Emails To

Key: SEND_EXTRA_REVIEW_NOTIFICATION_EMAILS_TO
Path: Configuration > Email
Description: Send copy of Pending Reviews emails to the following email addresses, in this format: Name 1 <email@address1>, Name 2 <email@address2>

Set "Contact Us" Email Dropdown List

Key: CONTACT_US_LIST
Path: Configuration > Email
Description: On the "Contact Us" Page, set the list of email addresses , in this format: Name 1 <email@address1>, Name 2 <email@address2>

Contact Us - Show Store Name and Address

Key: CONTACT_US_STORE_NAME_ADDRESS
Path: Configuration > Email
Description: Include Store Name and Address
0= off 1= on

Send Low Stock Emails

Key: SEND_LOWSTOCK_EMAIL
Path: Configuration > Email
Description: When stock level is at or below low stock level send an email
0= off
1= on

Send Low Stock Emails To

Key: SEND_EXTRA_LOW_STOCK_EMAILS_TO
Path: Configuration > Email
Description: When stock level is at or below low stock level send an email to this address, in this format: Name 1 <email@address1>, Name 2 <email@address2>
Key: SHOW_NEWSLETTER_UNSUBSCRIBE_LINK
Path: Configuration > Email
Description: Show "Newsletter Unsubscribe" link in the "Information" side-box?

Audience-Select Count Display

Key: AUDIENCE_SELECT_DISPLAY_COUNTS
Path: Configuration > Email
Description: When displaying lists of available audiences/recipients, should the recipients-count be included?
(This may make things slower if you have a lot of customers or complex audience queries)

SMTP Email Account Mailbox

Key: EMAIL_SMTPAUTH_MAILBOX
Path: Configuration > Email
Description: Enter the mailbox account name (me@mydomain.com) supplied by your host. This is the account name that your host requires for SMTP authentication.
Only required if using SMTP Authentication for email.

SMTP Email Account Password

Key: EMAIL_SMTPAUTH_PASSWORD
Path: Configuration > Email
Description: Enter the password for your SMTP mailbox.
Only required if using SMTP Authentication for email.

SMTP Email Mail Host

Key: EMAIL_SMTPAUTH_MAIL_SERVER
Path: Configuration > Email
Description: Enter the DNS name of your SMTP mail server.
ie: mail.mydomain.com
or 55.66.77.88
Only required if using SMTP Authentication for email.

SMTP Email Mail Server Port

Key: EMAIL_SMTPAUTH_MAIL_SERVER_PORT
Path: Configuration > Email
Description: Enter the IP port number that your SMTP mailserver operates on.
Only required if using SMTP Authentication for email.

Default: 25
Typical values are:
25 - normal unencrypted SMTP
587 - encrypted SMTP
465 - older MS SMTP port

Convert currencies for Text emails

Key: CURRENCIES_TRANSLATIONS
Path: Configuration > Email
Description: What currency conversions do you need for Text emails?
Example = &pound;,£:&euro;,€

Newsletter SMTP Email Account Mailbox

Key: NEWSLETTER_EMAIL_SMTPAUTH_MAILBOX
Path: Configuration > Email
Description: Enter the newsletter mailbox account name (me@mydomain.com) supplied by your host. This is the account name that your newsletter host requires for SMTP authentication.

Newsletter SMTP Email Account Password

Key: NEWSLETTER_EMAIL_SMTPAUTH_PASSWORD
Path: Configuration > Email
Description: Enter the password for your newsletter SMTP mailbox.

Newsletter SMTP Email Mail Host

Key: NEWSLETTER_EMAIL_SMTPAUTH_MAIL_SERVER
Path: Configuration > Email
Description: Enter the DNS name of your Newsletter SMTP mail server if you are using a separate email server for bulk email.

Newsletter SMTP Email Mail Server Port

Key: NEWSLETTER_EMAIL_SMTPAUTH_MAIL_SERVER_PORT
Path: Configuration > Email
Description: Enter the IP port number that your newsletter SMTP mailserver operates on.

Default: 587
Typical values are:
587 - encrypted SMTP
465 - older MS SMTP port

Newsletter Modules

Key: NEWSLETTER_MODULES
Path: Configuration > Email
Description: Enter a comma-separated list of the modules that should use the newsletter settings when sending email (rather than the regular email settings).

Configuration ≫ Attribute Settings


See also Admin > Catalog > Attributes Controller for attribute pricing settings.

Enable Downloads

Key: DOWNLOAD_ENABLED
Path: Configuration > Attribute Settings
Description: Enable the products download functions.

Download by Redirect

Key: DOWNLOAD_BY_REDIRECT
Path: Configuration > Attribute Settings
Description: Use browser redirection for download. Disable on non-Unix systems.

Note: Set /pub to 777 when redirect is true

Download by streaming

Key: DOWNLOAD_IN_CHUNKS
Path: Configuration > Attribute Settings
Description: If download-by-redirect is disabled, and your PHP memory_limit setting is under 8 MB, you might need to enable this setting so that files are streamed in smaller segments to the browser.

Has no effect if Download By Redirect is enabled.

Download Expiration (Number of Days)

Key: DOWNLOAD_MAX_DAYS
Path: Configuration > Attribute Settings
Description: Set number of days before the download link expires. 0 means no limit.

Number of Downloads Allowed - Per Product

Key: DOWNLOAD_MAX_COUNT
Path: Configuration > Attribute Settings
Description: Set the maximum number of downloads. 0 means no download authorized.

Downloads Controller Update Status Value

Key: DOWNLOADS_ORDERS_STATUS_UPDATED_VALUE
Path: Configuration > Attribute Settings
Description: What orders_status resets the Download days and Max Downloads - Default is 4

Downloads Controller Order Status Value >= lower value

Key: DOWNLOADS_CONTROLLER_ORDERS_STATUS
Path: Configuration > Attribute Settings
Description: Downloads Controller Order Status Value - Default >= 2

Downloads are available for checkout based on the orders status. Orders with orders status greater than this value will be available for download. The orders status is set for an order by the Payment Modules. Set the lower range for this range.

Downloads Controller Order Status Value <= upper value

Key: DOWNLOADS_CONTROLLER_ORDERS_STATUS_END
Path: Configuration > Attribute Settings
Description: Downloads Controller Order Status Value - Default <= 4

Downloads are available for checkout based on the orders status. Orders with orders status less than this value will be available for download. The orders status is set for an order by the Payment Modules. Set the upper range for this range.

Enable Price Factor

Key: ATTRIBUTES_ENABLED_PRICE_FACTOR
Path: Configuration > Attribute Settings
Description: Enable the Attributes Price Factor.

Enable Qty Price Discount

Key: ATTRIBUTES_ENABLED_QTY_PRICES
Path: Configuration > Attribute Settings
Description: Enable the Attributes Quantity Price Discounts.

Enable Attribute Images

Key: ATTRIBUTES_ENABLED_IMAGES
Path: Configuration > Attribute Settings
Description: Enable the Attributes Images.

Enable Text Pricing by word or letter

Key: ATTRIBUTES_ENABLED_TEXT_PRICES
Path: Configuration > Attribute Settings
Description: Enable the Attributes Text Pricing by word or letter.

Text Pricing - Spaces are Free

Key: TEXT_SPACES_FREE
Path: Configuration > Attribute Settings
Description: On Text pricing Spaces are Free

0= off 1= on

Read Only option type - Ignore for Add to Cart

Key: PRODUCTS_OPTIONS_TYPE_READONLY_IGNORED
Path: Configuration > Attribute Settings
Description: When a Product only uses READONLY attributes, should the Add to Cart button be On or Off?
0= OFF
1= ON

Configuration ≫ GZip Compression


Enable GZip Compression

Key: GZIP_LEVEL
Path: Configuration > GZip Compression
Description: 0= off 1= on

Configuration ≫ Sessions


Session Directory

Key: SESSION_WRITE_DIRECTORY
Path: Configuration > Sessions
Description: This should point to the folder specified in your DIR_FS_SQL_CACHE setting in your configure.php files.
Key: SESSION_USE_FQDN
Path: Configuration > Sessions
Description: If True the full domain name will be used to store the cookie, e.g. www.mydomain.com. If False only a partial domain name will be used, e.g. mydomain.com. If you are unsure about this, always leave set to true.
Key: SESSION_FORCE_COOKIE_USE
Path: Configuration > Sessions
Description: Force the use of sessions when cookies are only enabled.

Check SSL Session ID

Key: SESSION_CHECK_SSL_SESSION_ID
Path: Configuration > Sessions
Description: Validate the SSL_SESSION_ID on every secure HTTPS page request.

Check User Agent

Key: SESSION_CHECK_USER_AGENT
Path: Configuration > Sessions
Description: Validate the clients browser user agent on every page request.

Check IP Address

Key: SESSION_CHECK_IP_ADDRESS
Path: Configuration > Sessions
Description: Validate the clients IP address on every page request.

Prevent Spider Sessions

Key: SESSION_BLOCK_SPIDERS
Path: Configuration > Sessions
Description: Prevent known spiders from starting a session.

Recreate Session

Key: SESSION_RECREATE
Path: Configuration > Sessions
Description: Recreate the session to generate a new session ID when the customer logs on or creates an account (PHP >=4.1 needed).

IP to Host Conversion Status

Key: SESSION_IP_TO_HOST_ADDRESS
Path: Configuration > Sessions
Description: Convert IP Address to Host Address

Note: on some servers this can slow down the initial start of a session or execution of Emails
Key: SESSION_USE_ROOT_COOKIE_PATH
Path: Configuration > Sessions
Description: Normally Zen Cart will use the directory that a store resides in as the cookie path. This can cause problems with some servers. This setting allows you to set the cookie path to the root of the server, rather than the store directory. It should only be used if you have problems with sessions. Default Value = False

Changing this setting may mean you have problems logging into your admin, you should clear your browser cookies to overcome this.
Key: SESSION_ADD_PERIOD_PREFIX
Path: Configuration > Sessions
Description: Normally Zen Cart will add a period prefix to the cookie domain, e.g. .www.mydomain.com. This can sometimes cause problems with some server configurations. If you are having session problems you may want to try setting this to False. Default Value = True

Configuration ≫ Regulations


Confirm Terms and Conditions During Checkout Procedure

Key: DISPLAY_CONDITIONS_ON_CHECKOUT
Path: Configuration > Regulations
Description: Show the Terms and Conditions during the checkout procedure which the customer must agree to.

Confirm Privacy Notice During Account Creation Procedure

Key: DISPLAY_PRIVACY_CONDITIONS
Path: Configuration > Regulations
Description: Show the Privacy Notice during the account creation procedure which the customer must agree to.

Configuration ≫ GV Coupons


Default Order Status For Zero Balance Orders

Key: DEFAULT_ZERO_BALANCE_ORDERS_STATUS_ID
Path: Configuration > GV Coupons
Description: When an order's balance is zero, this order status will be assigned to it.

Length of the redeem code

Key: SECURITY_CODE_LENGTH
Path: Configuration > GV Coupons
Description: Enter the length of the redeem code
The longer the more secure

New Signup Discount Coupon ID#

Key: NEW_SIGNUP_DISCOUNT_COUPON
Path: Configuration > GV Coupons
Description: Select the coupon

New Signup Gift Voucher Amount

Key: NEW_SIGNUP_GIFT_VOUCHER_AMOUNT
Path: Configuration > GV Coupons
Description: Leave blank for none
Or enter an amount ie. 10 for $10.00

Maximum Discount Coupons Per Page

Key: MAX_DISPLAY_SEARCH_RESULTS_DISCOUNT_COUPONS
Path: Configuration > GV Coupons
Description: Number of Discount Coupons to list per Page

Maximum Discount Coupon Report Results Per Page

Key: MAX_DISPLAY_SEARCH_RESULTS_DISCOUNT_COUPONS_REPORTS
Path: Configuration > GV Coupons
Description: Number of Discount Coupons to list on Reports Page

Configuration ≫ Credit Cards


Credit Card Enable Status - VISA

Key: CC_ENABLED_VISA
Path: Configuration > Credit Cards
Description: Accept VISA 0= off 1= on

Credit Card Enable Status - MasterCard

Key: CC_ENABLED_MC
Path: Configuration > Credit Cards
Description: Accept MasterCard 0= off 1= on

Credit Card Enable Status - AmericanExpress

Key: CC_ENABLED_AMEX
Path: Configuration > Credit Cards
Description: Accept AmericanExpress 0= off 1= on

Credit Card Enable Status - Diners Club

Key: CC_ENABLED_DINERS_CLUB
Path: Configuration > Credit Cards
Description: Accept Diners Club 0= off 1= on

Credit Card Enable Status - Discover Card

Key: CC_ENABLED_DISCOVER
Path: Configuration > Credit Cards
Description: Accept Discover Card 0= off 1= on

Credit Card Enable Status - JCB

Key: CC_ENABLED_JCB
Path: Configuration > Credit Cards
Description: Accept JCB 0= off 1= on

Credit Card Enable Status - AUSTRALIAN BANKCARD

Key: CC_ENABLED_AUSTRALIAN_BANKCARD
Path: Configuration > Credit Cards
Description: Accept AUSTRALIAN BANKCARD 0= off 1= on

Credit Card Enable Status - SOLO

Key: CC_ENABLED_SOLO
Path: Configuration > Credit Cards
Description: Accept SOLO Card 0= off 1= on

Credit Card Enable Status - Debit

Key: CC_ENABLED_DEBIT
Path: Configuration > Credit Cards
Description: Accept Debit Cards 0= off 1= on
NOTE: This is not deeply integrated at this time, and this setting may be redundant if your payment modules do not yet specifically have code to honour this switch.

Credit Card Enable Status - Maestro

Key: CC_ENABLED_MAESTRO
Path: Configuration > Credit Cards
Description: Accept MAESTRO Card 0= off 1= on

Credit Card Enabled - Show on Payment

Key: SHOW_ACCEPTED_CREDIT_CARDS
Path: Configuration > Credit Cards
Description: Show accepted credit cards on Payment page?
0= off
1= As Text
2= As Images

Note: images and text must be defined in both the database and language file for specific credit card types.

Configuration ≫ Product Info


Previous Next - Button and Image Status

Key: SHOW_PREVIOUS_NEXT_STATUS
Path: Configuration > Product Info
Description: Button and Product Image status settings are:
0= Off
1= On

Previous Next - Navigation Includes Category Position

Key: PRODUCT_INFO_CATEGORIES
Path: Configuration > Product Info
Description: Product's Category Image and Name Alignment Above Previous/Next Navigation Bar
0= off
1= Align Left
2= Align Center
3= Align Right

Previous Next - Navigation Includes Category Name and Image Status

Key: PRODUCT_INFO_CATEGORIES_IMAGE_STATUS
Path: Configuration > Product Info
Description: Product's Category Image and Name Status
0= Category Name and Image always shows
1= Category Name only
2= Category Name and Image when not blank

Previous Next - Navigation Bar Position

Key: PRODUCT_INFO_PREVIOUS_NEXT
Path: Configuration > Product Info
Description: Location of Previous/Next Navigation Bar
0= off
1= Top of Page
2= Bottom of Page
3= Both Top and Bottom of Page

Previous Next - Button and Image Settings

Key: SHOW_PREVIOUS_NEXT_IMAGES
Path: Configuration > Product Info
Description: Show Previous/Next Button and Product Image Settings
0= Button Only
1= Button and Product Image
2= Product Image Only

Previous Next - Sort Order

Key: PRODUCT_INFO_PREVIOUS_NEXT_SORT
Path: Configuration > Product Info
Description: Products Display Order by
0= Product ID
1= Product Name
2= Model
3= Price, Product Name
4= Price, Model
5= Product Name, Model
6= Product Sort Order

Previous Next - Image Width?

Key: PREVIOUS_NEXT_IMAGE_WIDTH
Path: Configuration > Product Info
Description: Previous/Next Image Width?

Previous Next - Image Height?

Key: PREVIOUS_NEXT_IMAGE_HEIGHT
Path: Configuration > Product Info
Description: Previous/Next Image Height?

Products Info - Products Option Name Sort Order

Key: PRODUCTS_OPTIONS_SORT_ORDER
Path: Configuration > Product Info
Description: Sort order of Option Names for Products Info
0= Sort Order, Option Name
1= Option Name

Products Info - Product Option Value of Attributes Sort Order

Key: PRODUCTS_OPTIONS_SORT_BY_PRICE
Path: Configuration > Product Info
Description: Sort order of Product Option Values of Attributes for Products Info
0= Sort Order, Price
1= Sort Order, Option Value Name

Product Info - Show Option Values Name Below Attributes Image

Key: PRODUCT_IMAGES_ATTRIBUTES_NAMES
Path: Configuration > Product Info
Description: Product Info - Show the name of the Option Value beneath the Attribute Image?
0= off 1= on

Product Info - Show Sales Discount Savings Status

Key: SHOW_SALE_DISCOUNT_STATUS
Path: Configuration > Product Info
Description: Product Info - Show the amount of discount savings?
0= off 1= on

Product Info - Show Sales Discount Savings Dollars or Percentage

Key: SHOW_SALE_DISCOUNT
Path: Configuration > Product Info
Description: Product Info - Show the amount of discount savings display as:
1= % off 2= $amount off

Product Info - Show Sales Discount Savings Percentage Decimals

Key: SHOW_SALE_DISCOUNT_DECIMALS
Path: Configuration > Product Info
Description: Product Info - Show discount savings display as a Percentage with how many decimals?:
Default= 0

Product Info - Price is Free Image or Text Status

Key: OTHER_IMAGE_PRICE_IS_FREE_ON
Path: Configuration > Product Info
Description: Product Info - Show the Price is Free Image or Text on Displayed Price
0= Text
1= Image

Product Info - Price is Call for Price Image or Text Status

Key: PRODUCTS_PRICE_IS_CALL_IMAGE_ON
Path: Configuration > Product Info
Description: Product Info - Show the Price is Call for Price Image or Text on Displayed Price
0= Text
1= Image

Product Quantity Box Status - Adding New Products

Key: PRODUCTS_QTY_BOX_STATUS
Path: Configuration > Product Info
Description: What should the Default Quantity Box Status be set to when adding New Products?

0= off
1= on
NOTE: This will show a Qty Box when ON and default the Add to Cart to 1

Product Reviews Require Approval

Key: REVIEWS_APPROVAL
Path: Configuration > Product Info
Description: Do product reviews require approval?

Note: When Review Status is off, it will also not show

0= off 1= on

Product page generated <title> tag - include Product Model?

Key: META_TAG_INCLUDE_MODEL
Path: Configuration > Product Info
Description: When custom Keywords and Description meta tags are not set, include the Product Model in the generated page <title> tag?

0=no / 1=yes

Product page generated <title> tag - include Product Price?

Key: META_TAG_INCLUDE_PRICE
Path: Configuration > Product Info
Description: When custom Keywords and Description meta tags are not set, include the Product Price in the generated page <title> tag?

0=no / 1=yes

Product page generated <meta - description> tag - Maximum Length

Key: MAX_META_TAG_DESCRIPTION_LENGTH
Path: Configuration > Product Info
Description: When custom Keywords and Description meta tags are not set, limit the generated <meta - description> tag to this number of words. Default 50.

Also Purchased Products Columns per Row

Key: SHOW_PRODUCT_INFO_COLUMNS_ALSO_PURCHASED_PRODUCTS
Path: Configuration > Product Info
Description: Also Purchased Products Columns per Row
0= off or set the sort order

Configuration ≫ Layout Settings


See also Admin > Catalog > Product Types > Layout Settings for product type specific layout settings.

Column Width - Left Boxes

Key: BOX_WIDTH_LEFT
Path: Configuration > Layout Settings
Description: Width of the Left Column Boxes
px may be included
Default = 150px

Column Width - Right Boxes

Key: BOX_WIDTH_RIGHT
Path: Configuration > Layout Settings
Description: Width of the Right Column Boxes
px may be included
Default = 150px
Key: BREAD_CRUMBS_SEPARATOR
Path: Configuration > Layout Settings
Description: Enter the separator symbol to appear between the Navigation Bread Crumb trail
Note: Include spaces with the &nbsp; symbol if you want them part of the separator.
Default = &nbsp;::&nbsp;

Define Breadcrumb Status

Key: DEFINE_BREADCRUMB_STATUS
Path: Configuration > Layout Settings
Description: Enable the Breadcrumb Trail Links?
0= OFF
1= ON
2= Off for Home Page Only

Bestsellers - Number Padding

Key: BEST_SELLERS_FILLER
Path: Configuration > Layout Settings
Description: What do you want to Pad the numbers with?
Default = &nbsp;

Bestsellers - Truncate Product Names

Key: BEST_SELLERS_TRUNCATE
Path: Configuration > Layout Settings
Description: What size do you want to truncate the Product Names?
Default = 35

Bestsellers - Truncate Product Names followed by ...

Key: BEST_SELLERS_TRUNCATE_MORE
Path: Configuration > Layout Settings
Description: When truncated Product Names follow with ...
Default = true
Key: SHOW_CATEGORIES_BOX_SPECIALS
Path: Configuration > Layout Settings
Description: Show Specials Link in the Categories Box
Key: SHOW_CATEGORIES_BOX_PRODUCTS_NEW
Path: Configuration > Layout Settings
Description: Show Products New Link in the Categories Box

Shopping Cart Box Status

Key: SHOW_SHOPPING_CART_BOX_STATUS
Path: Configuration > Layout Settings
Description: Shopping Cart Shows
0= Always
1= Only when full
2= Only when full but not when viewing the Shopping Cart
Key: SHOW_CATEGORIES_BOX_FEATURED_PRODUCTS
Path: Configuration > Layout Settings
Description: Show Featured Products Link in the Categories Box
Key: SHOW_CATEGORIES_BOX_PRODUCTS_ALL
Path: Configuration > Layout Settings
Description: Show Products All Link in the Categories Box

Column Left Status - Global

Key: COLUMN_LEFT_STATUS
Path: Configuration > Layout Settings
Description: Show Column Left, unless page override exists?
0= Column Left is always off
1= Column Left is on, unless page override

Column Right Status - Global

Key: COLUMN_RIGHT_STATUS
Path: Configuration > Layout Settings
Description: Show Column Right, unless page override exists?
0= Column Right is always off
1= Column Right is on, unless page override

Column Width - Left

Key: COLUMN_WIDTH_LEFT
Path: Configuration > Layout Settings
Description: Width of the Left Column
px may be included
Default = 150px

Column Width - Right

Key: COLUMN_WIDTH_RIGHT
Path: Configuration > Layout Settings
Description: Width of the Right Column
px may be included
Default = 150px
Key: SHOW_CATEGORIES_SEPARATOR_LINK
Path: Configuration > Layout Settings
Description: Show Category Separator between Category Names and Links?
0= off
1= on

Categories Separator between the Category Name and Count

Key: CATEGORIES_SEPARATOR
Path: Configuration > Layout Settings
Description: What separator do you want between the Category name and the count?
Default = -&gt;

Categories Separator between the Category Name and Sub Categories

Key: CATEGORIES_SEPARATOR_SUBS
Path: Configuration > Layout Settings
Description: What separator do you want between the Category name and Sub Category Name?
Default = |_&nbsp;

Categories Count Prefix

Key: CATEGORIES_COUNT_PREFIX
Path: Configuration > Layout Settings
Description: What do you want to Prefix the count with?
Default= (

Categories Count Suffix

Key: CATEGORIES_COUNT_SUFFIX
Path: Configuration > Layout Settings
Description: What do you want as a Suffix to the count?
Default= )

Categories SubCategories Indent

Key: CATEGORIES_SUBCATEGORIES_INDENT
Path: Configuration > Layout Settings
Description: What do you want to use as the subcategories indent?
Default=   

Categories with 0 Products Status

Key: CATEGORIES_COUNT_ZERO
Path: Configuration > Layout Settings
Description: Show Category Count for 0 Products?
0= off
1= on

Shopping Cart - Show Totals

Key: SHOW_TOTALS_IN_CART
Path: Configuration > Layout Settings
Description: Show Totals Above Shopping Cart?
0= off
1= on: Items Weight Amount
2= on: Items Weight Amount, but no weight when 0
3= on: Items Amount

Customer Greeting - Show on Index Page

Key: SHOW_CUSTOMER_GREETING
Path: Configuration > Layout Settings
Description: Always Show Customer Greeting on Index?
0= off
1= on

Categories - Always Show on Main Page

Key: SHOW_CATEGORIES_ALWAYS
Path: Configuration > Layout Settings
Description: Always Show Categories on Main Page
0= off
1= on
Default category can be set to Top Level or a Specific Top Level

Main Page - Opens with Category

Key: CATEGORIES_START_MAIN
Path: Configuration > Layout Settings
Description: 0= Top Level Categories
Or enter the Category ID#
Note: Sub Categories can also be used Example: 3_10

Categories - Always Open to Show SubCategories

Key: SHOW_CATEGORIES_SUBCATEGORIES_ALWAYS
Path: Configuration > Layout Settings
Description: Always Show Categories and SubCategories
0= off, just show Top Categories
1= on, Always show Categories and SubCategories when selected
Key: SHOW_BANNERS_GROUP_SET1
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups

For multiple Banner Groups enter the Banner Group Name separated by a colon :

Example: Wide-Banners:SideBox-Banners

What Banner Group(s) do you want to use in the Header Position 1?
Leave blank for none
Key: SHOW_BANNERS_GROUP_SET2
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups

For multiple Banner Groups enter the Banner Group Name separated by a colon :

Example: Wide-Banners:SideBox-Banners

What Banner Group(s) do you want to use in the Header Position 2?
Leave blank for none
Key: SHOW_BANNERS_GROUP_SET3
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups

For multiple Banner Groups enter the Banner Group Name separated by a colon :

Example: Wide-Banners:SideBox-Banners

What Banner Group(s) do you want to use in the Header Position 3?
Leave blank for none
Key: SHOW_BANNERS_GROUP_SET4
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups

For multiple Banner Groups enter the Banner Group Name separated by a colon :

Example: Wide-Banners:SideBox-Banners

What Banner Group(s) do you want to use in the Footer Position 1?
Leave blank for none
Key: SHOW_BANNERS_GROUP_SET5
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups

For multiple Banner Groups enter the Banner Group Name separated by a colon :

Example: Wide-Banners:SideBox-Banners

What Banner Group(s) do you want to use in the Footer Position 2?
Leave blank for none
Key: SHOW_BANNERS_GROUP_SET6
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups

For multiple Banner Groups enter the Banner Group Name separated by a colon :

Example: Wide-Banners:SideBox-Banners

Default Group is Wide-Banners

What Banner Group(s) do you want to use in the Footer Position 3?
Leave blank for none
Key: SHOW_BANNERS_GROUP_SET7
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups

For multiple Banner Groups enter the Banner Group Name separated by a colon :

Example: Wide-Banners:SideBox-Banners
Default Group is SideBox-Banners

What Banner Group(s) do you want to use in the Side Box - banner_box?
Leave blank for none
Key: SHOW_BANNERS_GROUP_SET8
Path: Configuration > Layout Settings
Description: The Banner Display Groups can be from one Banner Group or multiple Banner Groups

For multiple Banner Groups enter the Banner Group Name separated by a colon :

Example: Wide-Banners:SideBox-Banners
Default Group is SideBox-Banners

What Banner Group(s) do you want to use in the Side Box - banner_box2?
Leave blank for none
Key: SHOW_BANNERS_GROUP_SET_ALL
Path: Configuration > Layout Settings
Description: The Banner Display Group may only be from one Banner Group for the Banner All sidebox

Default Group is BannersAll

What Banner Group do you want to use in the Side Box - banner_box_all?
Leave blank for none
Key: SHOW_FOOTER_IP
Path: Configuration > Layout Settings
Description: Show Customer IP Address in the Footer
0= off
1= on
Should the Customer IP Address show in the footer?

Product Discount Quantities - Add how many blank discounts?

Key: DISCOUNT_QTY_ADD
Path: Configuration > Layout Settings
Description: How many blank discount quantities should be added for Product Pricing?

Product Discount Quantities - Display how many per row?

Key: DISCOUNT_QUANTITY_PRICES_COLUMN
Path: Configuration > Layout Settings
Description: How many discount quantities should show per row on Product Info Pages?

Categories/Products Display Sort Order

Key: CATEGORIES_PRODUCTS_SORT_ORDER
Path: Configuration > Layout Settings
Description:

Set the initial sort order for the Admin Category/Product listing page.

 0 = Categories/Products: Sort Order, Name
 1 = Categories/Products: Name
 2 = Categories: ID+ / Products: Model
 3 = Categories: ID- / Products: Qty+, Name
 4 = Categories: Status, Name+ / Products: Qty-, Name
 5 = Categories: Status, Name- / Products: Price+, Name
 6 = Products: Price-, Name
 7 = Products: Model-
 8 = Products: Status+
 9 = Products: Status-
10 = Products: ID
11 = Products: Weight

Option Names and Values Global Add, Copy and Delete Features Status

Key: OPTION_NAMES_VALUES_GLOBAL_STATUS
Path: Configuration > Layout Settings
Description: Option Names and Values Global Add, Copy and Delete Features Status
0= Hide Features
1= Show Features
(Default=1)

Category Header Menu ON/OFF

Key: CATEGORIES_TABS_STATUS
Path: Configuration > Layout Settings
Description: Category Header Nav
This enables the display of your store's categories as a menu across the top of your header. There are many potential creative uses for this.
0= Hide Categories Tabs
1= Show Categories Tabs
Key: SHOW_ACCOUNT_LINKS_ON_SITE_MAP
Path: Configuration > Layout Settings
Description: Should the links to My Account show up on the site-map?
Note: Spiders will try to index this page, and likely should not be sent to secure pages, since there is no benefit in indexing a login page.

Default: false

Skip 1-prod Categories

Key: SKIP_SINGLE_PRODUCT_CATEGORIES
Path: Configuration > Layout Settings
Description: Skip single-product categories
If this option is set to True, then if the customer clicks on a link to a category which only contains a single item, then Zen Cart will take them directly to that product-page, rather than present them with another link to click in order to see the product.
Default: True

Use split-login page

Key: USE_SPLIT_LOGIN_MODE
Path: Configuration > Layout Settings
Description: The login page can be displayed in two modes: Split or Vertical.
In Split mode, the create-account options are accessed by clicking a button to get to the create-account page. In Vertical mode, the create-account input fields are all displayed inline, below the login field, making one less click for the customer to create their account.
Default: False

CSS Buttons

Key: IMAGE_USE_CSS_BUTTONS
Path: Configuration > Layout Settings
Description: CSS Buttons
Use CSS buttons instead of images (GIF/JPG)?
Button styles must be configured in the stylesheet if you enable this option.

Configuration ≫ Website Maintenance


Down for Maintenance: ON/OFF

Key: DOWN_FOR_MAINTENANCE
Path: Configuration > Website Maintenance
Description: Down for Maintenance
(true=on false=off)

Down for Maintenance: filename

Key: DOWN_FOR_MAINTENANCE_FILENAME
Path: Configuration > Website Maintenance
Description: Down for Maintenance filename
Note: Do not include the extension
Default=down_for_maintenance

Down for Maintenance: Hide Header

Key: DOWN_FOR_MAINTENANCE_HEADER_OFF
Path: Configuration > Website Maintenance
Description: Down for Maintenance: Hide Header
(true=hide false=show)

Down for Maintenance: Hide Column Left

Key: DOWN_FOR_MAINTENANCE_COLUMN_LEFT_OFF
Path: Configuration > Website Maintenance
Description: Down for Maintenance: Hide Column Left
(true=hide false=show)

Down for Maintenance: Hide Column Right

Key: DOWN_FOR_MAINTENANCE_COLUMN_RIGHT_OFF
Path: Configuration > Website Maintenance
Description: Down for Maintenance: Hide Column Right
(true=hide false=show)
Key: DOWN_FOR_MAINTENANCE_FOOTER_OFF
Path: Configuration > Website Maintenance
Description: Down for Maintenance: Hide Footer
(true=hide false=show)

Down for Maintenance: Hide Prices

Key: DOWN_FOR_MAINTENANCE_PRICES_OFF
Path: Configuration > Website Maintenance
Description: Down for Maintenance: Hide Prices
(true=hide false=show)

Down For Maintenance (exclude this IP-Address)

Key: EXCLUDE_ADMIN_IP_FOR_MAINTENANCE
Path: Configuration > Website Maintenance
Description: This IP Address is able to access the website while it is Down For Maintenance (like webmaster)
To enter multiple IP Addresses, separate with a comma. If you do not know your IP Address, check in the Footer of your Shop.

NOTICE PUBLIC Before going Down for Maintenance: ON/OFF

Key: WARN_BEFORE_DOWN_FOR_MAINTENANCE
Path: Configuration > Website Maintenance
Description: Give a WARNING some time before you put your website Down for Maintenance
(true=on false=off)
If you set the 'Down For Maintenance: ON/OFF' to true this will automatically be updated to false

Date and hours for notice before maintenance

Key: PERIOD_BEFORE_DOWN_FOR_MAINTENANCE
Path: Configuration > Website Maintenance
Description: Date and hours for notice before maintenance website, enter date and hours for maintenance website

Display when webmaster has enabled maintenance

Key: DISPLAY_MAINTENANCE_TIME
Path: Configuration > Website Maintenance
Description: Display when Webmaster has enabled maintenance
(true=on false=off)

Display website maintenance period

Key: DISPLAY_MAINTENANCE_PERIOD
Path: Configuration > Website Maintenance
Description: Display Website maintenance period
(true=on false=off)

Website maintenance period

Key: TEXT_MAINTENANCE_PERIOD_TIME
Path: Configuration > Website Maintenance
Description: Enter Website Maintenance period (hh:mm)

Configuration ≫ New Listing (Zen Cart v1.x.x only)


Controls the appearance of the New Products page in Zen Cart 1.x.x. See New Listing Configuration in v1.x.x for instructions on use.

For Zen Cart 2.0.0 and newer, please see New Listing Configuration.

Display Product Image

Key: PRODUCT_NEW_LIST_IMAGE
Path: Configuration > New Listing
Description: Do you want to display the Product Image?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Quantity

Key: PRODUCT_NEW_LIST_QUANTITY
Path: Configuration > New Listing
Description: Do you want to display the Product Quantity?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Buy Now Button

Key: PRODUCT_NEW_BUY_NOW
Path: Configuration > New Listing
Description: Do you want to display the Product Buy Now Button

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Name

Key: PRODUCT_NEW_LIST_NAME
Path: Configuration > New Listing
Description: Do you want to display the Product Name?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Model

Key: PRODUCT_NEW_LIST_MODEL
Path: Configuration > New Listing
Description: Do you want to display the Product Model?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Manufacturer Name

Key: PRODUCT_NEW_LIST_MANUFACTURER
Path: Configuration > New Listing
Description: Do you want to display the Product Manufacturer Name?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Price

Key: PRODUCT_NEW_LIST_PRICE
Path: Configuration > New Listing
Description: Do you want to display the Product Price

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Weight

Key: PRODUCT_NEW_LIST_WEIGHT
Path: Configuration > New Listing
Description: Do you want to display the Product Weight?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Date Added

Key: PRODUCT_NEW_LIST_DATE_ADDED
Path: Configuration > New Listing
Description: Do you want to display the Product Date Added?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Description

Key: PRODUCT_NEW_LIST_DESCRIPTION
Path: Configuration > New Listing
Description: How many characters do you want to display of the Product Description?

0= OFF
150= Suggested Length, or enter the maximum number of characters to display

Display Product Display - Default Sort Order

Key: PRODUCT_NEW_LIST_SORT_DEFAULT
Path: Configuration > New Listing
Description: What Sort Order Default should be used for New Products Display?
Default= 6 for Date New to Old

1= Products Name
2= Products Name Desc
3= Price low to high, Products Name
4= Price high to low, Products Name
5= Model
6= Date Added desc
7= Date Added
8= Product Sort Order

Default Products New Group ID

Key: PRODUCT_NEW_LIST_GROUP_ID
Path: Configuration > New Listing
Description: Warning: Only change this if your Products New Group ID has changed from the default of 21
What is the configuration_group_id for New Products Listings?

Display Multiple Products Qty Box Status and Set Button Location

Key: PRODUCT_NEW_LISTING_MULTIPLE_ADD_TO_CART
Path: Configuration > New Listing
Description: Do you want to display Add Multiple Products Qty Box and Set Button Location?
0= off
1= Top
2= Bottom
3= Both

Mask Upcoming Products from being include as New Products

Key: SHOW_NEW_PRODUCTS_UPCOMING_MASKED
Path: Configuration > New Listing
Description: Do you want to mask Upcoming Products from being included as New Products in Listing, Sideboxes and Centerbox?
0= off
1= on

Configuration ≫ Featured Listing (Zen Cart v1.x.x only)


Controls the appearance of the Featured Products page in Zen Cart v1.x.x. See Featured Listing Configuration in v1.x.x for instructions on use.

For Zen Cart 2.0.0 and newer, please see Featured Listing Configuration.

Display Product Image

Key: PRODUCT_FEATURED_LIST_IMAGE
Path: Configuration > Featured Listing
Description: Do you want to display the Product Image?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Quantity

Key: PRODUCT_FEATURED_LIST_QUANTITY
Path: Configuration > Featured Listing
Description: Do you want to display the Product Quantity?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Buy Now Button

Key: PRODUCT_FEATURED_BUY_NOW
Path: Configuration > Featured Listing
Description: Do you want to display the Product Buy Now Button

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Name

Key: PRODUCT_FEATURED_LIST_NAME
Path: Configuration > Featured Listing
Description: Do you want to display the Product Name?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Model

Key: PRODUCT_FEATURED_LIST_MODEL
Path: Configuration > Featured Listing
Description: Do you want to display the Product Model?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Manufacturer Name

Key: PRODUCT_FEATURED_LIST_MANUFACTURER
Path: Configuration > Featured Listing
Description: Do you want to display the Product Manufacturer Name?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Price

Key: PRODUCT_FEATURED_LIST_PRICE
Path: Configuration > Featured Listing
Description: Do you want to display the Product Price

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Weight

Key: PRODUCT_FEATURED_LIST_WEIGHT
Path: Configuration > Featured Listing
Description: Do you want to display the Product Weight?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Date Added

Key: PRODUCT_FEATURED_LIST_DATE_ADDED
Path: Configuration > Featured Listing
Description: Do you want to display the Product Date Added?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Description

Key: PRODUCT_FEATURED_LIST_DESCRIPTION
Path: Configuration > Featured Listing
Description: How many characters do you want to display of the Product Description?

0= OFF
150= Suggested Length, or enter the maximum number of characters to display

Display Product Display - Default Sort Order

Key: PRODUCT_FEATURED_LIST_SORT_DEFAULT
Path: Configuration > Featured Listing
Description: What Sort Order Default should be used for Featured Product Display?
Default= 1 for Product Name

1= Products Name
2= Products Name Desc
3= Price low to high, Products Name
4= Price high to low, Products Name
5= Model
6= Date Added desc
7= Date Added
8= Product Sort Order
Key: PRODUCT_FEATURED_LIST_GROUP_ID
Path: Configuration > Featured Listing
Description: Warning: Only change this if your Featured Products Group ID has changed from the default of 22
What is the configuration_group_id for Featured Products Listings?

Display Multiple Products Qty Box Status and Set Button Location

Key: PRODUCT_FEATURED_LISTING_MULTIPLE_ADD_TO_CART
Path: Configuration > Featured Listing
Description: Do you want to display Add Multiple Products Qty Box and Set Button Location?
0= off
1= Top
2= Bottom
3= Both

Configuration ≫ All Listing (Zen Cart v1.x.x only)


Controls the appearance of the All Products page in Zen Cart v1.x.x. See All Listing Configuration in v1.x.x for instructions on use.

For Zen Cart 2.0.0 and newer, please see All Listing Configuration.

Display Product Image

Key: PRODUCT_ALL_LIST_IMAGE
Path: Configuration > All Listing
Description: Do you want to display the Product Image?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Quantity

Key: PRODUCT_ALL_LIST_QUANTITY
Path: Configuration > All Listing
Description: Do you want to display the Product Quantity?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Buy Now Button

Key: PRODUCT_ALL_BUY_NOW
Path: Configuration > All Listing
Description: Do you want to display the Product Buy Now Button

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Name

Key: PRODUCT_ALL_LIST_NAME
Path: Configuration > All Listing
Description: Do you want to display the Product Name?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Model

Key: PRODUCT_ALL_LIST_MODEL
Path: Configuration > All Listing
Description: Do you want to display the Product Model?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Manufacturer Name

Key: PRODUCT_ALL_LIST_MANUFACTURER
Path: Configuration > All Listing
Description: Do you want to display the Product Manufacturer Name?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Price

Key: PRODUCT_ALL_LIST_PRICE
Path: Configuration > All Listing
Description: Do you want to display the Product Price

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Weight

Key: PRODUCT_ALL_LIST_WEIGHT
Path: Configuration > All Listing
Description: Do you want to display the Product Weight?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Date Added

Key: PRODUCT_ALL_LIST_DATE_ADDED
Path: Configuration > All Listing
Description: Do you want to display the Product Date Added?

0= off
1st digit Left or Right
2nd and 3rd digit Sort Order
4th digit number of breaks after

Display Product Description

Key: PRODUCT_ALL_LIST_DESCRIPTION
Path: Configuration > All Listing
Description: How many characters do you want to display of the Product Description?

0= OFF
150= Suggested Length, or enter the maximum number of characters to display

Display Product Display - Default Sort Order

Key: PRODUCT_ALL_LIST_SORT_DEFAULT
Path: Configuration > All Listing
Description: What Sort Order Default should be used for All Products Display?
Default= 1 for Product Name

1= Products Name
2= Products Name Desc
3= Price low to high, Products Name
4= Price high to low, Products Name
5= Model
6= Date Added desc
7= Date Added
8= Product Sort Order

Default Products All Group ID

Key: PRODUCT_ALL_LIST_GROUP_ID
Path: Configuration > All Listing
Description: Warning: Only change this if your Products All Group ID has changed from the default of 23
What is the configuration_group_id for Products All Listings?

Display Multiple Products Qty Box Status and Set Button Location

Key: PRODUCT_ALL_LISTING_MULTIPLE_ADD_TO_CART
Path: Configuration > All Listing
Description: Do you want to display Add Multiple Products Qty Box and Set Button Location?
0= off
1= Top
2= Bottom
3= Both

Configuration ≫ Index Listing


Show New Products on Main Page

Key: SHOW_PRODUCT_INFO_MAIN_NEW_PRODUCTS
Path: Configuration > Index Listing
Description: Show New Products on Main Page
0= off or set the sort order
Key: SHOW_PRODUCT_INFO_MAIN_FEATURED_PRODUCTS
Path: Configuration > Index Listing
Description: Show Featured Products on Main Page
0= off or set the sort order

Show Special Products on Main Page

Key: SHOW_PRODUCT_INFO_MAIN_SPECIALS_PRODUCTS
Path: Configuration > Index Listing
Description: Show Special Products on Main Page
0= off or set the sort order

Show Upcoming Products on Main Page

Key: SHOW_PRODUCT_INFO_MAIN_UPCOMING
Path: Configuration > Index Listing
Description: Show Upcoming Products on Main Page
0= off or set the sort order

Show New Products on Main Page - Category with SubCategories

Key: SHOW_PRODUCT_INFO_CATEGORY_NEW_PRODUCTS
Path: Configuration > Index Listing
Description: Show New Products on Main Page - Category with SubCategories
0= off or set the sort order
Key: SHOW_PRODUCT_INFO_CATEGORY_FEATURED_PRODUCTS
Path: Configuration > Index Listing
Description: Show Featured Products on Main Page - Category with SubCategories
0= off or set the sort order

Show Special Products on Main Page - Category with SubCategories

Key: SHOW_PRODUCT_INFO_CATEGORY_SPECIALS_PRODUCTS
Path: Configuration > Index Listing
Description: Show Special Products on Main Page - Category with SubCategories
0= off or set the sort order

Show Upcoming Products on Main Page - Category with SubCategories

Key: SHOW_PRODUCT_INFO_CATEGORY_UPCOMING
Path: Configuration > Index Listing
Description: Show Upcoming Products on Main Page - Category with SubCategories
0= off or set the sort order

Show New Products on Main Page - Errors and Missing Products Page

Key: SHOW_PRODUCT_INFO_MISSING_NEW_PRODUCTS
Path: Configuration > Index Listing
Description: Show New Products on Main Page - Errors and Missing Product
0= off or set the sort order
Key: SHOW_PRODUCT_INFO_MISSING_FEATURED_PRODUCTS
Path: Configuration > Index Listing
Description: Show Featured Products on Main Page - Errors and Missing Product
0= off or set the sort order

Show Special Products on Main Page - Errors and Missing Products Page

Key: SHOW_PRODUCT_INFO_MISSING_SPECIALS_PRODUCTS
Path: Configuration > Index Listing
Description: Show Special Products on Main Page - Errors and Missing Product
0= off or set the sort order

Show Upcoming Products on Main Page - Errors and Missing Products Page

Key: SHOW_PRODUCT_INFO_MISSING_UPCOMING
Path: Configuration > Index Listing
Description: Show Upcoming Products on Main Page - Errors and Missing Product
0= off or set the sort order

Show New Products - below Product Listing

Key: SHOW_PRODUCT_INFO_LISTING_BELOW_NEW_PRODUCTS
Path: Configuration > Index Listing
Description: Show New Products below Product Listing
0= off or set the sort order
Key: SHOW_PRODUCT_INFO_LISTING_BELOW_FEATURED_PRODUCTS
Path: Configuration > Index Listing
Description: Show Featured Products below Product Listing
0= off or set the sort order

Show Special Products - below Product Listing

Key: SHOW_PRODUCT_INFO_LISTING_BELOW_SPECIALS_PRODUCTS
Path: Configuration > Index Listing
Description: Show Special Products below Product Listing
0= off or set the sort order

Show Upcoming Products - below Product Listing

Key: SHOW_PRODUCT_INFO_LISTING_BELOW_UPCOMING
Path: Configuration > Index Listing
Description: Show Upcoming Products below Product Listing
0= off or set the sort order

New Products Columns per Row

Key: SHOW_PRODUCT_INFO_COLUMNS_NEW_PRODUCTS
Path: Configuration > Index Listing
Description: New Products Columns per Row
Key: SHOW_PRODUCT_INFO_COLUMNS_FEATURED_PRODUCTS
Path: Configuration > Index Listing
Description: Featured Products Columns per Row

Special Products Columns per Row

Key: SHOW_PRODUCT_INFO_COLUMNS_SPECIALS_PRODUCTS
Path: Configuration > Index Listing
Description: Special Products Columns per Row

Filter Product Listing for Current Top Level Category When Enabled

Key: SHOW_PRODUCT_INFO_ALL_PRODUCTS
Path: Configuration > Index Listing
Description: Filter the products when Product Listing is enabled for current Main Category or show products from all categories?
0= Filter Off 1=Filter On

Configuration ≫ Define Page Status


See Define Pages for instructions on use.

Define Main Page Status

Key: DEFINE_MAIN_PAGE_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Main Page Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Define Contact Us Status

Key: DEFINE_CONTACT_US_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Contact Us Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Define Privacy Status

Key: DEFINE_PRIVACY_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Privacy Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Define Shipping & Returns

Key: DEFINE_SHIPPINGINFO_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Shipping & Returns Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Define Conditions of Use

Key: DEFINE_CONDITIONS_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Conditions of Use Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Define Checkout Success

Key: DEFINE_CHECKOUT_SUCCESS_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Checkout Success Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Define Discount Coupon

Key: DEFINE_DISCOUNT_COUPON_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Discount Coupon Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Define Site Map Status

Key: DEFINE_SITE_MAP_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Site Map Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Define Page-Not-Found Status

Key: DEFINE_PAGE_NOT_FOUND_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Page-Not-Found Text from define-pages?
0= Define Text OFF
1= Define Text ON

Define Page 2

Key: DEFINE_PAGE_2_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Page 2 Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Define Page 3

Key: DEFINE_PAGE_3_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Page 3 Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Define Page 4

Key: DEFINE_PAGE_4_STATUS
Path: Configuration > Define Page Status
Description: Enable the Defined Page 4 Link/Text?
0= Link ON, Define Text OFF
1= Link ON, Define Text ON
2= Link OFF, Define Text ON
3= Link OFF, Define Text OFF

Configuration ≫ EZ-Pages Settings


EZ-Pages Display Status - HeaderBar

Key: EZPAGES_STATUS_HEADER
Path: Configuration > EZ-Pages Settings
Description: Display of EZ-Pages content can be Globally enabled/disabled for the Header Bar
0 = Off
1 = On
2= On ADMIN IP ONLY located in Website Maintenance
NOTE: Warning only shows to the Admin and not to the public

EZ-Pages Display Status - FooterBar

Key: EZPAGES_STATUS_FOOTER
Path: Configuration > EZ-Pages Settings
Description: Display of EZ-Pages content can be Globally enabled/disabled for the Footer Bar
0 = Off
1 = On
2= On ADMIN IP ONLY located in Website Maintenance
NOTE: Warning only shows to the Admin and not to the public

EZ-Pages Display Status - Sidebox

Key: EZPAGES_STATUS_SIDEBOX
Path: Configuration > EZ-Pages Settings
Description: Display of EZ-Pages content can be Globally enabled/disabled for the Sidebox
0 = Off
1 = On
2= On ADMIN IP ONLY located in Website Maintenance
NOTE: Warning only shows to the Admin and not to the public
Key: EZPAGES_SEPARATOR_HEADER
Path: Configuration > EZ-Pages Settings
Description: EZ-Pages Header Link Separator
Default = &nbsp;::&nbsp;
Key: EZPAGES_SEPARATOR_FOOTER
Path: Configuration > EZ-Pages Settings
Description: EZ-Pages Footer Link Separator
Default = &nbsp;::&nbsp;

EZ-Pages Prev/Next Buttons

Key: EZPAGES_SHOW_PREV_NEXT_BUTTONS
Path: Configuration > EZ-Pages Settings
Description: Display Prev/Continue/Next buttons on EZ-Pages pages?
0=OFF (no buttons)
1="Continue"
2="Prev/Continue/Next"

Default setting: 2.

EZ-Pages Table of Contents for Chapters Status

Key: EZPAGES_SHOW_TABLE_CONTENTS
Path: Configuration > EZ-Pages Settings
Description: Enable EZ-Pages Table of Contents for Chapters?
0= OFF
1= ON

EZ-Pages Pages to disable headers

Key: EZPAGES_DISABLE_HEADER_DISPLAY_LIST
Path: Configuration > EZ-Pages Settings
Description: EZ-Pages "pages" on which to NOT display the normal "header" for your site.
Simply list page ID numbers separated by commas with no spaces.
Page ID numbers can be obtained from the EZ-Pages screen under Admin > Tools.
ie: 1,5,2
or leave blank.

EZ-Pages Pages to disable footers

Key: EZPAGES_DISABLE_FOOTER_DISPLAY_LIST
Path: Configuration > EZ-Pages Settings
Description: EZ-Pages "pages" on which to NOT display the normal "footer" for your site.
Simply list page ID numbers separated by commas with no spaces.
Page ID numbers can be obtained from the EZ-Pages screen under Admin > Tools.
ie: 3,7
or leave blank.

EZ-Pages Pages to disable left-column

Key: EZPAGES_DISABLE_LEFTCOLUMN_DISPLAY_LIST
Path: Configuration > EZ-Pages Settings
Description: EZ-Pages "pages" on which to NOT display the normal "left" column (of sideboxes) for your site.
Simply list page ID numbers separated by commas with no spaces.
Page ID numbers can be obtained from the EZ-Pages screen under Admin > Tools.
ie: 21
or leave blank.

EZ-Pages Pages to disable right-column

Key: EZPAGES_DISABLE_RIGHTCOLUMN_DISPLAY_LIST
Path: Configuration > EZ-Pages Settings
Description: EZ-Pages "pages" on which to NOT display the normal "right" column (of sideboxes) for your site.
Simply list page ID numbers separated by commas with no spaces.
Page ID numbers can be obtained from the EZ-Pages screen under Admin > Tools.
ie: 3,82,13
or leave blank.

Configuration ≫ Options’ Stock Manager


See Variant Stock for details and instructions on use.

General: Enable Products Options Stock Manager?

Key: POSM_ENABLE
Path: Configuration > Options' Stock Manager
Description: Enable the Products' Options' Stock processing for the storefront?

General: Duplicate Model Numbers

Key: POSM_DUPLICATE_MODELNUMS
Path: Configuration > Options' Stock Manager
Description: How should the admin-level tools handle duplicate model numbers? Choose one of:
  1. Allow (default): No message, allows saving.
  2. Disallow: Issue message, don't allow saving.
  3. Message-Only: Issue message, allow saving.

General: Divider Color

Key: POSM_DIVIDER_COLOR
Path: Configuration > Options' Stock Manager
Description: Enter the background color to be used for the divider in Catalog :: Products' Options' Stock Manager.

General: Options Stock Re-order Level

Key: POSM_STOCK_REORDER_LEVEL
Path: Configuration > Options' Stock Manager
Description: Enter the low-stock level for products with options' stock. This value is used to highlight low-stock options within the Catalog->Manage Options' Stock tools and, if Configuration->E-mail Options->Send Low Stock Emails is enabled, determines the stock-level at which to send those emails.

Note: The value entered must consist of numeric (0-9) characters only.

General: Back-in-Stock Date Reminder

Key: POSM_BIS_DATE_REMINDER
Path: Configuration > Options' Stock Manager
Description: If your store is using POSM's back-in-stock labels with availability dates, you might want a reminder when a date is imminent. Identify the number of days prior to any expiration that the notification should be issued; set the value to 0 (the default) if you do not want a reminder.

General: Option Types to Manage?

Key: POSM_OPTIONS_TYPES_TO_MANAGE
Path: Configuration > Options' Stock Manager
Description: Enter the types of options to manage using a packed, comma-separated list. Currently, only Dropdown/Select (0) and Radio (2) option types are supported!

General: Optional Option Types List

Key: POSM_OPTIONAL_OPTION_TYPES_LIST
Path: Configuration > Options' Stock Manager
Description: Enter types of options to be ignored when determining if a product's option-combination is managed, using a packed, comma-separated list.

The built-in Zen Cart option types are Dropdown/Select (0), Text (1), Radio (2), Checkbox (3), File (4) and Read-Only (5).

General: Optional Option Names List

Key: POSM_OPTIONAL_OPTION_NAMES_LIST
Path: Configuration > Options' Stock Manager
Description: Enter the list of optional product options for your store, using a packed, comma-separated list of their option_id values. All option values associated with the options that you identify here are ignored when determining if a product's option-combination is managed.

Use this value in conjunction with the "Optional Option Types List" to refine your store's option-combination configurations.

Stock Status Display: Show Messages?

Key: POSM_SHOW_STOCK_MESSAGES
Path: Configuration > Options' Stock Manager
Description: Choose where (Store Only, Admin Only, Both or Neither) the POSM in-/out-of-stock messages will be displayed.

If you choose Store Only or Both, this status will be displayed to your customers on the shopping_cart, checkout_confirmation and account_history_info pages. See also the Dependent Attributes: Stock Status Display setting, below, which operates independently of this setting.

If you choose Admin Only or Both, the in-/out-of-stock messages will be displayed within your Customers->Orders details display, invoices and packing slips.

Stock Status Display: Messages for Unmanaged Options?

Key: POSM_SHOW_UNMANAGED_OPTIONS_STATUS
Path: Configuration > Options' Stock Manager
Description: Should the store-side processing include in-/out-of-stock messages for non-POSM-managed products? If set to true, the messages will be displayed depending on the unmanaged product's stock quantity — In Stock if > 0; the default out-of-stock message (PRODUCTS_OPTIONS_STOCK_NOT_IN_STOCK), otherwise.

Stock Status Display: Include In-Stock Status?

Key: POSM_SHOW_IN_STOCK_MESSAGE
Path: Configuration > Options' Stock Manager
Description: Choose whether to include the display of the "in-stock" product status, wherever that status-display is enabled. If set to false, only out-of-stock messages will be displayed.

Admin: Model Number Field Width

Key: POSM_ADMIN_MODEL_WIDTH
Path: Configuration > Options' Stock Manager
Description: Use this setting to control the width of the Option Model/SKU field displayed by Catalog :: Manage Options' Stock and Catalog :: Options' Stock — View All pages. Enter a valid CSS "width" value, e.g. 9em (default) or 9px.

Note: Leave the setting blank to use the database-defined field width.

Dependent Attributes: Enable

Key: POSM_DEPENDENT_ATTRS_ENABLE
Path: Configuration > Options' Stock Manager
Description: Identify whether or not the plugin's dependent-attributes processing should be enabled.

Dependent Attributes: Insert "Please Choose"?

Key: POSM_DEPENDENT_ATTRS_PLEASE_CHOOSE
Path: Configuration > Options' Stock Manager
Description: Identify whether or not the plugin's dependent-attributes processing should insert a "Please Choose" selection into a product's drop-down options. If false, the first option value for each attribute is assumed to be a "Please choose …" type value.

Note: This setting does not apply when a product has a single drop-down option.

Dependent Attributes: Show Model Number?

Key: POSM_DEPENDENT_ATTRS_SHOW_MODEL
Path: Configuration > Options' Stock Manager
Description: Identify whether or not the plugin's dependent-attributes processing should include the model-numbers for each attribute value on the final, selectable attribute's option.

Note: A model-number is included only if that value is not an empty string.

Dependent Attributes: Show Stock Status?

Key: POSM_DEPENDENT_ATTRS_STOCK_STATUS
Path: Configuration > Options' Stock Manager
Description: Identify whether or not the plugin's dependent-attributes processing should include the in-/out-of-stock status for each attribute value on the final, selectable attribute's option.

Note: In-stock status is included only if Stock Status Display: Include In-Stock Status? is set to true.

Dependent Attributes: Show In-Stock Quantity in Status?

Key: POSM_DEPENDENT_ATTRS_STOCK_STATUS_QTY
Path: Configuration > Options' Stock Manager
Description: When Dependent Attributes: Stock Status Display and Stock Status Display: Include In-Stock Status? are both true, should the in-stock quantity be displayed when the option-combination is In Stock?

Dependent Attributes: Outer Selector

Key: POSM_ATTRIBUTE_WRAPPER_SELECTOR
Path: Configuration > Options' Stock Manager
Description: Identify the outer CSS selector (default: an empty string) that wraps all elements associated with a single option.

Notes:
  1. For Zen Cart's built-in responsive_classic and template_default templates (and clones thereof), this value should be set to .attribBlock.
  2. For the bootstrap template (and clones thereof), this value should be set to an empty string.

Dependent Attributes: Inner Selector

Key: POSM_ATTRIBUTE_SELECTOR
Path: Configuration > Options' Stock Manager
Description: Identify the inner CSS selector (default: .wrapperAttribsOptions) that contains, at a minimum, each option's name. Note: This value should be changed only if your custom template has modified the attributes' display formatting.

Dependent Attributes: Option Name Selector

Key: POSM_OPTION_NAME_SELECTOR
Path: Configuration > Options' Stock Manager
Description: Identify the CSS selector (default: .optionName) that identifies the element that contains the current option's name. Note: This value should be changed only if your custom template has modified the attributes' display formatting.

Dependent Attributes: Attributes Images Selector

Key: POSM_ATTRIBUTE_IMAGE_SELECTOR
Path: Configuration > Options' Stock Manager
Description: Identify the CSS selector (default: .attribImg) that wraps, if configured, each attribute's image. Note: This value should be changed only if your custom template has modified the attributes' display formatting.

Dependent Attributes: Use Minified Script File?

Key: POSM_USE_MINIFIED_JSCRIPT
Path: Configuration > Options' Stock Manager
Description: Identify whether or not the plugin's dependent-attributes processing should load the minified version of the jQuery script, reducing the page-load time for a product's page.

View All: Allow Model Number Updates?

Key: POSM_VIEW_ALL_MODEL_UPDATE
Path: Configuration > Options' Stock Manager
Description: Should the "View All" processing for Catalog->Manage Options' Stock enable the managed variants' model numbers to be updated? If set to false, the model numbers are displayed but cannot be updated; you'll need to update the model numbers on a product-by-product basis.

View All: Maximum Products/Page

Key: POSM_MAX_PRODUCTS_VIEW_ALL
Path: Configuration > Options' Stock Manager
Description: Enter the maximum number of products to display on a single page of the View All tool.

Shopping Cart: Display Model Numbers?

Key: POSM_CART_DISPLAY_MODEL_NUMBERS
Path: Configuration > Options' Stock Manager
Description: Should the shopping_cart page display a product's model-number? If you choose true, a product's model number is appended to its name for the display, e.g. "Product Name [model]", if the model-number is not empty.

Enable debug?

Key: POSM_ENABLE_DEBUG
Path: Configuration > Options' Stock Manager
Description: If enabled, the POSM processing will write debug information to either a myDEBUG-POSM-*.log (for store-side actions) or a myDEBUG-POSM-adm-*.log (for admin-side actions) file in your store's logs directory.




Still have questions? Use the Search box in the upper right, or try the full list of FAQs. If you can't find it there, head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified July 13, 2024 by Scott C Wilson (70f5bea3).