Как я сделал плагин для WordPress

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

Итак, у нас есть:

• Готовый плагин с исходниками на GitHub.
• Много энтузиазма.

Для начала нам нужно добавить файл “readme.txt” в наш репозиторий на GitHub. Этот файл имеет определённую структуру, расписанную на сайте WordPress. На основе него формируется страница плагина в официальном репозитории WordPress.Существует онлайн сервис для проверки этого файла.

Особо ничего сложного нет. Мой файл получился таким:

Теперь запакуем в ZIP-архив наш плагин вместе с “readme.txt”. В ZIP-архив нужно вкладывать только файлы, которые должны попасть в плагин и сам “readme.txt”. Нам не нужны всякие “.gitignore”, “.git”, “README.md” и прочие.

Логинимся в wordpress.org и загружаем готовый ZIP-архив на странице добавления нового плагина.

Если вы выбрали нормальное имя плагина и не нарушили никаких правил, то через несколько дней вам придёт письмо на почту, что плагин успешно принят:

Congratulations, your plugin hosting request for Urvanov richtext addfmt has been approved.
 Within one hour you will have access to your SVN repository with the WordPress.org username and password you used to log in and submit your request. Your username is case sensitive.

 https://plugins.svn.wordpress.org/urvanov-richtext-addfmt

 Here are some handy links to help you get started.
 WordPress Plugin Directory Guidelines:
 https://developer.wordpress.org/plugins/wordpress-org/detailed-plugin-guidelines/

 Using Subversion with the WordPress Plugin Directory:
 https://developer.wordpress.org/plugins/wordpress-org/how-to-use-subversion/

 FAQ about the WordPress Plugin Directory:
 https://developer.wordpress.org/plugins/wordpress-org/plugin-developer-faq/

 WordPress Plugin Directory readme.txt standard:
 https://wordpress.org/plugins/developers/#readme

 A readme.txt validator:
 https://wordpress.org/plugins/developers/readme-validator/

 Plugin Assets (header images, etc):
 https://developer.wordpress.org/plugins/wordpress-org/plugin-assets/

 If you have issues or questions, please reply to this email and let us know.
 Enjoy!
 --
 The WordPress Plugin Directory Team
 https://make.wordpress.org/plugins

Теперь нам нужно закачать наш плагин в SVN. Нам выделяют репозиторий по адресу:

http://plugins.svn.wordpress.org/<имя плагина>/

Например, мне дали вот такой:

https://plugins.svn.wordpress.org/urvanov-richtext-addfmt

Переместим в trunk файлы из нашего ZIP-архива с плагином и добавим их в SVN:

Сделаем commit:

Каждый раз, когда мы выпускаем новый релиз, мы должны создавать tag для этого релиза, чтобы пользователям было легче выкачивать последний релиз и старые. Имена tag-ов должны быть в формате версий с точками. Мы выпустим версию 0.1:

Не забудьте после этого в trunk в файле “readme.txt” указать tag стабильной версии 0.1 и закоммитить его:

Наш плагин уже должен отображаться на своей странице https://wordpress.org/plugins/urvanov-richtext-addfmt/

Не хватает только скриншота. В нашем “readme.txt” описан один скриншот с подписью “Buttons in format toolbar”:

Саму картинку нам нужно добавить в assets в SVN назвав его “screenshot-1.png” ( можно с расширением jpg):

Готово. Теперь у меня есть свой плагин для WordPress.