Tutorial:Customising the JA Purity template

From Joomla! Documentation

This tutorial page or section is in the middle of an expansion or major revamping. However, you are welcome to assist in its construction by editing it as well. Please view the edit history should you wish to contact the person who placed this template. If the tutorial page has not been edited in several days please remove this template. While actively editing, consider adding {{inuse}} to reduce edit conflicts.

Contents 1 Introduction 1.1 Before You Start 2 Template Layout 2.1 Front Page 2.2 Positions 2.3 Classes/IDs 2.3.1 Body 2.3.2 Header 2.3.3 Horizontal Navigation 2.3.4 Top 2.3.5 Left 2.3.6 Right 2.3.7 Main 2.3.8 Breadcrumbs 2.3.9 Spotlight 2.3.10 User 1 2.3.11 User 2 2.3.12 User 3 2.3.13 User 4 2.3.14 User 5 2.3.15 Syndication 2.3.16 Footer 2.4 CSS Files 3 Customisation - Basics 3.1 Administration Features 3.2 Customise Module Position and Content 3.3 Customise the Logo 3.4 Customise the Header 3.5 Customise the Favicon 3.6 Customise Horizontal Navigation Menus 4 Customisation - Intermediate 5 Customisation - Advanced 6 Known Issues and Bugs 7 See also

Introduction

JA Purity is a highly customizable template available by default in standard Joomla 1.5 installations. JA Purity was designed by JoomlArt.com and features the following:

1. Screen width configuration (Fluid/Narrow/Widescreen/Fixed in pixel or percentage)
2. Multiple colors schemes (Red, Green, Blue and Black )
3. Well Structured, xHTML/CSS validated and SEO-optimized source
4. Cross-browser support for Internet Explorer 6+, Firefox, Safari, Opera

If you have a support question about the JA Purity template check for a solution on the following forum.

Before You Start

Before you start hacking away at the template you may want to do ONE of the following:

• Create a directory templates/my_japurity. Copy the contents of the original ja_purity directory to the my_japurity directory. Go to the administrator/language/en-GB directory and copy en-GB.tpl_ja_purity.ini to en-GB.tpl_my_japurity.ini. Do the same in the language/en-GB directory. Open the templateDetails.xml file in the my_japurity directory and change ALL references for the original ja_purity directory to the new directory my_japurity.

  3. <name>JA_Purity</name>

  326. <language tag="en-GB">en-GB.tpl_ja_purity.ini</language>

  330. <language tag="en-GB">admin/en-GB.tpl_ja_purity.ini</language>

  388. <param name="theme_header" type="folderlist" directory="templates/ja_purity/styles/header" default="" label="Header Themes" description="HEADER THEMES DESCRIPTION" />
  389. <param name="theme_background" type="folderlist" directory="templates/ja_purity/styles/background" default="" label="Background Themes" description="BACKGROUND THEMES DESCRIPTION" />
  390. <param name="theme_elements" type="folderlist" directory="templates/ja_purity/styles/elements" default="" label="Primary Elements" description="PRIMARY ELEMENTS DESCRIPTION" />

• Download the tutorial template. Once you download the archive, rename it as my_japurity.zip and then log into the Administration area of your Joomla site and install the template.

This will save you from worrying about any updates to the Joomla source that might overwrite your edits. This tutorial is based on the latest template version as of Joomla version 1.5.11.

Template Layout

Here's the directory structure for the template. Click to see a description of the directory contents (if available)

Front Page

Click on the picture to see the descriptions (if available)

Positions

Classes/IDs

Body

• JA Purity body

Header

• JA Purity header
  • JA Purity logo
  • JA Purity accessibility
  • JA Purity search
    • JA Purity user4

Horizontal Navigation

• JA Purity horizontal navigation

Top

• JA Purity top

Left

• JA Purity left

Right

• JA Purity right

Main

• JA Purity content
  • JA Purity breadcrumbs
  • JA Purity banners

Breadcrumbs

• JA Purity breadcrumbs

Spotlight

• JA Purity spotlight
  • JA Purity user 1
  • JA Purity user 2
  • JA Purity top
  • JA Purity user 5

User 1

• JA Purity user 1

User 2

• JA Purity user 2

User 3

• JA Purity user3

User 4

• JA Purity user 4

User 5

• JA Purity user 5

Syndication

• JA Purity Syndication

Footer

• JA Purity Footer
  • JA Purity Syndication
  • JA Purity user3

CSS Files

• JA Purity template.css

Customisation - Basics

Administration Features

Enable Horizontal Navigation Menus

Customise Module Position and Content

Customise - Header Area
Customise - Module Position Left
Customise - Main Content Area
Customise - Module Position Right
Customise - Spotlight Area
Customise - Module Position Footer

Customise the Logo

Customise the Logo
Change the Position of Your Logo
Use one image for Header and Logo

Customise the Header

Customise the Header Background
Change the Size of the Header
Add or Change the Header Color Scheme

Customise the Favicon

Customise the Favorite Icon

Customise Horizontal Navigation Menus

Center the Horizontal Menus
Change the Color of the Horizontal Menus
Use a Gradient Image for the Background in the Horizontal Menus
Allow Right to Left language use of Horizontal Menu

Customisation - Intermediate

Customise Accessibility
Customise Searching

Customisation - Advanced

Customise Overrides

Known Issues and Bugs

• IE8 Compatibility - SEE: http://forum.joomla.org/viewtopic.php?f=541&t=393631&p=1709079&hilit=ie8#p1709079
• Active Menu item not updating. SEE: http://forum.joomla.org/viewtopic.php?f=466&t=396625
• PROBLEM: When Joomla cache is enabled reference Joomla 1.5.10 and before) and clicking a menu item it doesn't change color. It is impossible to understand which is the active menu item. SOLUTION: for now the only solution is to disable the cache function in the mod_mainmenu: go to 'Tools>Module Manager' and select the 'Main Menu' module (type=mod_mainmenu). Under 'Parameters>Advanced Parameters' select 'Caching>No Caching'. SEE: http://forum.joomla.org/viewtopic.php?f=541&t=378584

See also

Some information about this template