Додавання посилання на налаштування плагіна

Кожного разу, коли ви створюєте плагін, який вводить підменю, і використовуєте належні API, ви збираєтеся створити сторінку адміністрування (незалежно від того, чи є у неї налаштування).

Однак при цьому ви також можете ввести посилання на налаштування плагіна. Це посилання, які з’являються під назвою плагіна на інформаційній панелі плагіна.

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

Посилання на налаштування плагіна

По-перше, може бути корисно переглянути хук plugin_action_links, який надає WordPress.

Як зазначено в Кодексі:

Застосовується до списку посилань для відображення на сторінці плагінів (поряд із посиланнями активації/деактивації).

Звідти вам потрібно буде визначити свою функцію, а потім створити посилання на сторінку налаштувань.

Усе, що вам потрібно знати, це:

1. функція зворотного виклику приймає масив посилань, які вона збирається відобразити,
2. URL-адресу вашої сторінки налаштувань

Звідти ви просто додаєте посилання на сторінку налаштувань плагіна та додаєте посилання до вхідного масиву. Потім ви повертаєте цей масив до WordPress.

Ось як :

<?php
add_filter('plugin_action_links_'. plugin_basename(__FILE__), __NAMESPACE__. 'acme_settings_link' );
/**
 * Creates a Settings link that links the users directly to the Settings page from the admin
 * screen.
 *
 * @param array $links The list of links to appear under the plugin title.
 * @return array $links The updated array of links including the 'Settings' link.
 */
function acme_settings_link($links) {

    // Build the URL.
    $url = add_query_arg(
        'page',
        'acme-plugin',
        get_admin_url(). 'admin.php'
    );

    // Create the link.
    $settings_link = "<a href='$url'>". __( 'Settings' ). '</a>';

    // Adds the link to the end of the array.
    array_push(
        $links,
        $settings_link
    );

    return $links;
}

І це все.

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

Однак звідси посилання на налаштування плагіна з’явиться на сторінці плагіна в області адміністрування WordPress.