You have strange text on your page after upgrading

 
Introduction
 
This scenario addresses a common issue that users experience after upgrading.
 
After an upgrade you may see new areas in your Jomres pages, but instead of a string like "Advanced site config" you see something like _JOMRES_COM_ADVANCED_SITE_CONFIG.
 
This is not a bug, it's caused by the normal operation of the system and here we'll show you how to fix it, but first a little explanation.
 
Background
 
Jomres uses language files with code in them to define the language strings, these definitions look something like
 
 
define('_JOMRES_COM_ADVANCED_SITE_CONFIG','Advanced site config');
 
 
As new functionality is added to Jomres, language strings are added to the end of the existing language files (this makes them easy for translators to find so they can add the strings to their own versions of the language files).
 
HOWEVER, Jomres also has a feature where if a new property type is created, then the current language's file (eg 'de-DE.php') is copied to a sub directory so that it can be used instead of the original. So, if you've created a new property type called "Mountain Villas" while editing the site in the German language, then Jomres will create a subdirectory in the /jomres/language folder called 'mountainvillas' and copy de-DE.php into that directory. This is useful because you can have language strings that are only applicable to mountain villa type properties, for example.
 
Now, when you upgrade Jomres, only the default language files are overwritten, those in /jomres/language, /jomres/language/campsite /jomres/language/propertyrental, /jomres/language/vehiclerental and /jomres/language/yachtbrokerage. If there are other files, they are not updated. This means that any other language files will have the new definitions missing from the end of the file. We do it this way because if we tried to automatically upgrade your customised language file there's a danger that you'll lose any customisations that you made and that would be a bad thing.
 
How to bring your files up to date
 
You now will need to use ftp and navigate to the /jomres/language directory and identify any files that weren't overwritten during the upgrade. Open /jomres/language/en-GB.php in a text editor, and scroll to the bottom to find the new language definitions. Now open your un-updated language file (for example, /jomres/language/mountainvillas/de-DE.php) in your text editor, and scroll to the bottom of that too. If you compare the two you'll see the new definitions in the /jomres/language/en-GB.php, all you need to do is copy the new definitions from the /jomres/language/en-GB.php to /jomres/language/mountainvillas/de-DE.php and save that file.
 
At this point, if you're using a language other than English, you'll probably want to translate the content of those defines to suit your own language.
 
Now just save the language file and that's it, you're done.
 
 
This document is copyright Vince Wooll/Woollyinwales IT, 2011. All rights reserved.