Створення власних віджетів для wordpress

Попередня ↔ Наступна

Якщо ви коли-небудь використовували WordPress для створення сайтів, то напевно використовували і плагіни, які розширюють функціонал цієї чудової системи. Модулі - потужний інструмент, який робить WordPress дуже гнучким і придатним для створення будь-яких сайтів, не тільки блогів.

Головний файл плагіна

Це обов'язковий мінімум для будь-якого WordPress плагіна. Тепер зайдіть на сторінку ваших плагінів в WordPress і ви побачите, що ваш плагін розпізнаний і готовий до активації:

Створення віджета для WordPress

Віджети в WordPress

У WordPress є клас WP_Widget. який надає доступ до API віджетів. Коли ви успадковуєте цей клас, ваш віджет буде доступний для будь-якого сайдбара, який підтримує ваша тема. У комплекті WordPress вже є деякі віджети, наприклад «Свіжі записи» або «Архів», вони теж успадковують клас WP_Widget.

Клас WP_Widget містить чотири методи, які повинні бути перевантажені:

__construct () - викликає батьківський конструктор і ініціалізує віджет.
form () - виводить форму для налаштування віджета.
update () - оновлення налаштувань віджета, які були вказані в формі аміністратором.
widget () - показує плагіна на сайті.

конструктор

Конструктор нічим не відрізняється від тих, що ви зазвичай пишете. Головне, що потрібно зробити - це викликати батьківський конструктор, який приймає три аргументи: ідентифікатор віджета, назва віджета (це ім'я буде показано на сторінці віджетів) і масив з іншими деталями віджета (потрібно тільки «description»):

Тепер, коли ваш плагін зареєстрований і инициализирован, ви можете побачити його на сторінці віджетів.

Метод form ()

Віджет, який ми робимо повинен давати можливість вводити заголовок і трохи тексту для відображення на сторінках сайту. Виходячи з цього нам треба створити форму для введення цих значень. Метод form () використовується для відображення налаштувань віджета на сторінці віджетів. У методу один аргумент - $ instance - масив змінних, пов'язаних з віджетом. Коли форма відправиться на сервер, буде викликаний метод update () і ми зможемо оновити змінні в масиві $ instance. Після, метод widget () буде використовувати цей масив для відображення віджета.

Методи get_field_id () і get_field_name () класу WP_Widget використовуються для генерації унікальних імен та ідентифікаторів для полів вашого плагіна. Використання цих методів дозволяє уникнути конфліктів.

Зовнішній вигляд форми віджета на сторінці віджетів:

Створення власних віджетів для wordpress

Створення віджета для WordPress

Батьківський елемент

, кнопки «видалити», «закрити» і «Зберегти» WrodPress генерує автоматично, що значною мірою знижує нам життя. Ця форма відправить введені значення на сервер і викличе метод update (), що б ми змогли зберегти їх.

Метод update ()

Цей метод дає вам можливість перевірити і обробити передані значення перед використанням. Також у нас є можливість приймати рішення виходячи зі старих значень. Метод update () повинен повертати масив, в якому знаходяться, які ви збираєтеся використовувати для відображення віджета на сайті. WordPress передає два аргументи: масив нових значень і масив оригінальних значень.

WordPress збереже ці значення самостійно, про це можна не турбуватися.

Метод widget ()

Цей метод використовується для відображення віджета безпосередньо в сайдбарі на сайті. У методу два аргументи: $ args - аргументи віджета (масив, що містить деяку інформацію про віджеті), $ instance - масив з пов'язаними з віджетом змінними. У нашому випадку $ args не має значення.

У підсумку ми отримаємо остаточний вигляд віджету:

Створення віджета для WordPress

Готово! Цей дуже простий плагін дозволяє відображати простий текст на вашому сайті за допомогою віджетів.