После обновления в административной панели белый экран

Актуально для версии 2.9

Симптомы

Если после обновления системы Вы перешли в административную панель и увидели белый экран, то, прежде всего, Вам нужно включить режим "Дебага", для этого, откройте на редактирование файл config.ini, находящийся в корневой директории файлов Вашего сайта, и в секции [debug] установите следующие значения параметрам:

enabled = "1"
show-backtrace = "1"

После этого, перейдите в административную панель, если Вы увидите множественный XSLT ошибки вида:

Warning: XSLTProcessor::importStylesheet(): ^ in /mnt/sdb2/home/domains/c-madgrant/htdocs/classes/system/subsystems/umiTemplaters/types/umiTemplaterXSLT.phpon line 33
Warning: XSLTProcessor::importStylesheet(): compilation error: file /mnt/sdb2/home/domains/c-madgrant/htdocs/styles/skins/mac/interface/ui/navibar.xsl line 8 
element text in /mnt/sdb2/home/domains/c-madgrant/htdocs/classes/system/subsystems/umiTemplaters/types/umiTemplaterXSLT.php on line 33 
Warning: XSLTProcessor::importStylesheet(): xsltParseTemplateContent: xslt:text content problem in 
/mnt/sdb2/home/domains/c-madgrant/htdocs/classes/system/subsystems/umiTemplaters/types/umiTemplaterXSLT.php on line 33 
Warning: XSLTProcessor::importStylesheet(): /mnt/sdb2/home/domains/c-madgrant/htdocs/styles/skins/mac/interface/ui/site-langs.xsl:7: parser error :
Entity 'site-lang-versions' not defined in /mnt/sdb2/home/domains/c-madgrant/htdocs/classes/system/subsystems/umiTemplaters/types/umiTemplaterXSLT.php on line 33
Warning: XSLTProcessor::importStylesheet(): &site-lang-versions; in /mnt/sdb2/home/domains/c-madgrant/htdocs/classes/system/subsystems/umiTemplaters/types/umiTemplaterXSLT.php on line 33

То, данная статья Вам поможет.

Причина ошибки

Полученный ошибки связаны с тем, что система не смогла найти значения языковых констант для отображения административной панели текущей языковой версии, и из-за этого не смогли корректно отработать xsl шаблоны административной панели. Такая ситуация может возникнуть, например, если у Вас в русскоязычной версии административной панели используется файл языковых констант /classes/modules/i18n.ru.php. Дело в том, что при обновлении изменяется только системный файл констант /classes/modules/i18n.php и аналогичные файлы каждого модуля.

Решение

Для решения проблемы Вам нужно перенести все недостающие константы из файла i18n.php в i18n.ru.php и, при необходимости, в файлы языковых констант других версий. Узнать имена недостающих констант можно из текста ошибок, например, строка:

...
Entity 'site-lang-versions' not defined in /mnt/sdb2/home/domains/c-madgrant/htdocs/classes/system/subsystems/umiTemplaters/types/umiTemplaterXSLT.php on line 33
...

говорит нам о том, что не найдена константа 'site-lang-versions'