Photofolio:Upgrade to version 3.2.0 for Drupal 7

From MtTWiki

This document will guide you to upgrade your Drupal 7 Photofolio 3.1.0 installation to Photofolio 3.2.0 for Drupal 7.

Prepare your workbench

1. Be sure that you are currently running Photofolio 3.1.0 for Drupal 7.
2. Create a temporary installation of Drupal 7 Photofolio 3.2.0 using our installation profile. You will use this as a reference to guide you.

Backup

1. Backup everything.
2. Just in case, make sure you backed up everything =) (besides, it's always a good idea).

Put your website in maintenance mode

1. Login to your Drupal installation as administration user
2. Navigate to admin/config/development/maintenance
3. Enable the "Put site into maintenance mode" option
4. 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".

1. Locate the root folder of your site. This is Drupal's root folder, where the index.php file is located.
2. Delete all Drupal files and folders except the [sites] folder.
3. Copy all Drupal files and folders from your temporary installation except the [sites] folder.
4. 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

Photofolio 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 API module to latest release 7.x-2.2
• Update Views module to latest release 7.x-3.8
• Update Superfish module to latest release 7.x-1.9

1. Locate the extra modules folder of your site, usually at [sites/all/modules].
2. Delete the folders ctools, jquery_update, libraries, views and superfish that belong to the Photofolio distribution.
3. Copy the latest versions of the deleted modules from your temporary installation.
4. 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 Superfish library

• Locate the libraries folder of your site, usually at [sites/all/libraries].
• Delete the folder superfish.
• Copy the latest version of the deleted library from your temporary installation.

Uninstall extra modules

Photofolio comes with several extra modules required to achieve its functionality. The following process will uninstall one of them: Uninstall MtT Twitter module (MtT Twitter module and Twitter API 1.1 - http://mtt.desk.com/customer/portal/articles/1183966)

1. Disable the MtT Twitter module through Home » Administration » Modules and Save this configuration.
2. Uninstall the MtT Twitter module through Home » Administration » Modules » UNINSTALL tab.
3. Locate the extra modules folder of your site, usually at [sites/all/modules].
4. Delete the folder mtt_twitter that belongs to the Photofolio distribution.

Install extra modules(optional)

The following process will install some extra modules to your installation regarding the Twitter integration:

• Install OAuth module (https://drupal.org/project/oauth)
• Install Twitter module (https://drupal.org/project/twitter)

1. Locate the modules folder in your temporary installation at [sites/all/modules]
2. Locate the modules folder in your drupal 7 site. Usually at [sites/all/modules]
3. Copy the folders oauth and twitter using the corresponding folders from the temporary installation
4. Install OAuth and Twitter modules through through Home » Administration » Modules and Save this configuration (there is no need to install the modules OAuth Provider UI, Twitter actions, Twitter Post and Twitter Signin)
5. Import our Twitter Updates view through Home » Administration » Structure » Views » + Import (Twitter Updates view Import code)
   • You have always the option to disable the default Tweets view
6. Configure the Twitter module by creating a Twitter application https://drupal.org/node/1346824
7. Run cron through Home » Administration » Configuration » System » Cron to fetch the latest tweets of the account.

Patch your Photofolio theme files

1. Locate our theme folder in your temporary installation. Usually at [sites/all/themes/photofolio]
2. Locate our theme folder in your drupal 7 site. Usually at [sites/all/themes/photofolio]
3. Replace the following files or folders in your installation, using the corresponding source files from the temporary installation. (Regarding the folders you should first delete them and finally copy them from your temp installation)

• photofolio3.info
• template.php
• node--article.tpl.php
• node--blog.tpl.php
• field--field_image.tpl.php
• field--field_image--mt_gallery.tpl.php
• camera.css
• style.css
• style-bluered.css
• style-brightgray.css
• style-darkgray.css
• style-orangegray.css
• style-pinkgray.css
• js
• img

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

1. Navigate to admin/config/development/maintenance
2. Disable the "Put site into maintenance mode" option.
3. Save your configuration