* existing PHP installation and implements fallback functions when required
* functions are not available. Scripts in functions/ directory should not
* setup anything when they are loaded.
- * @copyright © 1999-2009 The SquirrelMail Project Team
+ *
+ * @copyright 1999-2017 The SquirrelMail Project Team
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
* @version $Id$
* @package squirrelmail
/**
* Wrapper for textdomain(), bindtextdomain() and
* bind_textdomain_codeset() primarily intended for
- * plugins when changing into their own text domain
+ * plugins when changing into their own text domain
* and back again.
*
- * Note that if plugins using this function have
+ * Note that if plugins using this function have
* their translation files located in the SquirrelMail
* locale directory, the second argument is optional.
*
- * @param string $domain_name The name of the text domain
- * (usually the plugin name, or
- * "squirrelmail") being switched to.
- * @param string $directory The directory that contains
+ * @param string $domain_name The name of the text domain
+ * (usually the plugin name, or
+ * "squirrelmail") being switched to.
+ * @param string $directory The directory that contains
* all translations for the domain
* (OPTIONAL; default is SquirrelMail
* locale directory).
*
* @return string The name of the text domain that was set
* *BEFORE* it is changed herein - NOTE that
- * this differs from PHP's textdomain()
+ * this differs from PHP's textdomain()
*
- * @since 1.5.2 and 1.4.10
+ * @since 1.4.10 and 1.5.2
*/
function sq_change_text_domain($domain_name, $directory='') {
-
- static $domains_already_seen = array();
global $gettext_domain;
+ static $domains_already_seen = array();
+
$return_value = $gettext_domain;
- // empty domain defaults to "squirrelmail"
- //
+ // empty domain defaults to "squirrelmail"
+ //
if (empty($domain_name)) $domain_name = 'squirrelmail';
- // only need to call bindtextdomain() once
+ // only need to call bindtextdomain() once
//
if (in_array($domain_name, $domains_already_seen)) {
sq_textdomain($domain_name);
* @since 1.4.10 and 1.5.1
* @param string $domain gettext domain name
* @param string $dir directory that contains all translations (OPTIONAL;
- * if not specified, defaults to SquirrelMail locale
+ * if not specified, defaults to SquirrelMail locale
* directory)
* @return string path to translation directory
*/
$dir=bindtextdomain($domain,$dir);
// set codeset in order to avoid gettext charset conversions
- if (function_exists('bind_textdomain_codeset')
+ if (function_exists('bind_textdomain_codeset')
&& isset($languages[$sm_notAlias]['CHARSET'])) {
// Japanese translation uses different internal charset
* (LC_ALL, LC_COLLATE, LC_CTYPE, LC_MONETARY, LC_NUMERIC, LC_TIME)
* @param mixed $locale option contains array with possible locales or string with one locale
* @return string name of set locale or false, if all locales fail.
- * @since 1.5.1 and 1.4.5
- * @see http://www.php.net/setlocale
+ * @since 1.4.5 and 1.5.1
+ * @see http://php.net/setlocale
*/
function sq_setlocale($category,$locale) {
if (is_string($locale)) {
if (preg_match("/^.*\/.*\/.*\/.*\/.*\/.*$/",$ret)) {
/**
* Welcome to We-Don't-Follow-Own-Fine-Manual department
- * OpenBSD 3.8, 3.9-current and maybe later versions
+ * OpenBSD 3.8, 3.9-current and maybe later versions
* return invalid response to setlocale command.
* SM bug report #1427512.
*/
* @param string $charset
* @param string $string Text to be decoded
* @param boolean $force_decode converts string to html without $charset!=$default_charset check.
- * Argument is available since 1.5.1 and 1.4.5.
- * @param boolean $save_html disables htmlspecialchars() in order to preserve
- * html formating. Use with care. Available since 1.5.1
+ * Argument is available since 1.4.5 and 1.5.1.
+ * @param boolean $save_html disables sm_encode_html_special_chars() in order to preserve
+ * html formating. Use with care. Available since 1.4.6 and 1.5.1
* @return string decoded string
*/
function charset_decode ($charset, $string, $force_decode=false, $save_html=false) {
// Don't do conversion if charset is the same.
if ( ! $force_decode && $charset == strtolower($default_charset) )
- return ($save_html ? $string : htmlspecialchars($string));
+ return ($save_html ? $string : sm_encode_html_special_chars($string));
// catch iso-8859-8-i thing
if ( $charset == "iso-8859-8-i" )
// other charsets can be converted to utf-8 without loss.
// and output string is smaller
$string = recode_string($charset . "..utf-8",$string);
- return ($save_html ? $string : htmlspecialchars($string));
+ return ($save_html ? $string : sm_encode_html_special_chars($string));
} else {
$string = recode_string($charset . "..html",$string);
- // recode does not convert single quote, htmlspecialchars does.
+ // recode does not convert single quote, sm_encode_html_special_chars does.
$string = str_replace("'", ''', $string);
// undo html specialchars
if ($save_html)
// iconv functions does not have html target and can be used only with utf-8
if ( $use_php_iconv && $default_charset=='utf-8') {
$string = iconv($charset,$default_charset,$string);
- return ($save_html ? $string : htmlspecialchars($string));
+ return ($save_html ? $string : sm_encode_html_special_chars($string));
}
// If we don't use recode and iconv, we'll do it old way.
/* All HTML special characters are 7 bit and can be replaced first */
- if (! $save_html) $string = htmlspecialchars ($string);
+ if (! $save_html) $string = sm_encode_html_special_chars ($string);
/* controls cpu and memory intensive decoding cycles */
if (! isset($aggressive_decoding) || $aggressive_decoding=="" ) {
/**
* Converts html string to given charset
- * @since 1.5.1 and 1.4.4
+ * @since 1.4.4 and 1.5.1
* @param string $string
* @param string $charset
- * @param boolean $htmlencode keep htmlspecialchars encoding
+ * @param boolean $htmlencode keep sm_encode_html_special_chars encoding
* @return string
*/
function charset_encode($string,$charset,$htmlencode=true) {
*
* If conversion is done to charset different that utf-8, unsupported symbols
* will be replaced with question marks.
- * @since 1.5.1 and 1.4.4
+ * @since 1.4.4 and 1.5.1
* @param string $in_charset initial charset
* @param string $string string that has to be converted
* @param string $out_charset final charset
- * @param boolean $htmlencode keep htmlspecialchars encoding
+ * @param boolean $htmlencode keep sm_encode_html_special_chars encoding
* @return string converted string
*/
function charset_convert($in_charset,$string,$out_charset,$htmlencode=true) {
/**
* Makes charset name suitable for decoding cycles
*
- * @since 1.5.0 and 1.4.4
+ * ks_c_5601_1987, x-euc-* and x-windows-* charsets are supported
+ * since 1.4.6 and 1.5.1.
+ *
+ * @since 1.4.4 and 1.5.0
* @param string $charset Name of charset
* @return string $charset Adjusted name of charset
*/
* @param string $content_type The content type being served currently (OPTIONAL;
* if not specified, defaults to whatever the template
* set that is in use has defined).
- *
* @return int function execution error codes.
*
*/
-function set_up_language($sm_language, $do_search=false,
- $default=false, $content_type='') {
+function set_up_language($sm_language, $do_search = false, $default = false,
+ $content_type = '') {
static $SetupAlready = 0;
- global $use_gettext, $languages, $oTemplate,
- $squirrelmail_language, $squirrelmail_default_language, $default_charset,
- $sm_notAlias, $username, $data_dir;
+ global $use_gettext, $languages, $squirrelmail_language,
+ $squirrelmail_default_language, $default_charset, $sm_notAlias,
+ $username, $data_dir, $oTemplate;
if ($SetupAlready) {
return;
/**
* If function is asked to detect preferred language
- * OR squirrelmail default language is set to empty string
+ * OR SquirrelMail default language is set to empty string
* AND
- * squirrelmail language ($sm_language) is empty string
+ * SquirrelMail language ($sm_language) is empty string
* (not set in user's prefs and no cookie with language info)
* AND
* browser provides list of preferred languages
/**
* If language preference is not set OR script asks to use default language
* AND
- * default squirrelmail language is not set to empty string
+ * default SquirrelMail language is not set to empty string
* THEN
- * use default squirrelmail language value from configuration.
+ * use default SquirrelMail language value from configuration.
*/
if ((!$sm_language||$default) &&
! empty($squirrelmail_default_language)) {
* mbstring.func_overload fix (#929644).
*
* php mbstring extension can replace standard string functions with their multibyte
- * equivalents. See http://www.php.net/ref.mbstring#mbstring.overload. This feature
+ * equivalents. See http://php.net/ref.mbstring#mbstring.overload. This feature
* was added in php v.4.2.0
*
* Some SquirrelMail functions work with 8bit strings in bytes. If interface is forced
}
/**
- * Sets default_charset variable according to the one that is used by user's translations.
+ * Sets default_charset variable according to the one that is used by user's
+ * translations.
*
- * Function changes global $default_charset variable in order to be sure, that it
- * contains charset used by user's translation. Sanity of $squirrelmail_language
- * and $default_charset combination is also tested.
+ * Function changes global $default_charset variable in order to be sure, that
+ * it contains charset used by user's translation. Sanity of
+ * $squirrelmail_language and $default_charset combination provided in the
+ * SquirrelMail configuration is also tested.
*
* There can be a $default_charset setting in the
* config.php file, but the user may have a different language
switch ($default_charset) {
case "windows-1251":
if ( $input_charset == "iso-8859-5" ||
- $input_charset == "koi8-r" ||
- $input_charset == "koi8-u" ) {
+ $input_charset == "koi8-r" ||
+ $input_charset == "koi8-u" ) {
return true;
} else {
return false;
}
/**
- * Array specifies the available translations.
+ * This array specifies the available translations.
*
* Structure of array:
* $languages['language']['variable'] = 'value'
* ALTNAME - Native translation name. Any 8bit symbols must be html encoded.
* LOCALE - Full locale name (in xx_XX.charset format). It can use array with more than one locale name since 1.4.5 and 1.5.1
* DIR - Text direction. Used to define Right-to-Left languages. Possible values 'rtl' or 'ltr'. If undefined - defaults to 'ltr'
- * XTRA_CODE - translation uses special functions. See http://www.squirrelmail.org/docs/devel/devel-3.html
+ * XTRA_CODE - translation uses special functions. See http://squirrelmail.org/docs/devel/devel-3.html
*
* Each 'language' definition requires NAME+CHARSET or ALIAS variables.
*