Описание:
Возвращяет название языка (например, "Русский", "English").
Названия всех языков из списка зарегистрированных в системе можно посмотреть (или изменить) в модуле "Конфигурация", закладка "Языки" (а также программно, используя метод lang::setTitle). Названия языков используются для задания текста, определяющего язык, понятного для посетителя сайта. Их можно выводить например в качестве текста ссылок, перенаправляющих посетителей на различные языковые версии сайта, или как атрибуты "alt" и "title" соответствующих изображений.
Пример кода:
<?php
/*
Допустим, мы хотим вывести панель для переключения между языковыми версиями сайта.
//
!!! В данной функции не учтено, что названия языков могут содержать любые символы (например, двойные кавычки), и их следует предварительно обработать перед тем как вставлять в html-код (например, в качестве значения атрибута)
*/
public function getExampleLangsPanel() {
$sPanel = "";
//
$oLangsColl = langsCollection::getInstance();
$arrLangsColl = $oLangsColl->getList();
foreach ($arrLangsColl as $iNextLangId=>$oNextLang) {
$sLangPrefix = $oNextLang->getPrefix();
$sUrlLangPart = ($sLangPrefix === langsCollection::getInstance()->getDefaultLang()->getPrefix() ? '' : $sLangPrefix.'/'); // для языка по умолчанию в url языковую часть не подставляем
$sLangTitle = Описание:
Устанавливает для языка префикс, по которому будет определяться языковая версия сайта.
Пример кода:
<?php
/*
Допустим, мы запускаем эту функцию в инсталляторе модуля, чтобы изменить префикс марсианского языка в системе с 'ma' на 'mars' (возможно, нам это понадобилось по каким-то причинам)
*/
$oLangsColl = langsCollection::getInstance();
$iMartianLangId = $oLangsColl->getLangId('ma');
if ($iMartianLangId !== false) {
$oMartianLang = $oLangsColl->getLang($iMartianLangId);
$oMartianLang->setPrefix('mars');
$oMartianLang->commit(); // не забываем сохранить изменения
// допустим, что это настолько важно, что мы не можем продолжать дальше в случае ошибки:
$iMartianLangId = $oLangsColl->getLangId('mars');
if ($iMartianLangId === false) {
throw new CoreException('Can not change martian language prefix');
}
}
?> 