Как создать плагин wordpress

Регистрация настроек выполняется через register_setting():

add_action('admin_init', 'my_plugin_settings');
function my_plugin_settings() {
register_setting('my_plugin_settings_group', 'my_plugin_option');
add_settings_section(
'my_plugin_main_section',
'Основные настройки',
'my_plugin_section_callback',
'my_plugin'
);
add_settings_field(
'my_plugin_text',
'Текстовое поле',
'my_plugin_text_callback',
'my_plugin',
'my_plugin_main_section'
);
}
function my_plugin_section_callback() {
echo 'Настройте параметры плагина здесь.';
}
function my_plugin_text_callback() {
$value = get_option('my_plugin_option');
echo '';
}

Рекомендуется:

• Использовать уникальные префиксы для функций и опций, чтобы избежать конфликтов.
• Разбивать настройки на секции с add_settings_section() для удобства пользователя.
• Сохранять данные через register_setting() с функцией валидации при необходимости.

Работа с базой данных и создание пользовательских таблиц

Для создания пользовательских таблиц в WordPress используется глобальный объект $wpdb. Начните с определения имени таблицы, учитывая префикс базы данных, который хранится в $wpdb->prefix. Например: $table_name = $wpdb->prefix . 'custom_data';

Для создания таблицы применяют функцию dbDelta() из wp-admin/includes/upgrade.php. Она автоматически обновляет структуру таблицы при изменении схемы. Синтаксис SQL должен строго соответствовать формату MySQL, включая ключи и индексы. Пример:


require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
$sql = "CREATE TABLE $table_name (
  id mediumint(9) NOT NULL AUTO_INCREMENT,
  name varchar(100) NOT NULL,
  email varchar(100) NOT NULL,
  PRIMARY KEY (id)
) {$wpdb->get_charset_collate()};";
dbDelta( $sql );


Для безопасного вставления данных используйте метод $wpdb->insert(), который автоматически экранирует значения. Пример:


$wpdb->insert(
  $table_name,
  array( 'name' => 'Иван', 'email' => 'ivan@example.com' ),
  array( '%s', '%s' )
);


Для выборки данных применяйте $wpdb->get_results() с подготовленным SQL-запросом. Использование плейсхолдеров %s и %d обеспечивает защиту от SQL-инъекций:


$results = $wpdb->get_results(
  $wpdb->prepare( "SELECT * FROM $table_name WHERE email = %s", 'ivan@example.com' )
);


Для обновления записей используется $wpdb->update(), а для удаления $wpdb->delete(). Везде обязательно указывайте формат данных для безопасности.

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

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

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

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

function my_plugin_assets() {
  wp_enqueue_style('my-plugin-style', plugin_dir_url(__FILE__) . 'css/style.css', array(), '1.0.0');
  wp_enqueue_script('my-plugin-script', plugin_dir_url(__FILE__) . 'js/script.js', array('jquery'), '1.0.0', true);
}

После этого функция должна быть привязана к соответствующему хуку:

add_action('wp_enqueue_scripts', 'my_plugin_assets');

Важно различать хуки для фронтенда и админки. Для загрузки в админ-панели используйте admin_enqueue_scripts:

add_action('admin_enqueue_scripts', 'my_plugin_assets');

Таблица ниже показывает параметры функций подключения:

Для динамической передачи данных из PHP в JS используйте wp_localize_script. Пример:

wp_localize_script('my-plugin-script', 'myPluginData', array('ajaxUrl' => admin_url('admin-ajax.php')));

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

Тестирование плагина и публикация на WordPress.org

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

Для обнаружения ошибок подключите плагин Query Monitor. Он позволяет отслеживать PHP-ошибки, медленные запросы к базе данных и конфликтующие скрипты. Рекомендуется включить WP_DEBUG и WP_DEBUG_LOG, чтобы регистрировать предупреждения и ошибки.

Тестирование на совместимость с другими плагинами проводят, создавая сценарии с популярными плагинами, например WooCommerce, Yoast SEO и Contact Form 7. Проверяйте, что функциональность вашего плагина не нарушает работу этих инструментов и наоборот.

Перед публикацией создайте README-файл в формате Markdown с описанием функций, инструкцией по установке и списком изменений. Он должен содержать теги WordPress.org, например `== Changelog ==` и `== Installation ==`.

Для загрузки на WordPress.org создайте учетную запись и отправьте плагин через форму Add New Plugin. После проверки безопасности и лицензий WordPress выдаст SVN-доступ для размещения файлов. Структура должна включать папку плагина с основным PHP-файлом, папку assets для скриншотов и readme.txt.

После коммита в SVN используйте команду `svn commit -m "Initial commit"` для загрузки файлов. Проверяйте отображение плагина в репозитории и корректность скриншотов, иконок и описания. Регулярно обновляйте плагин, фиксируя баги и добавляя совместимость с новыми версиями WordPress.

Вопрос-ответ:

Что нужно для создания базового плагина WordPress?

Для начала требуется установленный WordPress и доступ к файловой системе сайта. Плагин создаётся как отдельная папка в директории /wp-content/plugins/, внутри которой создаётся основной PHP-файл с заголовком плагина. В этом файле прописывается информация о плагине и подключаются необходимые функции. После этого плагин можно активировать через админку WordPress.

Как правильно подключать скрипты и стили в плагине?

Для подключения скриптов и стилей нужно использовать функции WordPress wp_enqueue_script() и wp_enqueue_style(). Их вызывают внутри хука 'wp_enqueue_scripts' для фронтенда или 'admin_enqueue_scripts' для панели управления. Это позволяет избежать конфликтов с другими плагинами и темами и гарантирует корректную загрузку ресурсов.

Можно ли добавить настройки плагина в админку WordPress?

Да, можно создать страницу настроек через функцию add_menu_page() или add_submenu_page(). На этой странице можно размещать формы для ввода данных, сохранять их с помощью update_option() и получать через get_option(). Такой подход позволяет пользователю управлять функционалом плагина без редактирования кода.

Как обрабатывать данные, введённые пользователем в плагине?

Данные из форм лучше обрабатывать через функцию $_POST с последующей проверкой и очисткой с помощью функций sanitize_text_field(), esc_url() и других. Это предотвращает возможные уязвимости и некорректные значения. После обработки данные сохраняются в базу через update_option() или wp_insert_post(), в зависимости от задачи.

Можно ли добавить короткий код для использования функционала плагина в записях?

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

Какие шаги необходимы для создания базового плагина WordPress?

Для создания простого плагина нужно сначала создать папку в директории /wp-content/plugins/ с уникальным названием. Затем создайте главный PHP-файл с заголовком плагина, который включает имя, версию и автора. После этого можно добавить функции или хуки для расширения функционала сайта. Важно убедиться, что код не вызывает ошибок и совместим с текущей версией WordPress. Для проверки плагин нужно активировать через административную панель.

Как подключить внешний скрипт или стиль в плагине без конфликтов с темой?

Лучший способ добавить скрипты или стили — использовать функции wp_enqueue_script и wp_enqueue_style. Их стоит подключать через хук wp_enqueue_scripts для фронтенда или admin_enqueue_scripts для административной панели. При этом рекомендуется использовать уникальные префиксы для идентификаторов файлов, чтобы избежать совпадений с другими плагинами или темой. Также можно указать зависимости и версии файлов, что поможет управлять загрузкой и кешированием.