Skip to content

Soft Configuration Settings

lat9 edited this page May 25, 2026 · 1 revision

There are a couple of "soft" (i.e. PHP variables) configuration settings provided by the Bootstrap template, distributed in /includes/extra_datafiles/dist.site-specific-bootstrap-settings.php. To change any of the soft-settings for use on your site, first create a copy of that file in /includes/extra_datafiles/site-specific-bootstrap-settings.php (so you don't lose your settings on a template upgrade) and then edit that copy.

The settings available in that file are:

Variable Name Description
$zca_js_zone_list_use_zone_code This boolean flag instructs the zca_js_zone_list function whether to use a zone's zone_id (false, default) or zone_code (true) as the 'key' to the zone's name in the generated JSON array.
$zca_disable_back_to_top This boolean flag, used at the bottom of tpl_main_page.php, indicates whether (false, the default) or not (true) to disable the back-to-top control on each page.
$zca_include_zero_product_categories If your site has Configuration :: My Store :: Show Category Counts set to 'true', this boolean flag indicates whether (true, the default) of not (false) categories with no products are to be included in sub-categories' listings and in the "Categories" sidebox.
$zca_no_preloading This boolean flag controls the preloading of the template's "core" CSS and JS files. Set the value to false (the default) to perform the preloading or true to disable the preloading.
$zca_show_contact_us_instead_of_continue This boolean flag controls the checkout_shipping page's behavior when there are no shipping methods available to ship the customer's order. Set its value to false (the default) to display a "Continue" button, which results in the checkout_shipping page's re-display if clicked. Set the value to true to have that page display a "Contact Us" button/link instead.
$zca_load_fa_brands The Font Awesome 6 Brand icons are not loaded by default; they may be loaded by setting this flag to true.

Clone this wiki locally