How To Solve Theme Issues

System Check

If you are having trouble or issues with your theme, this can have numerous causes. First of all take a look at our built-in system check in theme administration. It helps you to detect and determine common issues.

Here are some more common issues that might arise:

Can't save template configuration

This might be due to file permission issues. Please read this tutorial on how to detect and resolve the problem.

You renamed our Joomla theme and can't save template configuration

In Joomla, if you have rename your theme and get a message similar to the following:

The parameter file /templates/YOO_TEMPLATE/params.ini is unwritable!
config Element not defined for type = config

The template directory YOO_TEMPLATE does not match the path set in the templateDetails.xml file, therefore the config element cannot be loaded. Make sure the addpath attribute matches your templates directory:

Joomla 1.5

<params addpath="/templates/YOO_TEMPLATE/warp/systems/joomla.1.5/config/elements">

Joomla 2.5

<fields name="params" addfieldpath="/templates/YOO_TEMPLATE/warp/systems/joomla/config/elements">

Warp theme administration is unstyled

This is caused by Javascript conflicts in the adminstration area. Most likely another jQuery library is loaded by a 3rd party extension or plugin. Please read this tutorial on how to resolve this issue.

Javascript Effects stop working

If you are having trouble with Javascript effects, e.g. the Accordion Menu, this might be due to a jQuery conflict. Please read this tutorial on how to detect and resolve the problem.

The content is unstyled because no CSS is being loaded

This might be due to file permission issues in the theme directory. Please read this tutorial on how to detect and resolve the problem.

Blank Page

This is most likely due to a php error being thrown. Please enable the display_errors parameter in your php.ini. Only with an error message the problem can be found.

Another way to check for PHP errors is to have a look at your PHP error log. The PHP log shows information on errors and warnings thrown by PHP. Your host should have configured PHP to write that information to a log rather than output them on screen.

Please check this guide to PHP error messages for webdesigners for a more thorough view on the subject.

Webfonts are not loading in Internet Explorer

If webfonts are not being rendered in IE7 and IE8, your server might not supporting the required Mime-Types. To solve the issue, you need to open the .htaccess file in your installation root folder and add the following code:

AddType font/ttf .ttf  
AddType font/eot .eot  
AddType font/otf .otf  
AddType font/woff .woff
AddType application/octet-stream .otf .ttf

We also recommend not to use IE9 browser modes for IE7 and IE8 to check your website, you should use a native IE7 / IE8 on a virtual machine like Oracle's VirtualBox.

CSS3Pie is not working

This can be caused by not serving the correct HTC behavior. To solve the issue, you need to open the .htaccess file in your installation root folder and add the following code:

AddType text/x-component .htc

Another issue could be an incorrect permission setup for the cache folder, please read this tutorial for more information.

Why does the Validation Fail

This can be caused by poorly formatted or broken code in your Content or Ouput from a 3rd Party extension or Plugin. You can use a Validation Service to validate your pages. To learn more about Validation failing, please read this tutorial for more information.

Documentation on Github

Help us out! If you are feeling that our documentation has errors or can be improved, fork it at Github and send us a pull request. Any contribution is much appreciated. Thank you!