Работа с шаблоном Joomla: что проверить до правок

За 30–60 минут вы подготовите сайт на Joomla 5.x к безопасной работе с шаблоном: найдёте активный стиль, проверите позиции модулей, создадите переопределение и поймёте, какие файлы нельзя редактировать напрямую. Это важно до первой правки: обновление шаблона или Joomla может удалить изменения, внесённые в исходные файлы.

Главное правило Joomla: не исправляйте внешний вид в файлах, которые принадлежат расширению или шаблону. Сначала ищите настройку, затем переопределение, и только потом меняйте код в копии.

Что нужно иметь до начала

Инструкция рассчитана на Joomla 5.x. В Joomla 4.x названия отдельных кнопок и разделов могут отличаться. Перед работой проверьте ветку Joomla в панели администратора: Система — Информация о системе.

• административный доступ с правом управления шаблонами и расширениями;
• резервную копию файлов и базы данных, которую можно восстановить;
• доступ к сайту по SFTP или к файловому менеджеру хостинга;
• отдельный тестовый сайт, если изменения затрагивают интернет-магазин или рабочий проект;
• название активного шаблона и его версию;
• современный браузер с инструментами разработчика.

Если сайт размещён на хостинге, выясните, кто может восстановить резервную копию. Бэкап, который нельзя развернуть, не защищает от неудачного обновления. Для первой правки не используйте продакшен, если есть хотя бы минимальная возможность проверить результат на копии.

Сноска. Переопределение — копия файла расширения внутри шаблона. Joomla использует её вместо исходного файла, поэтому обновление компонента обычно не затирает вашу разметку.

Как устроена работа с шаблоном

В Joomla есть три разных уровня изменений. Их часто смешивают, а затем не понимают, почему результат пропал после обновления.

• Стиль шаблона — настройки, цвета, логотип, шрифты и назначение шаблона для пунктов меню. Это не копия шаблона и не отдельный набор файлов.
• Файлы шаблона — PHP-разметка, CSS, JavaScript и изображения. Прямая правка быстрее, но её легко потерять при обновлении.
• Переопределения — изменённые представления компонентов и модулей внутри шаблона. Это основной способ менять HTML Joomla без редактирования файлов расширения.

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

Пошаговая подготовка к первой правке

1. Определите активный шаблон. В админ-панели откройте Система — Шаблоны — Шаблоны сайта. Звёздочка показывает стиль, который используется по умолчанию. Откройте его и проверьте, к каким пунктам меню он привязан.
   Проверка: откройте главную страницу в режиме инкогнито и убедитесь, что выбранный стиль действительно отображается.
2. Проверьте назначение для конкретной страницы. Стиль может быть назначен не всему сайту, а отдельному пункту меню. Поэтому главная страница, материал и страница категории иногда используют разные настройки.
   Проверка: откройте нужный пункт меню и сравните назначенный стиль с тем, который вы редактируете.
3. Сохраните исходные данные. Скачайте файлы сайта, экспортируйте базу и запишите название шаблона. Отдельно сохраните список установленных расширений.
   Проверка: найдите в скачанной копии папки administrator, components, modules, plugins и templates, а файл базы данных открывается как текстовый дамп.
4. Поймите, какой файл отвечает за нужный блок. В инструментах разработчика нажмите правой кнопкой на элемент и выберите просмотр кода. Ищите классы, например mod-menu, com-content или собственный класс шаблона. Не меняйте код прямо в браузере: DevTools показывает временный результат.
   Проверка: вы можете назвать компонент или модуль, который выводит блок, и пункт меню, на котором он появляется.
5. Создайте дочерний шаблон, если меняете структуру. В менеджере шаблонов откройте страницу исходного шаблона и проверьте, доступна ли команда создания дочернего шаблона. Joomla 5.x поддерживает этот подход для шаблонов, которые его предоставляют.
   Проверка: в списке шаблонов появляется отдельная запись, а исходный шаблон остаётся нетронутым.
