Добавление ссылки на настройки плагина

Всякий раз, когда вы создаете плагин, который вводит подменю, и используете соответствующие 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.