Додавання спеціальних посилань на плагін WordPress

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

І ви знаєте, про що я говорю: це посилання, які з’являються під назвою плагіна.

Відповідно до посилання на код, ця інформація:

Метадані плагіна, включаючи версію, автора, URI автора та URI плагіна.

Однак інколи ви можете виявити, що захочете додати або змінити посилання. Тобто ви можете додавати власні власні посилання, які відображатимуться у списку нижче.

Посилання на плагін WordPress

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

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

<?php

add_action('plugin_row_meta', __NAMESPACE__. 'addCustomPluginLinks');
/**
 * @param array $metaData the array of metadata that appears in the row of plugin information
 *
 * @return array $metaData the modified array that includes the custom anchor
 */
function addCustomPluginLinks(array $metaData): array
{
  $metaData[] = '<a href="https://google.com">Example Link</a>';
  return $metaData;
}

Але це залишає бажати кращого. а саме:

• немає безпеки навколо розмітки (і, можливо, ви могли б переконатися, що вона не потрібна, якщо ви відповідаєте за це),
• немає доступу навколо якоря,

Щоб пом’якшити це, код можна оновити до цього :

<?php

add_action('plugin_row_meta', __NAMESPACE__. 'addCustomPluginLinks');
/**
 * @param array $metaData the array of metadata that appears in the row of plugin information
 *
 * @return array $metaData the modified array that includes the custom anchor
 */
function addCustomPluginLinks(array $metaData): array
{
  // Safely build the markup for the new anchor.
  $html = wp_kses(
      '<a href="https://google.com" target="_blank" data-title="Example Link" aria-label="Example Link">Example Link</a>',
      [
          'a' => [
              'href' => [],
              'target' => [],
              'aria-label' => [],
              'data-title' => [],
          ],
      ]
  );

  // Insert the markup at the end of the array.
  $metaData[] = $html;  

  return $metaData;
}

І якщо ви справді хочете проявити творчість, ви можете використати метод array_splice PHP, щоб розмістити HTML, де завгодно. Крім того, ви можете додати захисне положення для певного плагіна, використовуючи щось на кшталт:

basename(plugin_dir_path(dirname(__FILE__, 2)));

І перевірка значення результату. Просто поверніть вхідний масив, якщо він не дорівнює назві вашого плагіна.

Однак це виходить за межі того, що ми прагнемо зробити. Наведеного вище має бути достатньо, щоб почати.