Wat is het en hoe maak je een nieuw taalpakket?
In een standaard installatie van Cotonti, alle teksten zijn in het Engels. Engels wordt veel gebruikt, maar is niet altijd geschikt voor je site.
Deze teksten kunnen veranderd worden via de taalbestanden.
Er zijn al verschillende taalpakketten beschikbaar voor Cotonti. Bekijk http://www.cotonti.com/locales/.
Elke verse van Cotonti gebruikt zijn eigen taalbestanden.
Elke taal heeft zijn eigen 2-karakter ISO taalcode. Bijvb. Engels: en ; Russisch: ru ; Duits: de ; Nederlands: nl ; …
Deze code wordt gebruikt in elk taal-bestande. Bijvb. Xxxx.en.lang.php, Xxxx.ru.lang.php, ...
Er zijn verschillende soorten taalbestanden welke zich op verschillende plaatsen bevinden. In onderstaande lijst kan je lang_code veranderen in de 2-karakter ISO taalcode van een taal.
| /lang | Deze folder bevat meest gebruikte en core taalbestanden. Elke taal heeft zijn eigen folder naar zijn code genoemd. Bijvb. /lang/en/ | |
| /lang/lang_code/admin.lang_code.lang.php | administratie backend taalstrings | |
| /lang/lang_code/countries.lang_code.lang.php | namen van landen | |
| /lang/lang_code/main.lang_code.lang.php | meest gebruikte woorden | |
| /lang/lang_code/message.lang_code.lang.php | service boodschappen | |
| /lang/lang_code/translit.lang_code.lang.php | voor de talen, andere dan Engels, het kan een tabel bevatten voor het omzetten van de ene naar de andere taal | |
| /lang/lang_code/users.lang_code.lang.php | gebruiker gerelateerde taalstrings | |
| /modules/ext_name/lang/ext_name.lang_code.lang.php | bevat taalstrings voor de module | |
| /plugins/plugin_name/lang/plugin_name.lang_code.lang.php | bevat taalstrings voor de plugin | |
| /themes/theme_name/theme_name.lang_code.lang.php | bevat taalstrings voor het thema | |
| /images/smilies/lang/lang_code.lang.js | bevat taalstrings voor de smilies |
Een voorbeeld van Main.en.lang.php
<?php
/**
* English Language File (main.lang.php)
*
* @package Cotonti
* @version 0.9.0
* @author Cotonti Translators Team
* @copyright Copyright (c) Cotonti Team 2008-2011
* @license BSD
*/
defined('COT_CODE') or die('Wrong URL.');
/**
* Main strings
*/
$L['Access'] = 'Access';
$L['Action'] = 'Action';
$L['Active'] = 'Active';
$L['Activity'] = 'Activity';
$Ls['Guests'] = array('guests','guest');
Het eerste gedeelte is de algemene info over het bestand.
Onder “defined('COT_CODE') or die('Wrong URL.');” kan je de taalstrings vinden.
Voor “=” kan je de strings terugvinden die gebruikt wordt in de .tpl bijvb. {PHP.L.Access}. Deze string in de tpl zal vervangen worden door de tekst na “=”.
Soms zie je array na ‘=’, dit betekent dat de engine zal beslissen a.d.h.v. bepaalde parameters welke tekst bij neemt uit de rij. Zoals in het voorbeeld hierboven, of het meervoud is of niet.
Er zijn 2 manieren om de taal de veranderen van je site.
- Verander de taal in de gebruiker zijn eigen profile. Dit zal enkel de taal veranderen voor de gebruiker zelf.
- Verander de taal in /datas/config.php
$cfg['defaultlang'] = 'en'; // Default language code
Dit zal de taal veranderen voor alle gasten en alle nieuw geregistreerde gebruikers.
Er is een aanpassing mogelijk in het adminmenu om de taal te forceren voor alle gebruikers.
http://yoursite.com/admin.php?m=config&n=edit&o=core&p=locale
- Kopieer alle taalbestanden en verander de 2-karakters ISO taalcode naar de taal die je wil maken (Voor de locatie van de bestanden, zie hierboven)
- Vertaal alle teksten na “=” tussen de aanhalingstekens. Verander niet de tekst voor “=”, of the strings worden onbruikbaar.