RetailPlus:Upgrade to version 2.1.1 for Drupal 7
From MtTWiki
This document will guide you to upgrade your Drupal 7 Retail+ 2.0.1 installation to Retail+ 2.1.1 for Drupal 7.
The steps that are tagged [Commerce] are relevant only to the Retail+ Commerce 7.x distribution and should be skipped if you are running the simple Retail+ 7.x distribution. The Retail+ Commerce 7.x distribution is only available in the Retail+ Pro & Retail+ Enterprise products. You can find out more about the Retail+ Commerce distribution at the Retail+ product page http://www.morethanthemes.com/?q=themes/retailplus
Contents |
Prepare your workbench
- Create a temporary installation of Drupal 7 Retail+ 2.1.1 using our installation profile. You will use this as a reference to guide you.
Backup
- Backup everything.
- Just in case, make sure you backed up everything =) (besides, it's always a good idea).
Put your website in maintenance mode
- Login to your Drupal installation as administration user
- Navigate to admin/config/development/maintenance
- Enable the "Put site into maintenance mode" option
- Save your configuration
Update Drupal core
Take a breath and read Drupal's Upgrading from previous versions first. This upgrade will update your Drupal core to the version 7.31. We assume that you are currently using a 7.x version so it's about a "Minor update procedure".
- Locate the root folder of your site. This is Drupal's root folder, where the index.php file is located.
- Delete all Drupal files and folders except the [sites] folder.
- Copy all Drupal files and folders from your temporary installation except the [sites] folder.
- Run the update.php file calling a url like http://www.example.com/update.php or http://www.example.com/test_site/update.php, if your site is located under a subdirectory.
Update extra modules
Retail+ comes with several extra modules required to achieve its functionality. The following process will update them to the latest (by the time these lines are written) version, as marked below:
- Update Flag module to latest release 7.x-3.6
- Update better_exposed_filters to latest release 7.x-3.2
- Update context to latest release 7.x-3.6
- Update addressfield to latest release 7.x-1.1
- Update ctools to latest release 7.x-1.7
- Update jquery_update to latest release 7.x-2.6
- Update sharethis to latest release 7.x-2.12
- Update views to latest release 3.11
- Update webform to latest release 7.x-4.10
- Locate the extra modules folder of your site, usually at [sites/all/modules].
- Delete the folders flag, better_exposed_filters, context, addressfield, ctools, jquery_update, sharethis, views, webform that belong to the Retail+ distribution. If there are any extra module folders that have been installed by you later, you should leave them untouched or update them later manually, which is beyond the scope of this guide
- Copy the latest version of the deleted module from your temporary installation.
- Run the update.php file calling a url like http://www.example.com/update.php or http://www.example.com/test_site/update.php, if your site is located under a subdirectory.
[Commerce] Update Commerce modules
Retail+ comes with several extra Commerce modules required to achieve its functionality. The following process will update them to the latest (by the time these lines are written) version, as marked bellow:
- [Commerce] Update commerce to latest release 7.x-1.11
- [Commerce] Update commerce_shipping to latest release 7.x-2.2
- [Commerce] Update entity to latest release 7.x-1.6
- [Commerce] Update inline_entity_form to latest release 7.x-1.6
- [Commerce] Update rules to latest release 7.x-2.9
- Locate the extra modules folder of your site, usually at [sites/all/modules/contrib].
- Delete the folders commerce, commerce_shipping, entity, inline_entity_form, rules that belong to the Retail+ distribution. If there are any extra module folders that have been installed by you later, you should leave them untouched or update them later manually, which is beyond the scope of this guide.
- Copy the latest version of the deleted module from your temporary installation.
- Run the update.php file calling a url like http://www.example.com/update.php or http://www.example.com/test_site/update.php, if your site is located under a subdirectory.
Patch your Retail+ theme files
- Locate our theme folder in your temporary installation. Usually at [sites/all/themes/retailplus]
- Locate our theme folder in your drupal 7 site. Usually at [sites/all/themes/retailplus]
- Replace the following files or folders in your installation, using the corresponding source files from the temporary installation (folders should be first deleted and finally copied from your temp installation).
- style.css
- template.php
- bootstrap
- js/rs-plugin
Clear all cached data
This step is important in order to force your template to be informed for the changes you have made in the template files.
To do this navigate to admin/config/development/performance and click the "Clear all caches" button
Disable maintenance mode
- Navigate to admin/config/development/maintenance
- Disable the "Put site into maintenance mode" option.
- Save your configuration