{"id":108,"date":"2012-01-18T19:33:26","date_gmt":"2012-01-18T19:33:26","guid":{"rendered":"https:\/\/www.inmotionhosting.com\/support\/2012\/01\/18\/how-to-upgrade-zencart\/"},"modified":"2021-11-19T02:07:32","modified_gmt":"2021-11-19T07:07:32","slug":"how-to-upgrade-zencart","status":"publish","type":"post","link":"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/","title":{"rendered":"How to upgrade Zen Cart"},"content":{"rendered":"

Zen Cart provides details on how to upgrade Zen Cart to a newer version on the following page:
\nHow do I Upgrade My Zen Cart site?<\/a><\/p>\n

After reading this documentation ourselves, we found it not to be a very user friendly process. In this article, we’ve duplicated the directions that Zen Cart provided (in the link above), and we’ve linked many steps to further documentation to help assist you in those individual steps. If you need further assistance with upgrading<\/strong>, it is recommend to post a question in the Zen Cart support forums<\/a>.<\/p>\n

The following content has been taken from tutorials.zen-cart.com<\/a>:<\/strong><\/p>\n

\n

NOTE: For each new release, there are important documents in the \/docs folder of the Zen Cart<\/span> ZIP file.  Please check the \/docs\/2.readme_how_to_upgrade.html file for any special notes about the version you are upgrading from\/to.<\/p>\n

Getting Started …<\/h2>\n

This is a basic guide to upgrading Zen Cart<\/span>\u00ae. If you have not yet installed Zen Cart<\/span><\/a>\u00ae, please see the \/docs\/1.readme_installation.html <\/a>file for installation instructions.<\/p>\n

To upgrade Zen Cart<\/span>\u00ae, you’ll need the same basic tools you used to install and customize it in the first place: An FTP<\/span> program<\/a>, a text editor friendly to HTML<\/span>\/PHP<\/span> code<\/a>, phpMyAdmin<\/span><\/a> or equivalent access to your MySQL<\/span> database, and your Control Panel for managing your webspace<\/a>.<\/p>\n

Additionally, you will find a file-comparison tool (see here for a list of recommended tools: https:\/\/www.zen-cart.com\/wiki\/index.php\/Useful_Tools<\/a> ) is invaluable. (The free tools offer 2-way comparison. The more advanced paid-for tools offer 3-way comparisons which can be very handy, but costly.)<\/p>\n

Upgrading follows 3 easy steps. We suggest you take your time going through each stage carefully and methodically. Don’t rush the process. And as always, be sure you keep good backups first.<\/p>\n

We highly recommend you pay special attention to getting familiar with the demo data in the new version, so that you can become comfortable with the many new features contained in the new release.<\/p>\n

\n

1. Preparation<\/h2>\n

Unzip<\/a> a copy of the new version of Zen Cart<\/span>\u00ae, upload it to your webserver<\/a> into a “demo<\/span>” folder, and install the new version into a separate database<\/a>, and include the Demo products. This is just for a place for you to play with the new version and get used to its new features. These can be deleted after conversion is complete.<\/p>\n

Study the new features, and the documented changes to the template structures, as well as the “changelog”. Use the demo products in the demo shop as examples. See also the supporting documentation provided with the new release.<\/p>\n

Make a full backup of your database (dump to SQL file)<\/a>. Store this file on your PC for later reference.<\/p>\n

Make a full backup of your site files (ftp to your PC and zip it up for safe-keeping)<\/a>.
\nKeep the backup on your PC to use in next steps. Perhaps call this folder “zen_backup<\/span>“.<\/p>\n

Now let’s find out the differences\/customizations details between your site and the original Zen Cart<\/span>\u00ae files.  (You can find older versions here: https:\/\/sourceforge.net\/projects\/zencart\/files\/<\/a> )<\/p>\n

Unzip<\/a> a copy of the original Zen Cart<\/span>\u00ae files for the version you originally installed<\/em> or last upgraded from<\/a> (ie: perhaps v1.1.3 or even 1.2.0). This should be placed in a separate working folder on your PC (perhaps “zen_orig<\/span>“).<\/p>\n

Make a list of any add-ons you have installed, for later reference.<\/p>\n

Run a tool like WinMerge<\/span><\/a> to compare the “Original” Zen Cart<\/span>\u00ae files in “zen_orig<\/span>” against your working backup files in “zen_backup<\/span>“.
\nNote all the files that are “different”. In WinMerge<\/span>, double-click on each file and note what the differences are.
\nIf the differences are just language defines for display text, those will be simple to carry forward.
\nIf the differences are actual programming\/code differences, you will need to make detailed notes in order to carry over those changes to the new new new version.
\nAny mods\/add-ons you’ve installed will likely contain many programming changes, and may not be fully compatible with the newer Zen Cart<\/span>\u00ae release.<\/p>\n

Your list of add-on’s may help you narrow down the source of any differences you’re finding between versions. You may have to download the add-on again to take a look at the readme or code contained in it. You may have to contact the author to ask for an updated version.<\/p>\n

As you make your list of changed files, etc, at this stage, you may want to move things into the Zen Cart<\/span>\u00ae template-override<\/span> structure, if you haven’t already done so. See the Template System Documentation<\/a> for help on the template system.<\/p>\n<\/div>\n

\n

2. Execution<\/h2>\n

Download and unzip the latest Zen Cart<\/span>\u00ae version<\/a> to your PC. This will be in a 3rd directory (perhaps “zen_new<\/span>“), separate from the other two folders compared above.<\/p>\n

Using the list of files you made earlier, go through each “changed” file, and make your changes from the old version into the new version.
\nSimple language edits will be just a matter of copy-and-paste.
\nProgramming changes to core components will be more difficult and require significant testing.
\nYou may find WinMerge<\/span> handy at this stage to apply edits as well. However, you will see many extra differences that may not be related to your own customizations, or that may conflict. Be careful making changes to program code.<\/p>\n

Note that there will be several changes you will have to make to files that you have overridden using the template overrides system. Thus, you’ll want to compare files from \/includes\/templates\/MYTEMPLATE\/*<\/span> to \/includes\/template\/template_default\/*<\/span> … and the same with language file overrides, sideboxes, etc.<\/p>\n<\/div>\n

\n

3. Testing<\/strong><\/h2>\n

Make a NEW database<\/a> to install the new version of Zen Cart<\/span>\u00ae into.<\/p>\n

If the last backup you made of your data is older than the last order that might have been processed or customer registration, make a fresh database backup<\/a>.
\nRestore your database<\/a> from the backup in step #1 earlier into your NEW database just created.<\/p>\n

If your \/zen_new<\/span> folder doesn’t have “\/includes\/configure.php<\/span>” and “\/admin\/includes\/configure.php<\/span>” files, copy them from your old store folder.<\/p>\n

EDIT your “\/zen_new\/includes\/configure.php<\/span>” file and ensure that the DIR_FS_CATALOG and DIR_WS_CATALOG and DIR_FS_SQL_CACHE (and other path settings too) correctly match your NEW directory structure on the server.<\/p>\n

EDIT your “\/zen_new\/includes\/configure.php<\/span>” file and ensure that your DATABASE_NAME matches your NEW database. Also verify database username and password in case that information has changed. Save this file, and be sure to upload it as part of the next step:<\/p>\n

Upload the files from your modified “new version” (created in step 2) to your server, into an alternate folder, perhaps called “\/store_new<\/span>“.<\/p>\n

Run \/zc_install\/index.php<\/span> and choose “Upgrade<\/em>” when prompted. (Don’t select “Install”, or you will overwrite your database.) (If “Upgrade” is not offered, then the installer was unable to connect to your database to confirm what version its structure is at. Check your configure.php settings.)<\/p>\n

Test your customizations. Edit as needed. Compare with the test\/demo install performed earlier, as needed.<\/p>\n

When satisfied that all is OK, go live.
\nIf significant time has passed since you did your last backup, you may want to repeat the steps in this “Testing” section again, using a fresh backup from your live shop. You don’t need to re-upload files again … simply do the database restore<\/a>, and run the installer to do the database upgrade again.<\/p>\n

To go live, put your shop into “Down for Maintenance” mode in the admin area. Be sure to add your IP address<\/span> to the list of allowed addresses to get into the site for previewing.
\nThis can be done easiest by renaming “store_new<\/span>” to “store<\/span>“. (You’ll have to rename “store” to something else first.)
\nTest it to be sure that things are operating as desired. If you have small problems to repair, turn “Down for maintenance” on and off again as necessary.<\/p>\n

NOTES<\/h2>\n

Remember that your “configure.php” files on your server are typically set to read-only, and thus in order to upload them will require that you mark those files read-write<\/a> before uploading.  Be sure to put them back to read-only after uploading.<\/p>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

Zen Cart provides details on how to upgrade Zen Cart to a newer version on the following page: How do I Upgrade My Zen Cart site? After reading this documentation ourselves, we found it not to be a very user friendly process. In this article, we’ve duplicated the directions that Zen Cart provided (in the Read More ><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[4288],"tags":[],"class_list":["post-108","post","type-post","status-publish","format-standard","hentry","category-website"],"acf":[],"yoast_head":"\nHow to upgrade Zen Cart | InMotion Hosting<\/title>\n<meta name=\"description\" content=\"Upgrading Zen Cart is not very user friendly. In this article, we build off of the official Zen Cart Upgrade documentation and provide helpful links to assist you in many of the required steps.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to upgrade Zen Cart | InMotion Hosting\" \/>\n<meta property=\"og:description\" content=\"Upgrading Zen Cart is not very user friendly. In this article, we build off of the official Zen Cart Upgrade documentation and provide helpful links to assist you in many of the required steps.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/\" \/>\n<meta property=\"og:site_name\" content=\"InMotion Hosting Support Center\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/inmotionhosting\/\" \/>\n<meta property=\"article:published_time\" content=\"2012-01-18T19:33:26+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2021-11-19T07:07:32+00:00\" \/>\n<meta name=\"author\" content=\"Brad Markle\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@InMotionHosting\" \/>\n<meta name=\"twitter:site\" content=\"@InMotionHosting\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Brad Markle\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"7 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/\"},\"author\":{\"name\":\"Brad Markle\",\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/#\/schema\/person\/5ae05d1210b0ef63c437ccedce2799bf\"},\"headline\":\"How to upgrade Zen Cart\",\"datePublished\":\"2012-01-18T19:33:26+00:00\",\"dateModified\":\"2021-11-19T07:07:32+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/\"},\"wordCount\":1393,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/#organization\"},\"articleSection\":[\"Website\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/\",\"url\":\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/\",\"name\":\"How to upgrade Zen Cart | InMotion Hosting\",\"isPartOf\":{\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/#website\"},\"datePublished\":\"2012-01-18T19:33:26+00:00\",\"dateModified\":\"2021-11-19T07:07:32+00:00\",\"description\":\"Upgrading Zen Cart is not very user friendly. In this article, we build off of the official Zen Cart Upgrade documentation and provide helpful links to assist you in many of the required steps.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.inmotionhosting.com\/support\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to upgrade Zen Cart\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/#website\",\"url\":\"https:\/\/www.inmotionhosting.com\/support\/\",\"name\":\"InMotion Hosting Support Center\",\"description\":\"Web Hosting Support & Tutorials\",\"publisher\":{\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.inmotionhosting.com\/support\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/#organization\",\"name\":\"InMotion Hosting\",\"url\":\"https:\/\/www.inmotionhosting.com\/support\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.inmotionhosting.com\/support\/wp-content\/uploads\/2023\/02\/inmotion-hosting-logo-yoast.jpg\",\"contentUrl\":\"https:\/\/www.inmotionhosting.com\/support\/wp-content\/uploads\/2023\/02\/inmotion-hosting-logo-yoast.jpg\",\"width\":696,\"height\":696,\"caption\":\"InMotion Hosting\"},\"image\":{\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/inmotionhosting\/\",\"https:\/\/x.com\/InMotionHosting\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.inmotionhosting.com\/support\/#\/schema\/person\/5ae05d1210b0ef63c437ccedce2799bf\",\"name\":\"Brad Markle\",\"url\":\"https:\/\/www.inmotionhosting.com\/support\/author\/bradm\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to upgrade Zen Cart | InMotion Hosting","description":"Upgrading Zen Cart is not very user friendly. In this article, we build off of the official Zen Cart Upgrade documentation and provide helpful links to assist you in many of the required steps.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/","og_locale":"en_US","og_type":"article","og_title":"How to upgrade Zen Cart | InMotion Hosting","og_description":"Upgrading Zen Cart is not very user friendly. In this article, we build off of the official Zen Cart Upgrade documentation and provide helpful links to assist you in many of the required steps.","og_url":"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/","og_site_name":"InMotion Hosting Support Center","article_publisher":"https:\/\/www.facebook.com\/inmotionhosting\/","article_published_time":"2012-01-18T19:33:26+00:00","article_modified_time":"2021-11-19T07:07:32+00:00","author":"Brad Markle","twitter_card":"summary_large_image","twitter_creator":"@InMotionHosting","twitter_site":"@InMotionHosting","twitter_misc":{"Written by":"Brad Markle","Est. reading time":"7 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/#article","isPartOf":{"@id":"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/"},"author":{"name":"Brad Markle","@id":"https:\/\/www.inmotionhosting.com\/support\/#\/schema\/person\/5ae05d1210b0ef63c437ccedce2799bf"},"headline":"How to upgrade Zen Cart","datePublished":"2012-01-18T19:33:26+00:00","dateModified":"2021-11-19T07:07:32+00:00","mainEntityOfPage":{"@id":"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/"},"wordCount":1393,"commentCount":0,"publisher":{"@id":"https:\/\/www.inmotionhosting.com\/support\/#organization"},"articleSection":["Website"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/","url":"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/","name":"How to upgrade Zen Cart | InMotion Hosting","isPartOf":{"@id":"https:\/\/www.inmotionhosting.com\/support\/#website"},"datePublished":"2012-01-18T19:33:26+00:00","dateModified":"2021-11-19T07:07:32+00:00","description":"Upgrading Zen Cart is not very user friendly. In this article, we build off of the official Zen Cart Upgrade documentation and provide helpful links to assist you in many of the required steps.","breadcrumb":{"@id":"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.inmotionhosting.com\/support\/website\/how-to-upgrade-zencart\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.inmotionhosting.com\/support\/"},{"@type":"ListItem","position":2,"name":"How to upgrade Zen Cart"}]},{"@type":"WebSite","@id":"https:\/\/www.inmotionhosting.com\/support\/#website","url":"https:\/\/www.inmotionhosting.com\/support\/","name":"InMotion Hosting Support Center","description":"Web Hosting Support & Tutorials","publisher":{"@id":"https:\/\/www.inmotionhosting.com\/support\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.inmotionhosting.com\/support\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.inmotionhosting.com\/support\/#organization","name":"InMotion Hosting","url":"https:\/\/www.inmotionhosting.com\/support\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.inmotionhosting.com\/support\/#\/schema\/logo\/image\/","url":"https:\/\/www.inmotionhosting.com\/support\/wp-content\/uploads\/2023\/02\/inmotion-hosting-logo-yoast.jpg","contentUrl":"https:\/\/www.inmotionhosting.com\/support\/wp-content\/uploads\/2023\/02\/inmotion-hosting-logo-yoast.jpg","width":696,"height":696,"caption":"InMotion Hosting"},"image":{"@id":"https:\/\/www.inmotionhosting.com\/support\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/inmotionhosting\/","https:\/\/x.com\/InMotionHosting"]},{"@type":"Person","@id":"https:\/\/www.inmotionhosting.com\/support\/#\/schema\/person\/5ae05d1210b0ef63c437ccedce2799bf","name":"Brad Markle","url":"https:\/\/www.inmotionhosting.com\/support\/author\/bradm\/"}]}},"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"primary_category":null,"_links":{"self":[{"href":"https:\/\/www.inmotionhosting.com\/support\/wp-json\/wp\/v2\/posts\/108","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.inmotionhosting.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.inmotionhosting.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.inmotionhosting.com\/support\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.inmotionhosting.com\/support\/wp-json\/wp\/v2\/comments?post=108"}],"version-history":[{"count":4,"href":"https:\/\/www.inmotionhosting.com\/support\/wp-json\/wp\/v2\/posts\/108\/revisions"}],"predecessor-version":[{"id":92289,"href":"https:\/\/www.inmotionhosting.com\/support\/wp-json\/wp\/v2\/posts\/108\/revisions\/92289"}],"wp:attachment":[{"href":"https:\/\/www.inmotionhosting.com\/support\/wp-json\/wp\/v2\/media?parent=108"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.inmotionhosting.com\/support\/wp-json\/wp\/v2\/categories?post=108"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.inmotionhosting.com\/support\/wp-json\/wp\/v2\/tags?post=108"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}