Плагін WordPress: Керівництво по створенню свого плагіна

  1. вступ У цьому керівництві ми детально розглянемо як створити плагін WordPress зі своєю власною сторінкою...
  2. Що таке плагін WordPress?
  3. Що таке хук (hook)?
  4. Події і хукі-події
  5. Додавання функцій на хук події, використовуючи add_action ()
  6. Приклад коду плагіна для відображення тексту після розділу футера (footer) на кожній сторінці
  7. Видалення функцій з хуков-подій, використовуючи remove_action ()
  8. Фільтри і хукі-фільтри
  9. Додавання фільтрів, використовуючи add_filter ()
  10. Приклад. Плагін WordPress для зміни фрагмента / витримки записи
  11. Підсумковий результат: Видалення фільтрів, використовуючи remove_filter ()
  12. Крок 1 - Збереження плагіна
  13. Крок 2 - Створення першого файлу
  14. Крок 3 - Написання функцій плагіна
  15. Крок 4 - Створення нової адмін-сторінки
  16. Висновок

вступ

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

що знадобиться

Для виконання кроків цього керівництва вам знадобитися текстовий редактор, наприклад, Notepad ++ або середовище розробки NetBeans . Також вам потрібен доступ по FTP в ваш обліковий запис на хостингу і працює установка WordPress .

Дізнатися про те, як підключити Notepad ++ до своєї FTP-сервера можна прочитати в керівництві як підключитися по FTP з Notepad ++ (Англ.). Також ви можете скористатися FTP програмою такий як FileZilla для завантаження ваших файлів і докладніше дізнатися про те, як налаштувати клієнт FileZilla в цьому керівництві .

Дане плагін WordPress керівництво написано для тих, хто вже має базові знання в програмуванні на PHP . Щодо керівництва ми створимо нову функцію, викличемо існуючі функції WordPress, використовуючи їх як параметри.

Також настійно рекомендуємо зробити бекап вашого сайту (Англ.) Перед початком.

Що таке плагін WordPress?

Плагін WordPress - це автономний код, який покращує і розширює функціональність WordPress. Використовуючи будь-яку комбінацію PHP, HTML, CSS, JavaScript / jQuery або ряду інших мов програмування, плагін WordPress може додати нові характеристики до будь-якої частини вашого сайту, включаючи Консоль Адміністрування. Ви можете змінювати поведінку WordPress за замовчуванням або повністю видаляти непотрібне поведінку. Модулі дозволяють легко налаштовувати WordPress під себе і свої потреби.

Оскільки плагін WordPress це окремий код, він не перетинається безпосередньо з будь-якої частиною коду ядра WordPress. Плагін може бути скопійований або встановлений на будь-яку установку WordPress. Альтернативний (і дуже не рекомендований) шлях внесення змін до WordPress - написання нової функції в файл WordPress functions.php, який знаходиться в каталозі / wp-includes / або в файл functions.php, який є частиною вашої теми. Це може привести до ряду можливих проблем.

WordPress і його теми регулярно оновлюються. І поки ви використовуєте дочірню тему WordPress , Чергове оновлення буде перезаписувати файл functions.php, а доданий вами новий код буде вилучений і доведеться його додавати знову і знову. Ще один незручний момент може виникнути, якщо ви напишете багато функцій і в одній з них буде помилка, яку ви ніяк не може відстежити, вам може знадобитися замінити поточний файл оригінальним, проте при цьому доведеться пожертвувати всіма іншими функціями. Це спричинить за собою велику кількість PHP-помилок на сайті, тому як виклики вже віддалених функцій ще будуть здійснюватися з інших місць.

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

Що таке хук (hook)?

Модулі WordPress взаємодіють з кодом ядра через так звані хукі (hooks, від англ. Hook - гачок). До них, як до гачків можна "чіпляти" виконання будь-яких цікавих нам функцій. У WordPress є два види хуков:

  1. Action hooks або хукі-події (додати / видалити користувача функцію до деякого події).
  2. Filter hooks або хукі-фільтри (для зміни даних, які обробляються функціями).

