Описание:
Метод назначает язык с идентификатором $lang_id языком системы по умолчанию.
Язык системы по умолчанию - это язык, который использует система в качестве языка домена, если у объекта класса домен (domain) по каким-либо причинам не указан язык по умолчанию
Язык по умолчанию домена - это язык, который использует система (во всех случаях, когда ее поведение зависит от текущего языка), если ей явно не указано, какой язык следует использовать. Например, если имеется две языковые версии сайта (доиена) - русская и английская, и при этом русский назначен языком по умолчанию, все ссылки на английские страницы должны иметь вид http://www.example.com/en/some_english_page/, на русские же - просто http://www.example.com/some_russian_page/.
Пользователи системы не могут сами назначать язык системы по умолчанию. Пользователям доступно только изменения значения по умолчанию для языков доменоа (раздел "Конфигурация", закладка "Домены").
NOTE: Не следует использовать НЕДОКУМЕНТИРОВАННЫЙ метод setIsDefault для объектов типа lang, так как это не приведет к желаемому результату. Несмотря на то, что методы могут показаться сходными по назначению, для установки языка системы по умолчанию необходимо использовать именно метод langsCollection::setDefault класса langsCollection. Метод же setIsDefault класса lang определен для внутреннего использования системой.
NOTE: Обратите внимание, что в большинстве случаев разработчику не требуется использование метода langsCollection::setDefault класса langsCollection; скорее всего вам требуется метод domains::setDefaultLangId класса domain
Пример кода:
<?php
/*
Данный пример устанавливает языком по умолчанию системы английский (язык, зарегистрированного в системе с префиксом 'en')
*/
$lang_id = langsCollection::getInstance()->getLangId("en"); // получили id языка по префиксу
if ($lang_id !== false) {
langsCollection::getInstance()->setDefault($lang_id); // назначили его языком по умолчанию
// метод setDefault ничего не возвращает, поэтому проверяем результат действия дополнительной инструкцией:
$oDefaultLang = langsCollection::getInstance()->getDefaultLang();
$bActionSuccessfull = ($lang_id === $oDefaultLang->getId());
}
?>
