Кастомизированные страницы ошибок

В этой статье вы узнаете, как создавать и настраивать страницы ошибок, соответствующие вашим нуждам и требованиям.

Создание страницы ошибки

Когда CMS Engine сталкивается с ошибкой при попытке выполнить запрос, он будет искать предназначенную для этого страницу ошибки для отображения в браузере.

Чтобы добавить кастомизированную страницу ошибки:

  1. Создайте новую папку по пути /templates/web/errors.

  2. Разработайте шаблон Freemarker, назвав его именем конкретного кода ошибки, для которого будет отображаться соответствующая страница (например, 404.ftl).

Разработчики могут внедрять любой HTML/CSS/JS в шаблон страницы ошибки, чтобы обеспечить интеграцию с общим дизайном сайта.

Кастомизированные страницы ошибок действуют как независимые шаблоны. Они не связаны с каким-либо конкретным элементом сайта и не имеют доступа к объекту model.

Для отображения кастомизированных страниц ошибок необходимо наличие допустимого контекста. В случаях, когда CMS Engine не может загрузить контекст сайта из-за проблем конфигурации или других ошибок, пользователи столкнутся с общей страницей о системной ошибке.

После сохранения файла он будет автоматически использоваться при предварительном просмотре. Однако для delivery-узла важно опубликовать новый файл, чтобы внести изменения на действующем сайте.

Связанные статьи

Документация для разработчиков