Подключение файлов в WordPress с помощью include и require

Расширенные и нестандартные примеры использования include в WordPress

Динамическое подключение на основе условий

Пример: загрузка разных шаблонов в зависимости от типа записи.

$post_type = get_post_type();
$file = locate_template("template-parts/content-{$post_type}.php");
if ($file) {
    include $file;
} else {
    // Запасной вариант
    get_template_part('template-parts/content', 'default');
}

Подключение конфигурационного файла с возвратом массива

Файл config/theme-settings.php:

<?php
return array(
    'color' => '#333',
    'font' => 'Open Sans',
    'version' => '2.0.1',
);

В основном файле:

$settings = include locate_template('config/theme-settings.php');
if (is_array($settings)) {
    echo 'Цвет: ' . $settings['color'];
}

Результат: Вывод Цвет: #333.

Подключение файла из директории плагина с проверкой

$plugin_file = WP_PLUGIN_DIR . '/my-plugin/inc/vendor.php';
if (file_exists($plugin_file)) {
    require_once $plugin_file;
} else {
    // Вывод сообщения администратору
    add_action('admin_notices', function() {
        echo '<div class="notice notice-warning"><p>Файл vendor.php не найден.</p></div>';
    });
}

Использование include в хуке для добавления контента в футер

add_action('wp_footer', function() {
    if (is_single()) {
        include locate_template('template-parts/related-posts.php');
    }
});

Результат: На странице одиночной записи подключается блок похожих записей.

Подключение класса с автозагрузкой через include

// В functions.php
require_once locate_template('inc/class-custom-walker.php');

// Использование:
$walker = new Custom_Walker_Nav_Menu();

Результат: Класс становится доступным глобально.

Безопасное подключение с передачей глобальных переменных через extract

$data = array('posts' => get_posts(), 'title' => 'Последние новости');
extract($data);
include locate_template('template-parts/news-block.php');

Внутри news-block.php переменные $posts и $title доступны напрямую.

Подключение файла из дочерней темы с приоритетом

$file = locate_template('override.php');
if (!$file) {
    // Если файла нет ни в дочерней, ни в родительской теме
    $file = get_stylesheet_directory() . '/fallback.php';
    if (!file_exists($file)) {
        $file = false;
    }
}
if ($file) {
    include_once $file;
}

Результат: Сначала подключается файл из дочерней темы, затем из родительской, и только потом запасной.

Парсинг PHP-шаблона как строки с помощью буферизации и передачи аргументов

function render_template($template_name, $vars = array()) {
    $path = locate_template("templates/{$template_name}.php");
    if (!$path) return '';
    
    extract($vars);
    ob_start();
    include $path;
    return ob_get_clean();
}

// Использование:
echo render_template('email-notification', array('user' => $user, 'message' => 'Привет!'));

Результат: Возвращается готовый HTML-код письма.

Подключение файла с проверкой версий для кэширования

$theme_version = wp_get_theme()->get('Version');
$file_path = get_template_directory() . '/assets/css/custom.css';
if (file_exists($file_path)) {
    // Подключаем как inline стили
    $css_content = file_get_contents($file_path);
    echo '<style id="custom-theme-css" data-version="' . esc_attr($theme_version) . '">' . $css_content . '</style>';
}

Результат: CSS-стили внедряются напрямую, минуя внешний файл.