Кастомизированные страницы ошибок
Создание страницы ошибки
Когда CMS Engine сталкивается с ошибкой при попытке выполнить запрос, он будет искать предназначенную для этого страницу ошибки для отображения в браузере.
Чтобы добавить кастомизированную страницу ошибки:
-
Создайте новую папку по пути
/templates/web/errors
. -
Разработайте шаблон Freemarker, назвав его именем конкретного кода ошибки, для которого будет отображаться соответствующая страница (например,
404.ftl
).
Разработчики могут внедрять любой HTML/CSS/JS в шаблон страницы ошибки, чтобы обеспечить интеграцию с общим дизайном сайта.
Кастомизированные страницы ошибок действуют как независимые шаблоны. Они не связаны с каким-либо конкретным элементом сайта и не имеют доступа к объекту model
.
Для отображения кастомизированных страниц ошибок необходимо наличие допустимого контекста. В случаях, когда CMS Engine не может загрузить контекст сайта из-за проблем конфигурации или других ошибок, пользователи столкнутся с общей страницей о системной ошибке.
После сохранения файла он будет автоматически использоваться при предварительном просмотре. Однако для delivery-узла важно опубликовать новый файл, чтобы внести изменения на действующем сайте.