Здравствуйте сегодня попробуем создать простой плагин для wordpress, для того чтобы понять из чего состоит плагин, как его написать и установить на сайт, также приведу пример с кодом создания простого плагина на вордпресс.

Скачать исходники для статьи можно ниже

Для примера создадим плагин с уникальным названием mnogoblogplugin, который будет изменять заголовок записей следующим образом – каждое слово будет начинаться с заглавной буквы, то есть плагин будет преобразовывать в каждом слове заголовка первую букву из прописной в заглавную.

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

Например, заголовок:

My pervii plagin na wordpress

, будет преобразован в следующий:

My Pervii Plagin Na WordPress

Приступим:

1. Структура плагина:

Самый простой плагин может состоять только из одного PHP-файла – данный файл называется главным файлом плагина, его имя должно быть уникальным – именно такой плагин мы и будем сегодня создавать!

Многофункциональный плагин может содержать файлы JavaScript, CSS, изображения, языковые файлы и т.п., например так:

Все файлы плагина хранятся в папке, имя которой должно быть также уникально.

Поэтому, для начала создаем на своем компьютере папку с названием – mnogoblogplugin, в которой и будет располагаться php-файл нашего плагина.

2. Создаем главный файл плагина (php-файл)

2.1. Начало вашего файла должно содержать стандартный информационный заголовок.

<?php
/*
Plugin Name: Название плагина
Plugin URI: http://страница_с_описанием_плагина_и_его_обновлений
Description: Краткое описание плагина.
Version: Номер версии плагина, например: 1.0
Author: Имя автора плагина
Author URI: http://страница_автора_плагина
*/
?>

Минимальная информация, которая нужна WordPress, чтобы обнаружить ваш плагин — его название (Plugin Name).

Поэтому открываем бесплатный редактор кода – Notepad++ и создаем заголовок для нашего плагина:

<?php
/*
Plugin Name: mnogoblogplugin
Plugin URI: https://mnogoblog.ru/sozdaem-prostoj-plagin-wordpress
Description: Преобразует в каждом слове заголовка первую букву из прописной в заглавную.
Version: 1.0
Author: Mnogoblog
Author URI: https://mnogoblog.ru
*/
?>

К сведению, на этом шаге можно сказать, что простейший плагин готов, правда он ничего не умеет делать, но данный плагин можно уже установить и активировать на сайте wordpress.

Ну, а мы продолжим создавать плагин.

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

2.3. Программирование плагина.

Для того, чтобы плагины имели возможность влиять на работу ядра WordPress или на конечный результат его действий, была придумана система так называемых зацепок (часто их без перевода так и называют «хуками» от англ. hook — крючок, зацепка).

Принцип ее действия состоит в том, что каждая более или менее важная элементарная функция в ядре WordPress перед тем как вернуть какой-то результат своей работы или совершить какое-то важное действие (например вывести содержимое записи на странице, или произвести запрос к базе данных) «пытается» исполнить дополнительные инструкции (строки кода) предназначенные именно для нее в файлах плагина.

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

Например, перед тем как WordPress добавляет заголовок к записи, сначала он проверяет, имеет ли какой-либо плагин зарегистрированные функции для зацепки под названием «the_title» (элементарная функция):

add_filter( 'the_title', 'my_own_function_for_title' ); //Так выглядит регистрация в файле плагина новой функции my_own_function_for_title(); с дополнительным инструкциями для зацепки 'the_title'.

Если такая зацепка имеется (код выше), то текст заголовка «пропускается» через каждую такую зарегистрированную функцию (my_own_function_for_title), и выводится конечный результат.

Например, код функции my_own_function_for_title будет такой:

function my_own_function_for_title( $title ){
      $title = ucwords($title);
      return $title;
}

В данном случае она заставляет выводить каждое слово заголовка с большой буквы.

Таким образом код плагина для преобразования первой буквы каждого слова заголовка из прописной в заглавную будет выглядеть следующим образом:

<?php
/*
Plugin Name: mnogoblogplugin
Plugin URI: https://mnogoblog.ru/sozdaem-prostoj-plagin-wordpress
Description: Преобразует в каждом слове заголовка первую букву из прописной в заглавную.
Version: 1.0
Author: Mnogoblog
Author URI: https://mnogoblog.ru
*/

add_filter( 'the_title', 'my_own_function_for_title' );

function my_own_function_for_title( $title ){
      $title = ucwords($title);
      return $title;
}
?>

Сохраняем данный код в редакторе кода Notepad++ как php файл, например с названием mnogoblogtitle, далее перекидываем его в созданную ранее папку mnogoblogplugin.

Устанавливаем плагин

Чтобы плагин можно было установить – нужно заархивировать папку mnogoblogplugin в zip архив (можно воспользоваться бесплатной программой – 7-ZIP).

В результате у нас получится следующий файл – можете скачать его к себе на компьютер –  mnogoblogplugin.zip

Далее, чтобы установить и активировать данный плагин достаточно сделать следующее – зайти в панель управления wordpress, в левом меню выбрать пункт “Плагины” и его подпункт “Добавить новый”, далее выбрать закладку “Загрузить” и с помощью кнопки “Обзор” выбрать файл mnogoblogplugin.zip – установить и активировать плагин!