MarketSquare:Upgrade to version 2.1.0 for Drupal 7
From MtTWiki
This document will guide you to upgrade your Drupal 7 MarketSquare 2.0.1 installation to MarketSquare 2.1.0 for Drupal 7.
The steps that are tagged [Commerce] are relevant only to the MarketSquare Commerce 7.x distribution and should be skipped if you are running the simple MarketSquare 7.x distribution. The MarketSquare Commerce 7.x distribution is only available in the MarketSquare Pro & MarketSquare Enterprise products. You can find out more about the MarketSquare Commerce distribution at the MarketSquare product page http://www.morethanthemes.com/?q=themes/marketsquare
Contents |
Prepare your workbench
- Be sure that you are currently running MarketSquare 2.0.1 for Drupal 7.
- Create a temporary installation of Drupal 7 MarketSquare 2.1.0 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 extra modules
MarketSquare 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 bellow:
- Update Chaos tool suite (ctools) module to 7.x-1.4
- Update jQuery Update module to latest release 7.x-2.4
- Update Libraries module to latest release 7.x-2.2
- Update Oauth module to latest release 7.x-3.2
- Update Views module to latest release 7.x-3.8
- Update Webform module to latest release 7.x-3.20
- Locate the extra modules folder of your site, usually at [sites/all/modules].
- Delete the folders ctools, jquery_update, libraries, oauth, views and webform that belong to the MarketSquare distribution.
- Copy the latest versions of the deleted modules 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
In MarketSquare 2.1.0 we have changed the location of the commerce specific modules from [profiles/marketsquare_commerce/modules] to [sites/all/modules/contrib]. This change does not affect the commerce functionality however it simplifies future updates. The steps below will also achieve this folder change.
MarketSquare comes with several extra modules required to achieve the commerce functionality. The following process will update them to the latest (by the time these lines are written) version, as marked bellow:
- [Commerce] Update Address Field module to latest release 7.x-1.0-beta5
- [Commerce] Update Drupal Commerce module to latest release 7.x-1.9
- [Commerce] Update Commerce Shipping module to latest release 7.x-2.1
- [Commerce] Update Entity API module to latest release 7.x-1.5
- [Commerce] Update Rules module to latest release 7.x-2.7
- [Commerce] Update Commerce PayPal module to latest release 7.x-2.3
- [Commerce] Copy the [sites/all/modules/contrib] folder from your temporary installation inside the [sites/all/modules] folder of your site.
- [Commerce] Locate the commerce profile modules folder of your site [profiles/marketsquare_commerce/modules] and delete it. If there are any extra modules installed in this folder that have been added by you manually, you should move those to the [sites/all/modules/contrib] folder as well.
- [Commerce] Download and install the "Registry rebuild" module (https://www.drupal.org/project/registry_rebuild) into the [sites/all/modules] folder of your site. You do not need to enable it.
- [Commerce] Run the registry_rebuild.php file by calling a url like http://example.com/sites/all/modules/registry_rebuild/registry_rebuild.php or http://example.com/test_site/sites/all/modules/registry_rebuild/registry_rebuild.php, if your site is located under a subdirectory.
- [Commerce] 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 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.
Patch your MarketSquare theme files
- Locate our theme folder in your temporary installation. Usually at [sites/all/themes/marketsquare]
- Locate our theme folder in your drupal 7 site. Usually at [sites/all/themes/marketsquare]
- Replace the following files or folders (regarding the folders you should first delete them and finally copy them from your temp installation) in your installation, using the corresponding source files from the temporary installation
- marketsquare.info
- template.php
- js
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