Joomla Template Installation Instructions
This document will guide you how to install any HotThemes Joomla template onto your server. It will also describe some of the template's features and explain how to use the extensions included in the template package. However, it will not teach you Joomla or some basic web design techniques (see Assumptions part).
You don't like to read guides?
Well, you must read (at least) this:
- Unzip (unarchive) what you downloaded prior to using it!
- Don't install this Joomla template as you usually install templates. Make sure you follow HotStart instructions to install this template properly!
- You don't need to install Joomla prior to template installation! Joomla is included in the HotStart template installation.
An Important Notice for Joomla 3 Users:
This document has been written for Joomla 2.5. Instructions for Joomla 3 are exactly the same. However, in HotStart template installation there's one difference. Please read about this on the bottom of this page.
Table of Contents
- I installed template in my Joomla, but...
- HotStart Installation (installation of template with demo data) – Joomla 2.5
- HotStart Installation (installation of template with demo data) – Joomla 3
- Basic Template Installation (installation of template without demo data)
- Template Parameters
- Module Positions
You know Joomla!
This document will not teach you how to use Joomla and it's assumed that you have a fair knowledge of this matter. You may read official Joomla! documentation here: http://docs.joomla.org or find some nice books about Joomla! here: http://shop.joomla.org/
You know how to unpack (unzip) the archive
It's assumed that you know what's ZIP and how to unzip the archive you downloaded.
You know how to use a FTP program
It's assumed that you know what's FTP and how to use it. You can use any FTP program to upload files onto the server, however, we strongly recommend FileZilla. We found it as a stable and reliable software. It can be downloaded for all platforms for free here: http://filezilla-project.org
Use only plain text editors
If you need to edit a file that's a part of our templates or extensions, please use only plain type text editors. On Windows, you can use Notepad (and you must not use WordPad or MS Word). On Mac, you can use TextEdit, but make sure it works in Plain Text Mode (TextEdit > Preferences > New Document > Plain Text).
You have a Joomla compatible hosting account
It's assumed that you have an hosting account that's compatible with Joomla. Check technical requirements of Joomla and make sure your host meets them: http://www.joomla.org/technical-requirements.html. If you don't have an hosting account yet, we recommend HostGator's Linux packages because they're reliable and 100% Joomla compatible.
I installed template in my Joomla, but...
This is the most common error! You can not install template through Joomla!
Please read HotStart Installation section of this document to install the template properly!
You should not install Joomla prior to template installation! If you want to copy demo data that comes with the template, please follow HotStart Installation instructions instead. This method contains a new Joomla installation. This is the only way to copy demo data!
If you have a live site that already contains data, you may insist not to install a new Joomla. But you can't copy demo data in this case (it would overwrite your site's data) and you must setup everything manually. Please read this blog post: http://www.hotjoomlatemplates.com/blog/joomla-installation/60-change-joomla-template-on-existing-website
HotStart Installation – Joomla 2.5
You have purchased this product (most likely) because you were impressed with our demo! Now, you expect to see that same on your server. This is possible if you install template using HotStart installation method.
Once you finish this installation method, you should get exactly the same copy of the template demo site on your server. Let's start!
Step 1 - Unpacking (unzip)
Download the archive hot_templatename_jXX_unzip_first.zip from our server. Unzip it on your computer. It contains several files. One of the files is hot_templatenameXX_hotstart.zip. Create a separate folder on your computer and unzip hot_templatenameXX_hotstart.zip there. The unpacking may take several minutes. If you did it well, you would see several folders and files (see image).
All these files and folders actually represent a Joomla installation package. It's modified to copy our demo data instead of default Joomla demo data.
Step 2 - Uploading files
Using the FTP program (such as free FileZilla - http://filezilla-project.org) upload all files and folders (that you unpacked in the previous step) to your hosting space. There are many files (several thousands), so it may take some time, depending of your upload connection speed.
The left pane of your FTP program represents the folder on your computer where you unpacked hot_templatenameXX_hotstart.zip archive. The right pane represents a folder on your web hosting space. If you'd like to install template in the root site folder (to see it when you go to www.yoursite.com), make sure you're uploading files into site's root folder. To find out what's site's root folder of your hosting space, consult your hosting provider.
At the end of uploading process, your left and right pane must contains the same files and folders. Make sure there are no files in the "Failed Transfers" pane (bottom). If there are some files, upload them again.
Step 3 - Check permissions
This is very important, especially if you uploaded files through the hosting's control panel.
Make sure the folder where you uploaded files is readable by server (all folders should have permissions set to 755, and all files should have permissions set to 644). You can check this in the "Permissions" column (the right pane) in FileZilla.
If the permissions are not correct, you must change them! Select all the files and folders (in the right pane), right-click and select File permissions...
Enter 755 in the field "Numeric value". Select "Recurse into subdirectories" option and select "Apply to directories only". Click OK and FileZilla will change permissions of all folders. It may take several minutes.
Now, repeat the procedure for the files. Select all the files and folders (in the right pane) again, right-click and select File permissions... Enter 644 in the field "Numeric value". Select "Recurse into subdirectories" option and select "Apply to files only". Click OK and FileZilla will change permissions of all files. It may take several minutes.
Make sure once again that all files and folders have correct permissions. Look at the permissions column. Browse the folders (such as "administrator", "components"...) and make sure that files and folders inside them also have the correct permissions set (755 for folders, 644 for files).
If you can't change the permissions, maybe it's not allowed by your hosting provider. Ask your hosting provider to change permissions of the uploaded files and folders for you.
Step 4 - Prepare MySQL database
Your hosting account must have at least one MySQL database included. You should know connection parameters of the database. The connection parameters are:
- Database Host (usually it's "localhost" or IP address or address)
- Database Name (this is the name of your database)
- Database User Name (this is the name of user that connects to the database)
- Database Password (this is the password of user that connects to the database)
You most likely received these when your hosting account has been activated. If you don't have those 4 MySQL connection parameters, please contact your hosting provider.
Step 5 – Starting Joomla installation
In case that you uploaded the HotStart files in the root folder of your hosting space, in browser go to http://www.your_site_address.com/index.php (change "your_site_address.com" with your site address.
If you uploaded the HotStart files into a subfolder of your hosting space, you should go to http://www.your_site_address.com/subfolder/index.php (change "subfolder" with folder name where you uploaded files.
If you got 404 error (page not found), you probably missed the root folder. Root folder of your web hosting space are usually named as "public_html" or "html". But it can be anything else. Contact your hosting provider and ask where is your site's root folder, if you are unsure.
If you see this screen on your browser, you're good to proceed.
The first screen allows you to select language for the installation procedure only. After installation, your site front-end and Joomla backend will be set to English. Click NEXT to continue.
Step 6 - Checking your server
The installer now checks your server to find out if it's compatible with Joomla. If all items are green, you can click NEXT. Even if some items are marked red in the bottom part (under Recommended Settings), you can continue, but problems after installation are possible in this case. If you see any parts marked red, please contact your hosting provider to resolve the problem.
Step 7 – MySQL Connection
You should enter MySQL database connection parameters (that you prepared in Step 4) now. Enter your Database's Host Name, Username, Password and Database Name into the fields.
You can leave the Table Prefix field unchanged. Click NEXT.
If you got an error message, please check database parameters. It's important to enter them correctly. Hostname is address of your MySQL server (can be localhost, IP address...). Database Name is the name of your database. Username is the name of the user that connects to the database (don't mix it with database name). Password is a secret word that User uses to connect to the database. If you don't know correct parameters, please contact your hosting provider.
Step 7 - FTP Configuration
You can simply click NEXT here without entering anything.
Step 8 - Main Configuration (and Copying Demo Data)
On this screen, you should enter your site name (can be anything), your email address, Joomla super administrator's username and password (twice).
Click "Install Sample Data" button before you click NEXT button. If you forget to do it, the demo data that comes with this template will not be copied!
After clicking the "Install Sample Data" button, you should see the confirmation about successful installation of the sample data. Now, you can click NEXT.
Step 8 - Removing Installation Folder
The last screen of the Joomla installation informs you that you should delete Installation folder from your web hosting space to complete the installation. You can do it by clicking the "Remove Installation Folder" button on this screen.
After clicking the "Remove Installation Folder" button, you should get confirmation message "Installation folder successfully removed".
On some servers, it's not possible to delete the installation folder this way. If that's your case, go back to FTP program and delete it manually. In FileZilla, select "installation" folder, right-click and select Delete.
It may take some time until all files and folders from the "installation" folder are deleted.
Step 9 – Installation Completed
The HotStart installation should be completed now. Point your browser to your website. If everything went well, you should now see the exact same copy of our template demo on your server.
Basic Template Installation (no demo data)
If you are about to start a new website, it's strongly recommended to use HotStart method!
The Basic Installation method assumes that you don't need our demo data. Keep in mind, after this installation, your site will not look the same as our demo server! The only reason to install template using this method, and not the HotStart method, is to keep data that you already have on the site. But in this case, after template installation, you must setup many things manually. Please read this Blog post for details about changing template on the existing website: http://www.hotjoomlatemplates.com/blog/joomla-installation/60-change-joomla-template-on-existing-website
Step 1 - Determine Your Joomla Version
Make sure you know what's your Joomla version. You can check this in the top right corner or in the footer of your Joomla administrator's panel. The first two numbers are important, so your Joomla version can be 1.5.x, 1.6.x, 1.7.x, 2.5.x, and so on. The x is not important and can be any value.
Some Joomla versions may be discontinued during time. This means they are not supported anymore by the Joomla community. From our site, you can download only template versions for current (alive) Joomla versions. If you are using a Joomla version that's discontinued, you should upgrade as soon as possible for security reasons! Do it prior to template installation!
Step 2 – Download and Unzip The Correct Template Archive
If your Joomla version is 1.5, you should download archive "hot_templatename_j15_unzip_first.zip", if it is 2.5, you should download archive "hot_templatename_j25_unzip_first.zip", and so on.
Don't try to install this file! As its name suggests, you should unzip it first!
When you unzip this archive, you will have several files. The file you should use for the Basic Template Installation is named as "hot_templatenameXX.zip". In the name, XX represents the first two numbers of the Joomla version. This template should be installed only in this version of Joomla.
Step 3 – Check Joomla Permissions
Make sure all folders of your Joomla have permissions set to 755. You can check this from FTP program and if you go to Site > System Information > Directory Permissions. All directories listed here must have status "writable".
Step 4 - Uploading Template Through Joomla
In Joomla administrator's panel, go to Extensions > Extensions Manager. Click "Choose File" button and select file "hot_templatenameXX.zip" from your computer. Click "Upload & Install" button.
If everything went well, you would see the confirmation about template installation on the next screen.
Step 5 - Change Default Template
After template installation, go to Extensions > Template Manager. You will see the new template in the list of available templates. To make this template default, click on its star in the Default row.
Step 6 – The result is different than what you've seen on our Demo?
Yes, this is true! Since you installed template only, the demo data have not been installed. Most likely, your site looks messy now. You need less or more work to make it look properly.
So, if you need template with Demo data, please complete HotStart Installation. Step-by-step instructions are in the HotStart chapter of this document.
Our templates are highly customizable. Some templates allows you to change layout, colors, font, widths, and so on.
To reach the Template Parameters page, in your Joomla administrator's panel, go to Extensions > Template Manager. You see the list of all available templates. Click on the template's name to open the Edit Style page where you can set various parameters of the template.
Different templates have different parameters. We will not explain individual parameters here, because you can guess the parameter's purpose yourself from its name. Also, you can see the explanation of each parameter when you move mouse pointer over the parameter's name.
Pre-defined and Custom Color Styles
The templates usually come with several pre-defined color styles. The color style can be selected in the Edit Style page, in Template Layout tab. Please keep in mind, if any pre-defined color scheme has been selected, then whatever you entered in the parameters below would be disregarded (however, you selection would be saved). To use your own template parameters, you must select Custom Style in Template Layout tab to activate your custom parameters.
If you want to keep most of the settings of (in example) Style 3, and change only a couple of them, then you can edit the pre-defined style's file using a plain text editor. Open file <joomla root>/templates/hot_templatename/styles/style3.php. You will see all the parameters in the textual format. In example, to change value for body text, you edit this line:
$bodyText = "#555555";
Here, you can edit a color's hex number (555555), but you must not change anything else (special characters), otherwise you can get a server error message.
Different Parameters on Different Pages
If you want a parameter with different values on the Page A and the Page B, then you can use multiple template styles (new feature from Joomla 1.6).
After template installation, you have only one template style in Template Manager. It's named as hot_templatename - Default. If this template is marked as default site template, then all site's pages will be shown using this template and parameters.
You can make a copy of the Default style in the Template Manager page (select it and click "Duplicate") or in the Edit Style page (click "Save as Copy"). Now, you have two styles of the same template, but only one can be marked as default (notice the star in the Default column!). It's now possible to edit the parameters of the second (copied) template style independently of the default style. Finally, using Menus Assignment section, it's possible to assign this template style to the certain pages (menu items). Those pages will be rendered using the duplicated style, while all the rest pages will be rendered using the default style.
Using Different Pre-defined Styles on the Site
Create a template style duplicate, as explained above. In the default style, in Template Layout tab, select (in example) Style 1. In the duplicated style, select (in example) Style 2 and select pages (menu items) where to use this style (under Menus Assignment).
Module positions are place holders for your Joomla modules. If you install template using HotStart method, all modules will be pre-installed and placed in the appropriate module positions. If you didn't use the HotStart installation, then you must setup all the modules yourself and select appropriate module position for each module.
Each template demo contains several dozens of module positions. We prepared a graphically presented "map" of all available module positions for this template. To find this "map" for your template, open this link http://demo.hotjoomlatemplates.com/module_positions in your browser, and select the template by its name. The image with module positions map for this template will be opened.
Typography determines what fonts will be used on your site. Templates come with different typography aspects, depending of the overall template style.
You would need to use different font styles for headings, subheadings, paragraphs, lists, quotes and so on. However, all those font styles should be in harmonic relations. The art of typography starts there!
Our templates come with pre-defined font styles for most commonly used elements of text. Furthermore, there are some additional font styles that you may find useful for your site. To see how all text styles available in a specific template, please visit our demo server (http://demo.hotjoomlatemplates.com) and select your template. Then select the Typography link from the menu. The Typography page will show you all text styles available in this template as well as how to implement them on your text.
Of course, you will need some HTML/CSS knowledge to create text elements (paragraphs, lists, block-quotes...) and apply style to them.
The scope of this manual is not to teach you HTML and CSS. You may find so many books and video tutorials about HTML/CSS on the Internet. It's assumed that you know a little bit of HTML and CSS. If you know how to create HTML elements (paragraphs, headings, lists...) and how to apply styles to the elements, you are experienced enough to read and understand the Typography page mentioned above.
HotStart Installation - Joomla 3
If you are about to install template with Joomla 3, you can follow instructions written for Joomla 2.5. However, there's only one step in Joomla 3 that's different.
On the screen where you are asked about the sample data installation, you should select option "Default English (GB) Sample Data" and click the Install button. On some templates, this option is clearly marked as "Select this for HotStart!".