Changelog entries prior to this release are not available.
Versatile Changelog
Version 6.2.0
First Joomla 6 native release. Versatile has been converted from Joomla 3 and rebuilt for Joomla 6.2.0 + PHP 8 + Bootstrap 5. The previous download is the Joomla 3 package (versatile_template_package.01.10.2022 3.10.11.zip, template manifest01.10.2022 3.10.11), and everything below is measured against it. Every Joomla 3 class call is gone (211 → 0), the template options use Joomla’s own on/off switches and colour pickers, every template setting written into the page is escaped, desktop pages are 1170 px wide instead of the fixed 960 px page, the text is a size larger and darker, and there is a new phone layout with a slide-out menu and a row of fingertip-sized buttons. Joomla 6’s Bootstrap 5 replaces the template’s Bootstrap 2; the template’s own markup keeps its Bootstrap 2 classes and renders through a compatibility stylesheet. The Camera slideshow stays. Template files: 248 → 235, with 11 added, 24 removed and 27 modified. The template version is now 6.2.0, matching the Joomla version it ships with.Added
Bootstrap 5 rendering through a compatibility stylesheet
index.phpandcomponent.phpload Joomla 6’s bundled Bootstrap 5 (/media/vendor/bootstrap/css/bootstrap.min.css) in place of the template’s own Bootstrap 2 sheet (css/bootstrap.css).- New
css/bs2-bs5-bridge.css(canonical revision2026-11-16.168), linked last in the page head. It lets Versatile’s Bootstrap 2 markup render correctly on Bootstrap 5:- Bootstrap 2 grid:
.row-fluid/.spanNwidths and gutters, nested spans and phone stacking of every column; the Bootstrap 2 responsive utilities (hidden-phone,visible-desktopand the rest). - Joomla 4+ icon classes (pagination arrows, the password eye and others) mapped to Font Awesome 6 glyphs; the Smart Search field is the same height as its buttons.
- The desktop drop-down menu waits a moment before it closes, so the pointer can cross from an item to its 2nd, 3rd, 4th and 5th level panels; a panel closes at once only when you move to one of its neighbours, as the Joomla 3 menu script did, and it stays above the module row below it while it waits.
- One Versatile block,
versatile-std-20261103: the phone layout, the slideshow band, the menu-bar search, the breadcrumb bar, the text sizes and colours, the galleries, buttons and the other rules below.
- Bootstrap 2 grid:
- New
js/cs-jq-compat.js: restores the jQuery 1.x calls that Joomla 6’s jQuery 3.7 removed but the bundled Camera slideshow still uses. - Font Awesome 6.5.2 (
all.min.css+v4-shims.min.cssfrom cdnjs) on the front end; existingfa fa-*class names keep working through the shims.
New phone layout
- Phones now get a phone layout. The old page was a fixed-width desktop page that a phone drew and shrank. On phones the logo, content, side modules and footer each sit 16 px in from the edges, every column stacks to the screen width, and nothing scrolls sideways.
- The logo and slogan sit on the same 16 px inset with the slogan under the logo (the old layout drew the logo over the slogan), and the slideshow sits right under the header without the empty blue band.
- New
js/cs-mobile-generic.js. On phones (up to 767 px) a menu button beside the logo opens the top menu as a slide-out panel. It is filled in the template’s blue (rgb(30, 81, 121)) with white bars. - A phone button row of 44×44 px buttons in the same blue: Section menu, Log in, Register, Search and Follow us (the social links). Each opens its own panel; tapping outside an open panel closes it.
- Section menu opens the sidebar’s Main Menu, followed by the menus that belong to the page you are on, under their own headings. On phones the sidebar copy of the Main Menu is hidden, so the same links do not show twice.
- The menu, search, social and section panels open below the menu button, so it never covers a panel’s first row. Opening a panel dims the page below the button row only.
- The footer stacks and centres on phones. Login fields use 16 px text on phones, so iPhones no longer zoom the page in when you tap them.
Favicon
- New Favicon tab in the template options (fieldset
faviconsettings, fieldsfaviconandfavicontool, field classfields/favicontool.php). Pick one image, crop a square from it, and the template builds the icon set (a multi-size.icoand PNG icons from 32 to 512 px, including the 180 px Apple touch icon) and prints the matching tags in the page head (phFaviconSet(),phIcoBytes()inindex.php). With thanks to Gianluca, whose favicon question inspired this tool. - 10 new language strings (
TPL_VERSATILE_FAVICON_*,TPL_VERSATILE_FAVICONTOOL_*): the template’s language file goes from 62 to 72 strings.
Template Options screen
- 25 colour settings now use a colour picker (Coloris:
fields/colorpicker.php,js/coloris.min.js,css/coloris.min.css). They were plain text boxes with the oldjscolorcolour changer. - New
fields/adminui.php: help rows in the options run the full width of the form, and the template’s Details panel follows Joomla’s light or dark admin theme. - The icons in the template description load again:
templateDetails.xmlpointed at Font Awesome on MaxCDN, which no longer serves it; it now uses Font Awesome 6.5.2 from cdnjs. - Template options: 7 → 8 tabs, 122 → 126 fields; 20 fields added and 16 retired (below).
Modern social network support
- Eight new social services, each with its own URL field and show/hide switch: Instagram, Threads, Bluesky, Mastodon, YouTube, TikTok, Pinterest and Discord.
- The Twitter slot is now X (formerly Twitter) with the X logo (
fa-x-twitter). The full set is X, Facebook, Instagram, Threads, Bluesky, Mastodon, LinkedIn, YouTube, TikTok, Vimeo, Pinterest, Discord and RSS (13), drawn as Font Awesome 6 glyphs, each with a screen-reader label.
Module style and module lists
- New
html/layouts/chromes/vmdefault.php: the module style the template’s modules ask for, carrying the template’s own box markup, so the side and content boxes keep their artwork and padding. Joomla 4+ reads module styles only fromhtml/layouts/chromes/and ignores the Joomla 3html/modules.phpthey used to live in. - New
html/mod_articles_latest/default.phpon the Joomla 6 layout: the Latest News list prints the module’s class suffix again, so the template’s list styles (latestnews_menu,latestnews_menu_light) apply. Joomla 6’s own layout drops the suffix. Article titles in the list are escaped.
Changed
Joomla 6 platform
- Built for Joomla 6.2.0 (previous download: Joomla 3 only), with no need for Joomla’s Backward Compatibility plugin.
templateDetails.xml: version01.10.2022 3.10.11→6.2.0, creation date29/11/2012→2026-11-16, and the version shown in the template description is6.2.0 (2026-11-16).method="upgrade"is kept, so an existing install updates in place.
Page width and slideshow
- Desktop pages are 1170 px wide on wide screens, like every current Energize Themes template; the template had a fixed 960 px page.
- The slideshow keeps the photo’s own shape at the wider width (386 px tall at 1170 px; it was 316 px), and the blue band behind it grows with it, so the menu still sits 20 px below the slide.
- The breadcrumb bar keeps its 52 px height, and third-level fly-out menus open 12 px clear of their parent list.
Text
- Body and menu text is one size larger and darker, for easier reading. Content text is 13 px (was 12) in a darker grey (
#555555, was#6b6b6b); the top menu is 15 px, drop-down items 14 px and the sidebar menus 13 px, all#6b6b6b(was#9c9c9c, 2.7:1 on white), with hover still darker. Footer links are darker too. - Headings keep their size. The text size is the template’s Text Font Size option, now 13 px by default.
J3 → J6 API migration
- 211 Joomla 3 static class calls in the old template → 0. Each moved to its namespaced Joomla 4+ form (
JText→Text,JRoute→Route,JHtml→HTMLHelper,JFactory→Factoryand the rest). - Heaviest files:
html/com_content/featured/default_item.php(31),html/com_content/category/blog_item.php(29),html/mod_login/default.php(20),html/com_content/article/default.php(20),html/com_content/archive/default_items.php(18). All 19 PHP overrides carried over from the old template changed. - The article overrides build their links with Joomla 4+’s
RouteHelperinstead of Joomla 3’sContentHelperRoute(19 → 0). - Joomla 3
JHtmlbehaviour calls:behavior.framework(MooTools, removed in Joomla 4) is gone;behavior.keepalivestays.
Template options (administrator)
- 32 on/off settings that were legacy
class="switch" type="checkbox"fields are now Joomla’sradioswitcher (for examplelogoLinked,H1TitleImgText,H2TitleImgText, the social…ONswitches,cam_turnOn,cam_autoAdvance). The template has no legacy checkboxes left.
Defaults for a fresh install
- The slogan links to the home page, like the logo, and the home link is
/on a site installed at the domain root, where it used to be an empty link to the current page. - The site name / logo links to the home page and the built-in slideshow is switched on, with autoplay on desktop and phones (
logoLinked,cam_turnOn,cam_autoAdvance,cam_mobileAutoAdvancedefault to on intemplateDetails.xml; as checkboxes they had no default, so a fresh install had them off). Existing sites keep their saved settings.
Search
- Joomla 5 removed the old Search component and module, so the template’s
html/mod_searchoverride is gone. The search position in the menu bar takes Joomla’s Smart Search box: the field and its Search button are one height (28 px) inside the bar, and below 1200 px the button shows only its magnifier so the field keeps its room.
Menus, scripts and fonts
- The desktop drop-down menus are driven by CSS instead of the Superfish / Supersubs scripts.
- The slideshow loads
jquery.easing.1.3.jsandcamera.min.jsonly;jquery.mobile.customized.min.js, which throws under Joomla 6’s jQuery, is no longer loaded. component.phploads its Google web font from a direct stylesheet link withpreconnecthints instead of theWebFontConfigloader script, and the new error page is drawn inside the template’s own page.- The html5shiv script,
selectivizr-min.js,modernizr.jsandimgSizer.jsare no longer loaded, and the 8 Internet Explorer conditional comments inindex.phpare gone.
Print view
component.php(print views and pop-ups) has a viewport tag so it fits a phone, and loads Bootstrap 5, then the template’s stylesheets, then the compatibility stylesheet, so the template’s own colours and styles apply.
Look
- Photo gallery pages (Park Site > Photo Gallery > Animals and Scenery) show every photo at one size (300 px, 4:3) on the same left edge, and full width on phones, instead of small mixed thumbnails.
- On the login page the show password eye sits inside the password field in a dark grey you can see (8:1 on the white field), and the “Remember me” box is centred on its label.
- The gradient on the template’s buttons fills the whole button.
Fixed
Pages that failed on Joomla 4+
- Error pages:
error.phpusedJError, so on Joomla 4 and later the error page itself failed and every “page not found” became a 500. “Page not found” and “access denied” pages now show inside the template’s own page, with the site’s header, menus and phone navigation, a viewport tag and the compatibility stylesheet. Server errors (5xx) use Joomla’s plain system page. - Error pages and server details: an error caused by a missing item no longer prints the server’s file paths and a technical trace, and a missing article answers with the proper 404 page.
- Article pages on Joomla 6: the “Read more” label called
Text::sprintf('COM_CONTENT_READ_MORE_TITLE')with no title, which stops the page on Joomla 6 (2 → 0). The overrides now useJGLOBAL_READ_MORE/JGLOBAL_READ_MORE_TITLE.
Page layout
- Module positions:
index.phpchose its rows and columns with Joomla 3 expressions such ascountModules('top-1 or top-2 …')(19 of them). Joomla 4+ reads each as a single position name, so the test always failed and whole rows of modules did not show. Each position is now checked on its own (19 → 0). - Blog and featured rows: the blog and featured overrides counted their rows from Joomla 3’s article numbering. Joomla 4+ numbers the intro articles from 0, so in a multi-column blog an article could start no row and the next row began half-way along. Rows are now counted as they are printed.
- Drop-down menus: second to fifth level menu items stay open long enough to reach and click on the first hover; an open panel no longer slips under the module row below the menu while the pointer moves into it.
Maintenance pass
- The
@font-facerules incss/template.csspointing at Joomla 3’smedia/jui/fonts/IcoMoon font, which Joomla 4 removed, are switched off. - Pagination arrows: Joomla 4+’s
icon-angle-left/-right/-double-left/-double-rightbuttons had no glyph in the template’s icon CSS; they now show Font Awesome 6 arrows. - The template version in
templateDetails.xmland the version shown in its description now match the release. - With thanks to Michael Mullan, whose Expression bug report led to this maintenance pass across our templates.
Removed
Files removed (24)
- Bootstrap 2:
css/bootstrap.cssandjs/bootstrap.min.js. Joomla 6’s Bootstrap 5 and the compatibility stylesheet take their place. - Internet Explorer files:
css/ie.css,css/ie6.css,js/selectivizr-min.jsandjs/modernizr.js. - Old jQuery and MooTools scripts (
js/12 → 6 files):superfish.js,supersubs.js,jquery.mobile.customized.min.js,imgSizer.js, and the MooTools scriptstipz.jsandparallax.js, which nothing loaded. - The unused
css/responsive.cssandcss/slideshow.css, which nothing loaded. html/modules.php(Joomla 3 module chrome functions; the style the template uses is nowhtml/layouts/chromes/vmdefault.php), thehtml/mod_search/override (2 files) for the search module Joomla 5 removed, and a strayhtml/com_content/category/blog_item.zip.utils/admin-js.js(a Joomla 3-era admin script for the old checkbox switches) and the oldutils/js_colourchanger/colour picker (jscolor.jsand its four images).
Retired settings (16 fields)
- Five social slots removed with their switches: Google+, MySpace, StumbleUpon, Digg and Blogger.
- The settings that went with the old drop-down menu script (
dropheight,dropwidth,dropopacity,dropspeed,dropdownhandler1) and the old colour changer (colours_handlers).
Security
- Output helpers added at the top of
index.php. Every template setting written into the page is escaped or validated for where it lands:phEsc()(29 calls): HTML text and attributes.phRichText()(3): the site-name and slogan fields, which may contain simple markup. Joomla’s input filter keeps the markup but strips scripts, styles, iframes andon*event handlers.phCssToken()(49),phCssDim()andphCssNum()(1 each): colours, sizes and other values written into the page’s CSS. A setting likered;}body{background:url(//x)can no longer rewrite the page’s styles.phJsStr()andphJsLit()(11 each): values written into the slideshow’s inline JavaScript.
- Raw
echo $this->params->get(…)output inindex.php: 86 → 2 occurrences. The two left are on purpose: Header Custom Code (headcode) and Footer Custom Code (footercode) still print exactly what an administrator enters, because they exist to add scripts and HTML to the page. - The logo and slogan
alttext is escaped instead of the raw field, module and article titles printed by the overrides are escaped, and the menu overrides escape the menu’s link attributes. - The 13 social links open with
rel="noopener". The error page escapes the message it prints and casts the error code to a number. - Every PHP file in the template stops unless Joomla loads it (
_JEXECcheck): 28 of 28 files.
Quickstart Installer
Replaces the previous download’s Joomla 3 quickstart (an Akeeba
.jpaarchive restored with Kickstart): a complete Joomla 6.2.0 site with Versatile 6.2.0 pre-configured as the active template, set up as on the demo.- Bundled extensions: Akeeba Backup Core 10.5.0, StageIt 6.6.4, Web Links 5.2.1 and the en-GB language pack 6.2.0.1.
- Search is Joomla’s Smart Search (the old Search component and module are gone), and its index is built (155 items), so the site search returns results from the first visit.
- Search-engine-friendly URLs are on: pages open as
index.php/<page>instead ofindex.php?option=…, as on the other Energize Themes templates. - The footer copyright year is current, the contact’s missing image is cleared, and the photo galleries use the sample data’s full-size pictures. The sample article photos are 440 px versions, so they fill a phone’s column.
- Joomla updates follow the normal update channel (the Joomla 3 site was set to “next”, which offers the next major version), and the database carries no migration leftovers.
Package format
- Standalone template: now a Joomla package,
pkg_versatile-6.2.0.zip(pkg_versatile.xml), that installs the Versatile template (tpl_versatile.zip) and registers it in the package manager. It declaresmethod="upgrade", so an existing Versatile updates in place, and<blockChildUninstall>true</blockChildUninstall>, so the template is removed through the package rather than on its own. - Quickstart bundle: the complete Joomla 6.2.0 site described above.
Earlier history and version numbering: the previous download was the Joomla 3 package dated 01.10.2022 (3.10.11). From 6.2.0 the first three digits of the template version match the Joomla release it is built for; a later fix on the same Joomla release adds a fourth digit (6.2.0.1).