Події і хукі-події

Відвідування будь-якої сторінки WordPress-сайту - це виклик безлічі функцій PHP (званих подіями - actions). Функції прив'язуються до хукам-подій (action hooks). Механізм хуков-подій надається WordPress. Ви можете додавати свої функції до якої-небудь події зі списку подій, використовуючи механізм хуков і вони будуть запускатися по запуску цієї події. Ви також можете видаляти вже існуючі функції з будь-якого списку хуков-подій. Хукі-події прив'язані до виконання певної події. Наприклад, перед закриттям тега </ head> на будь-якій сторінці, викликається хук-подія wp_head () і запускається ряд функцій, які прив'язані до цього хуку wp_head ().

Хукі-події є контекстними - деякі викликаються на кожній сторінці сайту, інші тільки під час відображення Адмін Консоль і так далі. Повний список подій і контексту, в якому ви матимете змогу дзвонити дивіться тут сторінці API плагіна / Довідка по Action .

Додавання функцій на хук події, використовуючи add_action ()

Щоб додати функцію на будь-який хук-подія, ваш плагін WordPress повинен викликати функцію WordPress під назвою add_action (), як мінімум з двома параметрами.

// Хук події 'init', викликається після того, як WordPress завершує завантаження коду ядра add_action ( 'init', 'add_Cookie'); // Установка cookie з поточним часом дня function add_Cookie () {setcookie ( "last_visit_time", date ( "r"), time () + 60 * 60 * 24 * 30, "/"); }

  • Перший обов'язковий параметр - це назва хука-події (action hook), до якого збираємося пов'язати свою функцію.
  • Другий обов'язковий параметр - ім'я функції (function), яку будемо запускати.
  • Третій параметр (необов'язковий) - це пріоритет (priority) функції, яку ви збираєтеся запустити. Ви можете прив'язати скільки завгодно функцій до одному хуку події і звертатися до них в будь-якому порядку. Пріоритет запуску за замовчуванням - 10, ваша функція запускається відразу після вбудованих функцій WordPress. Функція з пріоритетом 11 запуститься наступної і так далі.
  • Четвертий параметр (необов'язковий) - це кількість аргументів, означає скільки параметрів ваша призначена для користувача функція може прийняти. За замовчуванням кількість параметрів дорівнює 1.

Приклад коду плагіна для відображення тексту після розділу футера (footer) на кожній сторінці

Цей плагін WordPress перехоплює хук-подія wp_footer (), який викликається відразу перед закриттям тега </ body> на кожній сторінці і додає нову функцію під назвою mfp_Add_Text (). Так як плагін WordPress не прив'язувати до теми, то функціонал буде працювати навіть при зміні теми на іншу. Можете зберегти собі цей приклад в файл PHP, завантажити його в каталог wp-content / plugins / і активувати в Адмін Консолі, щоб побачити зміни.

&lt;? Php / * Plugin Name: Add Text To Footer * / // Хук події 'wp_footer', додаємо функцію 'mfp_Add_Text' до нього add_action ( "wp_footer", "mfp_Add_Text"); // Визначаємо 'mfp_Add_Text' function mfp_Add_Text () {echo "<p style = 'color: black; padding-left: 15%;'> Після завантаження футера сайту додається мій текст! &lt;/ P>"; }?>

Ось результат:
Ось результат:

Примітка: PHP завантажує вміст відразу всього скрипта перед його виконанням, це означає, що ви можете викликати add_action () перед визначенням вашої функції: викликати add_action () з вашими функціями спочатку файлу в тому порядку, в якому вони будуть завантажуватися, потім визначити ваші функції в такому ж порядку нижче. Таке структурування коду зробить файл більш легким для читання.

Видалення функцій з хуков-подій, використовуючи remove_action ()

Щоб видалити функцію, пов'язаної з хуком-подією, потрібно скористатися remove_action (). Приклад нижче допоможе зрозуміти принцип роботи додавання і видалення функцій в / з хука подій.

// Хук на подію 'init', який викликається після завершення завантаження ядра WordPress і функція 'remove_My_Meta_Tags' add_action ( 'init', 'remove_My_Meta_Tags'); // Видаляємо функцію 'add_My_Meta_Tags' з хука-події wp_head function remove_My_Meta_Tags () {remove_action ( 'wp_head', 'add_My_Meta_Tags'); }

Запускається remove_action () як мінімум в двома параметрами.

  • Перший обов'язковий параметр - назва хука-події (action hook), до якого функція була прикріплена
  • Другий обов'язковий параметр - це ім'я функції (function), яку ви хочете видалити
  • Третій (необов'язковий) параметр - це пріоритет видаляється функції. Цей параметр повинен збігатися з тим пріоритетом, який був заданий при додаванні події до хуку подій. Якщо він не був визначений, не вмикайте цей параметр.

Приклад: уявімо, що ви хочете, щоб текст, доданий в футере в попередньому прикладі, що не виводився по понеділках. Один із шляхів реалізації цього, використовувати функцію дати в PHP, щоб отримати поточний день тижня, проходячи умовним оператором if ... then ... і перевіряючи чи поточний день понеділка, потім викликати remove_action (), якщо це понеділок. Викликаємо функцію перевірки і видалення за днями тижня за допомогою add_action (), прикріплений до події, що відбувається раніше (наприклад, wp_head), ніж те, до якого прикріплено наше основна дія виведення тексту в футере (wp_footer). Якщо ми виберемо подія відбувається пізніше, ніж wp_footer, видалення не відбудеться, оскільки сторінка вже буде згенеровано.

&lt;? Php // Хук події 'wp_footer', запуск функції 'mfp_Add_Text ()' add_action ( "wp_footer", "mfp_Add_Text"); // Хук події 'wp_head', запуск функції 'mfp_Remove_Text ()' add_action ( "wp_head", "mfp_Remove_Text"); // Визначення функції 'mfp_Add_Text ()', що виводить текст function mfp_Add_Text () {echo "<p style = 'color: black; padding-left: 15%;'> Після завантаження футера сайту додається мій текст! </ P>" ; } // Визначення функції 'mfp_Remove_Text ()' видалення нашої попередньої функції з події 'wp_footer' function mfp_Remove_Text () {if (date ( "l") === "Monday") {// Target the 'wp_footer' action, remove the 'mfp_Add_Text' function from it remove_action ( "wp_footer", "mfp_Add_Text"); }}?>

Фільтри і хукі-фільтри

Функції фільтри дозволяють змінювати повертаються іншими функціями дані і повинні бути перш за перехоплені за допомогою хуков-фільтрів. Хукі-фільтри дещо відрізняються від хуков-подій. Однак, працюють вони подібно хукам-подій - можуть бути викликані в різних точках скрипта і контекстно. Повний список хуков-фільтрів і контексту виклику можна знайти на WordPress Plugin API / Filter Reference page.

Додавання фільтрів, використовуючи add_filter ()

Щоб додати будь-яку функцію до хуку-фільтру, ваш плагін повинен викликати функцію WordPress під назвою add_filter (), з як мінімум двома параметрами.

// Перехоплення хука-фільтра 'the_content' (вміст будь-якого посту), запуск функції 'mfp_Fix_Text_Spacing' add_filter ( "the_content", "mfp_Fix_Text_Spacing"); // Автоматичне виправлення подвійного пробілу function mfp_Fix_Text_Spacing ($ the_Post) {$ the_New_Post = str_replace ( "", "", $ the_Post); return $ the_New_Post; }

  • Перший обов'язковий параметр - це назва хук-фільтра (filter hook), на який хочемо повісити функцію.
  • Другий параметр - це ім'я функції фільтра (filter function), яку хочемо запустити.
  • Третій параметр (необов'язковий) - це пріоритет (priority) функції, яку ви хочете запустити. У хуку-фільтру можна додати скільки завгодно різних фільтрів функцій. Пріоритет за замовчуванням - 10, встановлює чергу вашої користувальницької функції після будь-якої вбудованої функції. Функція з пріоритетом 11 запуститься наступної і так далі.
  • Четвертий параметр (необов'язковий) - це кількість аргументів, який означає скільки параметрів ваша призначена для користувача функція може прийняти. За замовчуванням кількість параметрів дорівнює 1.

Приклад. Плагін WordPress для зміни фрагмента / витримки записи

У WordPress є функція, яка витягує уривок (цитату) із запису, називається вона get_the_excerpt (), і також є хуком-фільтром. Функція, що відображає уривок, викликає get_the_excerpt (), щоб його отримати, це те місце, де застосовується фільтр і уривок змінюється до відображення. Цей плагін WordPress визначає функцію фільтр, яка бере уривок тексту як вхідний параметр, додає деякий текст спочатку нього і повертає нове значення кожен раз, коли викликається get_the_excerpt (). Так як повертається функцією get_the_excerpt () значення - це фактичний фрагмент тексту, він автоматично вводиться як параметр функції $ old_Excerpt, коли викликається, використовуючи add_filter (). Функція, яку ви визначаєте повинна повернути нове значення.

&lt;? Php / * Plugin Name: Add Excerpt * / // перехоплює get_the_excerpt фільтр хук, запускаємо функцію mfp_Add_Text_To_Excerpt add_filter ( "get_the_excerpt", "mfp_Add_Text_To_Excerpt"); // Беремо уривок, додаємо деякий текст перед ним і повертаємо змінений уривок function mfp_Add_Text_To_Excerpt ($ old_Excerpt) {$ new_Excerpt = "<b> Excerpt: </ b>". $ Old_Excerpt; return $ new_Excerpt; }?>

Підсумковий результат:

Видалення фільтрів, використовуючи remove_filter ()

Для видалення фільтра потрібно просто викликати функцію remove_filter (). Наприклад, додамо знову просте умова і будемо видаляти текст, якщо сьогодні четвер.

// Хук-фільтр get_the_excerpt, запуск функції mfp_Add_Text_To_Excerpt add_filter ( "get_the_excerpt", "mfp_Add_Text_To_Excerpt"); // Якщо сьогодні четвер, видалити фільтр the_excerpt () if (date ( "l") === "Thursday") {remove_filter ( "get_the_excerpt", "mfp_Add_Text_To_Excerpt"); } // Взяти уривок, додати текст і повернути новий уривок function mfp_Add_Text_To_Excerpt ($ old_Excerpt) {$ new_Excerpt = "Excerpt:". $ Old_Excerpt; return $ new_Excerpt; }

Тепер, коли вже є базове уявлення про хуках фільтрах і події, створимо простий плагін WordPress, який додає нову посилання і сторінку в Адмін Консоль.

Крок 1 - Збереження плагіна

Першим кроком у створенні плагіна для WordPress є створення каталогу для зберігання всіх файлів. Всі плагіни зберігаються в каталозі: / wp-content / plugins /. Каталог, який ви створюєте повинен мати унікальне і зрозумілу назву, що не перехресний з іншими плагінами. Поключіться до свого аккаунту на хостингу по FTP . З основного каталогу WordPress перейдіть в wp-content потім в plugins. Усередині каталогу plugins створіть новий каталог з назвою my-first-plugin.
Першим кроком у створенні плагіна для WordPress є створення каталогу для зберігання всіх файлів
Окремі файли з кодом плагіна краще тематично розділяти по підкаталогам всередині основного каталогу плагіна замість того, щоб зберігати все в одному каталозі, це дозволить не плутатися і буде хорошим смисловим поділом вихідних файлів плагіна. Особливо поділ файлів за змістом буде добре відчутно, коли ваш плагін буде розростатися і ставати більш складним. Якщо ваш плагін використовує свої стилі CSS створіть каталог CSS і збережіть туди всі файли CSS. Якщо ваш плагін WordPress використовує JavaScript створіть каталог JavaScript.

Крок 2 - Створення першого файлу

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

У вашому каталозі my-first-plugin створіть новий PHP-файл і назвіть його my-first-plugin.php. Доброю практикою є назва основного файлу плагіна також як і каталогу. Додайте відкриває тег PHP &lt;? Php в першому рядку. Вам не обов'язково додавати закриває тег в кінці файлу (щоб зрозуміти чому, почитайте примітка на сторінці PHP мануала ). Цей файл буде містити насамперед так звані 'header comments' або заголовні коментарі з інформацією, яка буде прочитана і відображена WordPress. Header comments полягає в багаторядковий коментар PHP, в кожному рядку визначається спеціальна інформація, що починається зі спеціальних символів, щоб можна було визначити, до чого цей рядок відноситься. Така структура має бути присутня тільки в першому файлі і її не потрібно повторювати в інших.

Першим рядком в коментарі в файлі my-first-plugin.php потрібно додати ім'я плагіна. Починайте багатостроковий коментар PHP відкриваючи його символами / * у другому рядку файлу, відразу після тега відкриття PHP. У третьому рядку напишіть Plugin Name: My First Plugin. У двох наступних окремих рядках можна вказати опис плагіна і ім'я автора. Потім, з наступного рядка закриваємо блок коментарів символами * /. Ваш файл тепер виглядає приблизно так:

&lt;? Php / * Plugin Name: My First Plugin Description: Це мій перший плагін! Він створює окрему адмін-посилання! Author: Ім'я автора * /

Як тільки ви його завантажити поновіть сторінку Плагіни в Адмін частини сайту і ви зможете побачити в списку свій плагін, його опис і Ім'я автора.
Як тільки ви його завантажити поновіть сторінку Плагіни в Адмін частини сайту і ви зможете побачити в списку свій плагін, його опис і Ім'я автора

Крок 3 - Написання функцій плагіна

Як вже було сказано вище, хорошою практикою є поділ коду плагіна в відповідні файли і каталоги. Так як основна функція першого файлу в тому, щоб утримувати в собі інформацію про плагіні, то сам плагін WordPress розмістимо в інших файлах і каталогах і скористаємося функцією PHP 'include' для доступу до них. Будь-які файли, що зберігаються в підкаталогах викликаються прямо з нашого коду і тільки з нашого коду, тому ім'я підкаталогу не потребує префікс. Однак, досить рекомендуємо застосовувати унікальний префікс для ваших файлів, функцій і змінних, щоб уникнути конфліктів з іншими плагінами. У зв'язку в цим ми будемо використовувати префікс mfp, скорочення від 'My First Plugin'.

У головному каталозі вашого плагіна створіть новий підкаталог з назвою includes. Будь-який файл, який буде підключаться по 'include' в іншому файлі буде йти в цей підкаталог. Створіть новий файл PHP в підкаталозі includes і збережіть його як mfp-functions.php. Відкриваємо тег &lt;? Php в першому рядку. У цьому новому файлі будуть зберігатися функції вашого плагіна.

Тепер поверніться до my-first-plugin.php в основному каталозі плагіна. Нам потрібно підключити файл mfp-functions.php, для того щоб використовувати нові функції. Так як це головний файл плагіна, підключення mfp-functions.php тут зробить функції доступними в будь-якому іншому файлі вашого плагіна. Використовуйте require_once, щоб один раз підключити файл з функціями і щоб бути впевненим, що плагін працює тільки, якщо функції доступні. Найпростіший шлях підключення файлів з вашого каталогу плагінів - це використання функції WordPress plugin_dir_path (__ FILE__), яка видає повний шлях до директорії, де наш плагін WordPress зберігається, потім використовувати. (period), щоб доповнити ім'ям підкаталогу, який ми створили раніше (includes), потім ім'я створеного нами файлу (mfp-functions.php).

Редагуємо my-first-plugin.php як показано нижче, потім зберігаємо і завантажуємо ще раз, переписуючи попередню версію.

&lt;? Php / * Plugin Name: My First Plugin Description: Це мій перший плагін! Він створює окрему адмін-посилання! Author: Ім'я автора * / // Підключаємо mfp-functions.php, використовуючи require_once, щоб зупинити скрипт, якщо mfp-functions.php не найден require_once plugin_dir_path (__ FILE__). 'Includes / mfp-functions.php';

Повернемося до mfp-functions.php в підкаталозі includes.

Хороша ідея об'єднати кілька функцій разом и Написати багатостроковій коментар над шкірних Груп, опісуючі групу, потім короткий однорядковій коментар перед шкірних з функцій з ее опису. Таким чином вам не доведеться читати весь код в пошуках функції і розпізнаванню, що вона робить. Назвемо функцію mfp_Add_My_Admin_Link (). Вона буде додавати нову верхню посилання в Адмін Консолі в меню навігації.

Резюмуючи, пишемо нову функцію слідуючи цим крокам:

  • Пишемо коментарі, які описують функцію
  • називаємо функцію
  • пишемо функцію

У mfp-functions.php, пишемо наступне:

&lt;? Php / * * Додаємо нове меню в Адмін Консоль * / // Додаємо нову посилання в меню Адмін Консолі function mfp_Add_My_Admin_Link () {// My code goes here}

Усередині нашої функції нам потрібно використовувати вбудовану функцію WordPress add_menu_page (), щоб задати ім'я меню, заголовок і визначити, хто може її бачити. Потім ми говоримо, що відображати, коли ми переходимо на сторінку. Ви можете також додати до заслання в меню іконку і встановити її позицію в меню навігації адмін панелі - і те й інше за бажанням, тому в нашому керівництві ми на цьому не будемо зупинятися. Поруч з посиланням на вашу сторінку буде відображатися іконка за замовчуванням. Наша посилання з'явиться внизу меню навігації адмін консолі. Вся ця інформація вводиться як параметри в add_menu_page ().

Чотири необхідні параметри add_menu_page () - кожен з нового рядка для кращої наочності:

  1. Простір назв, яку ви побачите після натискання на посилання (відображається у вкладці браузера).
  2. Текст, що відображається на засланні меню (відображається в списку навігації Адмін Консолі), це може бути назва вашого плагіна.
  3. Вимоги до можливостей користувача бачити меню, в цьому прикладі тільки користувачі з можливістю 'manage_options' можуть мати доступ до сторінки (про цю зараз не турбуйтеся).
  4. Який файл використовувати, коли відкривати сторінку (ми створимо його за наступним кроком), який буде зберігатися в підкаталозі includes і називатися mfp-first-acp-page.php. URL введений тут відомий як 'slug'.

Перш ніж ми продовжимо, важливо знати, що є альтернативний шлях використання цієї функції. Четвертий параметр може бути просто рядком тексту, яка відображається на засланні url після 'wp-admin / admin.php? Page ='. Якщо ви введете 'my-plugin-page', URL стане 'wp-admin / admin.php? Page = my-plugin-page'. Четвертий параметр тоді повинен бути ім'ям функції, яка виводить що-небудь. Ви можете написати функцію, яка лише виводити 'Welcome to page 1', наприклад. Значно простіше створити PHP файл, який буде містити вашу сторінку.

Редагуємо mfp-functions.php, видаляємо // My code goes here, замінюємо його на add_menu_page () і передаємо параметри, як показано нижче:

&lt;? Php / * * Додаємо нове меню в Адмін Консоль * / // Додаємо нову посилання в меню Адмін Консолі function mfp_Add_My_Admin_Link () {add_menu_page ( 'My First Page', // Назва сторінок (Title) 'My First Plugin', / / Текст посилання в меню 'manage_options', // Вимога до можливості бачити посилання 'my-first-plugin / includes / mfp-first-acp-page.php' // 'slug' - файл відобразиться після натискання на посилання); }

Щоб почати його використання нам потрібно використовувати функцію WordPress під назвою add_action () з двома параметрами, як описано в розділі 'Додавання функцій на хук-подія' цього керівництва. Ви можете перечитати цей розділ перед тим, як продовжити.

  • Перший параметр - action hook, який ви хочете відловити. У нашому випадку хук події це admin_menu - це значить, наша функція завантажується тоді, коли Адмін меню починає генеруватися.
  • Другий параметр - просто ім'я запускається функції. Функція, яку ми написали називається mfp_Add_My_Admin_Link. Зверніть увагу, що круглі дужки тут не пишуться. Пам'ятайте, що PHP завантажує весь скрипт до його запуску, дозволяючи вам використовувати add_action () раніше визначення функції, зазначеної в параметрі 2.

Наш остаточний файл виглядає так:

&lt;? Php / * * Додаємо нове меню в Адмін Консоль * / // Хук подія 'admin_menu', запуск функції 'mfp_Add_My_Admin_Link ()' add_action ( 'admin_menu', 'mfp_Add_My_Admin_Link'); // Додаємо нову посилання в меню Адмін Консолі function mfp_Add_My_Admin_Link () {add_menu_page ( 'My First Page', // Назва сторінок (Title) 'My First Plugin', // Текст посилання в меню 'manage_options', // Вимога до можливості бачити посилання 'my-first-plugin / includes / mfp-first-acp-page.php' // 'slug' - файл відобразиться після натискання на посилання); }

Завантажте файл mfp-functions.php в каталог includes і повторно старий.

Крок 4 - Створення нової адмін-сторінки

Тепер можна створити сторінку, яка буде відображатися при натисканні на посилання в вашій адмін консолі. Поверніться в підкаталог includes і створіть новий файл PHP з назвою mfp-first-acp-page.php. Хто відкриває тег PHP не є обов'язковим у цьому файлі, оскільки ми будемо використовувати тільки HTML. Напишіть HTML-код, як показано нижче і завантажте файл.

<Div class = "wrap"> <h1> Привіт! </ H1> <p> Це перша сторінка плагіна:) </ p> </ div>

При створенні адмін сторінок, WordPress рекомендує укладати свій HTML в теги div і давати йому ім'я класу "wrap", як показано вище. Це гарантує, що весь ваш контент з'явиться в правильному місці і буде виглядати також як і інші адмін сторінки. Якщо не дотримуватися цієї рекомендації, сторінка може виглядати не дуже привабливо.

Поверніться до списку плагінів WordPress в Адмін Консолі та активуйте його. Як тільки сторінка завантажиться, подивіться вниз мену навігації адмін панелі. Тут ви побачите нову посилання з ім'ям 'My First Plugin'. Натисніть на неї і ви побачите свою рідну сторінку адмін управління!
Поверніться до списку плагінів WordPress в Адмін Консолі та активуйте його

Висновок

Вітаємо, ви тільки що створили свій перший плагін WordPress, додали нову посилання в адмін меню і відобразили нову сторінку в Адмін Консолі! Здається, що це не так вже й багато, але це перші впевнені кроки. Тепер, спираючись на отримані знання, ви можете змінювати функціонал WordPress так, як вам потрібно. Більше знань про WordPress шукайте в наших інших посібниках WordPress .

Що таке плагін WordPress?
Що таке хук (hook)?
Що таке плагін WordPress?
Що таке хук (hook)?
Lt;?
Lt;/ P>"; }?
Lt;?
Lt;?
Old_Excerpt; return $ new_Excerpt; }?

Дополнительная информация

rss
Карта