Renaming a Helix Ultimate template requires careful adjustments in various files and databases due to how Joomla handles templates as extensions. The process outlined here applies to renaming any Helix Ultimate-based template.
Note: This guide only covers renaming templates for Joomla 4 and Joomla 5, not the Helix Ultimate framework plugin, which shouldn't be renamed.
Rename Before Installation
This method is simple and suitable for most beginners. Follow these steps:
- Download the Helix Ultimate template package from JoomShaper's download section.
- Rename the template package ZIP file to your desired name (e.g., "newname_template.zip").
- Extract the package, go to templates, and open the
templateDetails.xmlfile using a text editor like Notepad++ (or similar). - Locate the line
<name>shaper_helixultimate</name>and change it to<name>newname</name>. - Rename the language filename from
en-GB.tpl_shaper_helixultimate.initotpl_newname.ini. - Inside the
templateDetails.xmlfile, update the line<language tag="en-GB">en-GB.tpl_shaper_helixultimate.ini</language>to<language tag="en-GB">tpl_newname.ini</language>.
In Joomla 4 and Joomla 5, the language tag in the template and extensions' filename is no longer needed, as it was required in Joomla 3.x versions. But yes, you can still use them in J4 and J5. - Save the changes to the XML file.
- Made other changes in template files (if you need to).
- Compress the modified template package into a ZIP file.
- Install the template you have modified (or only renamed) as a new template, and then set it as the default template.
Manually adjust settings if needed, especially if using a QuickStart package. If using QuickStart, uninstall the old template after transferring settings.
Notice! If you still have Joomla 3.10, keep the language tag for the template language .ini file (en-GB.tpl_newname.ini) also in .xml file!