6. Для изменения HTML создайте переопределение. Откройте Система — Шаблоны — Переопределения шаблона, выберите сайт и нужный шаблон. Joomla покажет компоненты и модули, для которых можно создать копию представления.
   Проверка: после создания появляется файл в разделе переопределений, а Joomla не сообщает об ошибке записи.
7. Для CSS используйте отдельный пользовательский файл. У Cassiopeia для пользовательских стилей обычно применяется файл user.css внутри каталога стилей шаблона. У сторонней темы путь и способ подключения могут отличаться, поэтому сначала проверьте документацию разработчика.
   Проверка: добавьте временное, заметное, но безопасное правило для тестового элемента, обновите страницу и убедитесь, что оно применилось.
8. Очистите кэш после проверки. В Joomla очистите кэш через раздел системы, затем обновите страницу без использования старых ресурсов браузера. Если включено кеширование на сервере или CDN, очистите и его.
   Проверка: в исходном коде страницы или в DevTools загружается актуальный CSS, а не старая версия из кэша.

Что нельзя менять напрямую

Не редактируйте файлы в components, modules и plugins, если задача решается переопределением. Эти каталоги принадлежат расширениям, и обновление может заменить ваши изменения. Также не копируйте целиком стандартный шаблон в другой каталог без понимания его манифеста, путей к ресурсам и зависимостей.

Осторожнее с файлами index.php и файлами конфигурации шаблона. Ошибка в PHP может привести к белому экрану или сообщению о внутренней ошибке сервера. Если правка требует PHP-кода, сначала включите журналирование на тестовом сайте и проверьте версию PHP, которую поддерживает ваш шаблон.

Если не получилось

• Изменения не видны. Очистите кэш Joomla, браузера, хостинга и CDN. Затем откройте CSS в DevTools и проверьте, загружается ли нужный файл.
• Изменился не тот экран. Проверьте назначение стиля для пункта меню. В Joomla один сайт может одновременно использовать несколько стилей одного шаблона.
• Появилось сообщение «0 Call to a member function ...». Обычно это PHP-ошибка в переопределении или несовместимость с новой версией расширения. Временно переименуйте переопределение на тестовой копии и посмотрите журнал ошибок сервера.
• Появилось сообщение «The requested page could not be found». Проверьте, не удалён ли файл переопределения, не изменился ли путь представления и включены ли корректные маршруты. Не исправляйте это копированием случайного файла из другого шаблона.
• Вместо страницы отображается ошибка 500. Верните последний изменённый файл из резервной копии, проверьте журнал PHP и версию PHP. Если доступа к журналу нет, обратитесь к хостингу, а не отключайте защитные ограничения на рабочем сайте.

Как проверить результат перед публикацией

Одной проверки на главной странице недостаточно. Пройдите по тем сценариям, где используется изменённый блок: материал, категория, поиск, мобильное меню, форма входа и страница с ошибкой 404, если правка касается общей разметки.

• проверьте ширину 320–375 пикселей и десктопный экран;
• откройте страницу от имени гостя и авторизованного пользователя;
• проверьте несколько языков, если включена мультиязычность;
• посмотрите консоль браузера и вкладку Network на ошибки загрузки CSS, JavaScript и изображений;
• сравните результат после очистки кэша, а не только в уже открытой вкладке.

После обновления Joomla или расширения повторите эту проверку. Обновление может изменить структуру данных представления, и старое переопределение перестанет совпадать с новым исходным файлом.

Что делать дальше

Сначала внесите одну небольшую правку на копии сайта и запишите путь к изменённому файлу. Затем обновите Joomla и расширение на тестовой среде, снова проверьте страницу и только после этого переносите изменения на продакшен. Для контроля заведите список переопределений: название расширения, путь, дата создания и версия Joomla, на которой оно проверялось.

Если задача связана не с внешним видом, а с логикой компонента, не пытайтесь решать её через шаблон. Сначала изучите документацию конкретного расширения и его механизм событий или плагинов: переопределение меняет вывод, но не исправляет бизнес-логику.