Як підготувати тему або плагін до публікації у WordPress.org

Публікація вашого плагіна або теми у WordPress.org — це спосіб поділитися своїм рішенням з мільйонами користувачів, а також отримати зворотний зв’язок і репутацію як розробника. Але перед публікацією важливо пройти перевірку якості та дотриматися правил каталогу. У цій статті покроково розглянемо, як правильно підготувати продукт до релізу.

1. Вимоги до плагінів і тем

WordPress має суворі вимоги щодо безпеки, кодування, ліцензування і функціональності. Основні принципи:

  • Увесь код повинен мати ліцензію GPL або сумісну
  • Без шкідливих, закодованих або прихованих фрагментів
  • Плагін/тема має бути повністю працездатною після встановлення
  • Не дозволяється вставляти рекламу без відома користувача

2. Структура плагіна

my-plugin/
├── readme.txt
├── my-plugin.php
├── assets/
│   └── banner-772x250.png
└── includes/
    └── core.php

Файл my-plugin.php має починатися з заголовка:

/**
 * Plugin Name: My Plugin
 * Description: Короткий опис.
 * Version: 1.0.0
 * Author: Ваше ім’я
 * License: GPLv2 or later
 */

3. readme.txt — ключ до видимості в каталозі

Файл readme.txt має специфічну структуру (використовуйте шаблон):

  • === Назва плагіна ===
  • Tags, Requires at least, Tested up to, Stable tag
  • Опис, Встановлення, FAQ, Screenshots, Changelog

4. Стандарти коду

  • PHP-код має відповідати WordPress Coding Standards
  • JS/CSS — чисті, без лішнього minified-коду (краще збирати окремо)
  • Перевірка за допомогою PHP_CodeSniffer або WPCS

5. Локалізація (переклади)

Усі тексти мають бути обгорнуті в __() або _e(). Наприклад:

_e('Показати ще', 'my-plugin');

Це дозволяє переводити плагін через .po/.mo файли або translate.wordpress.org.

6. Завантаження до каталогу WordPress.org

  1. Увійдіть у WordPress.org/plugins
  2. Натисніть «Add New Plugin»
  3. Заповніть коротку форму, прикріпіть ZIP-архів
  4. Чекайте схвалення модератора (до 7 днів)
  5. Після схвалення ви отримаєте доступ до репозиторію SVN

7. Публікація оновлень

Після схвалення всі зміни завантажуються через SVN:

svn co https://plugins.svn.wordpress.org/my-plugin/
svn add trunk/*
svn commit -m "Initial commit"

Для тем — процес схожий, але публікація відбувається через upload + review командою Theme Review Team.

Висновок

Публікація у WordPress.org — це не тільки технічний процес, а й відповідальність перед спільнотою. Грамотно написаний, безпечний і документований продукт — запорука довгострокового успіху. Дотримання стандартів та прозора структура — ваш квиток до репозиторію WordPress.