Как создать свой плагин для WordPress с нуля: пошаговое руководство

Автор: Кирилл Сорокин | Опубликовано: 19.11.2025

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

Почему стоит создавать свой плагин для WordPress

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

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

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

Структура плагина WordPress: что нужно знать

Минимальный плагин — это один PHP-файл с заголовком. Но для удобства разработки и масштабируемости лучше организовать структуру:

wpconsult-myplugin.php — основной файл с описанием и кодом;
/includes/ — вспомогательные классы и функции;
/assets/ — CSS, JS, изображения;
/languages/ — файлы локализации.

Основной файл обязательно должен иметь заголовок с метаинформацией, например:

<?php
/*
Plugin Name: WPConsult Sample Plugin
Plugin URI: https://wpconsult.ru
Description: Пример простого плагина для WordPress
Version: 1.0
Author: WPConsult
Author URI: https://wpconsult.ru
Text Domain: wpconsult-sample
*/

// Код плагина здесь

Основные хуки и фильтры для плагина

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

Рассмотрим базовый пример регистрации шорткода, который выводит текущую дату:

function wpconsult_display_date() {
    return date('d.m.Y');
}
add_shortcode('wpconsult_date', 'wpconsult_display_date');

Теперь в любом посте или странице можно вставить [wpconsult_date], и плагин покажет текущую дату.

Добавление настроек плагина в админ-панель WordPress

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

Пример добавления страницы настроек:

function wpconsult_add_settings_page() {
    add_options_page(
        'Настройки WPConsult',
        'WPConsult Settings',
        'manage_options',
        'wpconsult-settings',
        'wpconsult_render_settings_page'
    );
}
add_action('admin_menu', 'wpconsult_add_settings_page');

function wpconsult_render_settings_page() {
    ?>
    <div class="wrap">
        <h1>Настройки WPConsult</h1>
        <form method="post" action="options.php">
            <?php
            settings_fields('wpconsult_settings_group');
            do_settings_sections('wpconsult-settings');
            submit_button();
            ?>
        </form>
    </div>
    <?php
}

Далее нужно зарегистрировать настройки и поля:

function wpconsult_register_settings() {
    register_setting('wpconsult_settings_group', 'wpconsult_option_text');

    add_settings_section(
        'wpconsult_main_section',
        'Основные настройки',
        null,
        'wpconsult-settings'
    );

    add_settings_field(
        'wpconsult_option_text',
        'Текст опции',
        'wpconsult_option_text_callback',
        'wpconsult-settings',
        'wpconsult_main_section'
    );
}
add_action('admin_init', 'wpconsult_register_settings');

function wpconsult_option_text_callback() {
    $value = get_option('wpconsult_option_text', '');
    echo '<input type="text" name="wpconsult_option_text" value="' . esc_attr($value) . '" />';
}

Так вы создадите страницу настроек с одним текстовым полем, значение которого хранится в базе.

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

Чтобы расширить функционал, часто нужно добавить CSS и JavaScript. Делается это через хуки wp_enqueue_scripts для фронтенда и admin_enqueue_scripts для админки.

Пример подключения в фронтенде:

function wpconsult_enqueue_scripts() {
    wp_enqueue_style('wpconsult-style', plugin_dir_url(__FILE__) . 'assets/css/style.css');
    wp_enqueue_script('wpconsult-script', plugin_dir_url(__FILE__) . 'assets/js/script.js', array('jquery'), null, true);
}
add_action('wp_enqueue_scripts', 'wpconsult_enqueue_scripts');

Для админки код аналогичный, но с другим хуком.

Пример простого плагина: счетчик посещений поста

Давайте создадим плагин, который считает и отображает количество просмотров каждого поста.

Сначала создадим функцию для увеличения счетчика:

function wpconsult_set_post_views($postID) {
    $count_key = 'wpconsult_post_views_count';
    $count = get_post_meta($postID, $count_key, true);
    if($count=='') {
        $count = 0;
        delete_post_meta($postID, $count_key);
        add_post_meta($postID, $count_key, '1');
    } else {
        $count++;
        update_post_meta($postID, $count_key, $count);
    }
}

Затем добавим вызов этой функции при загрузке одиночного поста:

function wpconsult_track_post_views ($post_id) {
    if ( !is_single() ) return;
    if ( empty ( $post_id) ) {
        global $post;
        $post_id = $post->ID;
    }
    wpconsult_set_post_views($post_id);
}
add_action( 'wp_head', 'wpconsult_track_post_views');

И наконец, функция для отображения количества просмотров:

function wpconsult_get_post_views($postID){
    $count_key = 'wpconsult_post_views_count';
    $count = get_post_meta($postID, $count_key, true);
    if($count=='') {
        delete_post_meta($postID, $count_key);
        add_post_meta($postID, $count_key, '0');
        return '0 просмотров';
    }
    return $count . ' просмотров';
}

Выводите количество просмотров в шаблоне с помощью echo wpconsult_get_post_views(get_the_ID());.

Заключение: создаем полезный и надежный плагин с WPConsult

Разработка собственного плагина — задача вполне доступная, если следовать рекомендациям и использовать стандарты WordPress. В этой статье показаны базовые шаги: структура, регистрация шорткодов, добавление настроек, подключение скриптов и пример реального функционала — счетчика просмотров.

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

Как создать свой плагин для WordPress с нуля