Template Editing

 
General description
 
This feature allows you to edit your jomres frontend html templates and css stylesheet, and save the template changes in the database (for technical reasons the css changes are saved to /jomres/temp). This way, when you upgrade Jomres, your custom templates and css will be kept. All changes are saved in the #__jomres_custom_templates table in your database.
 
Usage
 
Click on the 'Template editing' button in your Jomres control panel and you`ll be taken to a new screen. Here you can see your listed your jomrescss.css (originally located in /jomres/css) and all html files that are part of the jomres frontend template (files originally located in /jomres/templates/jomres/frontend).
 
The table has 5 columns.
 
The first is the name of the template.
The second tells you if your template has been customised or not (which version is active, the one on the disk or the one saved in the database).
The third column tells you when was the last time the template on the disk was modified. This date usually changes after an upgrade, when the templates are overwritten.
The fourth column contains the date when your custom template saved in database was last modified.
The fifth column is where the warnings show up. If there is an icon against a template, then Jomres has detected that the template stored in the database may be older than that stored on disk, in which case it is possible that the template has been updated in a newer version of Jomres. If this is the case, then it is possible that your template may not be benefiting from a new feature in Jomres, or that existing functionality may no longer work as expected, and you should compare the file on disk to your customisations to ensure that you are not missing out on new features.
 
Creating/Editing a custom template
 
  1. Click on the file name you want to edit and you`ll be taken to a new screen where you can see an editor
  2. Make the desired changes. This manual will not help you learn html or css, so if you need help with this, please search Google.
  3. Save your changes by hitting the 'Submit' button above the editor. You will be returned to the previous screen and you can see that the template has been saved ('Template modified' is now 'Yes') and last modified date has been updated.
  4. Go to the Jomres frontend to see your changes in action.
 
Deleting a custom template
 
If you find you've made a lot of changes to a template and have found that you want to restore the original template, use this delete function to do it. It will remove the record from the custom templates table and Jomres will start using the default template on the server's disk.
 
  1. Click on the template filename you want to delete from the database.
  2. In the editing screen, click on the trash can icon. When returning to the templates list, you`ll see that 'Template modified' is now 'No'. This means that the template on the disk is active from now on.
  3. Go to the frontend to check if everything is ok.
 
Final notes
Template editing is an advanced feature, so be careful with it. If you don`t have html or css knowledge, it`s better that you don`t use this feature at all.
 
If you do, however, want to edit your Jomres templates, we strongly advise you to not edit the templates in the /jomres/templates/frontend directory, and instead use this feature.
 
 
This document is copyright Vince Wooll/Woollyinwales IT, 2011. All rights reserved.