CB Language projects¶
Community Builder has its own CB Language plugin framework that supports front-end and back-end translations.
A single CB language plugin handles both ends of the translation.
A complete CB Language plugin will also support (front-end) translations of CB Team released add-ons (the ones shown on this page:
http://www.joomlapolis.com/cb-solutions/add-ons
Creating a CB Language Plugin for CB 2.0¶
The following steps should be followed:
- Get the latest CB English Language template plugin from here
- Unzip it and then rename its en-GB.xml file to your language locale code (e.g., el-GR.xml for Greek)
- Edit your new locale.xml (e.g., el-GR.xml) file with your text editor
- Find the
<name>en-GB</name>
line and change it to match your language (e.g., el-GR for Greek).
WARNING - You should only have 5 characters here (including the dash) - Find the
<description>....</description>
line and change it as you wish. - Find the
<filename plugin="en-GB">language.php</filename>
line and change it to match your language (e.g., el-GR for Greek). - Save the modified language.xml file
- Using your text editor edit each one of the admin_language.php and language.php files to prepare your translation. In the admin_language.php and language.php files just edit the second part of the line to translate (keep the first part intact). Do not rename the actual filenames!
- Follow the same process for all files in the cbplugin folder.
- Save these files utf-8 encoded without BOM.
- Repackage as a zip and you have your CB 2.0 language package.
WARNING - If you are on a MACOS environment you need to make sure that your zip file does not contain the _MACOX folder as is may cause problems with plugin installation
A properly prepared language package will install using the CB Plugin Manager in CB 2.0+ and will work with your Joomla 2.5+ and Joomla 3.3+ language environments.
Creating a CB Language Plugin for CB 1.9¶
The following steps should be followed:
- Get the latest CB English Language template plugin from here
- Unzip it and open its language.xml file with your text editor
- Find the
<name>en-GB</name>
line and change it to match your language (e.g., el-GR for Greek).
WARNING - You should only have 5 characters here (including the dash) - Find the
<description>Provides the English language for Community Builder 1.7 core functions.</description>
line and change it as you wish. - Save the modified language.xml file
- Using your text editor edit each one of the admin_language.php, calendar-locals.js, cbteamplugins_language.php and language.php files to prepare your translation. In the admin_language.php and cbteamplugins_language.php files just edit the second part of the line to translate (keep the first part intact). Also in the calendar-locals.js translate the relevant strings in double quotes. Do not rename the actual filenames!
- Save these files utf-8 encoded without BOM.
- Repackage as a zip and you have your CB 1.8 language package.
WARNING - If you are on a MACOS environment you need to make sure that your zip file does not contain the _MACOX folder as is may cause problems with plugin installation
A properly prepared language package will install using the CB Plugin Manager in CB 1.8 and will work with your Joomla 1.5.x, 1.6.x, 1.7.x and Joomla 2.5.x language environments.
WARNING: The above instructions do not include filename renaming! The filenames should continue to keep the string 'language' in them!