0
Welcome Guest! Login
0 items Join Now

Upgrade Instructions

    • Andy Miller's Avatar
    • Andy Miller
    • Preeminent Rocketeer
    • Posts: 9919
    • Thanks: 96
    • Web Kahuna

    Upgrade Instructions

    Posted 14 years 2 weeks ago
    • Upgrading from 2.5.x or newer to latest versions of the Gantry Framework

      Once you are on the 2.5 series or newer of the Gantry Framework, upgrading is just a matter of installing the latest Stand-alone Gantry Framework installer file via the Joomla Installer. The files will automatically be updated, and your Gantry-enabled templates will automatically start using the newer framework. You can grab the latest version of the Framework from here:

      code.google.com/p/gantry-framework/downloads/list
      the correct file is gantry_joomla_framework-x.x.x.zip

      Certain Framework upgrades, may have new functionality and features that will require an update to the templateDetails.xml to take advantage. These features should be totally optional, but if you would like to take advantage, you will have to download the latest "upgrade" package for the template in question. You will be able to find these packages in the download area for that template. Follow the instructions (#3) above on how to download, and extract those "upgrade" packages.

      Upgrading from PRE 2.5.x of the Gantry Framework

      Reaction, Dominion, Kinetic and Quasar were 4 Joomla templates that were initially released with the Gantry framework located in the lib/ folder of the template itself. With the Gantry Framework version 2.5 we've moved the framework itself into a seperate location. In Joomla 1.5 this is now located in the components/com_gantry/ folder structure. To upgrade your pre Gantry 2.5 template to the newer version of the library you have to do two things:

      1) Download the Gantry Framework

      Download the Gantry Library installer file from the Gantry Framework website.

      http://www.gantry-framework.org

      Upgrading from 2.5.X to a newer version of Gantry

      2) Install the Gantry Framework

      Navigate to the Extensions Installer in the Joomla Administrator, and upload the Gantry Library file you just downloaded. Once installed, you will be able to upgrade this Framework only at any time without having to update the template itself.

      Let's use the example of the Kinetic template for demonstration purposes.

      3) Install the Upgrade Package for your template

      Because the pre-2.5 versions of Gantry had the entire Gantry lib located in the template directory, you should remove everything that currently sits in the templates/rt_kinetic_j15/lib/ folder as this is no longer needed. Also there are a few minor changes required to be made in the templateDetails.xml to reference the new location as well as adding some options for the new features of Gantry 2.5.

      The download package named Kinetic Gantry Upgrade contains the updated templateDetails.xml as well as the new bootstrap file in the lib/ folder that will load the Gantry framework from the new location. You should download this file and extract it into your templates/rt_kinetic_j15/ folder.

      4) Confirm Successful Installation

      If all went correctly, you should be able to view your template and view the template parameter settings in the Administrator as you always have. If you get an error about not being able to find the Gantry Framework ensure the following:

      1) You have the Gantry Framework installed in the components/com_gantry/ folder of your Joomla installation.
      2) You have the update templateDetails.xml in your templates/rt_kinetic_j15/ folder. You can confirm this by ensuring you have the following line in your templateDetails.xml file:
       
      <params addpath="/components/com_gantry/admin/elements">
       

      3) You have the new updated Gantry bootstrap file located in the templates/rt_kinetic_j15/lib/gantry/ folder called gantry.php. Inside this file you should see the following:
       
      <?php
      /**
       * @package   gantry
       * @subpackage bootstrap
       
       
       
       
       
       
       
       
       

Time to create page: 0.046 seconds