TopHit:Upgrade to version 2.4 for Drupal 7

From MtTWiki

Jump to: navigation, search

This document will guide you to upgrade your Drupal 7 TopHit 2.3 installation to TopHit 2.4 for Drupal 7.

The steps that are tagged [Commerce] are relevant only to the TopHit Commerce 7.x distribution and should be skipped if you are running the simple TopHit 7.x distribution. The TopHit Commerce 7.x distribution is only available in the Top Hit Pro & Top Hit Enterprise products. You can find out more about the TopHit Commerce distribution at the TopHit product page


Prepare your workbench

  1. Be sure that you are currently running TopHit 2.3 for Drupal 7. If not, please upgrade your installation to TopHit 2.3 for Drupal 7 first.
  2. Create a temporary installation of Drupal 7 TopHit 2.4 using our installation profile. You will use this as a reference to guide you.


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

Update extra modules

TopHit 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:

  1. Locate the extra modules folder of your site, usually at [sites/all/modules].
  2. Delete the folders views and superfish that belong to the TopHit 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.
  3. Copy the latest versions of the deleted modules from your temporary installation.
  4. Locate the libraries folder of your site, usually at [sites/all/libraries].
  5. Delete the folder superfish that belongs to the TopHit distribution.
  6. Copy the latest version of the deleted library superfish from your temporary installation.
  7. [Commerce] Locate the commerce profile modules folder of your site, usually at [profiles/tophit_commerce/modules].
  8. [Commerce] Delete the folders addressfield, commerce, commerce_stock and entity that belong to the TopHit with Commerce distribution.
  9. [Commerce] Copy the latest versions of the deleted modules addressfield, commerce, commerce_stock and entity from your temporary installation.
  10. Run the update.php file calling a url like or, if your site is located under a subdirectory.

Patch your TopHit theme files

  1. Locate our theme folder in your temporary installation. Usually at [sites/all/themes/tophit]
  2. Locate our theme folder in your drupal 7 site. Usually at [sites/all/themes/tophit]
  3. Replace the following files in your installation, using the corresponding source files from the temporary installation
    1. style.css
    2. style-blue.css
    3. style-gray.css
    4. style-green.css
    5. style-pink.css
    6. template.php
    7. theme-settings.php

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 go to Administer » Site configuration » Performance » Clear cached data

Personal tools
Main Menu
Premium Themes
This wiki is hosted by, creators of top quality premium and free themes for Drupal 6 and 7, as well as HTML and PSD themes.
Find out more
for Drupal 6 & 7