functions/i18n.php

   1 <?php
   2
   3 /**
   4  * SquirrelMail internationalization functions
   5  *
   6  * Copyright (c) 1999-2004 The SquirrelMail Project Team
   7  * Licensed under the GNU GPL. For full terms see the file COPYING.
   8  *
   9  * This file contains variuos functions that are needed to do
  10  * internationalization of SquirrelMail.
  11  *
  12  * Internally the output character set is used. Other characters are
  13  * encoded using Unicode entities according to HTML 4.0.
  14  *
  15  * @version $Id$
  16  * @package squirrelmail
  17  * @subpackage i18n
  18  */
  19
  20 /** Everything uses global.php... */
  21 require_once(SM_PATH . 'functions/global.php');
  22
  23 /**
  24  * Converts string from given charset to charset, that can be displayed by user translation.
  25  *
  26  * Function by default returns html encoded strings, if translation uses different encoding.
  27  * If Japanese translation is used - function returns string converted to euc-jp
  28  * If iconv or recode functions are enabled and translation uses utf-8 - function returns utf-8 encoded string.
  29  * If $charset is not supported - function returns unconverted string.
  30  *
  31  * sanitizing of html tags is also done by this function.
  32  *
  33  * @param string $charset
  34  * @param string $string Text to be decoded
  35  * @return string decoded string
  36  */
  37 function charset_decode ($charset, $string) {
  38     global $languages, $squirrelmail_language, $default_charset;
  39     global $use_php_recode, $use_php_iconv, $agresive_decoding;
  40
  41     if (isset($languages[$squirrelmail_language]['XTRA_CODE']) &&
  42         function_exists($languages[$squirrelmail_language]['XTRA_CODE'] . '_decode')) {
  43         $string = call_user_func($languages[$squirrelmail_language]['XTRA_CODE'] . '_decode', $string);
  44     }
  45
  46     $charset = strtolower($charset);
  47
  48     set_my_charset();
  49
  50     // Variables that allow to use functions without function_exist() calls
  51     if (! isset($use_php_recode) || $use_php_recode=="" ) {
  52       $use_php_recode=false; }
  53     if (! isset($use_php_iconv) || $use_php_iconv=="" ) {
  54          $use_php_iconv=false; }
  55
  56     // Don't do conversion if charset is the same.
  57     if ( $charset == strtolower($default_charset) )
  58           return htmlspecialchars($string);
  59
  60     // catch iso-8859-8-i thing
  61     if ( $charset == "iso-8859-8-i" )
  62               $charset = "iso-8859-8";
  63
  64     /*
  65      * Recode converts html special characters automatically if you use
  66      * 'charset..html' decoding. There is no documented way to put -d option
  67      * into php recode function call.
  68      */
  69     if ( $use_php_recode ) {
  70       if ( $default_charset == "utf-8" ) {
  71         // other charsets can be converted to utf-8 without loss.
  72         // and output string is smaller
  73         $string = recode_string($charset . "..utf-8",$string);
  74         return htmlspecialchars($string);
  75       } else {
  76         $string = recode_string($charset . "..html",$string);
  77         // recode does not convert single quote, htmlspecialchars does.
  78         $string = str_replace("'", '&#039;', $string);
  79         return $string;
  80       }
  81     }
  82
  83     // iconv functions does not have html target and can be used only with utf-8
  84     if ( $use_php_iconv && $default_charset=='utf-8') {
  85       $string = iconv($charset,$default_charset,$string);
  86       return htmlspecialchars($string);
  87     }
  88
  89     // If we don't use recode and iconv, we'll do it old way.
  90
  91     /* All HTML special characters are 7 bit and can be replaced first */
  92
  93     $string = htmlspecialchars ($string);
  94
  95     /* controls cpu and memory intensive decoding cycles */
  96     if (! isset($agresive_decoding) || $agresive_decoding=="" ) {
  97          $agresive_decoding=false; }
  98
  99     $decode=fixcharset($charset);
 100     $decodefile=SM_PATH . 'functions/decode/' . $decode . '.php';
 101     if (file_exists($decodefile)) {
 102       include_once($decodefile);
 103       $ret = call_user_func('charset_decode_'.$decode, $string);
 104     } else {
 105       $ret = $string;
 106     }
 107     return( $ret );
 108 }
 109
 110 /**
 111  * Converts html string to given charset
 112  * @param string $string
 113  * @param string $charset
 114  * @param boolean $htmlencode keep htmlspecialchars encoding
 115  * @param string
 116  */
 117 function charset_encode($string,$charset,$htmlencode=true) {
 118   global $default_charset;
 119
 120   // Undo html special chars
 121   if (! $htmlencode ) {
 122      $string = str_replace(array('&amp;','&gt;','&lt;','&quot;'),array('&','>','<','"'),$string);
 123   }
 124
 125   $encode=fixcharset($charset);
 126   $encodefile=SM_PATH . 'functions/encode/' . $encode . '.php';
 127   if (file_exists($encodefile)) {
 128     include_once($encodefile);
 129     $ret = call_user_func('charset_encode_'.$encode, $string);
 130   } else {
 131     $ret = $string;
 132   }
 133   return( $ret );
 134 }
 135
 136 /**
 137  * Combined decoding and encoding functions
 138  *
 139  * If conversion is done to charset different that utf-8, unsupported symbols
 140  * will be replaced with question marks.
 141  * @param string $in_charset initial charset
 142  * @param string $string string that has to be converted
 143  * @param string $out_charset final charset
 144  * @param boolean $htmlencode keep htmlspecialchars encoding
 145  * @return string converted string
 146  */
 147 function charset_convert($in_charset,$string,$out_charset,$htmlencode=true) {
 148   $string=charset_decode($in_charset,$string);
 149   $string=charset_encode($string,$out_charset,$htmlencode);
 150   return $string;
 151 }
 152
 153 /**
 154  * Makes charset name suitable for decoding cycles
 155  *
 156  * @param string $charset Name of charset
 157  * @return string $charset Adjusted name of charset
 158  */
 159 function fixcharset($charset) {
 160     // minus removed from function names
 161     $charset=str_replace('-','_',$charset);
 162
 163     // windows-125x and cp125x charsets
 164     $charset=str_replace('windows_','cp',$charset);
 165
 166     // ibm > cp
 167     $charset=str_replace('ibm','cp',$charset);
 168
 169     // iso-8859-8-i -> iso-8859-8
 170     // use same cycle until I'll find differences
 171     $charset=str_replace('iso_8859_8_i','iso_8859_8',$charset);
 172
 173     return $charset;
 174 }
 175
 176 /**
 177  * Set up the language to be output
 178  * if $do_search is true, then scan the browser information
 179  * for a possible language that we know
 180  *
 181  * Function sets system locale environment (LC_ALL, LANG, LANGUAGE),
 182  * gettext translation bindings and html header information.
 183  *
 184  * Function returns error codes, if there is some fatal error.
 185  *  0 = no error,
 186  *  1 = mbstring support is not present,
 187  *  2 = mbstring support is not present, user's translation reverted to en_US.
 188  *
 189  * @param string $sm_language translation used by user's interface
 190  * @param bool $do_search use browser's preferred language detection functions. Defaults to false.
 191  * @param bool $default set $sm_language to $squirrelmail_default_language if language detection fails or language is not set. Defaults to false.
 192  * @return int function execution error codes.
 193  */
 194 function set_up_language($sm_language, $do_search = false, $default = false) {
 195
 196     static $SetupAlready = 0;
 197     global $use_gettext, $languages,
 198            $squirrelmail_language, $squirrelmail_default_language,
 199            $sm_notAlias, $username, $data_dir;
 200
 201     if ($SetupAlready) {
 202         return;
 203     }
 204
 205     $SetupAlready = TRUE;
 206     sqgetGlobalVar('HTTP_ACCEPT_LANGUAGE',  $accept_lang, SQ_SERVER);
 207
 208     if ($do_search && ! $sm_language && isset($accept_lang)) {
 209         $sm_language = substr($accept_lang, 0, 2);
 210     }
 211
 212     if ((!$sm_language||$default) && isset($squirrelmail_default_language)) {
 213         $squirrelmail_language = $squirrelmail_default_language;
 214         $sm_language = $squirrelmail_default_language;
 215     }
 216     $sm_notAlias = $sm_language;
 217
 218     // Catching removed translation
 219     // System reverts to English translation if user prefs contain translation
 220     // that is not available in $languages array
 221     if (!isset($languages[$sm_notAlias])) {
 222       $sm_notAlias="en_US";
 223     }
 224
 225     while (isset($languages[$sm_notAlias]['ALIAS'])) {
 226         $sm_notAlias = $languages[$sm_notAlias]['ALIAS'];
 227     }
 228
 229     if ( isset($sm_language) &&
 230          $use_gettext &&
 231          $sm_language != '' &&
 232          isset($languages[$sm_notAlias]['CHARSET']) ) {
 233         bindtextdomain( 'squirrelmail', SM_PATH . 'locale/' );
 234         textdomain( 'squirrelmail' );
 235         if (function_exists('bind_textdomain_codeset')) {
 236           if ($sm_notAlias == 'ja_JP') {
 237             bind_textdomain_codeset ("squirrelmail", 'EUC-JP');
 238             } else {
 239               bind_textdomain_codeset ("squirrelmail", $languages[$sm_notAlias]['CHARSET'] );
 240             }
 241         }
 242         if (isset($languages[$sm_notAlias]['LOCALE'])){
 243           $longlocale=$languages[$sm_notAlias]['LOCALE'];
 244         } else {
 245           $longlocale=$sm_notAlias;
 246         }
 247         if ( !ini_get('safe_mode') &&
 248              getenv( 'LC_ALL' ) != $longlocale ) {
 249             putenv( "LC_ALL=$longlocale" );
 250             putenv( "LANG=$longlocale" );
 251             putenv( "LANGUAGE=$longlocale" );
 252         }
 253         setlocale(LC_ALL, $longlocale);
 254
 255         // Set text direction/alignment variables
 256         if (isset($languages[$sm_notAlias]['DIR']) &&
 257             $languages[$sm_notAlias]['DIR'] == 'rtl') {
 258           /**
 259            * Text direction
 260            * @global string $text_direction
 261            */
 262           $text_direction='rtl';
 263           /**
 264            * Left alignment
 265            * @global string $left_align
 266            */
 267           $left_align='right';
 268           /**
 269            * Right alignment
 270            * @global string $right_align
 271            */
 272           $right_align='left';
 273         } else {
 274           $text_direction='ltr';
 275           $left_align='left';
 276           $right_align='right';
 277         }
 278
 279         $squirrelmail_language = $sm_notAlias;
 280         if ($squirrelmail_language == 'ja_JP') {
 281             header ('Content-Type: text/html; charset=EUC-JP');
 282             if (!function_exists('mb_internal_encoding')) {
 283               // Error messages can't be displayed here
 284               $error = 1;
 285               // Revert to English if possible.
 286               if (function_exists('setPref')  && $username!='' && $data_dir!="") {
 287                 setPref($data_dir, $username, 'language', "en_US");
 288                 $error = 2;
 289               }
 290               // stop further execution in order not to get php errors on mb_internal_encoding().
 291               return $error;
 292             }
 293             if (function_exists('mb_language')) {
 294                 mb_language('Japanese');
 295             }
 296             mb_internal_encoding('EUC-JP');
 297             mb_http_output('pass');
 298         } else {
 299         header( 'Content-Type: text/html; charset=' . $languages[$sm_notAlias]['CHARSET'] );
 300     }
 301 }
 302     return 0;
 303 }
 304
 305 /**
 306  * Sets default_charset variable according to the one that is used by user's translations.
 307  *
 308  * Function changes global $default_charset variable in order to be sure, that it
 309  * contains charset used by user's translation. Sanity of $squirrelmail_default_language
 310  * and $default_charset combination provided in SquirrelMail config is also tested.
 311  *
 312  * There can be a $default_charset setting in the
 313  * config.php file, but the user may have a different language
 314  * selected for a user interface. This function checks the
 315  * language selected by the user and tags the outgoing messages
 316  * with the appropriate charset corresponding to the language
 317  * selection. This is "more right" (tm), than just stamping the
 318  * message blindly with the system-wide $default_charset.
 319  */
 320 function set_my_charset(){
 321     global $data_dir, $username, $default_charset, $languages, $squirrelmail_default_language;
 322
 323     $my_language = getPref($data_dir, $username, 'language');
 324     if (!$my_language) {
 325         $my_language = $squirrelmail_default_language ;
 326     }
 327     // Catch removed translation
 328     if (!isset($languages[$my_language])) {
 329       $my_language="en_US";
 330     }
 331     while (isset($languages[$my_language]['ALIAS'])) {
 332         $my_language = $languages[$my_language]['ALIAS'];
 333     }
 334     $my_charset = $languages[$my_language]['CHARSET'];
 335     if ($my_charset) {
 336         $default_charset = $my_charset;
 337     }
 338 }
 339
 340 /* ------------------------------ main --------------------------- */
 341
 342 global $squirrelmail_language, $languages, $use_gettext;
 343
 344 if (! isset($squirrelmail_language)) {
 345     $squirrelmail_language = '';
 346 }
 347
 348 /**
 349  * Array specifies the available translations.
 350  *
 351  * Structure of array:
 352  * $languages['language']['variable'] = 'value'
 353  *
 354  * Possible 'variable' names:
 355  *  NAME      - Translation name in English
 356  *  CHARSET   - Encoding used by translation
 357  *  ALIAS     - used when 'language' is only short name and 'value' should provide long language name
 358  *  ALTNAME   - Native translation name. Any 8bit symbols must be html encoded.
 359  *  LOCALE    - Full locale name (in xx_XX.charset format)
 360  *  DIR       - Text direction. Used to define Right-to-Left languages. Possible values 'rtl' or 'ltr'. If undefined - defaults to 'ltr'
 361  *  XTRA_CODE - translation uses special functions. See doc/i18n.txt
 362  *
 363  * Each 'language' definition requires NAME+CHARSET or ALIAS variables.
 364  *
 365  * @name $languages
 366  * @global array $languages
 367  */
 368 $languages['bg_BG']['NAME']    = 'Bulgarian';
 369 $languages['bg_BG']['ALTNAME'] = '&#1041;&#1098;&#1083;&#1075;&#1072;&#1088;&#1089;&#1082;&#1080;';
 370 $languages['bg_BG']['CHARSET'] = 'windows-1251';
 371 $languages['bg_BG']['LOCALE']  = 'bg_BG.CP1251';
 372 $languages['bg']['ALIAS'] = 'bg_BG';
 373
 374 $languages['ca_ES']['NAME']    = 'Catalan';
 375 $languages['ca_ES']['CHARSET'] = 'iso-8859-1';
 376 $languages['ca_ES']['LOCALE']  = 'ca_ES.ISO8859-1';
 377 $languages['ca']['ALIAS'] = 'ca_ES';
 378
 379 $languages['cs_CZ']['NAME']    = 'Czech';
 380 $languages['cs_CZ']['ALTNAME'] = '&#268;e&scaron;tina';
 381 $languages['cs_CZ']['CHARSET'] = 'iso-8859-2';
 382 $languages['cs_CZ']['LOCALE']  = 'cs_CZ.ISO8859-2';
 383 $languages['cs']['ALIAS']      = 'cs_CZ';
 384
 385 $languages['cy_GB']['NAME']    = 'Welsh';
 386 $languages['cy_GB']['ALTNAME'] = 'Cymraeg';
 387 $languages['cy_GB']['CHARSET'] = 'iso-8859-1';
 388 $languages['cy_GB']['LOCALE']  = 'cy_GB.ISO8859-1';
 389 $languages['cy']['ALIAS'] = 'cy_GB';
 390
 391 // Danish locale is da_DK.
 392 $languages['da_DK']['NAME']    = 'Danish';
 393 $languages['da_DK']['ALTNAME'] = 'Dansk';
 394 $languages['da_DK']['CHARSET'] = 'iso-8859-1';
 395 $languages['da_DK']['LOCALE']  = 'da_DK.ISO8859-1';
 396 $languages['da']['ALIAS'] = 'da_DK';
 397
 398 $languages['de_DE']['NAME']    = 'German';
 399 $languages['de_DE']['ALTNAME']    = 'Deutsch';
 400 $languages['de_DE']['CHARSET'] = 'iso-8859-1';
 401 $languages['de_DE']['LOCALE']  = 'de_DE.ISO8859-1';
 402 $languages['de']['ALIAS'] = 'de_DE';
 403
 404 $languages['el_GR']['NAME']    = 'Greek';
 405 $languages['el_GR']['ALTNAME'] = '&Epsilon;&lambda;&lambda;&eta;&nu;&iota;&kappa;&#940;';
 406 $languages['el_GR']['CHARSET'] = 'iso-8859-7';
 407 $languages['el_GR']['LOCALE']  = 'el_GR.ISO8859-7';
 408 $languages['el']['ALIAS'] = 'el_GR';
 409
 410 $languages['en_GB']['NAME']    = 'British';
 411 $languages['en_GB']['CHARSET'] = 'iso-8859-15';
 412 $languages['en_GB']['LOCALE']  = 'en_GB.ISO8859-15';
 413
 414 $languages['en_US']['NAME']    = 'English';
 415 $languages['en_US']['CHARSET'] = 'iso-8859-1';
 416 $languages['en_US']['LOCALE']  = 'en_US.ISO8859-1';
 417 $languages['en']['ALIAS'] = 'en_US';
 418
 419 $languages['es_ES']['NAME']    = 'Spanish';
 420 $languages['es_ES']['ALTNAME'] = 'Espa&ntilde;ol';
 421 $languages['es_ES']['CHARSET'] = 'iso-8859-1';
 422 $languages['es_ES']['LOCALE']  = 'es_ES.ISO8859-1';
 423 $languages['es']['ALIAS'] = 'es_ES';
 424
 425 $languages['et_EE']['NAME']    = 'Estonian';
 426 $languages['et_EE']['CHARSET'] = 'iso-8859-15';
 427 $languages['et_EE']['LOCALE']  = 'et_EE.ISO8859-15';
 428 $languages['et']['ALIAS'] = 'et_EE';
 429
 430 $languages['eu_ES']['NAME']    = 'Basque';
 431 $languages['eu_ES']['CHARSET'] = 'iso-8859-1';
 432 $languages['eu_ES']['LOCALE']  = 'eu_ES.ISO8859-1';
 433 $languages['eu']['ALIAS'] = 'eu_ES';
 434
 435 $languages['fo_FO']['NAME']    = 'Faroese';
 436 $languages['fo_FO']['CHARSET'] = 'iso-8859-1';
 437 $languages['fo_FO']['LOCALE']  = 'fo_FO.ISO8859-1';
 438 $languages['fo']['ALIAS'] = 'fo_FO';
 439
 440 $languages['fi_FI']['NAME']    = 'Finnish';
 441 $languages['fi_FI']['ALTNAME'] = 'Suomi';
 442 $languages['fi_FI']['CHARSET'] = 'iso-8859-1';
 443 $languages['fi_FI']['LOCALE']  = 'fi_FI.ISO8859-1';
 444 $languages['fi']['ALIAS'] = 'fi_FI';
 445
 446 $languages['fr_FR']['NAME']    = 'French';
 447 $languages['fr_FR']['ALTNAME'] = 'Fran&#231;ais';
 448 $languages['fr_FR']['CHARSET'] = 'iso-8859-1';
 449 $languages['fr_FR']['LOCALE']  = 'fr_FR.ISO8859-1';
 450 $languages['fr']['ALIAS'] = 'fr_FR';
 451
 452 $languages['hr_HR']['NAME']    = 'Croatian';
 453 $languages['hr_HR']['CHARSET'] = 'iso-8859-2';
 454 $languages['hr_HR']['LOCALE']  = 'hr_HR.ISO8859-2';
 455 $languages['hr']['ALIAS'] = 'hr_HR';
 456
 457 $languages['hu_HU']['NAME']    = 'Hungarian';
 458 $languages['hu_HU']['ALTNAME'] = 'Magyar';
 459 $languages['hu_HU']['CHARSET'] = 'iso-8859-2';
 460 $languages['hu_HU']['LOCALE']  = 'hu_HU.ISO8859-2';
 461 $languages['hu']['ALIAS'] = 'hu_HU';
 462
 463 $languages['id_ID']['NAME']    = 'Indonesian';
 464 $languages['id_ID']['ALTNAME'] = 'Bahasa Indonesia';
 465 $languages['id_ID']['CHARSET'] = 'iso-8859-1';
 466 $languages['id_ID']['LOCALE']  = 'id_ID.ISO8859-1';
 467 $languages['id']['ALIAS'] = 'id_ID';
 468
 469 $languages['is_IS']['NAME']    = 'Icelandic';
 470 $languages['is_IS']['ALTNAME'] = '&Iacute;slenska';
 471 $languages['is_IS']['CHARSET'] = 'iso-8859-1';
 472 $languages['is_IS']['LOCALE']  = 'is_IS.ISO8859-1';
 473 $languages['is']['ALIAS'] = 'is_IS';
 474
 475 $languages['it_IT']['NAME']    = 'Italian';
 476 $languages['it_IT']['CHARSET'] = 'iso-8859-1';
 477 $languages['it_IT']['LOCALE']  = 'it_IT.ISO8859-1';
 478 $languages['it']['ALIAS'] = 'it_IT';
 479
 480 $languages['ja_JP']['NAME']    = 'Japanese';
 481 $languages['ja_JP']['ALTNAME'] = '&#26085;&#26412;&#35486;';
 482 $languages['ja_JP']['CHARSET'] = 'iso-2022-jp';
 483 $languages['ja_JP']['LOCALE'] = 'ja_JP.EUC-JP';
 484 $languages['ja_JP']['XTRA_CODE'] = 'japanese_xtra';
 485 $languages['ja']['ALIAS'] = 'ja_JP';
 486
 487 $languages['ko_KR']['NAME']    = 'Korean';
 488 $languages['ko_KR']['CHARSET'] = 'euc-KR';
 489 $languages['ko_KR']['LOCALE']  = 'ko_KR.EUC-KR';
 490 $languages['ko_KR']['XTRA_CODE'] = 'korean_xtra';
 491 $languages['ko']['ALIAS'] = 'ko_KR';
 492
 493 $languages['lt_LT']['NAME']    = 'Lithuanian';
 494 $languages['lt_LT']['ALTNAME'] = 'Lietuvi&#371;';
 495 $languages['lt_LT']['CHARSET'] = 'utf-8';
 496 $languages['lt_LT']['LOCALE'] = 'lt_LT.UTF-8';
 497 $languages['lt']['ALIAS'] = 'lt_LT';
 498
 499 $languages['nl_NL']['NAME']    = 'Dutch';
 500 $languages['nl_NL']['ALTNAME'] = 'Nederlands';
 501 $languages['nl_NL']['CHARSET'] = 'iso-8859-1';
 502 $languages['nl_NL']['LOCALE']  = 'nl_NL.ISO8859-1';
 503 $languages['nl']['ALIAS'] = 'nl_NL';
 504
 505 $languages['ms_MY']['NAME']    = 'Malay';
 506 $languages['ms_MY']['ALTNAME'] = 'Bahasa Melayu';
 507 $languages['ms_MY']['CHARSET'] = 'iso-8859-1';
 508 $languages['ms_MY']['LOCALE']  = 'ms_MY.ISO8859-1';
 509 $languages['my']['ALIAS'] = 'ms_MY';
 510
 511 $languages['nb_NO']['NAME']    = 'Norwegian (Bokm&aring;l)';
 512 $languages['nb_NO']['ALTNAME'] = 'Norsk (Bokm&aring;l)';
 513 $languages['nb_NO']['CHARSET'] = 'iso-8859-1';
 514 $languages['nb_NO']['LOCALE']  = 'nb_NO.ISO8859-1';
 515 $languages['nb']['ALIAS'] = 'nb_NO';
 516
 517 $languages['nn_NO']['NAME']    = 'Norwegian (Nynorsk)';
 518 $languages['nn_NO']['ALTNAME'] = 'Norsk (Nynorsk)';
 519 $languages['nn_NO']['CHARSET'] = 'iso-8859-1';
 520 $languages['nn_NO']['LOCALE']  = 'nn_NO.ISO8859-1';
 521
 522 $languages['pl_PL']['NAME']    = 'Polish';
 523 $languages['pl_PL']['ALTNAME'] = 'Polski';
 524 $languages['pl_PL']['CHARSET'] = 'iso-8859-2';
 525 $languages['pl_PL']['LOCALE']  = 'pl_PL.ISO8859-2';
 526 $languages['pl']['ALIAS'] = 'pl_PL';
 527
 528 $languages['pt_PT']['NAME'] = 'Portuguese (Portugal)';
 529 $languages['pt_PT']['CHARSET'] = 'iso-8859-1';
 530 $languages['pt_PT']['LOCALE']  = 'pt_PT.ISO8859-1';
 531 $languages['pt']['ALIAS'] = 'pt_PT';
 532
 533 $languages['pt_BR']['NAME']    = 'Portuguese (Brazil)';
 534 $languages['pt_BR']['ALTNAME'] = 'Portugu&ecirc;s do Brasil';
 535 $languages['pt_BR']['CHARSET'] = 'iso-8859-1';
 536 $languages['pt_BR']['LOCALE']  = 'pt_BR.ISO8859-1';
 537
 538 $languages['ro_RO']['NAME']    = 'Romanian';
 539 $languages['ro_RO']['ALTNAME'] = 'Rom&acirc;n&#259;';
 540 $languages['ro_RO']['CHARSET'] = 'iso-8859-2';
 541 $languages['ro_RO']['LOCALE']  = 'ro_RO.ISO8859-2';
 542 $languages['ro']['ALIAS'] = 'ro_RO';
 543
 544 $languages['ru_RU']['NAME']    = 'Russian';
 545 $languages['ru_RU']['ALTNAME'] = '&#1056;&#1091;&#1089;&#1089;&#1082;&#1080;&#1081;';
 546 $languages['ru_RU']['CHARSET'] = 'utf-8';
 547 $languages['ru_RU']['LOCALE']  = 'ru_RU.UTF-8';
 548 $languages['ru']['ALIAS'] = 'ru_RU';
 549
 550 $languages['sk_SK']['NAME']    = 'Slovak';
 551 $languages['sk_SK']['CHARSET'] = 'iso-8859-2';
 552 $languages['sk_SK']['LOCALE']  = 'sk_SK.ISO8859-2';
 553 $languages['sk']['ALIAS'] = 'sk_SK';
 554
 555 $languages['sl_SI']['NAME']    = 'Slovenian';
 556 $languages['sl_SI']['ALTNAME'] = 'Sloven&scaron;&#269;ina';
 557 $languages['sl_SI']['CHARSET'] = 'iso-8859-2';
 558 $languages['sl_SI']['LOCALE']  = 'sl_SI.ISO8859-2';
 559 $languages['sl']['ALIAS'] = 'sl_SI';
 560
 561 $languages['sr_YU']['NAME']    = 'Serbian';
 562 $languages['sr_YU']['ALTNAME'] = 'Srpski';
 563 $languages['sr_YU']['CHARSET'] = 'iso-8859-2';
 564 $languages['sr_YU']['LOCALE']  = 'sr_YU.ISO8859-2';
 565 $languages['sr']['ALIAS'] = 'sr_YU';
 566
 567 $languages['sv_SE']['NAME']    = 'Swedish';
 568 $languages['sv_SE']['ALTNAME'] = 'Svenska';
 569 $languages['sv_SE']['CHARSET'] = 'iso-8859-1';
 570 $languages['sv_SE']['LOCALE']  = 'sv_SE.ISO8859-1';
 571 $languages['sv']['ALIAS'] = 'sv_SE';
 572
 573 $languages['th_TH']['NAME']    = 'Thai';
 574 $languages['th_TH']['CHARSET'] = 'tis-620';
 575 $languages['th_TH']['LOCALE']  = 'th_TH.TIS-620';
 576 $languages['th']['ALIAS'] = 'th_TH';
 577
 578 $languages['tl_PH']['NAME']    = 'Tagalog';
 579 $languages['tl_PH']['CHARSET'] = 'iso-8859-1';
 580 $languages['tl_PH']['LOCALE']  = 'tl_PH.ISO8859-1';
 581 $languages['tl']['ALIAS'] = 'tl_PH';
 582
 583 $languages['tr_TR']['NAME']    = 'Turkish';
 584 $languages['tr_TR']['CHARSET'] = 'iso-8859-9';
 585 $languages['tr_TR']['LOCALE']  = 'tr_TR.ISO8859-9';
 586 $languages['tr']['ALIAS'] = 'tr_TR';
 587
 588 $languages['zh_TW']['NAME']    = 'Chinese Trad';
 589 $languages['zh_TW']['CHARSET'] = 'big5';
 590 $languages['zh_TW']['LOCALE']  = 'zh_TW.BIG5';
 591 $languages['tw']['ALIAS'] = 'zh_TW';
 592
 593 $languages['zh_CN']['NAME']    = 'Chinese Simp';
 594 $languages['zh_CN']['CHARSET'] = 'gb2312';
 595 $languages['zh_CN']['LOCALE']  = 'zh_CN.GB2312';
 596 $languages['cn']['ALIAS'] = 'zh_CN';
 597
 598 $languages['uk_UA']['NAME']    = 'Ukrainian';
 599 $languages['uk_UA']['CHARSET'] = 'koi8-u';
 600 $languages['uk_UA']['LOCALE']  = 'uk_UA.KOI8-U';
 601 $languages['uk']['ALIAS'] = 'uk_UA';
 602
 603 $languages['ru_UA']['NAME']    = 'Russian (Ukrainian)';
 604 $languages['ru_UA']['CHARSET'] = 'koi8-r';
 605 $languages['ru_UA']['LOCALE']  = 'ru_UA.KOI8-R';
 606
 607 /*
 608 $languages['vi_VN']['NAME']    = 'Vietnamese';
 609 $languages['vi_VN']['CHARSET'] = 'utf-8';
 610 $languages['vi']['ALIAS'] = 'vi_VN';
 611 */
 612
 613 // Right to left languages
 614 $languages['ar']['NAME']    = 'Arabic';
 615 $languages['ar']['CHARSET'] = 'windows-1256';
 616 $languages['ar']['DIR']     = 'rtl';
 617
 618 $languages['fa_IR']['NAME']    = 'Farsi';
 619 $languages['fa_IR']['CHARSET'] = 'utf-8';
 620 $languages['fa_IR']['DIR']     = 'rtl';
 621 $languages['fa_IR']['LOCALE']  = 'fa_IR.UTF-8';
 622 $languages['fa']['ALIAS']      = 'fa_IR';
 623
 624 $languages['he_IL']['NAME']    = 'Hebrew';
 625 $languages['he_IL']['CHARSET'] = 'windows-1255';
 626 $languages['he_IL']['LOCALE']  = 'he_IL.CP1255';
 627 $languages['he_IL']['DIR']     = 'rtl';
 628 $languages['he']['ALIAS']      = 'he_IL';
 629
 630 /* Detect whether gettext is installed. */
 631 $gettext_flags = 0;
 632 if (function_exists('_')) {
 633     $gettext_flags += 1;
 634 }
 635 if (function_exists('bindtextdomain')) {
 636     $gettext_flags += 2;
 637 }
 638 if (function_exists('textdomain')) {
 639     $gettext_flags += 4;
 640 }
 641
 642 /* If gettext is fully loaded, cool */
 643 if ($gettext_flags == 7) {
 644     $use_gettext = true;
 645 }
 646 /* If we can fake gettext, try that */
 647 elseif ($gettext_flags == 0) {
 648     $use_gettext = true;
 649     include_once(SM_PATH . 'functions/gettext.php');
 650 } else {
 651     /* Uh-ho.  A weird install */
 652     if (! $gettext_flags & 1) {
 653       /**
 654        * Function is used as replacement in broken installs
 655        * @ignore
 656        */
 657         function _($str) {
 658             return $str;
 659         }
 660     }
 661     if (! $gettext_flags & 2) {
 662       /**
 663        * Function is used as replacement in broken installs
 664        * @ignore
 665        */
 666         function bindtextdomain() {
 667             return;
 668         }
 669     }
 670     if (! $gettext_flags & 4) {
 671       /**
 672        * Function is used as replacemet in broken installs
 673        * @ignore
 674        */
 675         function textdomain() {
 676             return;
 677         }
 678     }
 679 }
 680
 681
 682 /**
 683  * Japanese charset extra function
 684  *
 685  * Action performed by function is defined by first argument.
 686  * Default return value is defined by second argument.
 687  * Use of third argument depends on action.
 688  *
 689  * @param string $action action performed by this function.
 690  *    possible values:
 691  *  decode - convert returned string to euc-jp. third argument unused
 692  *  encode - convert returned string to jis. third argument unused
 693  *  strimwidth - third argument=$width. trims string to $width symbols.
 694  *  encodeheader - create base64 encoded header in iso-2022-jp. third argument unused
 695  *  decodeheader - return human readable string from mime header. string is returned in euc-jp. third argument unused
 696  *  downloadfilename - third argument $useragent. Arguments provide browser info. Returns shift-jis or euc-jp encoded file name
 697  *  wordwrap - third argument=$wrap. wraps text at $wrap symbols
 698  *  utf7-imap_encode - returns string converted from euc-jp to utf7-imap. third argument unused
 699  *  utf7-imap_decode - returns string converted from utf7-imap to euc-jp. third argument unused
 700  * @param string $ret default return value
 701  */
 702 function japanese_xtra() {
 703     $ret = func_get_arg(1);  /* default return value */
 704     if (function_exists('mb_detect_encoding')) {
 705         switch (func_get_arg(0)) { /* action */
 706         case 'decode':
 707             $detect_encoding = @mb_detect_encoding($ret);
 708             if ($detect_encoding == 'JIS' ||
 709                 $detect_encoding == 'EUC-JP' ||
 710                 $detect_encoding == 'SJIS' ||
 711                 $detect_encoding == 'UTF-8') {
 712
 713                 $ret = mb_convert_kana(mb_convert_encoding($ret, 'EUC-JP', 'AUTO'), "KV");
 714             }
 715             break;
 716         case 'encode':
 717             $detect_encoding = @mb_detect_encoding($ret);
 718             if ($detect_encoding == 'JIS' ||
 719                 $detect_encoding == 'EUC-JP' ||
 720                 $detect_encoding == 'SJIS' ||
 721                 $detect_encoding == 'UTF-8') {
 722
 723                 $ret = mb_convert_encoding(mb_convert_kana($ret, "KV"), 'JIS', 'AUTO');
 724             }
 725             break;
 726         case 'strimwidth':
 727             $width = func_get_arg(2);
 728             $ret = mb_strimwidth($ret, 0, $width, '...');
 729             break;
 730         case 'encodeheader':
 731             $result = '';
 732             if (strlen($ret) > 0) {
 733                 $tmpstr = mb_substr($ret, 0, 1);
 734                 $prevcsize = strlen($tmpstr);
 735                 for ($i = 1; $i < mb_strlen($ret); $i++) {
 736                     $tmp = mb_substr($ret, $i, 1);
 737                     if (strlen($tmp) == $prevcsize) {
 738                         $tmpstr .= $tmp;
 739                     } else {
 740                         if ($prevcsize == 1) {
 741                             $result .= $tmpstr;
 742                         } else {
 743                             $result .= str_replace(' ', '',
 744                                                    mb_encode_mimeheader($tmpstr,'iso-2022-jp','B',''));
 745                         }
 746                         $tmpstr = $tmp;
 747                         $prevcsize = strlen($tmp);
 748                     }
 749                 }
 750                 if (strlen($tmpstr)) {
 751                     if (strlen(mb_substr($tmpstr, 0, 1)) == 1)
 752                         $result .= $tmpstr;
 753                     else
 754                         $result .= str_replace(' ', '',
 755                                                mb_encode_mimeheader($tmpstr,'iso-2022-jp','B',''));
 756                 }
 757             }
 758             $ret = $result;
 759             break;
 760         case 'decodeheader':
 761             $ret = str_replace("\t", "", $ret);
 762             if (eregi('=\\?([^?]+)\\?(q|b)\\?([^?]+)\\?=', $ret))
 763                 $ret = @mb_decode_mimeheader($ret);
 764             $ret = @mb_convert_encoding($ret, 'EUC-JP', 'AUTO');
 765             break;
 766         case 'downloadfilename':
 767             $useragent = func_get_arg(2);
 768             if (strstr($useragent, 'Windows') !== false ||
 769                 strstr($useragent, 'Mac_') !== false) {
 770                 $ret = mb_convert_encoding($ret, 'SJIS', 'AUTO');
 771             } else {
 772                 $ret = mb_convert_encoding($ret, 'EUC-JP', 'AUTO');
 773 }
 774             break;
 775         case 'wordwrap':
 776             $no_begin = "\x21\x25\x29\x2c\x2e\x3a\x3b\x3f\x5d\x7d\xa1\xf1\xa1\xeb\xa1" .
 777                 "\xc7\xa1\xc9\xa2\xf3\xa1\xec\xa1\xed\xa1\xee\xa1\xa2\xa1\xa3\xa1\xb9" .
 778                 "\xa1\xd3\xa1\xd5\xa1\xd7\xa1\xd9\xa1\xdb\xa1\xcd\xa4\xa1\xa4\xa3\xa4" .
 779                 "\xa5\xa4\xa7\xa4\xa9\xa4\xc3\xa4\xe3\xa4\xe5\xa4\xe7\xa4\xee\xa1\xab" .
 780                 "\xa1\xac\xa1\xb5\xa1\xb6\xa5\xa1\xa5\xa3\xa5\xa5\xa5\xa7\xa5\xa9\xa5" .
 781                 "\xc3\xa5\xe3\xa5\xe5\xa5\xe7\xa5\xee\xa5\xf5\xa5\xf6\xa1\xa6\xa1\xbc" .
 782                 "\xa1\xb3\xa1\xb4\xa1\xaa\xa1\xf3\xa1\xcb\xa1\xa4\xa1\xa5\xa1\xa7\xa1" .
 783                 "\xa8\xa1\xa9\xa1\xcf\xa1\xd1";
 784             $no_end = "\x5c\x24\x28\x5b\x7b\xa1\xf2\x5c\xa1\xc6\xa1\xc8\xa1\xd2\xa1" .
 785                 "\xd4\xa1\xd6\xa1\xd8\xa1\xda\xa1\xcc\xa1\xf0\xa1\xca\xa1\xce\xa1\xd0\xa1\xef";
 786             $wrap = func_get_arg(2);
 787
 788             if (strlen($ret) >= $wrap &&
 789                 substr($ret, 0, 1) != '>' &&
 790                 strpos($ret, 'http://') === FALSE &&
 791                 strpos($ret, 'https://') === FALSE &&
 792                 strpos($ret, 'ftp://') === FALSE) {
 793
 794                 $ret = mb_convert_kana($ret, "KV");
 795
 796                 $line_new = '';
 797                 $ptr = 0;
 798
 799                 while ($ptr < strlen($ret) - 1) {
 800                     $l = mb_strcut($ret, $ptr, $wrap);
 801                     $ptr += strlen($l);
 802                     $tmp = $l;
 803
 804                     $l = mb_strcut($ret, $ptr, 2);
 805                     while (strlen($l) != 0 && mb_strpos($no_begin, $l) !== FALSE ) {
 806                         $tmp .= $l;
 807                         $ptr += strlen($l);
 808                         $l = mb_strcut($ret, $ptr, 1);
 809                     }
 810                     $line_new .= $tmp;
 811                     if ($ptr < strlen($ret) - 1)
 812                         $line_new .= "\n";
 813                 }
 814                 $ret = $line_new;
 815             }
 816             break;
 817         case 'utf7-imap_encode':
 818             $ret = mb_convert_encoding($ret, 'UTF7-IMAP', 'EUC-JP');
 819             break;
 820         case 'utf7-imap_decode':
 821             $ret = mb_convert_encoding($ret, 'EUC-JP', 'UTF7-IMAP');
 822             break;
 823         }
 824     }
 825     return $ret;
 826 }
 827
 828 /**************************
 829  * Japanese extra functions
 830  **************************/
 831
 832 /**
 833  * Japanese decoding function
 834  *
 835  * converts string to euc-jp, if string uses JIS, EUC-JP, ShiftJIS or UTF-8
 836  * charset. Needs mbstring support in php.
 837  * @param string $ret text, that has to be converted
 838  * @return string converted string
 839  * @since 1.5.1
 840  */
 841 function japanese_xtra_decode($ret) {
 842     if (function_exists('mb_detect_encoding')) {
 843         $detect_encoding = @mb_detect_encoding($ret);
 844         if ($detect_encoding == 'JIS' ||
 845             $detect_encoding == 'EUC-JP' ||
 846             $detect_encoding == 'SJIS' ||
 847             $detect_encoding == 'UTF-8') {
 848
 849             $ret = mb_convert_kana(mb_convert_encoding($ret, 'EUC-JP', 'AUTO'), "KV");
 850         }
 851     }
 852     return $ret;
 853 }
 854
 855 /**
 856  * Japanese encoding function
 857  *
 858  * converts string to jis, if string uses JIS, EUC-JP, ShiftJIS or UTF-8
 859  * charset. Needs mbstring support in php.
 860  * @param string $ret text, that has to be converted
 861  * @return string converted text
 862  * @since 1.5.1
 863  */
 864 function japanese_xtra_encode($ret) {
 865     if (function_exists('mb_detect_encoding')) {
 866         $detect_encoding = @mb_detect_encoding($ret);
 867         if ($detect_encoding == 'JIS' ||
 868             $detect_encoding == 'EUC-JP' ||
 869             $detect_encoding == 'SJIS' ||
 870             $detect_encoding == 'UTF-8') {
 871
 872             $ret = mb_convert_encoding(mb_convert_kana($ret, "KV"), 'JIS', 'AUTO');
 873         }
 874     }
 875     return $ret;
 876 }
 877
 878 /**
 879  * Japanese header encoding function
 880  *
 881  * creates base64 encoded header in iso-2022-jp charset
 882  * @param string $ret text, that has to be converted
 883  * @return string mime base64 encoded string
 884  * @since 1.5.1
 885  */
 886 function japanese_xtra_encodeheader($ret) {
 887     if (function_exists('mb_detect_encoding')) {
 888         $result = '';
 889         if (strlen($ret) > 0) {
 890             $tmpstr = mb_substr($ret, 0, 1);
 891             $prevcsize = strlen($tmpstr);
 892             for ($i = 1; $i < mb_strlen($ret); $i++) {
 893                 $tmp = mb_substr($ret, $i, 1);
 894                 if (strlen($tmp) == $prevcsize) {
 895                     $tmpstr .= $tmp;
 896                 } else {
 897                     if ($prevcsize == 1) {
 898                         $result .= $tmpstr;
 899                     } else {
 900                         $result .= str_replace(' ', '',
 901                                                mb_encode_mimeheader($tmpstr,'iso-2022-jp','B',''));
 902                     }
 903                     $tmpstr = $tmp;
 904                     $prevcsize = strlen($tmp);
 905                 }
 906             }
 907             if (strlen($tmpstr)) {
 908                 if (strlen(mb_substr($tmpstr, 0, 1)) == 1)
 909                     $result .= $tmpstr;
 910                 else
 911                     $result .= str_replace(' ', '',
 912                                            mb_encode_mimeheader($tmpstr,'iso-2022-jp','B',''));
 913             }
 914         }
 915         $ret = $result;
 916     }
 917     return $ret;
 918 }
 919
 920 /**
 921  * Japanese header decoding function
 922  *
 923  * return human readable string from mime header. string is returned in euc-jp
 924  * charset.
 925  * @param string $ret header string
 926  * @return string decoded header string
 927  * @since 1.5.1
 928  */
 929 function japanese_xtra_decodeheader($ret) {
 930     if (function_exists('mb_detect_encoding')) {
 931         $ret = str_replace("\t", "", $ret);
 932         if (eregi('=\\?([^?]+)\\?(q|b)\\?([^?]+)\\?=', $ret))
 933             $ret = @mb_decode_mimeheader($ret);
 934         $ret = @mb_convert_encoding($ret, 'EUC-JP', 'AUTO');
 935     }
 936     return $ret;
 937 }
 938
 939 /**
 940  * Japanese downloaded filename processing function
 941  *
 942  * Returns shift-jis or euc-jp encoded file name
 943  * @param string $ret string
 944  * @param string $useragent browser
 945  * @return string converted string
 946  * @since 1.5.1
 947  */
 948 function japanese_xtra_downloadfilename($ret,$useragent) {
 949     if (function_exists('mb_detect_encoding')) {
 950         if (strstr($useragent, 'Windows') !== false ||
 951             strstr($useragent, 'Mac_') !== false) {
 952             $ret = mb_convert_encoding($ret, 'SJIS', 'AUTO');
 953         } else {
 954             $ret = mb_convert_encoding($ret, 'EUC-JP', 'AUTO');
 955         }
 956     }
 957     return $ret;
 958 }
 959
 960 /**
 961  * Japanese wordwrap function
 962  *
 963  * wraps text at set number of symbols
 964  * @param string $ret text
 965  * @param integer $wrap number of symbols per line
 966  * @return string wrapped text
 967  * @since 1.5.1
 968  */
 969 function japanese_xtra_wordwrap($ret,$wrap) {
 970     if (function_exists('mb_detect_encoding')) {
 971         $no_begin = "\x21\x25\x29\x2c\x2e\x3a\x3b\x3f\x5d\x7d\xa1\xf1\xa1\xeb\xa1" .
 972             "\xc7\xa1\xc9\xa2\xf3\xa1\xec\xa1\xed\xa1\xee\xa1\xa2\xa1\xa3\xa1\xb9" .
 973             "\xa1\xd3\xa1\xd5\xa1\xd7\xa1\xd9\xa1\xdb\xa1\xcd\xa4\xa1\xa4\xa3\xa4" .
 974             "\xa5\xa4\xa7\xa4\xa9\xa4\xc3\xa4\xe3\xa4\xe5\xa4\xe7\xa4\xee\xa1\xab" .
 975             "\xa1\xac\xa1\xb5\xa1\xb6\xa5\xa1\xa5\xa3\xa5\xa5\xa5\xa7\xa5\xa9\xa5" .
 976             "\xc3\xa5\xe3\xa5\xe5\xa5\xe7\xa5\xee\xa5\xf5\xa5\xf6\xa1\xa6\xa1\xbc" .
 977             "\xa1\xb3\xa1\xb4\xa1\xaa\xa1\xf3\xa1\xcb\xa1\xa4\xa1\xa5\xa1\xa7\xa1" .
 978             "\xa8\xa1\xa9\xa1\xcf\xa1\xd1";
 979         $no_end = "\x5c\x24\x28\x5b\x7b\xa1\xf2\x5c\xa1\xc6\xa1\xc8\xa1\xd2\xa1" .
 980             "\xd4\xa1\xd6\xa1\xd8\xa1\xda\xa1\xcc\xa1\xf0\xa1\xca\xa1\xce\xa1\xd0\xa1\xef";
 981
 982         if (strlen($ret) >= $wrap &&
 983             substr($ret, 0, 1) != '>' &&
 984             strpos($ret, 'http://') === FALSE &&
 985             strpos($ret, 'https://') === FALSE &&
 986             strpos($ret, 'ftp://') === FALSE) {
 987
 988             $ret = mb_convert_kana($ret, "KV");
 989
 990             $line_new = '';
 991             $ptr = 0;
 992
 993             while ($ptr < strlen($ret) - 1) {
 994                 $l = mb_strcut($ret, $ptr, $wrap);
 995                 $ptr += strlen($l);
 996                 $tmp = $l;
 997
 998                 $l = mb_strcut($ret, $ptr, 2);
 999                 while (strlen($l) != 0 && mb_strpos($no_begin, $l) !== FALSE ) {
1000                     $tmp .= $l;
1001                     $ptr += strlen($l);
1002                     $l = mb_strcut($ret, $ptr, 1);
1003                 }
1004                 $line_new .= $tmp;
1005                 if ($ptr < strlen($ret) - 1)
1006                     $line_new .= "\n";
1007             }
1008             $ret = $line_new;
1009         }
1010     }
1011     return $ret;
1012 }
1013
1014 /**
1015  * Japanese imap folder name encoding function
1016  *
1017  * converts folder name from euc-jp to utf7-imap
1018  * @param string $ret folder name
1019  * @return string converted folder name
1020  * @since 1.5.1
1021  */
1022 function japanese_xtra_utf7_imap_encode($ret){
1023     if (function_exists('mb_detect_encoding')) {
1024         $ret = mb_convert_encoding($ret, 'UTF7-IMAP', 'EUC-JP');
1025     }
1026     return $ret;
1027 }
1028
1029 /**
1030  * Japanese imap folder name decoding function
1031  *
1032  * converts folder name from utf7-imap to euc-jp.
1033  * @param string $ret folder name in utf7-imap
1034  * @return string converted folder name
1035  * @since 1.5.1
1036  */
1037 function japanese_xtra_utf7_imap_decode($ret) {
1038     if (function_exists('mb_detect_encoding')) {
1039         $ret = mb_convert_encoding($ret, 'EUC-JP', 'UTF7-IMAP');
1040     }
1041     return $ret;
1042 }
1043
1044 /**
1045  * Japanese string trimming function
1046  *
1047  * trims string to defined number of symbols
1048  * @param string $ret string
1049  * @param integer $width number of symbols
1050  * @return string trimmed string
1051  * @since 1.5.1
1052  */
1053 function japanese_xtra_strimwidth($ret,$width) {
1054     if (function_exists('mb_detect_encoding')) {
1055         $ret = mb_strimwidth($ret, 0, $width, '...');
1056     }
1057     return $ret;
1058 }
1059
1060 /********************************
1061  * Korean charset extra functions
1062  ********************************/
1063
1064 /**
1065  * Korean downloaded filename processing functions
1066  *
1067  * @param string default return value
1068  * @return string
1069  */
1070 function korean_xtra_downloadfilename($ret) {
1071     $ret = str_replace("\x0D\x0A", '', $ret);  /* Hanmail's CR/LF Clear */
1072     for ($i=0;$i<strlen($ret);$i++) {
1073         if ($ret[$i] >= "\xA1" && $ret[$i] <= "\xFE") {   /* 0xA1 - 0XFE are Valid */
1074             $i++;
1075             continue;
1076         } else if (($ret[$i] >= 'a' && $ret[$i] <= 'z') || /* From Original ereg_replace in download.php */
1077                    ($ret[$i] >= 'A' && $ret[$i] <= 'Z') ||
1078                    ($ret[$i] == '.') || ($ret[$i] == '-')) {
1079             continue;
1080         } else {
1081             $ret[$i] = '_';
1082         }
1083     }
1084     return $ret;
1085 }
1086
1087 /**
1088  * Replaces non-braking spaces inserted by some browsers with regular space
1089  *
1090  * This function can be used to replace non-braking space symbols
1091  * that are inserted in forms by some browsers instead of normal
1092  * space symbol.
1093  *
1094  * @param string $string Text that needs to be cleaned
1095  * @param string $charset Charset used in text
1096  * @return string Cleaned text
1097  */
1098 function cleanup_nbsp($string,$charset) {
1099
1100   // reduce number of case statements
1101   if (stristr('iso-8859-',substr($charset,0,9))){
1102     $output_charset="iso-8859-x";
1103   }
1104   if (stristr('windows-125',substr($charset,0,11))){
1105     $output_charset="cp125x";
1106   }
1107   if (stristr('koi8',substr($charset,0,4))){
1108     $output_charset="koi8-x";
1109   }
1110   if (! isset($output_charset)){
1111     $output_charset=strtolower($charset);
1112   }
1113
1114 // where is non-braking space symbol
1115 switch($output_charset):
1116  case "iso-8859-x":
1117  case "cp125x":
1118  case "iso-2022-jp":
1119   $nbsp="\xA0";
1120   break;
1121  case "koi8-x":
1122    $nbsp="\x9A";
1123    break;
1124  case "utf-8":
1125    $nbsp="\xC2\xA0";
1126    break;
1127  default:
1128    // don't change string if charset is unmatched
1129    return $string;
1130 endswitch;
1131
1132 // return space instead of non-braking space.
1133  return str_replace($nbsp,' ',$string);
1134 }
1135
1136 /**
1137  * Function informs if it is safe to convert given charset to the one that is used by user.
1138  *
1139  * It is safe to use conversion only if user uses utf-8 encoding and when
1140  * converted charset is similar to the one that is used by user.
1141  *
1142  * @param string $input_charset Charset of text that needs to be converted
1143  * @return bool is it possible to convert to user's charset
1144  */
1145 function is_conversion_safe($input_charset) {
1146   global $languages, $sm_notAlias, $default_charset;
1147
1148  // convert to lower case
1149  $input_charset = strtolower($input_charset);
1150
1151  // Is user's locale Unicode based ?
1152  if ( $default_charset == "utf-8" ) {
1153    return true;
1154  }
1155
1156  // Charsets that are similar
1157 switch ($default_charset):
1158 case "windows-1251":
1159       if ( $input_charset == "iso-8859-5" ||
1160            $input_charset == "koi8-r" ||
1161            $input_charset == "koi8-u" ) {
1162         return true;
1163      } else {
1164         return false;
1165      }
1166 case "windows-1257":
1167   if ( $input_charset == "iso-8859-13" ||
1168        $input_charset == "iso-8859-4" ) {
1169     return true;
1170   } else {
1171     return false;
1172   }
1173 case "iso-8859-4":
1174   if ( $input_charset == "iso-8859-13" ||
1175        $input_charset == "windows-1257" ) {
1176      return true;
1177   } else {
1178      return false;
1179   }
1180 case "iso-8859-5":
1181   if ( $input_charset == "windows-1251" ||
1182        $input_charset == "koi8-r" ||
1183        $input_charset == "koi8-u" ) {
1184      return true;
1185   } else {
1186      return false;
1187   }
1188 case "iso-8859-13":
1189   if ( $input_charset == "iso-8859-4" ||
1190        $input_charset == "windows-1257" ) {
1191      return true;
1192   } else {
1193      return false;
1194   }
1195 case "koi8-r":
1196   if ( $input_charset == "windows-1251" ||
1197        $input_charset == "iso-8859-5" ||
1198        $input_charset == "koi8-u" ) {
1199      return true;
1200   } else {
1201      return false;
1202   }
1203 case "koi8-u":
1204   if ( $input_charset == "windows-1251" ||
1205        $input_charset == "iso-8859-5" ||
1206        $input_charset == "koi8-r" ) {
1207      return true;
1208   } else {
1209      return false;
1210   }
1211 default:
1212    return false;
1213 endswitch;
1214 }
1215 ?>