Download JEvents
In JEvents 2.0+ you should take a look at the layout editing tool first - this allows you to customise your event detail and list pages without needing to do any PHP coding.
You want to customise one of the layouts provided by JEvents but don't want these changes to be lost when you upgrade. This is a very brief guide - if you want more general information about template overrides then I'd recommend you search for joomla template overrides in a search engine.
Basic Changes
Lets assume you want to customise the year list view of the Geraint layout.
- Create a folder called html (if it doesn't already exist in your template folder) e.g. templates/ja_purity/html
- Create a sub folder called com_jevents e.g. templates/ja_purity/html/com_jevents
- Create a sub folder called geraint e.g. templates/ja_purity/html/com_jevents/geraint
- Create a sub folder called year e.g. templates/ja_purity/html/com_jevents/geraint/year
- Copy the file listevents_body.php from the com_jevents layout folder to this new folder
- Change this copy as you want (remember to clear your cache)
Joomla should use this copy in preference to the core JEvents component file from now on and you won't loose these changes if you upgrade JEvents
Module overrides
You want to customise the latest events module: e.g. Create an override for a latest events module. You must create the override file as templates/YOURTEMPLATE/html/mod_jevents_latest/YOURLAYOUT/latest.php e.g. templates/beez_20/html/mod_jevents_latest/geraint/latest.php
with this content
<?php
/**
* copyright (C) 2013 GWE Systems Ltd - All rights reserved
*/
// Check to ensure this file is included in Joomla!
defined('_JEXEC') or die();
/**
* HTML View class for the module frontend
*
* @static
*/
include_once(JPATH_SITE."/modules/mod_jevents_latest/tmpl/geraint/latest.php");
class OverrideGeraintModLatestView extends GeraintModLatestView
{
function displayLatestEvents(){
return parent::displayLatestEvents();
} // end of function
} // end of class
Then customise the layout as you want
More Advanced Changes
You want to customise the stylesheets or images.
Follow setps 1-3 above and then
- Create a folder called assets/css or assets/images within this folder e.g. templates/ja_purity/html/com_jevents/geraint/assets/css
- Put your modified stylesheet or image in this folder
Serious Changes
You realise you need to change or add a helper function (e.g. the iconic navigation bar)
Follow steps 1-2 from "basic changes"then
- create a sub folder called helpers
- copy the helper file e.g. defaultviewnavtablebariconic.php to this folder
- modify as required
Geraint
