Как создать динамический файл в WordPress

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

Что такое динамический файл в WordPress и зачем он нужен

Динамический файл — это PHP-скрипт, который обрабатывается сервером при каждом запросе, генерируя уникальный HTML или другой контент. В WordPress обычно это шаблоны тем, но мы можем создавать свои файлы вне стандартной темы, подключая их через хуки или напрямую.

Зачем это нужно? Например, чтобы создать отчет по заказам в WooCommerce, выгрузку данных пользователей, обработку кастомных запросов или реализацию кастомного функционала, не влияющего на основную структуру сайта.

Основной плюс — гибкость и возможность интеграции с любыми внешними сервисами без необходимости создавать полноценный плагин.

Пример использования динамического файла

Допустим, нам нужно создать файл download-report.php, который формирует CSV-файл с данными из базы WordPress.

Как правильно подключать и обрабатывать динамические файлы в WordPress

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

Лучше сделать обработку через хук template_redirect в functions.php. Это позволит использовать все возможности WordPress, получать данные из базы, работать с пользователями, проверять права доступа и т.д.

Пример кода в functions.php для перехвата URL и обработки динамического файла:

function wphow_dynamic_file_handler() {
    if (isset($_GET['wphow_report']) && $_GET['wphow_report'] == 'csv') {
        if (!current_user_can('manage_options')) {
            wp_die('Доступ запрещен');
        }
        header('Content-Type: text/csv');
        header('Content-Disposition: attachment; filename="report.csv"');
        $output = fopen('php://output', 'w');
        fputcsv($output, ['ID', 'Username', 'Email']);
        $users = get_users();
        foreach ($users as $user) {
            fputcsv($output, [$user->ID, $user->user_login, $user->user_email]);
        }
        fclose($output);
        exit;
    }
}
add_action('template_redirect', 'wphow_dynamic_file_handler');

Теперь при обращении к https://ваш-сайт.ru/?wphow_report=csv администратор скачает CSV с пользователями.

Как создать отдельный шаблон для динамического файла внутри темы

Если нужно создать более сложный динамический файл с HTML-выводом, лучше сделать кастомный шаблон страницы. Для этого создаем файл шаблона в папке темы, например page-dynamic.php и в начале файла ставим:

<?php
/*
Template Name: WPHOW Динамический файл
*/
?>

Далее в шаблоне можно писать любой PHP-код с использованием функций WordPress, например, выводить данные из базы:

<?php
get_header();

if (!current_user_can('edit_posts')) {
    echo '<p>Доступ запрещен.</p>';
    get_footer();
    exit;
}

$custom_data = new WP_Query(['post_type' => 'custom_type']);
if ($custom_data->have_posts()) {
    echo '<ul>';
    while ($custom_data->have_posts()) {
        $custom_data->the_post();
        echo '<li>' . get_the_title() . '</li>';
    }
    echo '</ul>';
} else {
    echo '<p>Данных нет.</p>';
}

wp_reset_postdata();

get_footer();
?>

Чтобы использовать этот шаблон, создайте страницу в админке WordPress и выберите этот шаблон в атрибутах страницы.

Использование плагинов для динамического создания файлов

Если не хочется писать код с нуля, можно использовать плагины, которые расширяют возможности создания кастомных страниц и API:

• WP All Export — для экспорта данных в CSV, XML с удобным интерфейсом.
• Custom Post Type UI — для создания кастомных типов записей, которые потом можно динамически выводить.
• WP REST API Controller — позволяет создавать кастомные REST API эндпоинты без кода.

Плагины сильно облегчают задачу, но иногда нужен именно собственный код для максимальной кастомизации.

Пример расширения кода: динамическая генерация PDF

Для создания PDF можно использовать библиотеку TCPDF или FPDF. В WordPress подключаем библиотеку и в функции срабатывания выводим PDF с данными.

function wphow_generate_pdf() {
    if (isset($_GET['wphow_pdf']) && $_GET['wphow_pdf'] == '1') {
        if (!current_user_can('manage_options')) {
            wp_die('Доступ запрещен');
        }
        require_once get_template_directory() . '/lib/tcpdf/tcpdf.php';
        $pdf = new TCPDF();
        $pdf->AddPage();
        $pdf->SetFont('helvetica', '', 12);
        $pdf->Write(0, 'Отчет по пользователям');
        $users = get_users();
        foreach ($users as $user) {
            $pdf->Write(0, "\n" . $user->user_login . ' - ' . $user->user_email);
        }
        $pdf->Output('report.pdf', 'D');
        exit;
    }
}
add_action('template_redirect', 'wphow_generate_pdf');

Таким образом, при переходе по URL ?wphow_pdf=1 администратор скачает PDF с данными.

Безопасность и производительность динамических файлов

Обязательно проверяйте права доступа — не давайте скачивать или просматривать данные всем подряд. Используйте функции WordPress, такие как current_user_can(), is_user_logged_in().

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

Никогда не выводите данные без экранирования, чтобы избежать XSS и других уязвимостей.

Резюме: динамические файлы в WordPress — мощный инструмент

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

Используйте приведенные примеры как основу для собственных проектов и не забывайте про безопасность и производительность.