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   symbol if you want them part of the separator.
Default =  :: 

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 =  

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 = ->

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 = |_ 

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.



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 February 25, 2024 by Scott Wilson (3f2449d3).