The Blog

Check out our brand new Joomla! Template Club:
InspireTheme.com

How to rename the default Gantry Template

How to rename the default Gantry Template - 4.2 out of 5 based on 5 votes

There are many different reasons why you might want to change the default template name when you work with the Gantry Framework. For example, you might want to develop your own template and give it the name you want or you have purchased a Gantry-based template and you want to change its name. Anyway, the steps below explain the whole procedure. I will explain how to rename the default Gantry Template but you can use the below instructions to rename any Gantry 4 based template.

Let say you have installed the Gantry RocketLauncher. If you login to your Admin Panel and go to the Template Manager you will see that the Style name is "gantry - Default" and the Template name is "Gantry". So, here are all the steps you need to perform in order to rename the template properly:

1. Download the Gantry Template Bundle and UNZIP it.

2. Rename the "gantry" folder to whatever you want. In this example I will use "joomfx".

3. Open the "joomfx" folder and edit the "templateDetails.xml" file. The <name> of the template must be the same as the folder name and the other fields can be whatever you want. Here is an example:

<name>joomfx</name>
<author>JoomFX</author>
<creationDate>April 14, 2014</creationDate>
<copyright>JoomFX - All rights reserved.</copyright>
<license>http://www.gnu.org/copyleft/gpl.html GNU/GPL</license>
<authorEmail>This email address is being protected from spambots. You need JavaScript enabled to view it.</authorEmail>
<authorUrl>http://www.joomfx.com</authorUrl>
<version>1.0</version>
<description>JoomFX - Responsive Joomla Template</description>

4. Go to "joomfx/html/mod_roknavmenu/themes/gantry-dropdown" and edit the "item.xml" file. You need to replace the word "gantry" with "joomfx" on line 5 and line 7.

5. Go to "joomfx/html/mod_roknavmenu/themes/gantry-splitmenu" and edit the "item.xml" file. You need to replace the word "gantry" with "joomfx" on line 5 and line 7.

6. Go to "joomfx/language/en-GB" and rename the "en-GB.tpl_gantry.ini" file to "en-GB.tpl_joomfx.ini".

7. Go out of the "joomfx" folder and edit the "a_installer.xml". Since this is just the Installer I recommend to leave the Information Fields on the top as they are. The only thing you need to edit is the following code starting on line 31:

<cog type="template" client="site" access="1" enabled="true" protected="false" remove_style="true">
gantry
<name>Gantry Template</name>
<description>Parent for all PHP based projects</description>
<style name="Gantry - Default" default="false" master="true" paramsfile="template-options.xml"/>
</cog>

Edit the above code so it looks like this:

<cog type="template" client="site" access="1" enabled="true" protected="false" remove_style="true">
joomfx
<name>JoomFX - Responsive Joomla Template</name>
<description>Your Description goes here.</description>
<style name="JoomFX - Default" default="false" master="true" paramsfile="template-options.xml"/>
</cog>

8. ZIP everything again and install it from the Extension Manager in your Admin Panel.

Now go to the Template Manager and you will see the "joomfx" template. If you go to "root/templates" you will see a new folder called "joomfx".

Basically, that's all. If you need to add something or have any questions please do not hesitate to use the comments below.

Ivo Valkov

I'm a front end developer. I love creating things, playing football, snowboarding and so on. I also hope you like all our stuff. We started using Gantry for our projects and honestly, we love it!

Website: joomfx.com