The Quickstart allows you to replicate the demo package to your server. It means, after installing the Joomla 4 demo Quickstart, you will have a site exactly the same as the demo site. Including components, demo content, Joomlead particles configuration, and site configuration.
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.
There are two ways of accessing files when working with Joomla: either directly via your webserver or through an FTP client. Different files and directories have permissions specifying who can read, write or access them. Sometimes the permission settings of your webserver and your FTP client can collide, so that when trying to install an extension from the backend you are suddenly confronted with messages, like JFolder::create: Could not create directory or Directory not writable: /administrator/templates/system/ or you may not be able to save theme settings.
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.
Manage and organize your menus with additional settings. Menu items can be filtered by the position to which they are assigned.
The following table shows you all additional menu settings.
The layout settings manage the positioning of different layout parts.
This section makes the arrangement of your content very easy and flexible. You can enable or disable system output, define the layout of the theme’s widget or module positions and select a style you created in the customizer. Additionally you have the possibility to store your modifications in a layout profile and assign it to different pages.
This option enables you to assign a style to your layout. In addition with the customizer and the layout manager this makes styling your pages very flexible.
Learn all about managing theme styles and how to add your own.
The Warp customizer simplifies your workflow and allows you to add new styles with no need for any CSS knowledge. It is divided into two sections. The left hand vertical bar indicates the settings for the theme and on the right you can see your selected theme. All modifications within the customizer will instantly be displayed in the preview on the right side.
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.
The style section contains the customizer. Hit the Customizer button to add your own style or to modify an existing style. After the customizer is loaded, you can easily customize colors, fonts, margins and even more settings of the theme. The customizer saves only the modified variables and automatically compiles them into CSS.
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.
/warp folder. That way, you will have a backup in case the update fails./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.
/templates/THEME-NAME for Joomla and replace all files.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.
For more information, take a look at the official Joomla documentation.
