Bootstrap-4 Template for Zen Cart v1.5.7 and later

Version 3.1.5, by lat9, drbyte, scottcwilson, marco-pm and dennisns7d

Current Support Thread at Zen Cart Forums: https://www.zen-cart.com/showthread.php?223910-ZCA-Bootstrap-4-Template-Support-Thread

Zen Cart Download Link: https://www.zen-cart.com/downloads.php?do=file&id=2191

GitHub repository: https://github.com/lat9/ZCA-Bootstrap-Template.

What it does

This template uses Bootstrap-4 to provide its styling and builds on the base that Raymond Barbour provided over the past few years, supporting Zen Cart versions 1.5.7 and later — best supported by zc157c and later. If your store is based on either zc157, zc157a or zc157b, be sure that you have applied all the patches!

Bootstrap Template, Files List

The following files are provided in the current template distribution:

  1. /includes/auto_loaders/config.zca_bootstrap.php
  2. /includes/classes/observers/ZcaBootstrapObserver.php
  3. /includes/classes/zca/zca_message_stack.php
  4. /includes/classes/zca/zca_split_page_result.php
  5. /includes/classes/zca/zca_site_map.php
  6. /includes/functions/zca_bootstrap_functions.php
  7. /includes/init_includes/init_zca_bootstrap.php
  8. /includes/languages/english/bootstrap/extra_definitions/*.php
  9. /includes/modules/bootstrap/*.php
  10. /includes/modules/bootstrap/centerboxes/*.php
  11. /includes/modules/order_total/ot_coupon.php
  12. /includes/modules/pages/account_history/header_php_account_history_zca_bootstrap.php
  13. /includes/modules/pages/featured_products/header_php_featured_products_zca_bootstrap.php
  14. /includes/modules/pages/page_not_found/header_php_page_not_found_zca_bootstrap.php
  15. /includes/modules/pages/product_reviews/header_php_product_reviews_zca_bootstrap.php
  16. /includes/modules/pages/product_reviews_info/header_php_product_reviews_info_zca_bootstrap.php
  17. /includes/modules/pages/product_reviews_write/header_php_product_reviews_write_zca_bootstrap.php
  18. /includes/modules/pages/products_all/header_php_products_all_zca_bootstrap.php
  19. /includes/modules/pages/products_new/header_php_products_new_zca_bootstrap.php
  20. /includes/modules/pages/shopping_cart/header_php_shopping_cart_zca_bootstrap.php
  21. /includes/modules/pages/site_map/header_php_site_map_zca_bootstrap.php
  22. /includes/modules/pages/specials/header_php_specials_zca_bootstrap.php
  23. /includes/modules/sideboxes/bootstrap/*.php
  24. /includes/templates/bootstrap/*.*

Upgrading from v2.0.0c

As an aid in upgrading from the template's v2.0.0c release, this section identifies the files added, removed or moved in the transition from v2.0.0c of the template to v3.0.0. They might also apply to upgrades from a previous version, but you'll need to check the CHANGELOG.txt file provided by this template's zip-file for those prior changes.

Files Removed

  1. /includes/classes/order.php (Removed from this distribution only. Use the zc157b version of the file.)
  2. /includes/classes/site_map.php (Removed from this distribution only. Use the zc157b version of the file.)
  3. /includes/classes/ajax/zcAjaxPayment.php (Removed from this distribution only. Use the zc157b version of the file.)
  4. /includes/classes/zca/zca_breadcrumb.php
  5. /includes/classes/zca_photoswipe/autoload_default.php
  6. /includes/classes/zca_photoswipe/jquery_photoswipe.php
  7. /includes/functions/extra_functions/zen_photoswipe.php
  8. /includes/init_includes/init_zca_listing_style.php
  9. /includes/languages/english/bootstrap/button_names.php
  10. /includes/languages/english/bootstrap/checkout_payment_address.php
  11. /includes/languages/english/bootstrap/checkout_shipping_address.php
  12. /includes/languages/english/bootstrap/create_account.php
  13. /includes/languages/english/bootstrap/create_account_success.php
  14. /includes/languages/english/bootstrap/document_general_info.php
  15. /includes/languages/english/bootstrap/document_product_info.php
  16. /includes/languages/english/bootstrap/featured_products.php
  17. /includes/languages/english/bootstrap/info_shopping_cart.php
  18. /includes/languages/english/bootstrap/login.php
  19. /includes/languages/english/bootstrap/popup_coupon_help.php
  20. /includes/languages/english/bootstrap/popup_cvv_help.php
  21. /includes/languages/english/bootstrap/popup_search_help.php
  22. /includes/languages/english/bootstrap/products_all.php
  23. /includes/languages/english/bootstrap/products_new.php
  24. /includes/languages/english/bootstrap/product_free_shipping.php
  25. /includes/languages/english/bootstrap/product_free_shipping_info.php
  26. /includes/languages/english/bootstrap/product_info.php
  27. /includes/languages/english/bootstrap/product_music_info.php
  28. /includes/languages/english/bootstrap/product_reviews_info.php
  29. /includes/languages/english/bootstrap/product_reviews_write.php
  30. /includes/languages/english/bootstrap/shopping_cart.php
  31. /includes/languages/english/bootstrap/specials.php
  32. /includes/languages/english/extra_definitions/zca_photoswipe.php
  33. /includes/modules/order_total/ot_gv.php (Removed from this distribution only. Use the zc157b version of the file.)
  34. /includes/modules/bootstrap/additional_images.php
  35. /includes/modules/bootstrap/bootstrap_main_image.php
  36. /includes/modules/pages/address_book_process/jscript_addr_pulldowns_zca_bootstrap.php
  37. /includes/modules/pages/checkout_payment_address/jscript_addr_pulldowns_zca_bootstrap.php
  38. /includes/modules/pages/checkout_shipping_address/jscript_addr_pulldowns_zca_bootstrap.php
  39. /includes/modules/pages/create_account/jscript_addr_pulldowns_zca_bootstrap.php
  40. /includes/modules/pages/document_general_info/jscript_zca_photoswipe.php
  41. /includes/modules/pages/document_product_info/jscript_zca_photoswipe.php
  42. /includes/modules/pages/login/jscript_addr_pulldowns_zca_bootstrap.php
  43. /includes/modules/pages/page/jscript_zca_photoswipe.php
  44. /includes/modules/pages/popup_shipping_estimator/jscript_addr_pulldowns_zca_bootstrap.php
  45. /includes/modules/pages/product_free_shipping_info/jscript_zca_photoswipe.php
  46. /includes/modules/pages/product_info/jscript_zca_photoswipe.php
  47. /includes/modules/pages/product_music_info/jscript_zca_photoswipe.php
  48. /includes/modules/pages/product_reviews/jscript_zca_photoswipe.php
  49. /includes/modules/pages/product_reviews_info/jscript_zca_photoswipe.php
  50. /includes/modules/pages/product_reviews_write/jscript_zca_photoswipe.php
  51. /includes/modules/pages/specials/main_template_vars.php (Removed from this distribution only. Use the zc157b version of the file.)
  52. /includes/templates/bootstrap/template_readme.html
  53. /includes/templates/bootstrap/css/stylesheet_photoswipe.css
  54. /includes/templates/bootstrap/jscript/jscript_zca_bootstrap.php
  55. /includes/templates/bootstrap/sideboxes/tpl_banner_box.php
  56. /includes/templates/bootstrap/sideboxes/tpl_banner_box_all.php
  57. /includes/templates/bootstrap/sideboxes/tpl_banner_box2.php
  58. /includes/templates/bootstrap/sideboxes/tpl_currencies.php
  59. /includes/templates/bootstrap/sideboxes/tpl_languages.php
  60. /includes/templates/bootstrap/sideboxes/tpl_manufacturer_info.php
  61. /includes/templates/bootstrap/sideboxes/tpl_music_genres_select.php
  62. /includes/templates/bootstrap/sideboxes/tpl_no_notifications.php
  63. /includes/templates/bootstrap/sideboxes/tpl_record_company_select.php
  64. /includes/templates/bootstrap/sideboxes/tpl_reviews_none.php
  65. /includes/templates/bootstrap/sideboxes/tpl_reviews_write.php
  66. /includes/templates/bootstrap/sideboxes/tpl_whos_online.php
  67. /includes/templates/bootstrap/sideboxes/tpl_yes_notifications.php
  68. /includes/templates/bootstrap/templates/tpl_modules_checkout_new_address.php
  69. /includes/templates/bootstrap/templates/tpl_modules_new_payment_address.php
  70. /includes/templates/bootstrap/templates/tpl_modules_new_shipping_address.php
  71. /includes/templates/bootstrap/templates/tpl_zc_install_suggested_default.php

Files Added

  1. /includes/classes/zca/zca_site_map.php
  2. /includes/languages/english/extra_definitions/bootstrap/zca_bootstrap_common.php
  3. /includes/modules/pages/page_not_found/header_php_page_not_found_zca_bootstrap.php
  4. /includes/templates/bootstrap/common/tpl_tabular_display.php
  5. /includes/templates/bootstrap/jscript/jscript_addr_pulldowns_zca_bootstrap.php
  6. /includes/templates/bootstrap/jscript/jscript_zca_bootstrap.js
  7. /includes/templates/bootstrap/templates/tpl_ask_a_question_default.php
  8. /includes/templates/bootstrap/templates/tpl_modules_common_address_format.php

Files Moved

  1. /includes/modules/centerboxes/*.* moved to /includes/modules/bootstrap/centerboxes/*.*

Initial Installation

This template currently has one core-file overwrite; you should always backup your cart's database and files prior to making any changes.

  1. Unzip the template's package file, which you've most likely already done if you're reading this!
  2. If you haven't made any changes to the Zen Cart 'base' version of /includes/modules/order_total/ot_coupon.php, you can simply copy that file from the template's distribution. Otherwise, you'll need to merge the one marked section with your store's version of the file.
  3. Rename the distribution's YOUR_ADMIN sub-directory to match the name of your site's Zen Cart admin directory.
  4. Copy the files present in the includes and the renamed YOUR_ADMIN sub-directories to your site's file-system.
  5. Log into your Zen Cart admin to allow the template's initialization to be run. If you want to enable the template:

As a suggestion, keep the as-distributed bootstrap template's files unmodified so that you can easily revert to see if your custom changes have affected the template's output. Once you have installed the template and customized its sidebox use, you can clone the template for use on your site.

Version History

This section identifies the template's version history and changes, starting with its v2.0.0c release. Prior version changes can be found in the root of the template's distribution zip-file (CHANGELOG.txt).