Функция cot_translit_encode в Cotonti

Функция cot_translit_encode выполняет транслитерацию строки, если для текущего языка доступна соответствующая таблица транслитерации.

Код функции:

function cot_translit_encode($str)
{
    global $lang, $cot_translit;
    static $lang_loaded = false;
    
    // Проверка: если язык не английский и файл с транслитерацией для текущего языка существует
    if (!$lang_loaded && $lang != 'en' && file_exists(cot_langfile('translit', 'core')))
    {
        // Подключение файла с транслитерацией для текущего языка
        require_once cot_langfile('translit', 'core');
        $lang_loaded = true;
    }
    
    // Если массив транслитерации существует, применяем его
    if (is_array($cot_translit))
    {
        $str = strtr($str, $cot_translit); // Преобразование строки с помощью транслитерации
    }
    
    return $str; // Возвращаем результат
}

Пояснение:

Глобальные переменные:

$lang — переменная, которая хранит текущий язык сайта.
$cot_translit — массив, содержащий правила транслитерации для текущего языка. Это массив вида ['символ_для_замены' => 'заменяющий_символ'].

Переменная $lang_loaded:

Это статическая переменная, которая сохраняет состояние загрузки файла с транслитерацией. Она нужна для того, чтобы файл загружался только один раз, даже если функция вызывается несколько раз.
Проверка и загрузка файла с транслитерацией:

Если транслитерация для текущего языка еще не загружена (переменная $lang_loaded равна false), а текущий язык не является английским ($lang != 'en'), функция пытается загрузить файл с транслитерацией, если он существует.
Файл с транслитерацией должен быть расположен в директории для языков в формате translit.php. Для этого используется функция cot_langfile('translit', 'core'), которая возвращает путь к файлу для текущего языка.

Преобразование строки:

Если массив $cot_translit существует (то есть файл с транслитерацией был успешно загружен), применяется функция strtr($str, $cot_translit), которая заменяет символы в строке $str по правилам, описанным в массиве $cot_translit.

Возврат результата:

Функция возвращает строку с выполненной транслитерацией (если она была применена).
Пример использования:
Если для русского языка существует файл с транслитерацией, в котором массив $cot_translit выглядит, например, так:
 
$cot_translit = [
    'я' => 'ya',
    'ю' => 'yu',
    'ш' => 'sh',
    // ... другие правила
];

Тогда вызов функции:
 
echo cot_translit_encode('Пример текста');

Вернет строку:

Primer teksta

Резюме:

Эта функция используется для транслитерации строк в зависимости от текущего языка сайта. Она полезна, например, при преобразовании кириллических символов в латиницу для создания человекочитаемых URL или других целей, где важно, чтобы текст был представлен в латинском алфавите.

$cot_languages['cn']= '中文';
$cot_languages['de']= 'Deutsch';
$cot_languages['dk']= 'Dansk';
$cot_languages['en']= 'English';
$cot_languages['es']= 'Español';
$cot_languages['fi']= 'Suomi';
$cot_languages['fr']= 'Français';
$cot_languages['gr']= 'Greek';
$cot_languages['hu']= 'Hungarian';
$cot_languages['it']= 'Italiano';
$cot_languages['jp']= '日本語';
$cot_languages['kr']= '한국어';
$cot_languages['nl']= 'Dutch';
$cot_languages['pl']= 'Polski';
$cot_languages['pt']= 'Portugese';
$cot_languages['ru']= 'Русский';
$cot_languages['se']= 'Svenska';
$cot_languages['ua'] = 'Українська';