123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154 |
- <?php
- use Patchwork\Utf8;
- define('SPECIAL_OPENING_TAG', '[=');
- define('SPECIAL_CLOSING_TAG', '=]');
- define('TIME_NO_SEC_FORMAT', 0);
- define('DATE_FORMAT_SHORT', 1);
- define('DATE_FORMAT_LONG', 2);
- define('DATE_FORMAT_LONG_NO_DAY', 10);
- define('DATE_TIME_FORMAT_LONG', 3);
- define('DATE_FORMAT_NUMBER', 4);
- define('DATE_TIME_FORMAT_LONG_24H', 5);
- define('DATE_TIME_FORMAT_SHORT', 6);
- define('DATE_TIME_FORMAT_SHORT_TIME_FIRST', 7);
- define('DATE_FORMAT_NUMBER_NO_YEAR', 8);
- define('DATE_FORMAT_ONLY_DAYNAME', 9);
- define('PERSON_NAME_COMMON_CONVENTION', 0);
- define('PERSON_NAME_WESTERN_ORDER', 1);
- define('PERSON_NAME_EASTERN_ORDER', 2);
- define('PERSON_NAME_LIBRARY_ORDER', 3);
- define('PERSON_NAME_EMAIL_ADDRESS', PERSON_NAME_WESTERN_ORDER);
- define('PERSON_NAME_DATA_EXPORT', PERSON_NAME_EASTERN_ORDER);
- function get_lang($variable, $reserved = null, $language = null)
- {
-
-
-
- global $language_interface;
-
-
- global $language_interface_initial_value;
- global $used_lang_vars, $_configuration;
-
-
-
- if (isset($_configuration['language_measure_frequency']) &&
- $_configuration['language_measure_frequency'] == 1
- ) {
- require_once api_get_path(SYS_CODE_PATH).'/cron/lang/langstats.class.php';
- global $langstats;
- $langstats->add_use($variable, '');
- }
- if (!isset($used_lang_vars)) {
- $used_lang_vars = [];
- }
-
- static $initialized, $show_special_markup;
- if (!isset($initialized)) {
- $test_server_mode = api_get_setting('server_type') === 'test';
- $show_special_markup = api_get_setting('hide_dltt_markup') != 'true' || $test_server_mode;
- $initialized = true;
- }
-
- if (empty($language)) {
- $language = $language_interface;
- }
- $lang_postfix = isset($is_interface_language) && $is_interface_language ? '' : '('.$language.')';
- $is_interface_language = $language == $language_interface_initial_value;
-
- static $cache;
-
- if (isset($cache[$language][$variable])) {
-
-
- $ret = $cache[$language][$variable];
- $used_lang_vars[$variable.$lang_postfix] = $ret;
- return $ret;
- }
-
-
-
-
- $read_global_variables = $is_interface_language;
- if ($read_global_variables) {
- if (isset($GLOBALS[$variable])) {
- $langvar = $GLOBALS[$variable];
- } elseif (isset($GLOBALS["lang$variable"])) {
- $langvar = $GLOBALS["lang$variable"];
- } else {
- $langvar = $show_special_markup ? SPECIAL_OPENING_TAG.$variable.SPECIAL_CLOSING_TAG : $variable;
- }
- }
- if (empty($langvar) || !is_string($langvar)) {
- $langvar = $show_special_markup ? SPECIAL_OPENING_TAG.$variable.SPECIAL_CLOSING_TAG : $variable;
- }
- $ret = $cache[$language][$variable] = $langvar;
- $used_lang_vars[$variable.$lang_postfix] = $ret;
- return $ret;
- }
- function api_get_interface_language(
- $purified = false,
- $check_sub_language = false,
- $setParentLanguageName = true
- ) {
- global $language_interface;
- if (empty($language_interface)) {
- return 'english';
- }
- if ($check_sub_language) {
- static $parent_language_name = null;
- if (!isset($parent_language_name)) {
-
-
- $language_id = api_get_language_id($language_interface);
- $language_info = api_get_language_info($language_id);
- if (!empty($language_id) &&
- !empty($language_info)
- ) {
- if (!empty($language_info['parent_id'])) {
- $language_info = api_get_language_info($language_info['parent_id']);
- if ($setParentLanguageName) {
- $parent_language_name = $language_info['english_name'];
- }
- if (!empty($parent_language_name)) {
- return $parent_language_name;
- }
- }
- return $language_info['english_name'];
- }
- return 'english';
- } else {
- return $parent_language_name;
- }
- } else {
-
- $interface_language = $purified ? api_purify_language_id($language_interface) : $language_interface;
- }
- return $interface_language;
- }
- function api_purify_language_id($language)
- {
- static $purified = [];
- if (!isset($purified[$language])) {
- $purified[$language] = trim(
- str_replace(
- ['_unicode', '_latin', '_corporate', '_org', '_km'],
- '',
- strtolower($language)
- )
- );
- }
- return $purified[$language];
- }
- function api_get_language_isocode($language = null, $default_code = 'en')
- {
- static $iso_code = [];
- if (empty($language)) {
- $language = api_get_interface_language(false, true);
- }
- if (!isset($iso_code[$language])) {
- if (!class_exists('Database')) {
-
- return $default_code;
- }
- $sql = "SELECT isocode
- FROM ".Database::get_main_table(TABLE_MAIN_LANGUAGE)."
- WHERE dokeos_folder = '$language'";
- $sql_result = Database::query($sql);
- if (Database::num_rows($sql_result)) {
- $result = Database::fetch_array($sql_result);
- $iso_code[$language] = trim($result['isocode']);
- } else {
- $language_purified_id = api_purify_language_id($language);
- $iso_code[$language] = isset($iso_code[$language_purified_id]) ? $iso_code[$language_purified_id] : null;
- }
- if (empty($iso_code[$language])) {
- $iso_code[$language] = $default_code;
- }
- }
- return $iso_code[$language];
- }
- function api_get_platform_isocodes()
- {
- $iso_code = [];
- $sql = "SELECT isocode
- FROM ".Database::get_main_table(TABLE_MAIN_LANGUAGE)."
- ORDER BY isocode ";
- $sql_result = Database::query($sql);
- if (Database::num_rows($sql_result)) {
- while ($row = Database::fetch_array($sql_result)) {
- $iso_code[] = trim($row['isocode']);
- }
- }
- return $iso_code;
- }
- function api_get_text_direction($language = null)
- {
- static $text_direction = [];
- if (empty($language)) {
- $language = api_get_interface_language();
- }
- if (!isset($text_direction[$language])) {
- $text_direction[$language] = in_array(
- api_purify_language_id($language),
- [
- 'arabic',
- 'ar',
- 'dari',
- 'prs',
- 'hebrew',
- 'he',
- 'iw',
- 'pashto',
- 'ps',
- 'persian',
- 'fa',
- 'ur',
- 'yiddish',
- 'yid'
- ]
- ) ? 'rtl' : 'ltr';
- }
- return $text_direction[$language];
- }
- function api_get_timezones()
- {
- $timezone_identifiers = DateTimeZone::listIdentifiers();
- sort($timezone_identifiers);
- $out = [];
- foreach ($timezone_identifiers as $tz) {
- $out[$tz] = $tz;
- }
- $null_option = ['' => ''];
- $result = array_merge($null_option, $out);
- return $result;
- }
- function api_get_timezone()
- {
-
- $to_timezone = date_default_timezone_get();
-
- $timezone_value = api_get_setting('timezone_value', 'timezones');
- if ($timezone_value != null) {
- $to_timezone = $timezone_value;
- }
-
- $use_users_timezone = api_get_setting('use_users_timezone', 'timezones');
- if ($use_users_timezone === 'true') {
- $userId = api_get_user_id();
-
- $timezone_user = UserManager::get_extra_user_data_by_field(
- $userId,
- 'timezone'
- );
- if (isset($timezone_user['timezone']) && $timezone_user['timezone'] != null) {
- $to_timezone = $timezone_user['timezone'];
- }
- }
- return $to_timezone;
- }
- function api_get_utc_datetime(
- $time = null,
- $return_null_if_invalid_date = false,
- $returnObj = false
- ) {
- $from_timezone = api_get_timezone();
- $to_timezone = 'UTC';
- if (is_null($time) || empty($time) || $time === '0000-00-00 00:00:00') {
- if ($return_null_if_invalid_date) {
- return null;
- }
- if ($returnObj) {
- return $date = new DateTime(gmdate('Y-m-d H:i:s'));
- }
- return gmdate('Y-m-d H:i:s');
- }
-
- if (is_numeric($time)) {
- $time = intval($time);
- return gmdate('Y-m-d H:i:s', $time);
- }
- try {
- $date = new DateTime($time, new DateTimezone($from_timezone));
- $date->setTimezone(new DateTimeZone($to_timezone));
- if ($returnObj) {
- return $date;
- } else {
- return $date->format('Y-m-d H:i:s');
- }
- } catch (Exception $e) {
- return null;
- }
- }
- function api_get_local_time(
- $time = null,
- $to_timezone = null,
- $from_timezone = null,
- $return_null_if_invalid_date = false,
- $showTime = true,
- $humanForm = false
- ) {
-
- if (is_null($from_timezone)) {
- $from_timezone = 'UTC';
- }
-
- if (is_null($to_timezone)) {
- $to_timezone = api_get_timezone();
- }
-
- if (is_null($time) || empty($time) || $time == '0000-00-00 00:00:00') {
- if ($return_null_if_invalid_date) {
- return null;
- }
- $from_timezone = 'UTC';
- $time = gmdate('Y-m-d H:i:s');
- }
- if (is_numeric($time)) {
- $time = intval($time);
- if ($return_null_if_invalid_date) {
- if (strtotime(date('d-m-Y H:i:s', $time)) !== (int) $time) {
- return null;
- }
- }
- $from_timezone = 'UTC';
- $time = gmdate('Y-m-d H:i:s', $time);
- }
- if ($time instanceof DateTime) {
- $time = $time->format('Y-m-d H:i:s');
- $from_timezone = 'UTC';
- }
- try {
- $date = new DateTime($time, new DateTimezone($from_timezone));
- $date->setTimezone(new DateTimeZone($to_timezone));
- return api_get_human_date_time($date, $showTime, $humanForm);
- } catch (Exception $e) {
- return '';
- }
- }
- function api_strtotime($time, $timezone = null)
- {
- $system_timezone = date_default_timezone_get();
- if (!empty($timezone)) {
- date_default_timezone_set($timezone);
- }
- $timestamp = strtotime($time);
- if (!empty($timezone)) {
-
- date_default_timezone_set($system_timezone);
- }
- return $timestamp;
- }
- function api_format_date($time, $format = null, $language = null)
- {
- if (empty($time)) {
- return '';
- }
- $system_timezone = date_default_timezone_get();
- date_default_timezone_set(api_get_timezone());
- if (is_string($time)) {
- $time = strtotime($time);
- }
- if (is_null($format)) {
- $format = DATE_TIME_FORMAT_LONG;
- }
- $datetype = null;
- $timetype = null;
- if (is_int($format)) {
- switch ($format) {
- case DATE_FORMAT_ONLY_DAYNAME:
- $date_format = get_lang('dateFormatOnlyDayName', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::SHORT;
- $timetype = IntlDateFormatter::NONE;
- }
- break;
- case DATE_FORMAT_NUMBER_NO_YEAR:
- $date_format = get_lang('dateFormatShortNumberNoYear', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::SHORT;
- $timetype = IntlDateFormatter::NONE;
- }
- break;
- case DATE_FORMAT_NUMBER:
- $date_format = get_lang('dateFormatShortNumber', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::SHORT;
- $timetype = IntlDateFormatter::NONE;
- }
- break;
- case TIME_NO_SEC_FORMAT:
- $date_format = get_lang('timeNoSecFormat', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::NONE;
- $timetype = IntlDateFormatter::SHORT;
- }
- break;
- case DATE_FORMAT_SHORT:
- $date_format = get_lang('dateFormatShort', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::LONG;
- $timetype = IntlDateFormatter::NONE;
- }
- break;
- case DATE_FORMAT_LONG:
- $date_format = get_lang('dateFormatLong', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::FULL;
- $timetype = IntlDateFormatter::NONE;
- }
- break;
- case DATE_TIME_FORMAT_LONG:
- $date_format = get_lang('dateTimeFormatLong', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::FULL;
- $timetype = IntlDateFormatter::SHORT;
- }
- break;
- case DATE_FORMAT_LONG_NO_DAY:
- $date_format = get_lang('dateFormatLongNoDay', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::FULL;
- $timetype = IntlDateFormatter::SHORT;
- }
- break;
- case DATE_TIME_FORMAT_SHORT:
- $date_format = get_lang('dateTimeFormatShort', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::FULL;
- $timetype = IntlDateFormatter::SHORT;
- }
- break;
- case DATE_TIME_FORMAT_SHORT_TIME_FIRST:
- $date_format = get_lang('dateTimeFormatShortTimeFirst', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::FULL;
- $timetype = IntlDateFormatter::SHORT;
- }
- break;
- case DATE_TIME_FORMAT_LONG_24H:
- $date_format = get_lang('dateTimeFormatLong24H', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::FULL;
- $timetype = IntlDateFormatter::SHORT;
- }
- break;
- default:
- $date_format = get_lang('dateTimeFormatLong', '', $language);
- if (INTL_INSTALLED) {
- $datetype = IntlDateFormatter::FULL;
- $timetype = IntlDateFormatter::SHORT;
- }
- }
- } else {
- $date_format = $format;
- }
- if (0) {
-
-
-
- if (is_null($language)) {
- $language = api_get_language_isocode();
- }
- $date_formatter = new IntlDateFormatter($language, $datetype, $timetype, date_default_timezone_get());
-
- $formatted_date = api_to_system_encoding($date_formatter->format($time), 'UTF-8');
- } else {
-
- $translated = &_api_get_day_month_names($language);
- $date_format = str_replace(
- ['%A', '%a', '%B', '%b'],
- [
- $translated['days_long'][(int) strftime('%w', $time)],
- $translated['days_short'][(int) strftime('%w', $time)],
- $translated['months_long'][(int) strftime('%m', $time) - 1],
- $translated['months_short'][(int) strftime('%m', $time) - 1],
- ],
- $date_format
- );
- $formatted_date = api_to_system_encoding(strftime($date_format, $time), 'UTF-8');
- }
- date_default_timezone_set($system_timezone);
- return $formatted_date;
- }
- function date_to_str_ago($date, $timeZone = 'UTC')
- {
- if ($date === '0000-00-00 00:00:00') {
- return '';
- }
- $getOldTimezone = api_get_timezone();
- $isoCode = api_get_language_isocode();
- if ($isoCode == 'pt') {
- $isoCode = 'pt-BR';
- }
- $checkFile = api_get_path(SYS_PATH).'vendor/jimmiw/php-time-ago/translations/'.$isoCode.'.php';
- if (!file_exists($checkFile)) {
- $isoCode = 'en';
- }
- $timeAgo = new TimeAgo($timeZone, $isoCode);
- $value = $timeAgo->inWords($date);
- date_default_timezone_set($getOldTimezone);
- return $value;
- }
- function api_convert_and_format_date($time = null, $format = null, $from_timezone = null)
- {
-
- $time = api_get_local_time($time, null, $from_timezone, true);
-
- return api_format_date($time, $format);
- }
- function api_get_week_days_short($language = null)
- {
- $days = &_api_get_day_month_names($language);
- return $days['days_short'];
- }
- function api_get_week_days_long($language = null)
- {
- $days = &_api_get_day_month_names($language);
- return $days['days_long'];
- }
- function api_get_months_short($language = null)
- {
- $months = &_api_get_day_month_names($language);
- return $months['months_short'];
- }
- function api_get_months_long($language = null)
- {
- $months = &_api_get_day_month_names($language);
- return $months['months_long'];
- }
- function api_get_person_name(
- $first_name,
- $last_name,
- $title = null,
- $format = null,
- $language = null,
- $encoding = null,
- $username = null
- ) {
- static $valid = [];
- if (empty($format)) {
- $format = PERSON_NAME_COMMON_CONVENTION;
- }
-
-
- if (empty($language)) {
-
-
- $language = api_get_interface_language(false, true, false);
- }
- if (!isset($valid[$format][$language])) {
- if (is_int($format)) {
- switch ($format) {
- case PERSON_NAME_COMMON_CONVENTION:
- $valid[$format][$language] = _api_get_person_name_convention($language, 'format');
- $usernameOrderFromDatabase = api_get_setting('user_name_order');
- if (isset($usernameOrderFromDatabase) && !empty($usernameOrderFromDatabase)) {
- $valid[$format][$language] = $usernameOrderFromDatabase;
- }
- break;
- case PERSON_NAME_WESTERN_ORDER:
- $valid[$format][$language] = '%t %f %l';
- break;
- case PERSON_NAME_EASTERN_ORDER:
- $valid[$format][$language] = '%t %l %f';
- break;
- case PERSON_NAME_LIBRARY_ORDER:
- $valid[$format][$language] = '%t %l, %f';
- break;
- default:
- $valid[$format][$language] = '%t %f %l';
- break;
- }
- } else {
- $valid[$format][$language] = _api_validate_person_name_format($format);
- }
- }
- $format = $valid[$format][$language];
- $keywords = [
- '%firstname',
- '%f',
- '%F',
- '%lastname',
- '%l',
- '%L',
- '%title',
- '%t',
- '%T',
- '%username',
- '%u',
- '%U',
- ];
- $values = [
- $first_name,
- $first_name,
- api_strtoupper($first_name),
- $last_name,
- $last_name,
- api_strtoupper($last_name),
- $title,
- $title,
- api_strtoupper($title),
- $username,
- $username,
- api_strtoupper($username),
- ];
- $person_name = str_replace($keywords, $values, $format);
- return _api_clean_person_name($person_name);
- }
- function api_is_western_name_order($format = null, $language = null)
- {
- static $order = [];
- if (empty($format)) {
- $format = PERSON_NAME_COMMON_CONVENTION;
- }
- if (empty($language)) {
- $language = api_get_interface_language(false, true);
- }
- if (!isset($order[$format][$language])) {
- $test_name = api_get_person_name('%f', '%l', '%t', $format, $language);
- $order[$format][$language] = stripos($test_name, '%f') <= stripos($test_name, '%l');
- }
- return $order[$format][$language];
- }
- function api_sort_by_first_name($language = null)
- {
- $userNameSortBy = api_get_setting('user_name_sort_by');
- if (!empty($userNameSortBy) && in_array($userNameSortBy, ['firstname', 'lastname'])) {
- return $userNameSortBy == 'firstname' ? true : false;
- }
- static $sort_by_first_name = [];
- if (empty($language)) {
- $language = api_get_interface_language(false, true);
- }
- if (!isset($sort_by_first_name[$language])) {
- $sort_by_first_name[$language] = _api_get_person_name_convention($language, 'sort_by');
- }
- return $sort_by_first_name[$language];
- }
- function api_convert_encoding($string, $to_encoding, $from_encoding = 'UTF-8')
- {
- if (strtoupper($to_encoding) === strtoupper($from_encoding)) {
- return $string;
- }
- return mb_convert_encoding($string, $to_encoding, $from_encoding);
- }
- function api_utf8_encode($string, $from_encoding = 'UTF-8')
- {
- return mb_convert_encoding($string, 'UTF-8', $from_encoding);
- }
- function api_utf8_decode($string, $to_encoding = null)
- {
- return mb_convert_encoding($string, $to_encoding, 'UTF-8');
- }
- function api_to_system_encoding($string, $from_encoding = null, $check_utf8_validity = false)
- {
- $system_encoding = api_get_system_encoding();
- return api_convert_encoding($string, $system_encoding, $from_encoding);
- }
- function api_htmlentities($string, $quote_style = ENT_COMPAT, $encoding = 'UTF-8')
- {
- switch ($quote_style) {
- case ENT_COMPAT:
- $string = str_replace(['&', '"', '<', '>'], ['&', '"', '<', '>'], $string);
- break;
- case ENT_QUOTES:
- $string = str_replace(['&', '\'', '"', '<', '>'], ['&', ''', '"', '<', '>'], $string);
- break;
- }
- return mb_convert_encoding($string, 'HTML-ENTITIES', 'UTF-8');
- }
- function api_html_entity_decode($string, $quote_style = ENT_COMPAT, $encoding = 'UTF-8')
- {
- if (empty($encoding)) {
- $encoding = _api_mb_internal_encoding();
- }
- if (api_is_encoding_supported($encoding)) {
- if (!api_is_utf8($encoding)) {
- $string = api_utf8_encode($string, $encoding);
- }
- $string = html_entity_decode($string, $quote_style, 'UTF-8');
- if (!api_is_utf8($encoding)) {
- return api_utf8_decode($string, $encoding);
- }
- return $string;
- }
- return $string;
- }
- function api_xml_http_response_encode($string, $from_encoding = 'UTF8')
- {
- if (isset($_SERVER['HTTP_X_REQUESTED_WITH']) && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) == 'xmlhttprequest') {
- if (empty($from_encoding)) {
- $from_encoding = _api_mb_internal_encoding();
- }
- if (!api_is_utf8($from_encoding)) {
- return api_utf8_encode($string, $from_encoding);
- }
- }
- return $string;
- }
- function api_transliterate($string, $unknown = '?', $from_encoding = null)
- {
- return URLify::transliterate($string);
- }
- function api_ord($character, $encoding = 'UTF-8')
- {
- return Utf8::ord(api_utf8_encode($character, $encoding));
- }
- function api_str_ireplace($search, $replace, $subject, & $count = null, $encoding = null)
- {
- return Utf8::str_ireplace($search, $replace, $subject, $count);
- }
- function api_str_split($string, $split_length = 1, $encoding = null)
- {
- return Utf8::str_split($string, $split_length);
- }
- function api_stripos($haystack, $needle, $offset = 0, $encoding = null)
- {
- return Utf8::stripos($haystack, $needle, $offset);
- }
- function api_stristr($haystack, $needle, $before_needle = false, $encoding = null)
- {
- return Utf8::stristr($haystack, $needle, $before_needle);
- }
- function api_strlen($string, $encoding = null)
- {
- return Utf8::strlen($string);
- }
- function api_strpos($haystack, $needle, $offset = 0, $encoding = null)
- {
- return Utf8::strpos($haystack, $needle, $offset);
- }
- function api_strrchr($haystack, $needle, $before_needle = false, $encoding = null)
- {
- return Utf8::strrchr($haystack, $needle);
- }
- function api_strrev($string, $encoding = null)
- {
- return Utf8::strrev($string);
- }
- function api_strripos($haystack, $needle, $offset = 0, $encoding = null)
- {
- return Utf8::strripos($haystack, $needle, $offset);
- }
- function api_strrpos($haystack, $needle, $offset = 0, $encoding = null)
- {
- return Utf8::strrpos($haystack, $needle, $offset);
- }
- function api_strstr($haystack, $needle, $before_needle = false, $encoding = null)
- {
- return Utf8::strstr($haystack, $needle, $before_needle);
- }
- function api_strtolower($string, $encoding = null)
- {
- return Utf8::strtolower($string);
- }
- function api_strtoupper($string, $encoding = null)
- {
- return Utf8::strtoupper($string);
- }
- function api_substr($string, $start, $length = null, $encoding = null)
- {
- if (is_null($length)) {
- $length = api_strlen($string, $encoding);
- }
- return Utf8::substr($string, $start, $length);
- }
- function api_substr_count($haystack, $needle, $encoding = null)
- {
- return Utf8::substr_count($haystack, $needle);
- }
- function api_substr_replace($string, $replacement, $start, $length = null, $encoding = null)
- {
- if (is_null($length)) {
- $length = api_strlen($string);
- }
- return UTf8::substr_replace($string, $replacement, $start, $length);
- }
- function api_ucfirst($string, $encoding = null)
- {
- return Utf8::ucfirst($string);
- }
- function api_ucwords($string, $encoding = null)
- {
- return Utf8::ucwords($string);
- }
- function api_preg_match(
- $pattern,
- $subject,
- &$matches = null,
- $flags = 0,
- $offset = 0,
- $encoding = null
- ) {
- if (empty($encoding)) {
- $encoding = _api_mb_internal_encoding();
- }
- return preg_match(api_is_utf8($encoding) ? $pattern.'u' : $pattern, $subject, $matches, $flags, $offset);
- }
- function api_preg_match_all($pattern, $subject, &$matches, $flags = PREG_PATTERN_ORDER, $offset = 0, $encoding = null)
- {
- if (empty($encoding)) {
- $encoding = _api_mb_internal_encoding();
- }
- if (is_null($flags)) {
- $flags = PREG_PATTERN_ORDER;
- }
- return preg_match_all(api_is_utf8($encoding) ? $pattern.'u' : $pattern, $subject, $matches, $flags, $offset);
- }
- function api_preg_replace($pattern, $replacement, $subject, $limit = -1, &$count = 0, $encoding = null)
- {
- if (empty($encoding)) {
- $encoding = _api_mb_internal_encoding();
- }
- $is_utf8 = api_is_utf8($encoding);
- if (is_array($pattern)) {
- foreach ($pattern as &$p) {
- $p = $is_utf8 ? $p.'u' : $p;
- }
- } else {
- $pattern = $is_utf8 ? $pattern.'u' : $pattern;
- }
- return preg_replace($pattern, $replacement, $subject, $limit, $count);
- }
- function api_preg_split($pattern, $subject, $limit = -1, $flags = 0, $encoding = null)
- {
- if (empty($encoding)) {
- $encoding = _api_mb_internal_encoding();
- }
- return preg_split(api_is_utf8($encoding) ? $pattern.'u' : $pattern, $subject, $limit, $flags);
- }
- function api_strcasecmp($string1, $string2, $language = null, $encoding = null)
- {
- return api_strcmp(api_strtolower($string1, $encoding), api_strtolower($string2, $encoding), $language, $encoding);
- }
- function api_strcmp($string1, $string2, $language = null, $encoding = null)
- {
- return strcmp($string1, $string2);
- }
- function api_strnatcmp($string1, $string2, $language = null, $encoding = null)
- {
- return strnatcmp($string1, $string2);
- }
- function api_natsort(&$array, $language = null, $encoding = null)
- {
- return natsort($array);
- }
- function api_natrsort(&$array, $language = null, $encoding = null)
- {
- return uasort($array, '_api_strnatrcmp');
- }
- function api_refine_encoding_id($encoding)
- {
- if (is_array($encoding)) {
- return array_map('api_refine_encoding_id', $encoding);
- }
- return strtoupper(str_replace('_', '-', $encoding));
- }
- function api_equal_encodings($encoding1, $encoding2, $strict = false)
- {
- static $equal_encodings = [];
- if (is_array($encoding1)) {
- foreach ($encoding1 as $encoding) {
- if (api_equal_encodings($encoding, $encoding2, $strict)) {
- return true;
- }
- }
- return false;
- } elseif (is_array($encoding2)) {
- foreach ($encoding2 as $encoding) {
- if (api_equal_encodings($encoding1, $encoding, $strict)) {
- return true;
- }
- }
- return false;
- }
- if (!isset($equal_encodings[$encoding1][$encoding2][$strict])) {
- $encoding_1 = api_refine_encoding_id($encoding1);
- $encoding_2 = api_refine_encoding_id($encoding2);
- if ($encoding_1 == $encoding_2) {
- $result = true;
- } else {
- if ($strict) {
- $result = false;
- } else {
- $alias1 = _api_get_character_map_name($encoding_1);
- $alias2 = _api_get_character_map_name($encoding_2);
- $result = !empty($alias1) && !empty($alias2) && $alias1 == $alias2;
- }
- }
- $equal_encodings[$encoding1][$encoding2][$strict] = $result;
- }
- return $equal_encodings[$encoding1][$encoding2][$strict];
- }
- function api_is_utf8($encoding)
- {
- static $result = [];
- if (!isset($result[$encoding])) {
- $result[$encoding] = api_equal_encodings($encoding, 'UTF-8');
- }
- return $result[$encoding];
- }
- function api_get_system_encoding()
- {
- return 'UTF-8';
- }
- function api_is_encoding_supported($encoding)
- {
- static $supported = [];
- if (!isset($supported[$encoding])) {
- $supported[$encoding] = _api_mb_supports($encoding) || _api_iconv_supports($encoding) || _api_convert_encoding_supports($encoding);
- }
- return $supported[$encoding];
- }
- function api_detect_encoding($string, $language = null)
- {
-
- if (api_is_valid_utf8($string)) {
- return 'UTF-8';
- }
- return mb_detect_encoding($string);
- }
- function api_is_valid_utf8($string)
- {
- return Utf8::isUtf8($string);
- }
- function api_is_valid_ascii(&$string)
- {
- return mb_detect_encoding($string, 'ASCII', true) == 'ASCII' ? true : false;
- }
- function api_is_valid_date($date, $format = 'Y-m-d H:i:s')
- {
- $d = DateTime::createFromFormat($format, $date);
- return $d && $d->format($format) == $date;
- }
- function get_plugin_lang($variable, $pluginName)
- {
- $plugin = $pluginName::create();
- return $plugin->get_lang($variable);
- }
- function &_api_get_day_month_names($language = null)
- {
- static $date_parts = [];
- if (empty($language)) {
- $language = api_get_interface_language();
- }
- if (!isset($date_parts[$language])) {
- $week_day = [
- 'Sunday',
- 'Monday',
- 'Tuesday',
- 'Wednesday',
- 'Thursday',
- 'Friday',
- 'Saturday',
- ];
- $month = [
- 'January',
- 'February',
- 'March',
- 'April',
- 'May',
- 'June',
- 'July',
- 'August',
- 'September',
- 'October',
- 'November',
- 'December',
- ];
- for ($i = 0; $i < 7; $i++) {
- $date_parts[$language]['days_short'][] = get_lang(
- $week_day[$i].'Short',
- '',
- $language
- );
- $date_parts[$language]['days_long'][] = get_lang(
- $week_day[$i].'Long',
- '',
- $language
- );
- }
- for ($i = 0; $i < 12; $i++) {
- $date_parts[$language]['months_short'][] = get_lang(
- $month[$i].'Short',
- '',
- $language
- );
- $date_parts[$language]['months_long'][] = get_lang(
- $month[$i].'Long',
- '',
- $language
- );
- }
- }
- return $date_parts[$language];
- }
- function _api_get_person_name_convention($language, $type)
- {
- static $conventions;
- $language = api_purify_language_id($language);
- if (!isset($conventions)) {
- $file = __DIR__.'/internationalization_database/name_order_conventions.php';
- if (file_exists($file)) {
- $conventions = include $file;
- } else {
- $conventions = [
- 'english' => [
- 'format' => 'title first_name last_name',
- 'sort_by' => 'first_name'
- ]
- ];
- }
-
- $customConventions = api_get_configuration_value('name_order_conventions');
- if (!empty($customConventions)) {
- foreach ($customConventions as $key => $data) {
- $conventions[$key] = $data;
- }
- }
- $search1 = ['FIRST_NAME', 'LAST_NAME', 'TITLE'];
- $replacement1 = ['%F', '%L', '%T'];
- $search2 = ['first_name', 'last_name', 'title'];
- $replacement2 = ['%f', '%l', '%t'];
- foreach (array_keys($conventions) as $key) {
- $conventions[$key]['format'] = str_replace($search1, $replacement1, $conventions[$key]['format']);
- $conventions[$key]['format'] = _api_validate_person_name_format(
- _api_clean_person_name(
- str_replace(
- '%',
- ' %',
- str_ireplace(
- $search2,
- $replacement2,
- $conventions[$key]['format']
- )
- )
- )
- );
- $conventions[$key]['sort_by'] = strtolower($conventions[$key]['sort_by']) != 'last_name' ? true : false;
- }
- }
- switch ($type) {
- case 'format':
- return is_string($conventions[$language]['format']) ? $conventions[$language]['format'] : '%t %f %l';
- case 'sort_by':
- return is_bool($conventions[$language]['sort_by']) ? $conventions[$language]['sort_by'] : true;
- }
- return null;
- }
- function _api_validate_person_name_format($format)
- {
- if (empty($format) || stripos($format, '%f') === false || stripos($format, '%l') === false) {
- return '%t %f %l';
- }
- return $format;
- }
- function _api_clean_person_name($person_name)
- {
- return preg_replace(['/\s+/', '/, ,/', '/,+/', '/^[ ,]/', '/[ ,]$/'], [' ', ', ', ',', '', ''], $person_name);
- }
- function _api_convert_encoding(&$string, $to_encoding, $from_encoding)
- {
- return mb_convert_encoding($string, $to_encoding, $from_encoding);
- }
- function _api_get_character_map_name($encoding)
- {
- static $character_map_selector;
- if (!isset($character_map_selector)) {
- $file = __DIR__.'/internationalization_database/conversion/character_map_selector.php';
- if (file_exists($file)) {
- $character_map_selector = include($file);
- } else {
- $character_map_selector = [];
- }
- }
- return isset($character_map_selector[$encoding]) ? $character_map_selector[$encoding] : '';
- }
- function _api_strnatrcmp($string1, $string2)
- {
- return strnatcmp($string2, $string1);
- }
- function _api_mb_internal_encoding($encoding = 'UTF-8')
- {
- return mb_internal_encoding($encoding);
- }
- function _api_mb_supports($encoding)
- {
- static $supported = [];
- if (!isset($supported[$encoding])) {
- if (MBSTRING_INSTALLED) {
- $supported[$encoding] = api_equal_encodings($encoding, mb_list_encodings(), true);
- } else {
- $supported[$encoding] = false;
- }
- }
- return $supported[$encoding];
- }
- function _api_iconv_supports($encoding)
- {
- static $supported = [];
- if (!isset($supported[$encoding])) {
- if (ICONV_INSTALLED) {
- $enc = api_refine_encoding_id($encoding);
- if ($enc != 'HTML-ENTITIES') {
- $test_string = '';
- for ($i = 32; $i < 128; $i++) {
- $test_string .= chr($i);
- }
- $supported[$encoding] = (@iconv_strlen($test_string, $enc)) ? true : false;
- } else {
- $supported[$encoding] = false;
- }
- } else {
- $supported[$encoding] = false;
- }
- }
- return $supported[$encoding];
- }
- function _api_convert_encoding_supports($encoding)
- {
- static $supports = [];
- if (!isset($supports[$encoding])) {
- $supports[$encoding] = _api_get_character_map_name(api_refine_encoding_id($encoding)) != '';
- }
- return $supports[$encoding];
- }
- function api_get_human_date_time($date, $showTime = true, $humanForm = false)
- {
- if ($showTime) {
- if ($humanForm) {
- return $date->format('j M Y H:i:s');
- } else {
- return $date->format('Y-m-d H:i:s');
- }
- } else {
- if ($humanForm) {
- return $date->format('j M Y');
- } else {
- return $date->format('Y-m-d');
- }
- }
- }
|