This page contains general and specific instructions on how to translate DNS Manager.
General advice
Translate only the text on the right of the equal sign.
Make sure you do not translate keywords. This can accidentally happen if you use the Search and Replace All function available in most text editors.
Escape single quotes.
If the text contains single quotes, you must insert a backslash (\) in front of the quote, like in this example: 'Don\'t forget to escape single quotes in this text.'
Do not translate template fields.
The language files also contain some special elements called template fields. They come in the form of text surrounded by braces ({template filed}). These fields are automatically replaced by context–specific information. Below is an example of a language file entry containing a template field:
$msg_arr['java_send_ok'] = 'The email was sent to {mail}.';
In the DNS Manager interface, this entry can be displayed as: The email was sent to John Smith..
Deleting or even modifying these template fields will result in incomplete phrases being displayed in the DNS Manager interface and may cause undesired behavior.
Use a text editor with PHP error checking capabilities.
It is essential that the language interface file does not contain PHP syntax errors. To make sure that the translated file is valid, you can use a text editor that can check the PHP code and find errors. There are many editors with this capability, on a commercial as well as freeware, shareware or open-source basis. One example is jEdit, a free and powerful text editor. The PHP parser function can be installed as a plug-in.
Translate the interface language file
If you want to translate the interface language file only, follow these steps:
- Get the language pack component files in English.
- Translate the interface language file.
- Compile the language pack.
- Install the language pack.
- Distribute the language pack.
The standard DNS Manager distribution comes with a couple of scripts that help you create and install language packs. These scripts can be found at <DNSMANAGER_ROOT_D>/bin/utils/.
Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 4.0 International.