iT-Ti.ruочерки сисадмина

Сайт и хостинг WordPress

Файл functions.php темы WordPress: что в нём хранить и как не сломать сайт

Опубликовано: Обновлено: 4 мин чтенияАвтор: Редакция iT-Ti.ru

functions.php — файл темы, в котором подключаются хуки и возможности: размеры миниатюр, меню, скрипты, фильтры. Править его нужно в дочерней теме или в плагине фрагментов кода, с резервной копией и без встроенного редактора.

Файл functions.php в каталоге темы запускается при каждой загрузке страницы, как мини-плагин. Через него тема сообщает WordPress о своих возможностях и изменяет поведение ядра при помощи хуков. Сильная сторона файла — гибкость, слабая — любая ошибка в нём ломает весь сайт.

Что туда класть

Подходит всё, что относится к теме и внешнему виду:

  • add_theme_support() — миниатюры, title-tag, HTML5-разметка, широкие блоки;
  • регистрация меню, областей виджетов и размеров изображений;
  • подключение стилей и скриптов через wp_enqueue_style() и wp_enqueue_script();
  • небольшие фильтры для вывода (excerpt_length, the_content).

Что не стоит: регистрацию типов записей и таксономий, шорткоды и бизнес-логику сайта. Они исчезнут при смене темы, и контент «пропадёт» из админки. Такой код — для плагина. О структуре темы в целом читайте в статье про каркас темы WordPress.

Дочерняя тема

Если вы правите functions.php готовой темы, при её обновлении изменения пропадут. Дочерняя тема решает проблему. Создайте каталог my-theme-child рядом с родительской и положите в него:

/*
Theme Name: My Theme Child
Template: my-theme
Version: 1.0
*/
<?php
add_action( 'wp_enqueue_scripts', function () {
    wp_enqueue_style( 'parent-style', get_template_directory_uri() . '/style.css' );
    wp_enqueue_style( 'child-style', get_stylesheet_uri(), [ 'parent-style' ] );
} );

Значение Template — это имя каталога родительской темы. functions.php дочерней темы загружается раньше родительского, поэтому не копируйте файл целиком: добавляйте только свои функции. Если у родительской темы функция объявлена с проверкой function_exists(), её можно переопределить. Для блочных тем с theme.json дочерняя тема нужна реже, но принцип тот же.

Хуки: add_action и add_filter

Хуки бывают двух видов: действия (action) выполняют код в определённой точке, фильтры (filter) принимают значение и возвращают изменённое. Примеры:

<?php
// 1. Убрать версию WordPress из <head> и ленты
remove_action( 'wp_head', 'wp_generator' );
add_filter( 'the_generator', '__return_empty_string' );

// 2. Отключить эмодзи
add_action( 'init', function () {
    remove_action( 'wp_head', 'print_emoji_detection_script', 7 );
    remove_action( 'wp_print_styles', 'print_emoji_styles' );
    remove_action( 'admin_print_scripts', 'print_emoji_detection_script' );
    remove_action( 'admin_print_styles', 'print_emoji_styles' );
} );

// 3. Свой размер миниатюры
add_action( 'after_setup_theme', function () {
    add_theme_support( 'post-thumbnails' );
    add_image_size( 'card', 480, 270, true );
} );

// 4. Длина анонса
add_filter( 'excerpt_length', fn() => 40 );

Пояснения. Скрыть версию WordPress полезно, но это не защита: уязвимости определяются и другими способами, главное — вовремя обновляться. Отключение эмодзи убирает лишний скрипт и стиль, а размер card применяется к новым загрузкам; старые изображения пересоздают командой wp media regenerate из WP-CLI или плагином. Приоритет (третий параметр add_action) определяет порядок: меньше число — раньше.

Безопасное редактирование

  1. Не используйте встроенный редактор «Внешний вид → Редактор файлов тем». После ошибки вы потеряете доступ к админке, а само редактирование из браузера рискованно. Рекомендуется отключить его: define( 'DISALLOW_FILE_EDIT', true ); в wp-config.php.
  2. Делайте копию файла и файлов темы перед каждой правкой. Лучше держать тему в Git.
  3. Работайте на тестовой копии сайта или локально, затем переносите изменения.
  4. Включите отладку в wp-config.php на тестовой копии:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Ошибки пишутся в wp-content/debug.log. Начиная с WordPress 5.2 при фатальной ошибке в плагине или теме включается режим защиты от сбоев, и администратору приходит письмо со ссылкой на восстановление, но на практике белый экран всё равно случается.

В файле не должно быть пробелов и пустых строк до <?php, а закрывающий ?> в конце не нужен: лишний вывод приводит к ошибкам «headers already sent» и ломает даже RSS-ленту.

Если сайт упал

Белый экран или ошибка 500 после правки: подключитесь по FTP или SFTP, откройте файловый менеджер хостинга либо SSH. Откройте wp-content/themes/ваша-тема/, верните прежнюю копию functions.php или переименуйте каталог темы: WordPress переключится на стандартную тему. Затем изучите debug.log и найдите строку с ошибкой. Если сайт на вашем сервере, можно проверить синтаксис командой php -l functions.php.

Code Snippets как альтернатива

Плагины вроде Code Snippets позволяют хранить фрагменты кода в админке с включением и отключением по одному. Ошибка в фрагменте обычно приводит к его автоматической деактивации, а сам код не привязан к теме и остаётся после её смены. Для небольших правок это безопаснее правки файла, но помните: каждый фрагмент — это тоже исполняемый PHP, и доступ к нему должен быть только у администраторов. Подробнее о том, почему исполнять произвольный код из контента нельзя, см. в материале про вывод кода на странице.

Частые вопросы

Где находится файл functions.php в WordPress?

В каталоге активной темы: wp-content/themes/название-темы/functions.php. У дочерней темы свой functions.php, который выполняется до родительского.

Почему после правки functions.php сайт показывает белый экран?

Скорее всего, в файле синтаксическая ошибка или вызов несуществующей функции, и PHP остановился с фатальной ошибкой. Исправьте или откатите файл через FTP, файловый менеджер хостинга или SSH.

Куда лучше вставлять свой код: в functions.php или в плагин?

Код, связанный с оформлением (размеры изображений, меню, подключение стилей), логично хранить в теме. Функциональность, которая должна пережить смену темы, лучше оформить плагином или хранить в плагине фрагментов кода.

Как отключить эмодзи в WordPress?

Снять хуки wp_head и wp_print_styles, отвечающие за скрипт и стили эмодзи, через remove_action в functions.php. Готовый код приведён в разделе с примерами.