Так як це мій перший досвід перекладу великих технічних текстів, ляпи є. Будь-які виправлення будуть прийняті з радістю;)
Переклад під катом.
написання плагіна
Аж до версії WordPress 1.2, якщо ви хотіли змінити його поведінку, вам потрібно було редагувати (або «хакати») вихідний код WordPress. Однак, в більшості поточних версій WordPress ви можете з легкістю модифікувати функціональність ядра WordPress або додавати нову за допомогою «плагінів». Основна ідея використання розширюється архітектури полягає в тому, щоб при збереженні ядра відносно простим, але досить гнучким, кожен аспект його введення і виведення міг бути змінений за допомогою плагінів. Ось визначення:
Плагін WordPress - це програма або набір функцій, написаних на PHP, які додають певний набір можливостей або сервісів до блогу на WordPress, які легко об'єднуються з системою управління та методами WordPress за допомогою Plugin Application Program Interface (API).
Plugin Resources - всеосяжний список статей та засобів для розробників плагінів, що включає в себе розгорнуті статті з написання плагінів, і статті на специфічні «вузькі» теми.
Інший хороший шлях вивчити пристрій плагінів - це дивитися в вихідні PHP-коди добре написаних плагінів, таких як Hello Dolly. плагін, який входить в базову поставку WordPress.
Якщо ви написали плагін до WordPress, прочитайте Plugin Submission and Promotion. щоб дізнатися, як поширити ваш плагін.
створення плагіна
Ця частина статті дасть вам зрозуміти, які кроки ви повинні зробити для створення гарного плагіна.
Імена, файли, і розташування файлів
ім'я плагіна
Перше завдання при створенні плагіна - подумати, що плагін буде робити, і придумати для нього ім'я (бажано унікальне). Перевірте Plugins і інші сховища, щоб переконатися в тому, що придумане вами ім'я - унікальне; ви можете також погуглити за обраним вами імені. Більшість розробників плагінів вибирають імена, які відображають функціональність їх плагіна; наприклад, плагін для відображення погоди може мати в назві слово «погода». Назва може складатися з декількох слів. (Природно, ваш плагін повинен мати назву англійською мовою. - прим. Перекладача)
файли плагіна
Наступний крок - створення файлу PHP з ім'ям, похідним від назви плагіна. Наприклад, якщо ваш плагін буде називатися «Fabulous Functionality», ви можете назвати ваш файл fabfunc.php. Знову ж, спробуйте створити унікальне ім'я. Люди, які встановлять ваш плагін, покладуть цей файл в свою директорію для плагінів wp-content / plugins /, і два плагіна, які людина використовує, можуть мати однакове ім'я файлу.
У цій статті «PHP файл плагіна» означає головний PHP-файл, який знаходиться в директорії для плагінів або в її піддиректорії.
Файл «Прочитай мене» (Read me)
Домашня сторінка
Також, дуже зручно створити веб-сторінку, яка відіграє роль «домашньої сторінки» вашого плагіна. Ця сторінка повинна пояснювати, як встановити плагін, що він робить, з якими версіями WordPress сумісний, що змінювалося від версії до версії вашого плагіна, і як використовувати плагін.
заголовки файлів
Саме час дати деяку інформацію з приводу вашого головного файлу PHP.
Стандартна інформація про плагін
Початок вашого файлу повинна містити стандартний інформаційний заголовок. Цей заголовок дозволяє WordPress зрозуміти, що ваш плагін існує, додати його в панель управління плагінами, де він може бути активований, завантажити його і запустити його функції; без заголовка ваш плагін ніколи не буде активований і запущений. Це формат заголовка:
(Природно, все повинно бути по-англійськи - прим. Перекладача)
Мінімальна інформація, яка потрібна WordPress, щоб виявити ваш плагін - його назва (Plugin Name). Решта інформації (якщо вона є) використовується для створення таблиці плагінів на сторінці управління плагінами. Порядок рядків неважливий.
За стандартним заголовком звичайно треба інформація про ліцензії на плагін. більшість плагінів використовують ліцензію GPL або ліцензію, сумісну з GPL. Для вказівки ліцензії GPL додайте наступні рядки в файл вашого плагіна:
програмування плагіна
Саме час змусити ваш плагін що-небудь робити. Ця частина статті містить кілька основних ідей розробки плагінів, і пояснює, як довести до досконалості кілька завдань, які ваш плагін буде робити.
«Пастки» (Hooks) плагіна
Безліч плагінів виконують свої завдання за допомогою з'єднання з одного або більше «пастками». «Пастки» працюють в той час, поки WordPress запущений. WordPress перевіряє, чи мають кілька плагінів однакові зареєстровані функції, і якщо це так, функції запускаються. Ці функції змінюють стандартну поведінку WordPress.
Наприклад, перед тим як WordPress додає заголовок поста в висновок браузера, спочатку він перевіряє, чи має будь-якої плагін зареєстровану функцію для «фільтра-пастки» під назвою «the_title». Якщо має, текст заголовка пропускається через кожну зареєстровану функцію, і кінцевий результат виводиться. Таким чином, якщо ваш плагін повинен додавати певну інформацію до заголовка поста, він може зареєструвати функцію-фільтр «the_title».
Інший приклад - «діюча пастка» під назвою «wp_footer». Перед кінцем HTML-сторінки, яку генерує WordPress, він перевіряє, чи мають якісь плагіни зареєстровану функцію «wp_footer», і запускає її.
Ви можете дізнатися більше про те, як реєструвати функції для фільтрів і «пасток», і які «пастки» доступні в WordPress, в Plugin API. Якщо ви знайшли місце в коді WordPress, де ви хотіли б мати дію або фільтр, але в WordPress його немає, ви можете запропонувати нові «пастки» (пропозиції в основному приймаються); як це зробити, ви можете дізнатися в Reporting Bugs.
Теги шаблонів
Інший шлях додавання функціональності за допомогою плагіна - створення Тегів шаблонів. Той, хто хоче використовувати ваш плагін, може додати ці теги в свою тему, в панель, в секцію вмісту поста, або в інше відповідне місце. Наприклад, плагін, який додає географічні теги до постів, може визначатися функцією тега шаблону під назвою geotag_list_states () в панелі, який складає список усіх посад, помічених гео-тегами, з посиланням на архів сторінок плагіна.
Щоб оголосити тег шаблону, просто напишіть функцію php, і інвентаризують її для користувачів плагіна на вашій сторінці, присвяченій плагіну і / або в головному файлі плагіна. Гарна ідея, документуючи функцію, наводити приклад виконання містить