1
Template Installation Troubleshooting Manual
There are many errors that can occur during template installation for your Joomla! site. The aim of this documentis to identify common issues discovered in Joomla! 1.5 installation problems, and provide solutions. Sometimesthe solution is easy, sometimes its not.
1.
Error:
“Direct Access to this location is not allowed.”
Or:
“Warning! - Failed to move file”
Cause
:
The cause of this could be attributed to multiple sources. One possibility is that Joomla! does not have writableaccess to key directories. Another possibility is that the Joomla! has been been installed with incorrect ownershiprights.
Solutions:
1.1:
The first thing you should do is login to your File Transfer Protocol Client (FTP), and check the followingdirectories are set to
writable (777)
.
/joomlaroot/templatesand:/joomlaroot/tmpAnother way to fix this problem is to provide your FTP login details to Joomla!'s global configuration. If Joomla!has the correct file ownership permissions (see below) the directory write errors can be fixed automatically.
1.2:
If you are still having problems then the problem is probably an ownership issue. You will need to go to theapache user groups and
chown
Joomla!'s user group to have ownership of the website directories. You can dothis by running this command in apache:
sudo chown -R www-data:www-data joomlaid - *Where 'joomlaid' is the Joomla! root directory*
2.
Error:
“Your Extension appears to be written for an older version of Joomla!. You must enable the System - Legacy Plugin in the Plugin Manager if you wish to complete this task.”
Cause:
As the error says, the extension, (in your case, the template) was written for an older version of Joomla!specifically, Joomla! 1.0.X.
Note:
If after checking all these solutions,you cannot find a solution, check outJoomla.org. If you purchased a commercialtemplate, contact the developer(s).
Note:
Before you get into this trouble-shooting manual and start trying to figure outwhy your template will not work, be sure thatthe template is indeed a
Joomla! template.
Joomla! templates are specific to Joomla!
Note:
If you are unfamiliar withApache ownership settings I
strongly
advise you contact your hosting company and ask them tomake these changes for you.
2
Solutions:
2.1:
If you want to use this template, you can enable the
Legacy Plugin.
This is done by going to:
Extensions -->Plugin Manager
, -->
System – Legacy.
(you may have to check the second page of the
Plugin Manager to find this plugin)
Enable the
System – Legacy
plugin by clicking enable/disable toggle button.
2.2:
If you are determined to have a Joomla! 1.5 site that does not require
Legacy Mode
you will need to updatethe template's XML file, as well as the template's
index.php
file. This is easiest done by comparing a Joomla! 1.5XML/Index file to a Joomla! 1.0.X file, and making them match, save for code that is template specific.
3.
Error:
“Template Install: Another template is already using directory: 'joomlaroot/templates/template_name'”
Cause:
As the error message might suggest, another template by the same name is already installed. There is also thepossibility that at one time this template had been installed, but not properly uninstalled. Either way, to get thetemplate you have to work you will have to make sure to totally eradicate the previous template.
Solutions:
3.1:
Uninstall the previous template. You can do this by going to:
Extensions-->Install/Uninstall.
Displayed is the
Extension Manager.
On the list of the different extension types, select
Templates.
A list will appear showing allthe templates you have installed. This list should show the name of the template that you need to delete. Clickthe radio button next to it's name, and then click uninstall. The template should be successfully deleted.
3.2:
In the event that the template will not uninstall properly, you can log into your site via FTP, and delete itmanually. Log into your site via FTP, and go to this directory:
joomlaroot/templates/
Listed here are all the templates you have installed, each with its own directory. The template with the conflictingname should also be listed, click on it, and then delete it.
joomlaroot/templates/template_name
4.
Error:
“Error! Could not find an XML setup file in the package.”
Cause:
There are many possible causes for this problem. It could be that the XML is corrupt, it doesn't exist, or that itsnamed incorrectly.
Solutions:
4.1:
On your computer, unzip the template file and ensure that the real template file is not zipped inside of a zipfile. Its possible the developer created a installation zip, and then put that file inside of another file that containedinstallation documentation, source files etc..
4.2:
The next thing you should do is check to make sure that the XML exists. All templates come as archives,usually .zip files. Unzip the file locally on your desktop and verify it has the XML file:..
/template_name/templateDetails.xml
Note:
the spelling of the filetemplateDetails.xml is
not
an accident.Joomla! expects to see the XML filenamed templateDetails.xml!
3
4.3:
Another cause for this problem is file permissions. Refer to 1.1 for information on how to cure this problem.
Tips & Tricks: Customization:
5. Changing the Favicon Of Your Site:
The favicon appears usually in the favorites menu (bookmarks in some browsers) of a browser. Your favoriteicon (commonly referred to as the favicon) is an image file that is 16x16 pixels, and is normally namedfavicon.ico.Using an image editor, such as Adobe Photoshop, GIMP, or Macromedia Fireworks. Whatever is your preference, get an image that is 16x16 pixels, and save it as an ico file format. The file name should be
favicon.ico
. (There is an extension for Adobe Photoshop to save out files as .ico)Once you have saved out the file, you need to upload it to the template directory of the template that you areusing. If you are using multiple templates you'll need to upload it to different directories. If I were replacing thefavicon in the Joomla! 1.5 default template
Rhuk_Milkyway
, I would upload the favicon to:
joomlaroot/templates/rhuk_milkyway/favicon.ico
Since your browser has already downloaded (cached) your old favicon, you probably won't see the changed icontill you clear your cache and refresh (you may have to refresh multiple times before you see the changed icon).
6. Why Isn't My CSS Being Used?
Each Joomla! template has its own cascading style sheet (CSS). One reason that your CSS document might notbe being used is because you aren't calling for it in your index.php file.
<link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/system/css/system.css" type="text/css" /><link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/system/css/general.css" type="text/css" /><link rel="stylesheet" href="<?php echo $this->baseurl ?>/templates/system/css/system.css" type="text/css" />
Solutions:
6.1:
If those lines do not exist, you should add them to the
index.php
file. They need to be put in before theending head tag:
</head>
.
6.2:
It is possible that your template.css file was not uploaded, or the file is corrupt. Using your FTP (FileTransfer Protocol) software, go to:
joomlaroot/templates/template_name/css/
In the CSS directory upload your template.css file. If the file already exists, you should overwrite to ensure thatthe correct file is there and is not corrupted.
Note:
This document assumesthat you already have created a16x16 image and saved it as a icofile type.
Note:
Because the template has itsown favicon already, you will probablybe asked if you want to overwrite theprevious file. Obviously you do.
Note:
In Joomla! 1.0.X, the default name of CSSfiles was template_css.css. However, In Joomla!1.5, that name is now simply template.css
Search History:
Result 00 of 00
00 results for result for
p.
Joomla! v 1 5 Template Installation Troubleshooting Manual
by Chad Windnagle (drmmr763)
Google Highly Open Participation Contest
Joomla!
Google Highly Open Participation Contest
Joomla!
203.6K
Reads
119
Readcasts
16.6K
Embed Views
Recommended
More From This User
Notes
Load more
