Help Desk Software

Knowledgebase
Back to HESK.com > HESK Knowledgebase > Knowledgebase

Search help:


How do I translate HESK?

Solution

» The short version:

  • Text used by HESK is located in file language/en/text.php

  • Email templates are inside language/en/emails/

  • Settings help files are inside language/en/help_files/

  • As of version 2.4 encoding must be set to UTF-8 and files must be saved as UTF-8 without byte order mark (BOM).

  • When translated the language is installed on the admin Settings page.

 

» A Step-by-step guide:

  1. Go to the language folder and copy en folder into a new one, for example named fr (for French).

  2. Inside the new folder open text.php file with a text editor.

    Do NOT use Notepad or Wordpad in Windows as they do not save UTF-8 files correctly (without BOM)!

    Use a more powerful text editor, such as your website editor or the free Notepad++.

  3. Translate all lines containing text. You may translate only the right side of each line, for example:

    $hesklang['DO_NOT_CHANGE_THIS']='TRANSLATE WORDS HERE';

    When translating make sure to:

    • keep the line format: single quotes (') around each phrase and lines must end with a semi-colon (;)

    • if you use single quotes in the words escape them with a backslash (\).
      WRONG: can't
      CORRECT: can\'t

    • do not change special codes such as %s and %d as they are used by HESK

    • Language name is stored in variable
      $hesklang['LANGUAGE']='English';

      For example when translating to French change it to:
      $hesklang['LANGUAGE']='Francais';

    • The character encoding used must remain UTF-8, other encodings will not work correctly:
      $hesklang['ENCODING']='UTF-8';


  4. Save changes to the text.php file

  5. Translate all the text files inside emails folder (language/fr/email).

  6. Upload the new language folder to the server, for example to:
    http://www.domain.com/hesk/language/fr

  7. Open text.php file in your browser to check syntax, for example:
    http://www.domain.com/hesk/language/fr/text.php

    If everything is OK you should get a message saying "No syntax errors detected in /text.php".

    If you get any errors then the PHP syntax is wrong. The error should give you line number with error, check syntax around that line; make sure all lines end with ";" and quotes are escaped with \'

  8. Login to your HESK administration panel and go to Settings.

  9. Is your new language listed under Language Settings > Default Language?

    If yes, the language has been installed properly. You can make it the HESK default language by choosing it and clicking the Save Changes button at the bottom of the Settings page.

    If no, something is wrong. Clicking the Test language folder link and it will list all the folders located in the language folder and reason why the language isn't installed.

  10. To finish language install don't forget to click the Save Changes button at the bottom of the settings page!

  11. Test HESK with the new language and make sure it works OK.

 

If you want to allow your customers to choose a language from all the installed HESK languages, enable the Multiple languages setting (set it to YES). If you provide support in one (default) language only, leave it disabled (set it to NO).

If you translate HESK to your language, please share it with others on the forum:
HESK support and developer forum (username: php password: php)

 
Was this article helpful? yes / no
Related articles How do I install translations (languge packs)?
How do I customize HESK text?
How to customize email subjects
Where can I get HESK translations (language packs)?
How can I modify emails sent by HESK?
Article details
Article ID: 34
Category: Customization & Integration
Rating (Votes): Article rated 3.8/5.0 (267)

 
« Go back

 
Powered by Help Desk Software HESK, brought to you by SysAid

Help Desk Software