THE LANG DIRECTORY

What is the lang directory?

This directory is designed to help multi-language versions of DWmail.

Currently it only has the english language definitions, however feel free
to create your own

###########################################################################
CREATING YOUR OWN LANGUAGE SETS

To create your own language file for DWmail, create a directory within
this one with the ISO 639-1 language code for your desired language.

See: http://www.loc.gov/standards/iso639-2/englangn.html

E.g. for English the ISO code is 'en'

Then take a copy of the files in the 'en' directory as your base template
and put them in your new language directory.

Edit the variables and arrays in each of the files to your language

Do not change the array keys for the variables but feel free to change the
values to your language.

You should then add your language set to the $AvailLangs array in the
config.inc.php file in your 'includes' directory.  The name of the language
in the $AvailLangs array should be able to be read by the default languages
characterset as the default language is always displayed on the login page.

Important Note: DWmail has NOT been tested with multibyte charactersets
e.g. JIS, SJIS

Single byte character sets such as ISO-8859-*, EUC-JP, UTF-8, etc should
all work fine within DWmail

###########################################################################
TESTING YOUR OWN LANGUAGE SETS

There is quite a simple way to test if you have translated all of the text
and variable you should have done by loading the base English language pack
before your local language pack.

This will show up any missed words or phrases in English insead of your
local language.  This is especially useful if converting a language pack
from an earlier version of DWmail to the current version

An example of how to do this in mailbox.php:

Before the lines
require ("./lang/" . strip_tags(str_replace("..", "", trim($_SESSION['DefaultLang']))) . "/global.inc.php");
require ("./lang/" . strip_tags(str_replace("..", "", trim($_SESSION['DefaultLang']))) . "/mailbox.inc.php");

Simply add
require ("./lang/en/global.inc.php");
require ("./lang/en/mailbox.inc.php");

###########################################################################
OFFICIAL LANGUAGE SETS

At this time DWmail only ships with a UK English 'en' language set

If you wish to consider your own language set to be added to the shipped
version of DWmail your langage file must be an accurate translation of the 
standard English character set and must be a word for word translation
(accepting, of course, changes in the structure between languages).

Please submit a support ticket with details on your language extension.

We will of course add credit in the language files you create with
your selection of your name and/or your email address and/or your
website address

Please note we may not accept all submissions as official language sets

The boiler plate copyright notice header text for your own language pack
can be found in this directory and is called TEMPLATEHEADER.txt and goes
at the top of each language PHP file.  See the English language headers
to see what to put where.
###########################################################################
