Файл functions.php темы WordPress: что в нём хранить и как не сломать сайт
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) определяет порядок: меньше число — раньше.
Безопасное редактирование
- Не используйте встроенный редактор «Внешний вид → Редактор файлов тем». После ошибки вы потеряете доступ к админке, а само редактирование из браузера рискованно. Рекомендуется отключить его:
define( 'DISALLOW_FILE_EDIT', true );вwp-config.php. - Делайте копию файла и файлов темы перед каждой правкой. Лучше держать тему в Git.
- Работайте на тестовой копии сайта или локально, затем переносите изменения.
- Включите отладку в
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. Готовый код приведён в разделе с примерами.