Руководство для начинающих по созданию плагина WordPress
Плагины упрощают интеграцию определенных функций в веб-сайт WordPress. Если вам нужно, чтобы ваш веб-сайт выполнял определенную функцию, вы можете загрузить плагин из библиотеки плагинов. Как только плагин активирован, нужная функция уже есть.
Но что, если вам нужна конкретная функция, совместимая с вашей темой WordPress, и вы не можете ее найти?
Конечно, есть плагины, которые могут иметь желаемую функциональность, но совместимость – это все. Здесь, в конструкторе сайтов WordPress Templatetoaster, это руководство поможет вам создать плагин, который будет работать на вас.
Создайте свои папки и файлы
Первое, что вам нужно сделать, это создать папку. Вы можете использовать имя файла, например myplugin. Название вашего плагина подойдет. Затем вы хотите создать в папке папку, например myplugin.php. Вы запрограммируете информацию о своем плагине с помощью текстового редактора. Информация о подключаемом модуле затем перейдет в каталог подключаемого модуля, который должен иметь структуру. Ниже приведен пример того, как структурировать файлы плагинов:
Myplugin
Активы/
- Активы/
- CSS /
- Изображений/
- JS /
Включает в себя/
- Администратор /
- Библиотеки /
Языки /
Шаблоны /
Myplugin.php
License.txt
Readme.txt
Uninstall.txt
Выше представлена структура, используемая многими наиболее популярными плагинами.
Именование функций плагина
Все функции плагина должны иметь уникальные имена, которые отличаются от функций WordPress, тем и других плагинов WordPress. Лучше всего использовать уникальный префикс для всех функций вашего плагина. Убедитесь, что вы не используете префикс таблицы базы данных WordPress, который обычно начинается с wp. Вместо этого вы можете использовать $ wpdb.
Вы также хотите убедиться, что ваш плагин содержит некоторые метаданные. Вы хотите, чтобы он содержал:
<?php
/ *
Название
плагина URL плагина
Описание
Автор
Автор URL
Лицензия
/
И вы хотите, чтобы он содержал эту информацию в точном формате.
Программирование плагина
Когда вы начнете программировать плагин, у вас должна быть готова локальная копия WordPress. Для доступа к папке wp-content вам нужно будет использовать любой редактор кода. Внутри папки с плагинами вы сможете создать новую папку с именем вроде «my-custom-plugin», а затем вы создадите «my-custom-plugin.php_. Здесь вы можете добавить свои метаданные.
Вы вставите всю необходимую кодировку в соответствующие файлы.
Затем вы можете перейти в админку WordPress. Когда вы перейдете в Плагины в области администрирования, вы увидите, что ваш плагин доступен. Когда вы активируете плагин, вы можете добавить код, который является внутренней работой плагина.
Некоторые вещи, о которых вам следует знать при программировании плагина, упомянуты ниже:
Крючки
Хуки – это фрагменты кода, которые запускаются в определенное время при загрузке веб-сайта WordPress. Хуки существуют во всем коде WordPress, поэтому вы можете так легко расширить свой сайт. Вы можете использовать хуки действий или фильтры. К хукам действий привязаны определенные действия, например публикация сообщения. К хукам фильтров уже подключен контент. При присоединении кода к ловушке фильтра содержимое будет изменено. Здесь вы можете подключить свои собственные данные или полностью удалить контент. Ознакомьтесь с этой справкой по фильтрам, чтобы помочь вам с этим аспектом программирования вашего плагина.
Теги шаблона
Теги шаблона извлекают и отображают динамические данные. Это отличный способ настроить различные аспекты вашего блога. В WordPress есть отличная библиотека тегов, на которую можно ссылаться, когда вам нужно использовать эти теги при программировании вашего плагина.
Сохранение плагина в базе данных
Есть четыре способа сохранить в базе данных WordPress:
1. Используйте так называемый механизм опций WordPress, если объем данных, который необходимо сохранить, невелик. Эти отдельные фрагменты данных называются «опциями». Имена параметров – это строки, которые должны быть уникальными, чтобы не конфликтовать с другими плагинами или самим WordPress. Вы также можете минимизировать количество параметров, используемых для плагина. Например, вы можете создать одну именованную опцию для серии опций, а не разделять серию. Используйте этот код для добавления опций: add_option ($ name, $ value, $ deprecated, $ autoload); Устаревшее больше не используется WordPress, поэтому вы можете оставить его пустым.
2. Опубликуйте метаинформацию, как описано выше в разделе «Программирование плагина». WordPress предоставил этот пример.
3. Вы можете использовать метод настраиваемой таксономии для классификации объектов, таких как сообщения и комментарии, или других редактируемых списков данных. Это эффективный способ сгруппировать различные элементы несколькими способами. Для этого используется функция register_taxonomy().
4. Вы можете создать таблицу базы данных – метод, который вы можете использовать, когда данные плагина не связаны с определенными страницами, сообщениями, комментариями или вложениями.
После сохранения в базе данных вы хотите защитить свой плагин. Вы хотите запретить прямой доступ к плагину. Вы можете сделать это, не выполняя важный PHP-код перед вызовом функций WordPress. Вы также можете добавить определенные (‘ABSPATH’) или die (‘Детишки без скриптов, пожалуйста!’);
Локализуйте свой плагин
После завершения программирования вам нужно будет локализовать плагин. Это процесс обеспечения перевода текстовых дисплеев на разные языки. Это важно, потому что WordPress используется во всем мире. Поскольку языковые файлы для плагинов не загружаются автоматически, вам необходимо добавить этот код в плагин, чтобы убедиться, что языки:
Loadplugin_textdomain (‘ваше-уникальное-имя’, ложь, базовое имя (dirname (_FILE)). ‘/ Languages’);
Если вы хотите получить строку, используйте _ (‘String name’, ‘your-unique-name’). Это вернет перевод.
Настоятельно рекомендуется разрешить перевод вашего плагина, чтобы люди со всего мира могли его использовать.
Вы почти закончили
Теперь, когда у вас есть все важные дела, вы хотите очистить код. Если какие-либо аспекты кода, которые вы видите, не нужны, удалите их. Если есть ненужные таблицы, избавьтесь от них. Любой код, который находится внутри плагина, который не нужен, приведет к его сбою, поэтому убедитесь, что он исчез.
После того, как вы очистились, вы хотите задокументировать плагин. Необходимо включить следующую информацию:
- Требования к установке
- Порядок установки
- Конфигурация
- Использование по назначению
- Инструкции по применению
- Исправление проблем
- Удалить
- Контактная информация для поддержки
Теперь все, что вам нужно сделать, это протестировать ваш плагин. Используйте его, как любой другой плагин, и убедитесь, что он работает должным образом. Если этого не произойдет, вам придется вернуться назад и выяснить, почему, чтобы решить проблему. Если он работает, то все в порядке.
Это некоторые из основ создания плагина. Однако тип подключаемого модуля, который вам нужно создать, может изменить шаги. Программирование также будет варьироваться в зависимости от конкретной функции программы.
Легко создавать темы WordPress, которые совместимы со всеми плагинами, используя TemplateToaster конструктор сайтов
Источник записи: https://blog.templatetoaster.com