Щоб не дублювати по 150 разів один і той самий код із описом плагіна, вирішив зробити це лише один раз і повністю описати все в цій статті. А в усіх інших статтях — просто посилатись на неї.
Отже, для того щоб WordPress зрозумів, який саме плагін знаходиться в каталозі «/wp-content/plugins/» і зміг його встановити, йому потрібно це пояснити (а точніше — описати). Для цього, на самому початку головного файлу плагіна потрібно створити наступний коментар (вказавши, звісно, характеристики вашого плагіна):
<?php /* Plugin Name: Plugin Name Plugin URI: http://plance.top/plugins Description: Description Plugin Name Version: 1.0 Author: Pavel Author URI: http://plance.top/avtor License: GPL2 License URI: https://www.gnu.org/licenses/gpl-2.0.html Domain Path: /languages Text Domain: plugin-lng */
Нижче подано детальний опис кожного пункту:
Plugin Name — Назва плагіна, яка буде відображатися в адмін-панелі. Так ви зможете знайти свій плагін і встановити його.
Plugin URI — Посилання на сторінку плагіна. Це може бути як офіційний сайт WordPress, так і будь-яка інша сторінка в інтернеті.
Description — Короткий опис плагіна, відображається в розділі «Плагіни» в адмінці вашого WordPress сайту. Опис не має перевищувати 140 символів.
Version — Поточна версія плагіна. Має виглядати як 1.0 або 1.0.3. Такий формат дозволяє WP автоматично визначати версію, встановлену на вашому сайті, і пропонувати оновлення.
Author — Ім’я автора плагіна. Якщо авторів декілька, можна вказати список.
Author URI — Посилання на сайт автора або його профіль на іншому ресурсі.
License — Скорочена назва ліцензії.
License URI — Посилання з описом ліцензії.
Domain Path — Каталог, у якому зберігаються мовні файли. Зазвичай — «languages», з косою рискою наперед.
Text Domain — Текстовий домен, який використовується у функціях перекладу.
Чесно кажучи, для чого потрібні «Domain Path» і «Text Domain» я так і не зрозумів. Для локалізації все одно доводиться вручну підключати функцію «load_plugin_textdomain». Без неї нічого автоматично не підтягується і не працює (можливо, я ще чогось не розумію).
Найменш необхідні вимоги для опису плагіна виглядають наступним чином:
<?php /* Plugin Name: Plugin Name */
На цьому все.
