Find out how to add your own customizations and learn more about file hierarchy in Warp.
To provide as much flexibility as possible, Warp applies a special file cascade. If you include any file like CSS, JS or template PHP files, Warp looks successively in specific folders for the files and the first file found will be loaded. This gives you full flexibility to override any important theme related file.
We will explain the override cascade a bit further. If you just want to know, how to override theme files, jump down to the appropriate examples.
As an example, this is what the override hierarchy for the /layouts folder would look like.
The /styles/STYLE-NAME/layouts folder of your theme is at the top of the hierarchy and modifications or additions you make here will override all other theme files. Also this folder will be preserved during updates, so it's the safest place to make your modifications.
The theme's /layouts folder is the place where all the theme specific layout files are being stored.
The /warp/systems/joomla/layouts folder provides the individual system implementation needed to integrate with a particular CMS. This layer makes Warp adapt to a certain system to form a consistent API for theme development.
The /warp/layouts folder contains basic overrides made by the core framework. Each part of the core framework is universal and designed to work on every supported system.
The cascades for the /js, /css and /layouts folders are defined in the theme's config.php. If you want to register another folder in the cascade, you can do so here.
To customize the general theme layout, you need to override the /layouts/theme.php. To do so, create the /styles/STYLE-NAME/layouts directory, copy the file in there and start adding your own PHP code.
This way you can also override system files. For example, just take the Joomla article layout /warp/systems/joomla/layouts/com_content/article/default.php and copy it to your style folder /styles/STYLE-NAME/layouts/com_content/article/default.php and modify it. Now your modified article layout file will be used instead of the default system layout. The same applies for WordPress files.
There are several ways of adding your own custom CSS to a Warp theme. You can use the Customizer to change most aspects of the theme without having to write any CSS. Keep in mind that your style will only be shown in the Customizer, if there is a style.less file inside the style's folder. When you use the Customizer, changes will be saved in the style.less file. Together with the theme LESS files it will be compiled into the /css/theme.css file and override any customizations you may have done.
You can use the Customizer and also add your own CSS by creating a custom.css file inside the /css folder for the related style. That way your CSS won't be overwritten when you save changes in the Customizer.
This tutorial shows you how to set up the main menu correctly in your Warp 7 based template.
After installation of the template click on Menus » Menu Manager Menu » Add New Menu in the administration menu on top. Give it a name and click on Save & Close. For more detailed instructions on how to create a menu see the Joomla documentation.
You can now assign menu items to the menu. Click on Menus » YOUR MENU » Add New Menu Item. For additional instructions on how to create a menu item take a look at the Joomla documentation.
The Logo is actually a simple image element. In Joomla we are using a Custom HTML module published on the themes logo position for it to display.
Go to Extensions » Modules Manager. Click on New. Select a Custom HTML module.
On the following edit screen, you select the logo module position.
And fill the Custom Output field. After publishing the module, the logo will display in the template.
Learn, how to handle file permission issues with your Warp theme.
Learn how to handle PHP issues during the installation process.
Most of the time installation problems are due to limited resources, for example on shared hosting servers. Here's an overview of the PHP configuration settings you should check and increase, if needed.
Get an overview of versions, file modifications and potential issues in your theme.
The dashboard section displays the current version number of the theme and the framework. This kind of information might be useful, if you need to resolve technical issues. It is advisable to update the framework and the theme simultaneously.
The layout settings manage the positioning of different layout parts.
Learn all about managing theme styles and how to add your own.
NOTE To optimize performance, we recommend disabling add-ons, like Firebug in Firefox.
The general theme section allows you to control the behaviour and the overall appearance of your template.
Learn how to update Joomla template without losing your customizations.
If a newer version of your template or Warp framework is available, you will receive a notification in the theme settings. In that case, just visit the Downloads section and download the latest template package.
Create a copy of your theme's /warp folder. That way, you will have a backup in case the update fails.
Download any Warp 7 theme and unzip the package.
Copy the /warp folder from the theme and replace the one in your theme with this one.
NOTE Sometimes a Warp update also requires to update the theme to reflect the changes in Warp accordingly.
The file verification in the theme settings shows all modified and missing files in your theme to help you detect which files you have customized before you start updating. Changes in Warp's administration area will generate the config.json, which is not shown in the file verification. So be sure to have a backup of that file. To update your theme, do the follow these steps.
First of all, make a backup of all your customized theme files, so you can recover modifications at any time.
Copy all files to /templates/THEME-NAME for Joomla and replace all files.
Recover your modifications by merging your customized files with the new ones.
Open Warp's administration area and hit Compile LESS.
IMPORTANT We strongly recommend to create a new style for all modifications and make a backup before updating. That way all your changes will be kept when updating your original theme files by replacing them.
This tutorial gives you a brief overview of the general Joomla! and Joomla Template installation process.
Setting up a Joomla Template follows the standard Joomla installation procedure and works like with any other template.
Download Joomla from the Joomla website.
Setup a new Joomla install.
For more information, take a look at the official Joomla documentation.
This area of settings allows you to enable some appearance elements (icons in posts) as much a social comments and social share buttons.
Of course those icons from Post Format settings are based on FontAwesome typography.
This build-in option adds IntenseDebate Comments system, Facebook comments and / or Disqus Comments to your site. All in one tool. You don't have to install any addcional plugin anymore to get this feature. Social allows your readers to log in via a preferred social network and add comment under article. All you have to do is choose and set correct Facebook Application ID, IntenseDebate Account or Disqus Username/Subdomain. Sorry, but right now you can use only one selected social comments system or disable it for all content.
This section of JoomLead template settings allows you to reduce size of loaded template files. By speeding up template, you offer a better experience for your customers, improve your page speed (and therefore, possibly, your search engine ranking) and make your CMS appear more stable and professional.
Note Custom CSS field is not compressed when you're using this option. It will help you to keep control about small changes.