Adicionando um link de configurações de plug-in

Sempre que você estiver construindo um plugin que introduz um submenu e estiver usando as APIs apropriadas, estará criando uma página de administração (com ou sem configurações).

Ao fazer isso, porém, você também pode introduzir um link de configurações do plugin. Esses são os links que aparecem sob o nome do plug-in no painel do plug-in.

Se o seu plug-in apresentar seu item de submenu, provavelmente apresentará sua própria página de configurações. E se você deseja associar esta página ao link de configurações do plug-in, é muito fácil de fazer.

Link de configurações do plug-in

Primeiro, pode ser útil revisar o gancho plugin_action_links que o WordPress fornece.

Como diz o Codex:

Aplicado à lista de links a serem exibidos na página de plugins (ao lado dos links de ativação/desativação).

A partir daí, você precisará definir sua função e criar um link para a página de configurações.

Tudo que você precisa saber é o seguinte:

1. a função de retorno de chamada aceita uma matriz de links que irá renderizar,
2. o URL para sua página de configurações

A partir daí, basta adicionar um link à página de configurações do plug-in e adicionar o link à matriz de entrada. Então você retorna essa matriz para o WordPress.

Veja como :

<?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;
}

E é isso.

Se você quiser mudar onde o link está localizado, você pode colocá-lo em outro lugar no array usando uma das muitas funções do array PHP (ou até mesmo mudando onde está especificado na função acima (primeiro ou último).

A partir daqui, porém, o link de configurações do plug-in aparecerá na página do plug-in na área de administração do WordPress.