Jomres User Manual

Sidebar

Login Form

Remember Me
  • Forgot your username?
  • Forgot your password?
  • Home
  • Installation and Upgrading
  • Site Manager's Guide
  • Property Manager's Guide
  • Developer's Guide
  1. You are here:  
  2. Home
  3. Developer's Guide
  4. Customising Jomres

Customising Jomres


Here we will discuss ways that you can modify Jomres to suit your own requirements.

 

Jomres, whilst it works fine 'out of the box' should nevertheless be seen as a toolkit. It has been designed to be easily edited by everybody from your basic designer who's strengths are layout and design only, the part-time coder who can modify a few lines of code to achieve what they want, to the full developer who wants to build plugins either to extend their system or offer plugins to other users (either for free for for a fee).

 

So, you want to modify how Jomres works? Before you do, read this :

If you would like to edit some of the core Jomres functionality, for a large part this can be done easily in a way that is upgrade safe (i.e. will not be overwritten by an upgrade of Jomres). Many techniques are discussed at length in other manual pages, but to summarise :

  • If you want to customise a file with the naming pattern of jnnnnnxxxxx.class.php you can do so by first copying it to a /jomres/remote_plugins/xxxxx (e.g. /jomres/remote_plugins/custom_code) subfolder and then using the "Rebuild Registry" feature in the administrator area of Jomres. When you do this Jomres will use the copied file, instead of the one in the /jomres/core-minicomponents directory, so you can edit that file at your leisure. Jomres will not overwrite this copy of that file when you upgrade.
  • If you rename a Jomres minicomponent, to modify it's functionality, it's important to not only rename the file. For example if you have a minicomponent called j00005tom.class.php, and you want to rename it to j00005dick.class.php, you must also change the class name and the constructor to j00005dick too, in the file itself. (Note, later versions of Jomres plugins will not include a constructor called something like j0005dick as this isn't compatible with PHP7, however you may be working on older files that do retain this structure)
  • If you want to copy a minicomponent (for example so that you've got a backup while you edit another version of that file) do not simply rename it to something like j00005harry_backup.class.php. Instead rename it to xj00005harry.class.php, otherwise Jomres will try to run that script as it follows the naming pattern it's expecting, and this could result in unpredictable behaviour.
  • If you want to customise one of the classes found in /jomres/libraries/jomres/classes, then again first copy it to a  /jomres/remote_plugins/xxxxx subdirectory and rebuild the registry. Jomres' class import functionality will use that instead so you should make changes to that copy, not the original. Jomres will not overwrite this copy of that file when you upgrade.
  • If you want to change any of the Jomres template files, we strongly advise you to use the Template Overrides feature. If you install the Leohtian template then you will see that there are already files in /templates/jr_leohtian/com_jomres/html directory. If Leohtian is updated then these files are overwritten, so if you intend to customise those files too your best bet is to create a Template Override Package.
  • If you want to change the language strings/lables used, you can edit a language file, but before you do that we would encourage you to first use the Label Translations feature. This can be used even if you are not using multiple languages, if you simply want to reword one string from another. Again, changes are saved to the database so if you upgrade, your customisations are not lost. All language strings can be edited through the Label Translations and Translate Language File Strings menu options in the administrator area.

 

List of articles in category Customising Jomres
Title
Including script content in another template

Subcategories

Editing Code

Editing labels / languages

Language files

Customising templates/layout

Back to Jomres.net

Collapse All | Expand All | Toggle All
  • Intro
    • About Jomres
    • Conventions and Assumptions
    • Glossary
    • Content Management System integration
    • Jomres Platform
  • Video Tutorials
    • All Video Tutorials
  • Installation and Upgrading
    • Requirements
    • Jomres Quickstart
    • Where can I download the Quickstart from?
    • Installation into Joomla - Install from Web
    • Installation into Wordpress - Install from Web
    • Uninstallation
    • Installing/Updating to the Nightly branch
    • Joomla Quickstart Installation
    • Wordpress Quickstart Installation
    • Updating
      • Updating on Joomla
      • Updating on Wordpress
  • Site Manager's Guide
    • Introduction
    • Searching in Jomres
    • Live Scrolling (the Property List page)
    • Multi-language sites
    • Agents
    • Viewing error logs
    • Beds24 V2 plugin (migration from Beds24v1)
    • Channel Management (Beds24)
    • Language configuration
    • Jomres and the GDPR
    • User Profiles
    • Search Widgets
    • Property Approvals
    • Getting Started
      • Relationships
      • First Steps
      • Monetising your installation
      • Enabling front end access to Jomres
      • Users in Jomres
      • Google Maps API Key
    • Core Plugins
      • Joomla Menu Maker
      • Addthis Sharing
      • Advanced/Micromanage Tariff Editing Modes
      • Ajax Search
      • Ajax Search Composite
      • Asamodule Popular
      • Asamodule Random
      • Asamodule Recently Viewed
      • Auction House
      • Black Bookings
      • Book Guest In Out
      • Booking Enquiries
      • Bypass Confirmation
      • Cleaning Schedule
      • Clone Property
      • Clone Tariffs
      • Comments tabs disqus
      • Commission
      • Common Template Variables
      • Contact In Sidebar
      • Contact Page in Tabs
      • Core Gateway Cheque
      • Core Gateway Paypal
      • Coupons
      • CSV Export
      • Custom Fields
      • Custom Global Strings
      • Custom Property Fields
      • Data Wipe
      • Default Property Settings
      • Embed Booking Form
      • Exchange Rate Conversion Selector
      • Extended Maps
      • Extended Sorting
      • External Notification
      • Featured Listings
      • Featured Listings asaModule 1
      • Featured Listings asaModule 2
      • Featured Listings Slider 1
      • Featured Listings Slider 2
      • flipwall
      • Frontend in Backend
      • Funky Search Country
      • Funky Search Features
      • Guest Types
      • iDev Affiliates
      • internal_api
      • Jintour
      • jQuery Calendar asaModule
      • Lastminute Config Tab
      • Local Events
      • Location Map
      • Location Map Regions
      • Location Map Sitemap
      • Location Station
      • Lucky Dip
      • Magic Menu
      • Minimum Occupancies
      • My Shortlist
      • Nearest Properties Functions
      • Optional Extras
      • Partners
      • Popular Properties
      • Powered By Gone
      • Property Inna Module
      • Property List With Maps
      • Property Type Search Tabs
      • QR Code Vcard
      • Random Review Inna Module
      • Resource Features
      • Shopping Cart
      • Shopping Cart Module
      • SMS Clickatell
      • Stepz
      • Subscriptions
      • Tag Cloud
      • Useful links
      • Wiseprice config tab
      • Alternative Init
      • Jomres Booking Form In Content
      • Jomres Ajax Search Contentwrapper
      • Jomres asaModule
      • Jomres Asamodule Mambot
      • Module Jomsearch M1/M2/M3/M4
      • Jomres Selfregister
      • Twitter
      • ASAModule Resources
      • Manager cleaner
      • Number of Properties
      • Show Room Calendar
      • Tourist Tax
      • Weather
      • Property Details Standalone Map
      • Example Custom Common Strings
      • Jomres Selfregister Asamodule
      • Last Active
      • Mega Menu Utility Scripts
      • Property List Swipe
      • Featured Listings asaModule 3
      • Property Import Plugin
      • Embed Availability Calendar
      • Jomres Charts
      • Jomres iCal plugin
      • Property List Compact
      • DeepL plugin for Jomres
    • Control Panel
      • Main
        • Control Panel
        • Your Properties
        • Jomres Plugin Manager
        • Control Panel
        • Your Properties
        • Our Partners
        • Plugin Manager
        • Site Configuration
          • Site Configuration - Misc tab
          • Site Configuration - Booking form tab
          • Site Configuration - Your Business Details tab
          • Site Configuration - Commission tab
          • Site Configuration - Currency Conversion/Currency Codes tab
          • Site Configuration - Debugging tab
          • Site Configuration - Email settings tab
          • Site Configuration - File Uploads tab
          • Site Configuration - Google Map Options tab
          • Site Configuration - Input Filtering tab
          • Site Configuration - Integrated Search Feature tab
          • Site Configuration - JS Calendar tab
          • Site Configuration - Navigation Bar Settings tab
          • Site Configuration - reCaptcha tab
          • Site Configuration - Search Options tab
          • Site Configuration - Reviews tab
          • Compatability Mode switch - Site Config - Portal functionality tab
      • Developer Tools
        • Shortcodes - Developer tool
        • Booking data archive
        • Changelog
        • Data Wipe
        • Default Property Settings
        • Custom fields
        • Available Logs
        • Common Strings
        • Custom Property Fields
      • Help
        • Getting Started
        • Manual
        • My Account
        • Tickets
        • About Jomres
      • Income Generation
        • Assign Commission Rates
        • Invoices
        • List Commission Rates
        • Subscription Packages
        • Subscriptions
      • Integration
        • Disqus Settings
        • Edit External Notification
        • External Notification Transactions
        • iDev Affiliates
        • Jomres Clickatell settings
      • Languages
        • Export Definitions
        • Global Strings
        • Label Translations
        • Translate Language File Strings
        • Translate Locales
      • Payment Methods
        • Core Gateway Stripe
        • Gateways
        • Core Gateway Paypal
      • Portal Functionality
        • Ajax search composite settings
        • Extended Maps
        • External form
        • Featured Listings
        • Tour/Activity Management
        • What to do locally
        • What's Happening?
        • Local Events Settings
        • Location Station
        • Reviews
        • Useful links settings
        • Location Station
      • Reports/Statistics
        • CSV Export
        • Statistics
      • Scheduled Tasks
        • Cron job settings and logs
      • Site Structure
        • Clone property
        • Room/Resource types
        • Property/Business features
        • Business Features Categories
        • Property types
        • Resource Features
        • List Countries
        • Edit region
        • Media Centre (Feature and Room type images)
        • Site Structure 101
        • Property Import
      • System Maintenance
        • Access control
        • Rebuild Registry
        • Upgrades
      • Taxes
        • Tax rates
      • User Management
        • Property Managers
        • Partners
  • Property Manager's Guide
    • Getting Started
      • Before we start
      • How prices are calculated
      • Adding users
      • Fine tuning your system
    • Your Toolbar
      • Editing mode
      • Dashboard
        • Dashboard
        • Legacy Dashboard
      • Account Details
        • Log In
        • Log out
        • Edit Account
      • Bookings
        • New Booking
        • Black bookings
        • Simple Booking
        • Edit Booking
        • List Bookings
        • Jomres iCal
        • No Shows
      • Guests
        • New Guest
        • List Guests
      • Invoices
        • List Invoices
      • Misc
        • Cleaning schedule
        • Embed booking form
        • Auction House
      • Properties
        • List Properties
        • New Property
        • Delete Property
        • Preview
      • Reports
        • Statistics
      • Search
        • Add this page to a Joomla menu
        • Wordpress - Search by property name
      • Settings
        • Other Property Information
        • Property Details
        • Email Templates
        • Tariffs and Rooms
        • Guest types
        • Discount Coupons
        • Extras admin
        • Media Centre
        • Room/Resource features
        • Tour/Activity Management
        • Rooms
        • Clone Tariffs
        • Minimum Occupancies
        • Child Policies
        • Occupancy Levels
        • Tariffs
          • Normal Tariff Editing mode
          • Micromanage Tariff Editing mode
          • Advanced Tariff Editing mode
          • Standard Tariff Editing mode
        • Property Configuration
          • Booking Form
          • Bookings
          • Your Business Details
          • Gateways
          • Property Details page settings
          • Supplements
          • SMS
          • Tariff Configuration Mode
          • Tariffs and Currency
          • Micromanage
          • Wiseprice (or) Lastminute
  • Developer's Guide
    • Hints and Tips
    • Bookings not made when paid through Paypal
    • What is the Jomres Syndication Network?
    • TypeError: jomresJquery.fn.tipsy is undefined jomres.js
    • Introduction
      • Minicomponents
      • Registry
    • Customising Jomres
      • Including script content in another template
      • Editing Code
        • Editing the core Jomres code
        • Changing the order of property details tabs
        • Removing a tab from the property details page
      • Editing labels / languages
        • Plugin language files
        • Editing Mode
        • How to edit a gateway name
        • Language files
          • You have strange text on your page after upgrading
      • Customising templates/layout
        • Editing Templates
        • Template Override Packages
        • Basic Template Overrides
        • Make your own template override package
        • Identifying individual templates
    • Shortcodes
      • Shortcodes
      • Using Shortcodes to list properties with specific features
      • Shortcodes in Joomla Modules
    • Other Discussions
      • The Jomres License
      • Using Jomres as an appointment or slot booking application
      • Javascript Conflicts
      • Remote Access of the calendar
      • The Booking Engine
      • Memory and Performance
      • Pseudocron jobs
      • Alpha Beta and Release Candidate versions
      • Developing Tips and Tricks
      • I want to modify a plugin
      • Media Centre aide memoire
      • Language specific templates
      • Performance - Recommended settings
      • Logging in Jomres
      • FAQ modifications
      • JCH Optimize
      • Jomres Trigger system
      • Hello World Simple
      • Max Input Vars (max_input_vars in php.ini)
      • Beds24/Jomres no longer syncing
      • Jomres framework and Encryption/Decryption
      • PHP Updates and Ioncube encoded files
      • Migrate from Joomla to Wordpress
      • You see a SHA EMPTY message on your site
      • encryption_key.class.php
      • Payment Gateways
        • Gateway Aide Memoire
        • Debugging payment gateways
    • Jomres API
      • Using Postman to access the API
      • Creating Clients
      • Communicating with the Jomres API
      • Creating your own API plugins
      • API method description
      • API Sandbox
      • REST API & Webhook case study
      • Using the REST API in your own software
      • Wordpress : API TEST page says I have to move files
    • Webhooks
      • Webhooks Introduction
      • Webhook Methods
      • Creating Webhooks
      • Webhooks - Anatomy of a webhook plugin
    • Channel Management Framework
      • Creating a new property with the CMF REST API
      • Users, Managers and Channels in the CMF
      • Channel Manager Framework - Alpha & Beta testing
      • The CMF plugins - an overview
      • Using Jomres2jomres to create your own network of properties
      • Can Jomres be used with my Channel Manager or Property Management System?
      • Using the Rentals United thin plugin
  • Non-Jomres content
    • DeepL Machine Translation Tool for Joomla