Создание кастомных плагинов WordPress с паттернами и namespace

Главная > Создание кастомных плагинов WordPress с паттернами и namespace

Автор: Ольга Алексеева | Опубликовано: 18.11.2025

Разработка плагинов для WordPress – это не просто добавление функционала, но и грамотная организация кода, которая облегчает сопровождение и масштабирование проекта. В этой статье разберём, как создавать кастомные плагины с использованием namespace и распространённых шаблонов проектирования (паттернов) на примере практического кода.

Почему namespace важен в плагинах WordPress

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

Namespace позволяет изолировать код плагина, предотвращая конфликты и улучшая читаемость кода. Например, если ваш плагин называется IndexNowCustomPlugin, то можно использовать namespace IndexNowCustomPlugin.

Пример объявления namespace:

<?php
namespace IndexNowCustomPlugin;

class PluginCore {
    public function run() {
        // код запуска плагина
    }
}

Чтобы использовать классы из namespace, можно подключать их с помощью use или обращаться полностью по имени.

Использование паттернов проектирования в плагинах WordPress

Паттерны проектирования помогают создавать более структурированный и расширяемый код. Рассмотрим два основных паттерна, полезных в плагинах: Singleton и Observer.

Паттерн Singleton для главного класса плагина

Singleton гарантирует, что класс плагина будет создан только один раз, что удобно для управления состоянием и предотвращения дублирования.

namespace IndexNowCustomPlugin;

class PluginCore {
    private static $instance = null;

    private function __construct() {
        // Инициализация плагина
    }

    public static function getInstance() {
        if (self::$instance === null) {
            self::$instance = new self();
        }
        return self::$instance;
    }

    public function run() {
        // Запуск функционала
    }
}

// Инициализация плагина
PluginCore::getInstance()->run();

Такой подход исключает случайное создание нескольких экземпляров и упрощает доступ к функционалу.

Паттерн Observer для событий и хуков

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

Пример реализации простого Observable и Observer:

namespace IndexNowCustomPlugin;

interface Observer {
    public function update(string $event, $data);
}

class Observable {
    private $observers = [];

    public function attach(Observer $observer) {
        $this->observers[] = $observer;
    }

    public function notify(string $event, $data = null) {
        foreach ($this->observers as $observer) {
            $observer->update($event, $data);
        }
    }
}

class IndexNowObserver implements Observer {
    public function update(string $event, $data) {
        if ($event === 'post_saved') {
            // Логика обработки сохранения поста
        }
    }
}

// Использование
$observable = new Observable();
$observer = new IndexNowObserver();
$observable->attach($observer);
$observable->notify('post_saved', ['ID' => 123]);

Структура плагина с namespace и паттернами

Рекомендуемая структура папок и файлов плагина с namespace:

/indexnow-custom-plugin/ — корневая папка плагина
indexnow-custom-plugin.php — главный файл плагина с объявлением namespace и автозагрузкой
/src/ — папка с исходниками классов
/src/PluginCore.php — главный класс плагина (Singleton)
/src/Observer.php, Observable.php — классы для паттерна Observer

Главный файл для подключения:

<?php
/**
 * Plugin Name: IndexNow Custom Plugin
 * Description: Кастомный плагин с namespace и паттернами
 * Version: 1.0
 * Author: indexnow.su
 */

namespace IndexNowCustomPlugin;

spl_autoload_register(function ($class) {
    $prefix = __NAMESPACE__ . '\\';
    if (strpos($class, $prefix) !== 0) {
        return;
    }
    $relative_class = substr($class, strlen($prefix));
    $file = __DIR__ . '/src/' . str_replace('\\', '/', $relative_class) . '.php';
    if (file_exists($file)) {
        require $file;
    }
});

PluginCore::getInstance()->run();

Пример практического расширения плагина: отправка событий в IndexNow API

Допустим, нам нужно при публикации записи автоматически отправлять URL в IndexNow. Используем паттерн Observer для подписки на событие публикации и namespace.

namespace IndexNowCustomPlugin;

class IndexNowNotifier implements Observer {
    private $apiKey = 'ВАШ_API_КЛЮЧ';

    public function update(string $event, $data) {
        if ($event === 'post_published') {
            $url = get_permalink($data['ID']);
            $this->sendUrlToIndexNow($url);
        }
    }

    private function sendUrlToIndexNow(string $url) {
        $endpoint = 'https://api.indexnow.org/indexnow?url=' . urlencode($url) . '&key=' . $this->apiKey;

        $response = wp_remote_post($endpoint);

        if (is_wp_error($response)) {
            error_log('IndexNow API error: ' . $response->get_error_message());
        }
    }
}

// В PluginCore добавим инициализацию:
public function run() {
    // ...
    $observable = new Observable();
    $indexNowObserver = new IndexNowNotifier();
    $observable->attach($indexNowObserver);

    add_action('publish_post', function ($post_ID) use ($observable) {
        $observable->notify('post_published', ['ID' => $post_ID]);
    });
}

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