Installation
The most important decision to make before proceeding with your installation is whether you should install the template manually, or if you can use the Quickstart package, which will install everything for you.
Which installation method you should use depends on the current status of your site. Also, before installing either the template manually or the Quickstart Package, please make sure you meet the Joomla! and the template requirements.
Requirements
- Apache 2.2+ or Microsoft IIS 7 (Apache strongly recommended)
- PHP 5.4+ (PHP 5.5+ Recommended)
- MySQL 5.1+
- Joomla 3.4+
Also, please have a look at the Gantry5 requirements. Basically, they are the same as the above, but you will find some additional details there.
Quickstart Installation
The Quickstart Package consist of a full installation of Joomla! that installs Joomla itself, the template, the extensions, the demo content and the database data to match our demo layout. Have in mind that as this is a full Joomla! installation it may only be used on a clean server; the package cannot be installed in an existing Joomla installation. It can only be used when you start a new project/website.
Installing the Quickstart Package is a fairly simple process. Generally, a Quickstart install will consist of these small steps:
- Ensure you have installed an FTP client and prepared a database for your server, or have the credentials for an existing database.
- Download and extract the Quickstart Package.
- FTP the extracted Quickstart contents to your preferred install location.
- Open your browser to the install location on your server to begin the Joomla! installation process, entering the database credentials where required.
Once this final step is complete you will have a fresh install of Joomla!, along with the template and all the settings and content needed to match the demo, including sample article content. However, the images from the demo will NOT be included, as they are licensed via a third party. Instead, blank placeholder images will be included so that you can customize the content easily with your own images. For some users, the above steps are all that is needed for a successful installation of the Quickstart Package, but for those who are less experienced with this process, we recorded the following videos (they are for the Oxygen template but the process is absolutely the same for all our templates).
This video, from the official Akeeba Backup documentation, shows the whole process of installing the Quickstart package (restoring an Akeeba Backup file).
Also, make sure that you click on the "Override tmp and log paths" button during the installation and that you update the admin user details.
Manual Installation
Manual Installation refers to installing the template on your Joomla! powered website. This means you already have a website with content items, modules, extensions, so you just decided you want to improve the design of your website.
You can find step-by-step instructions as well as a video instructions regarding the Manual Installation in the Gantry5 Documentation, in the "Installation" chapter.
Customization
All your customization (custom code) should be placed in your "Custom Style Sheet" file. This is the custom.scss
file. By default, the custom.scss
file does not exists, so you will need to create it. You need to create this file in root/templates/TEMPLATE_NAME/custom/scss
. You will find all details in the Gantry5 Documentation, in the "Adding a Custom Style Sheet" chapter.
Changing the logo
You will need to change the logo, that's for sure. You can do that easily by editing the settings of the "Logo" particle:
- Go to the "Template Manager"
- Click on "Construction - Default"
- Select the "Base" Outline
- Go under the "Particle Defaults" tab, scroll down to the "Logo" particle and upload your logo file
The logo (and the menu) defines the height of the Header section so if your logo is with a different height than the Construction demo logo (70px) you might need to adjust the logo margins in order to make it in the middle of the Header. You can do that easily by adding the following code in your custom.scss
file:
.g-logo { margin: 20px 0; }
You need to modify this 20px so the logo fits the design. This 20px are actually 20px space/margin from the top and 20px from the bottom.
Once you change the logo you might also need to adjust the padding of the menu items so the menu can be in the middle of the header. You can do that easily by adding the following code in your custom.scss
file:
#g-header .g-main-nav .g-toplevel > li > .g-menu-item-container { padding: 50px 10px; }
You need to modify the 50px value which is the padding of the top and the bottom of each menu item.
Once you do the above, you might also want to adjust the padding of the Social/Search icons. You can do that easily by adding the following code in your custom.scss
file:
.g-social-search { padding: 45px 0; }
Have a look at the following video. It shows everything that we explained above.
Update
Updating the template
Updating the template is really easy. Here are the steps you need to perform:
- Download the new version of the template from the "Download" section on our website
- Go to "Extensions" -> "Manage" and click on the "Browse" button
- Select the template file you downloaded in step 1. It will usually be called
tpl_it_NAME.zip
- Click on the "Upload & Install" button
Gantry5 Framework update
This is just a simple one click task. If there is a newer version of the Gantry Framework released you will notice that in your Joomla Admin as well as in the Template Manager. Then just click on the button.
You might also want to read the "Updating" and "Updating Themes" chapters in the Gantry5 Documentation.
Joomla 3 to Joomla 4 MigrationJOOMLA 4
Here are the steps you need to perform:
- Get yourself familiar with the Joomla 3.x to 4.x Step by Step Migration Guide.
- Make sure you are on the latest Joomla 3.10 version.
- Make sure you are on the latest Gantry 5 version.
- Install the latest version of the template.
- Uninstall the extensions that are not compatible with Joomla 4 (RokSprocket, News Show SP2, etc) and create/configure their replacements ("Portfolio" particle, "Accordion" and "Accordion (Joomla)" particles, "Tabs" particle, "Slideshow" particle, "News PRO (Joomla)" particle, etc).
- IMPORTANT: If you are using the AcyMailing extension and it is not v7 already, make sure you migrate to v7.x. Once you have migrated to v7, make sure you have completely uninstalled all v5 plugins (Extensions Manager -> Manage -> Search for "AcyMailing"). If you do not do that the update will fail and your site will become unusable.
- IMPORTANT: If you are using the Falang v3.x extension, make sure you disable all its plugins (Extensions Manager -> Manage -> Search for "Falang") prior to the update. If you do not do that the update will fail and your site will become unusable. Once you update to Joomla 4, install Falang v4.x and enable all its plugins.
- Perform the Joomla 3 to Joomla 4 update.
Gantry 5 Basics
Please have a look at the Gantry Documentation in order to discover what Gantry is all about, the core-concepts behind it, and how to get started with this next-generation framework.
The most important things you need to know when working with our Gantry5-based templates are:
- The Layout Manager is used mostly for creating your module positions. Apart from the module positions, you should also keep the static content in the Layout Manager. By "static content" we mean the "Logo" particle, the "Menu" particle, the "System Messages" particle, the "Page Content" particle, the "To Top" particle and the "Mobile Menu" particle.
- If you want to hide some modules/elements on some devices (phones, tablets, etc) you should use the
hidden-phone
,hidden-tablet
, etc. classes but you should add them in the particular module positions (under the "Block" tab) in the Layout Manager, rather then in the "Module Class Suffix" field for the particular module. You will find more details in the "Layout Manager" chapter in the Gantry Documentation. - As mentioned above, you create your module positions in the Layout Manager, but then you will use the Module Manager to assign your modules, as you would do in any other framework as well as in the default Joomla!
- In order to publish the custom particles that come with the template you will use the "Gantry5 Particle" module in the Module Manager, rather than adding them directly in the Layout Manager.
- If you want to change the style of some sections (background color, background image, text color, etc.) globally, for the whole website, you should do it under the "Styles" tab in the "Base" outline. The "Base" outline holds the defaults for the whole website. You can then override those defaults in each outline you create.
- If you want to load an asset (JS, CSS, etc.) globally in the whole website, you can do it under the "Page Settings" tab in the "Base" outline.
- If you want to create an empty page so you can assign modules to it, you will use the "Gantry5 Themes" -> "Custom Page" menu item type. Previously, you would use the "Featured Items" menu item type.
Required Atoms
Please have a look at the Atoms sections in the Gantry Documentation so you know what they are all about.
Atoms basically load assets (scripts and stylesheets).
You must load the following atoms so the template can work properly. We recommend adding these atoms to the "Base" outline so the assets can be loaded on all your pages:
- "UIkit for Gantry5" Atom - loads a modified and optimized version of the UIkit Framework.
- "Template.js" Atom - loads the template specific JavaScript code.
Optionally, you can also add the "ScrollReveal.js" atom if you want to have onscroll animations. ScrollReveal.js is a library to easily reveal elements as they enter the viewport.
You need to load these Atoms if you install the template manually (refer to the "Installation" section for more details).
The following video shows how you add the Atoms.
Particles
Gantry5 comes with a brand new Particle system which makes it easy to create, configure, and manage content blocks.
Basically, everything that you would create a Custom HTML module for is now coded in to a particle. You no longer need to copy/paste long HTML codes and edit them, you just need to click here and there and fill out fields in the Admin.
In this chapter we will show you the custom particles that we developed as well as some of the core Gantry 5 particles that we modified and enhanced, for example the "Social" particle.
3D Slider
The "3D Slider" particle displays content in a very beautiful and eye-catching way. It is one of our most advanced and poweful particles. The following video shows the particle itself and most of its options.
Accordion
The "Accordion" particle is basically the UIkit Accordion coded into a particle and brought as a feature in our Gantry5-based templates. The following video shows the particle itself and most of its options.
Branding
The "Branding" particle is almost the same as the Custom HTML particle - it allows you to displays a text/HTML of your choice. The following video shows the particle itself and most of its options.
CTA Button
The "CTA Button" particle displays a really nice and highly effective Call-to-action button. The following video shows the particle itself and most of its options.
Companies
The "Companies" particle displays logos/images where you can optionally add some text. This particle is supposed to be used for sections like "Our Clients", "Our Sponsors" and so on. The following video shows the particle itself and most of its options.
Contacts
The "Contacts" particle displays contact information. It is a really flexible particle so you can basically display whatever contact details you want. The following video shows the particle itself and most of its options.
Content PRO
The "Content PRO" particle is one of our most advanced particles. It incorporates several UIkit components as well as quite some custom code and functionality written by us. You can use this particle for many different things. Basically, you will use it to display content, usually images, titles and text. The following video shows the particle itself and most of its options.
Content PRO (Joomla)
The "Content PRO (Joomla)" particle looks and works in absolutely the same way as the default "Content PRO" particle. The difference is that "Content PRO (Joomla)" fetches Joomla articles automatically, while in "Content PRO" the user creates the content manually. The following video shows the particle itself and most of its options.
Features
The "Features" particle displays, the quite popular nowadays, features that you, your company or your product provides. The following video shows the particle itself and most of its options.
Feedback
The "Feedback" particle is kind of variation of the "Content PRO" particle. It displays feedback of users and clients. The following video shows the particle itself and most of its options.
Feedback 2
The "Feedback 2" particle displays feedback of users, clients and guests. The following video shows the particle itself and most of its options.
Gallery
The "Gallery" particle is also a very advanced particle that incorporated several UIkit components. It is now a piece of cake to build awesome, responsive galleries in your Joomla! website. The following video shows the particle itself and most of its options.
Google Map
The "Google Map" particle is really flexible and displays a Google Map. The following video shows the particle itself and most of its options.
Hero Slider
The "Hero Slider" is a very effective and eye-catchy particle that shows your slides in a section where you can add a background image and several different animation effects. You can add a Title, Description and as many buttons as you want in each and every slide. The following video shows the particle itself and most of its options.
Main Feature
The "Main Feature" particle is divided into a left and right side. It displays an image and some text with a button. You can achieve some really nice visual effects if you add the ScrollReveal.js functionality to this particle. The following video shows the particle itself and most of its options.
Modal Search and Offcanvas Toggle
We put these two particles together because they are both supposed to be used inside the Main Menu. The "Modal Search" particle displays a nice magnifier icon and when you click on it a small popup window with the Joomla Search appears. The "Offcanvas Toggle" button displays an icon of your choice which, when clicked, triggers the Offcanvas section. The following video shows the particles themselves and most of their options.
News PRO (Joomla)
The "News PRO (Joomla)" particle is our most advanced and most awesome particle to date. It is incredibly powerful and allows you to fetch Joomla articles automatically and display them however you like. The following video shows the particle itself and most of its options.
OnePage Menu
The "OnePage Menu" particle display a sidebar, vertical menu that gets sticky/fixed when the user starts scrolling. And the page gets smoothscrolled to the particular sections when a menu item is clicked. The following video shows the particle itself and most of its options.
Our Team
The "Our Team" particle is a variation of the "Content PRO" particle. It displays team members together with their social accounts in a nice way. The following video shows the particle itself and most of its options.
Page Title
The "Page Title" particle is a nice, small particle that shows a title, icon and description. The following video shows the particle itself and most of its options.
Places
The "Places" particle provides a very cool functionality where you upload an image and add pointers/places with different information. The following video shows the particle itself and most of its options.
Portfolio
The "Portfolio" particle is also a very advanced particle that incorporated several UIkit components. It is now a piece of cake to build awesome, responsive portfolios in your Joomla! website. The following video shows the particle itself and most of its options.
Pricing Tables
The "Pricing Tables" particle displays pricing tables. The following video shows the particle itself and most of its options.
Slideshow
The "Slideshow" particle is basically the UIkit Slideshow coded into a particule and brought as a feature in our Gantry5-based templates. We also added many custom features in it (v2) so it is now one of the most powerful Slideshows you can find on the web. The following video shows the particle itself and most of its options.
Social
The "Social" particle displays social icons and/or text. We enhanced it so you can now also have tooltips with custom test. The following video shows the particle itself and most of its options.
Social/Search
The "Social/Search" particle is designed specifically for the Construction template. It is supposed to be used in the Header section ONLY. The "Social/Search" particle is an advanced particle that combines the functionality of several other particles - the "Social" particle, the "Modal Search" particle and the "Offcanvas Toggle" particle. The following video shows the particle itself and most of its options.
Tabs
The "Tabs" particle is basically the UIkit Tabs and UIkit Switcher coded into a particule and brought as a feature in our Gantry5-based templates. The following video shows the particle itself and most of its options.
Timeline
The "Timeline" particle display items, where you can add as many items as you like. The particle is perferct to present a sequence of events or dates, per example education background or work experience. The following video shows the particle itself and most of its options.
Fixed/Sticky Header
Construction has a nice fixed/sticky Header that stays on the top of the screen when you start scrolling down. This effect is achived with the UIkit Sticky component. Basically, all you need to do is to add the following "Tag Attribute" to the Header section:
data-uk-sticky="{top:-700, animation: 'uk-animation-slide-top', media: 768}"
You can easily disable the fixed Header or make another section fixed. The following video explains everything (the video is from Oxygen, but the process is exactly the same in Construction).
"Home" Outline
First of all, have a look at the Gantry 5 Documentation so you know what an "Outline" is and what it is about.
Construction comes with a "Home" outline that gives a unique layout and set of settings to the Home page.
Here are the things in the "Home" outline that are different compared to the "Default"/"Base" outline:
- The "Feature" section has different settings under the "Styles" tab that override the default ones.
- The "Subfeature" section has different settings under the "Styles" tab that override the default ones.
- The "Utility" section has different settings under the "Styles" tab that override the default ones.
- The "Additional" section has different settings under the "Styles" tab that override the default ones.
- The "Subfeature" section has different settings under the "Layout" tab that override the default ones.
- The "Utility" section has different settings under the "Layout" tab that override the default ones.
- The "Additional" section has different settings under the "Layout" tab that override the default ones.
If you install the Quickstart package the "Home" outline and everything else will be there already. But if you install just the template manually, all you need to do is to create a new Outline, assign it to your "Home" page (menu item) and then just select the settings under the "Styles" and "Layout" tabs so they can override the default ones.
The following video shows everything that we explained above.
Modules and Positions
Construction comes with unlimited module positions. Thanks to the awesome Gantry 5 framework you can now easily create as many module positions as you want. You just need to go to the Layout Manager, drag and drop the "Module Position" particle wherever you want it to be and set the module position name.
Quickstart Package - Modules Overview
Here, just for your orientation, you can see where the modules from the demo are published and what Module Class Suffixes they use.
"Home" Page
1. Logo
2. Menu
3. Social/Search
Particle: Social/Search
Module Position: social-search
Module Class Suffix: none
Show Title: Hide
4. Slideshow
Particle: Slideshow
CSS Classes: custom
Module Position: fullwidth
Module Class Suffix: none
Show Title: Hide
4. Hero Slider
Particle: Hero Slider
CSS Classes: custom
Module Position: fullwidth
Module Class Suffix: none
Show Title: Hide
5. Better Value, Better Experience
Particle: Main Feature
General CSS Classes: custom
Left CSS Classes: uk-flex, uk-flex-middle
Module Position: feature-a
Module Class Suffix: title-center title-dot
Show Title: Show
6. Outstanding windows design
Particle: Main Feature
General CSS Classes: fullwidth
Right CSS Classes: uk-flex, uk-flex-middle, uk-text-center
Module Position: subfeature-a
Module Class Suffix: title-center title-dot
Show Title: Hide
7. Beautiful interior design
Particle: Main Feature
General CSS Classes: fullwidth, margin-top
Left CSS Classes: uk-flex, uk-flex-middle, uk-text-center
Module Position: utility-a
Module Class Suffix: title-center title-dot
Show Title: Hide
8. Our Services
Particle: Features (Style 2)
CSS Classes: custom
Module Position: mainbottom-a
Module Class Suffix: title-center title-dot
Show Title: Show
9. Our Projects
Particle: 3D Slider(Style 1 - Carousel)
CSS Classes: uk-text-left
Module Position: extension-a
Module Class Suffix: title-center title-dot
Show Title: Show
10. Renovation Masters
Particle: Places
CSS Classes: light-nav
Module Position: additional-a
Module Class Suffix: title-center title-dot
Show Title: Show
11. Our Professionals
Particle: Our Team (Style 1)
Module Position: bottom-a
Module Class Suffix: title-center title-dot
Show Title: Show
12. Latest News
Particle: Content PRO (Joomla) (Style 3)
CSS Classes: uk-text-left, custom, image-overlay
Module Position: afterbottom-a
Module Class Suffix: title-center title-dot
Show Title: Show
13. 15 Years Warrenty
Particle: Main Feature
General CSS Classes: warranty
Left CSS Classes: uk-hidden
Module Position: last-a
Module Class Suffix: none
Show Title: Hide
14. About Us
Particle: Custom HTML
Module Position: footer-a
Module Class Suffix: none
Show Title: Show
15. Recent Posts
Particle: News PRO (Joomla)
CSS Classes: footer
Module Position: footer-b
Module Class Suffix: none
Show Title: Show
16. Useful Links
Module Position: footer-c
Module Class Suffix: none
Show Title: Show
17. Get in Touch
Particle: Contacts (Style 1)
Module Position: footer-d
Module Class Suffix: none
Show Title: Show
18. Copyright (Branding)
Particle: Branding
Module Position: copyright-a
Module Class Suffix: none
Show Title: Hide
19. Social Icons (Footer)
Particle: Social
Module Position: copyright-b
Module Class Suffix: none
Show Title: Hide
20. To Top
"Portfolio" Page
1. Page Title
Particle: Page Title
Module Position: navigation-a
Module Class Suffix: none
Show Title: Hide
2. Breadcrumbs
Module Position: breadcrumb-b
Module Class Suffix: none
Show Title: Hide
3. Portfolio
Particle: Portfolio
Module Position: feature-a
Module Class Suffix: none
Show Title: Hide
3. Gallery
Particle: Gallery
Module Position: feature-a
Module Class Suffix: none
Show Title: Hide
"Contact Us" Page
1. Page Title
Particle: Page Title
Module Position: navigation-a
Module Class Suffix: none
Show Title: Hide
2. Breadcrumbs
Module Position: breadcrumb-b
Module Class Suffix: none
Show Title: Hide
3. Company Information
Particle: Custom HTML
Module Position: sidebar-right
Module Class Suffix: title-border
Show Title: Show
4. Contact Details
Particle: Contacts (Style 1)
Module Position: sidebar-right
Module Class Suffix: title-border
Show Title: Show
5. Our Offices Worldwide
Particle: Places
Module Position: extension-a
Module Class Suffix: title-center title-dot
Show Title: Show
5. Find Us On The Map
Particle: Google Map
Module Position: extension-a
Module Class Suffix: title-center title-dot
Show Title: Show
"About Us" Page
1. Page Title
Particle: Page Title
Module Position: navigation-a
Module Class Suffix: none
Show Title: Hide
2. Breadcrumbs
Module Position: breadcrumb-b
Module Class Suffix: none
Show Title: Hide
3. Our Projects
Particle: 3D Slider(Style 3 - Coverflow)
CSS Classes: uk-text-left
Module Position: feature-a
Module Class Suffix: title-center title-dot
Show Title: Show
4. See Our History
Particle: Timeline (Style 2)
Module Position: subfeature-a
Module Class Suffix: title-center title-dot
Show Title: Show
5. What Our Customers Say
Particle: Feedback 2
Module Position: utility-a
Module Class Suffix: title-center title-dot
Show Title: Show
6. Our Awesome Team
Particle: Our Team (Style 1)
Module Position: maintop-a
Module Class Suffix: title-center title-dot
Show Title: Show
7. Our Awesome Clients
Particle: Companies (Style 2)
Module Position: mainbottom-a
Module Class Suffix: title-center title-dot
Show Title: Show
"RokSprocket Mosaic (Default)" Page
1. Page Title
Particle: Page Title
Module Position: navigation-a
Module Class Suffix: none
Show Title: Hide
2. Breadcrumbs
Module Position: breadcrumb-b
Module Class Suffix: none
Show Title: Hide
3. RokSprocket Mosaic (Default)
Columns: 3
Blocks per View: 9
Module Position: feature-a
Module Class Suffix: none
Show Title: Hide
3. Portfolio 1JOOMLA 4
Particle: Portfolio (Style 1)
Module Position: feature-a
Module Class Suffix: none
Show Title: Hide
"RokSprocket Mosaic (Gallery)" Page
1. Page Title
Particle: Page Title
Module Position: navigation-a
Module Class Suffix: none
Show Title: Hide
2. Breadcrumbs
Module Position: breadcrumb-b
Module Class Suffix: none
Show Title: Hide
3. RokSprocket Mosaic (Gallery)
Columns: 3
Blocks per View: 9
Module Position: feature-a
Module Class Suffix: none
Show Title: Hide
3. Portfolio 2JOOMLA 4
Particle: Portfolio (Style 2)
Module Position: feature-a
Module Class Suffix: none
Show Title: Hide
"Pricing" Page
1. Page Title
Particle: Page Title
Module Position: navigation-a
Module Class Suffix: none
Show Title: Hide
2. Breadcrumbs
Module Position: breadcrumb-b
Module Class Suffix: none
Show Title: Hide
3. Choose Your Plan
Particle: Pricing Tables (Style 1)
Module Position: feature-a
Module Class Suffix: none
Show Title: Hide
4. Pricing Features
Particle: Features (Style 2)
Module Position: subfeature-a
Module Class Suffix: none
Show Title: Hide
4. CTA Button
Particle: CTA Button (Style 1)
Module Position: utility-a
Module Class Suffix: none
Show Title: Hide
"FAQ" Page
1. Page Title
Particle: Page Title
Module Position: navigation-a
Module Class Suffix: none
Show Title: Hide
2. Breadcrumbs
Module Position: breadcrumb-b
Module Class Suffix: none
Show Title: Hide
3. FAQ
Module Position: utility-b
Module Class Suffix: none
Show Title: Hide
3. FAQJOOMLA 4
Particle: Accordion (Joomla)
Module Position: utility-b
Module Class Suffix: none
Show Title: Hide
"Typography" Page
1. Page Title
Particle: Page Title
Module Position: navigation-a
Module Class Suffix: none
Show Title: Hide
2. Breadcrumbs
Module Position: breadcrumb-b
Module Class Suffix: none
Show Title: Hide
3. OnePage Menu
Particle: OnePage Menu
Module Position: sidebar-left
Module Class Suffix: none
Show Title: Hide
Extensions
The Web is full of all kinds of different Joomla extensions. Throughout the years we had the chance to work with many extensions from many different providers which helped us to filter the best of best ones. The extensions that we use in our templates have the cleanest code, the best functionality and they've been very well supported by their developers.
Below you will find the Download link and the Documentation for each extension (Component, Module, Plugin) that we have used in this template.
- RokSprocket - Download | Documentation