Что такое functions.php и как его использовать в WordPress?

functions.php или функционный файл темы – это важный файл, используемый темами WordPress. Он работает подобно небольшому плагину и автоматически загружается как в панели администратора, так и на внешних страницах сайта. Обычно его используют для добавления функций, классов, действий и фильтров, которые применяются в рамках темы. Через этот файл можно расширять функциональность темы и вносить изменения в поведение WordPress.

Где находится functions.php и как его использовать

Файл functions.php расположен в папке вашей темы:

В нём вы можете использовать встроенные функции WordPress, добавлять собственные PHP-функции и подключаться к действиям и фильтрам ядра. Хотя каждая установленная тема имеет свой собственный файл functions.php, работает только тот, который принадлежит активной теме. Если в вашей теме по какой-либо причине нет этого файла, вы можете просто создать текстовый файл с именем functions.php и поместить его в директорию темы.

Дочерние темы также могут иметь свои файлы functions.php. Они используются для того, чтобы дополнять или переопределять функциональность родительской темы. Это позволяет аккуратно добавлять изменения, не вмешиваясь в исходный код основной темы.

Что можно делать через functions.php (с примерами)

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

Включение поддержки миниатюр (thumbnails):

add_theme_support( 'post-thumbnails' );

Добавление новых форматов записей:

add_theme_support( 'post-formats', array( 'aside', 'gallery', 'quote' ) );

Создание навигационных меню:

register_nav_menus( array(
    'main_menu' => 'Главное меню',
    'footer_menu' => 'Меню в футере',
) );

Подключение собственных скриптов и стилей:

function my_theme_scripts() {
    wp_enqueue_style( 'main-style', get_stylesheet_uri() );
    wp_enqueue_script( 'custom-js', get_template_directory_uri() . '/js/custom.js', array('jquery'), null, true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );

Автоматическое добавление текста в конец каждой записи:

function add_custom_text($content) {
    if (is_single()) {
        $content .= '<p>Спасибо за чтение! Подпишитесь на обновления.</p>';
    }
    return $content;
}
add_filter('the_content', 'add_custom_text');

Создание собственного виджета:

class Welcome_Widget extends WP_Widget {
    function __construct() {
        parent::__construct('welcome_widget', 'Приветственный виджет');
    }
    function widget($args, $instance) {
        echo $args['before_widget'] . '<p>Добро пожаловать на наш сайт!</p>' . $args['after_widget'];
    }
}
add_action('widgets_init', function() {
    register_widget('Welcome_Widget');
});

Регистрация пользовательского типа записи (Custom Post Type):

function create_portfolio_post_type() {
    register_post_type('portfolio',
        array(
            'labels' => array('name' => 'Портфолио'),
            'public' => true,
            'has_archive' => true,
            'supports' => array('title', 'editor', 'thumbnail')
        )
    );
}
add_action('init', 'create_portfolio_post_type');

Что лучше помещать в functions.php, а что — в плагин

Functions.php идеален для:

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

Плагин лучше использовать, если:

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

Советы по работе с functions.php

• Используйте дочернюю тему для внесения изменений, чтобы обновления основной темы не стерли ваши функции.
• Минимизируйте количество кода в functions.php — если функционал большой или универсальный, лучше сделать плагин.
• Всегда тестируйте добавленные функции на локальном или тестовом сайте, чтобы не сломать сайт на продакшене.
• Используйте хуки (actions и filters), чтобы не изменять ядро WordPress и тем самым сохранить совместимость с будущими обновлениями.

Вывод

Файл functions.php остаётся ключевым инструментом для добавления PHP-функций и расширения функционала темы. Он позволяет гибко настраивать сайт, подключать стили и скрипты, добавлять виджеты, шорткоды и пользовательские типы записей.

Наша специальность — разработка и поддержка сайтов на WordPress. Контакты для бесплатной консультации — [email protected], +371 29394520