/usr/share/awl/inc/Translation.php is in libawl-php 0.57-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 | <?php
/**
* Functions involved in translating with gettext
* @package awl
* @subpackage Translation
* @author Andrew McMillan <andrew@mcmillan.net.nz>
* @copyright Catalyst IT Ltd
* @license http://gnu.org/copyleft/gpl.html GNU GPL v2 or later
*/
if ( !function_exists('i18n') ) {
/**
* Mark a string as being internationalized. This is a semaphore method; it
* does nothing but it allows us to easily identify strings that require
* translation. Generally this is used to mark strings that will be stored
* in the database (like descriptions of permissions).
*
* AWL uses GNU gettext for internationalization (i18n) and localization (l10n) of
* text presented to the user. Gettext needs to know about all places involving strings,
* that must be translated. Mark any place, where localization at runtime shall take place
* by using the function translate().
*
* In the help I have used 'xlate' rather than 'translate' and 'x18n' rather than 'i18n'
* so that the tools skip this particular file for translation :-)
*
* E.g. instead of:
* print 'TEST to be displayed in different languages';
* use:
* print xlate('TEST to be displayed in different languages');
* and you are all set for pure literals. The translation teams will receive that literal
* string as a job to translate and will translate it (when the message is clear enough).
* At runtime the message is then localized when printed.
* The input string can contain a hint to assist translators:
* print xlate('TT <!-- abbreviation for Translation Test -->');
* The hint portion of the string will not be printed.
*
* But consider this case:
* $message_to_be_localized = 'TEST to be displayed in different languages';
* print xlate($message_to_be_localized);
*
* The translate() function is called in the right place for runtime handling, but there
* is no message at gettext preprocessing time to be given to the translation teams,
* just a variable name. Translation of the variable name would break the code! So all
* places potentially feeding this variable have to be marked to be given to translation
* teams, but not translated at runtime!
*
* This method resolves all such cases. Simply mark the candidates:
* $message_to_be_localized = x18n('TEST to be displayed in different languages');
* print xlate($message_to_be_localized);
*
* @param string the value
* @return string the same value
*/
function i18n($value) {
return $value; /* Just pass the value through */
}
}
if ( !function_exists('translate') ) {
/**
* Convert a string in English to whatever this user's locale is
*/
if ( function_exists('gettext') ) {
function translate( $en ) {
if ( ! isset($en) || $en == '' ) return $en;
$xl = gettext($en);
dbg_error_log('I18N','Translated =%s= into =%s=', $en, $xl );
return $xl;
}
}
else {
function translate( $en ) {
return $en;
}
}
}
if ( !function_exists('init_gettext') ) {
/**
* Initialise our use of Gettext
*/
function init_gettext( $domain, $location ) {
if ( !function_exists('bindtextdomain') ) return;
bindtextdomain( $domain, $location );
$codeset = bind_textdomain_codeset( $domain, 'UTF-8' );
textdomain( $domain );
dbg_error_log('I18N','Bound domain =%s= to location =%s= using character set =%s=', $domain, $location, $codeset );
}
}
if ( !function_exists('awl_set_locale') ) {
/**
* Set the translation to the user's locale. At this stage all we do is
* call the gettext function.
*/
function awl_set_locale( $locale ) {
global $c;
if ( !is_array($locale) && ! preg_match('/^[a-z]{2}(_[A-Z]{2})?\./', $locale ) ) {
$locale = array( $locale, $locale.'.UTF-8');
}
if ( !function_exists('setlocale') ) {
dbg_log_array('WARN','No "setlocale()" function? PHP gettext support missing?' );
return;
}
if ( $newlocale = setlocale( LC_ALL, $locale) ) {
dbg_error_log('I18N','Set locale to =%s=', $newlocale );
$c->current_locale = $newlocale;
}
else {
dbg_log_array('I18N','Unsupported locale: ', $locale, false );
}
}
}
|