Ajout d’un lien de paramètres de plugin

Chaque fois que vous créez un plugin qui introduit un sous-menu et que vous utilisez les API appropriées, vous allez créer une page d’administration (qu’elle ait ou non des paramètres).

Ce faisant, cependant, vous pouvez également introduire un lien de paramètres de plugin. Ce sont les liens qui apparaissent sous le nom du plugin depuis le tableau de bord du plugin.

Si votre plugin introduit son élément de sous-menu, il introduit probablement sa propre page de paramètres. Et si vous cherchez à associer cette page au lien des paramètres de votre plugin, c’est vraiment facile à faire.

Lien des paramètres du plug-in

Tout d’abord, il peut être utile de revoir le crochet plugin_action_links fourni par WordPress.

Comme l’indique le Codex :

Appliqué à la liste des liens à afficher sur la page des plugins (à côté des liens activer/désactiver).

À partir de là, vous devrez définir votre fonction, puis créer un lien vers la page des paramètres.

Tout ce que vous devez savoir est ce qui suit :

1. la fonction de rappel accepte un tableau des liens qu’elle va rendre,
2. l’URL de votre page de paramètres

À partir de là, vous ajoutez simplement un lien vers la page des paramètres de votre plug-in et ajoutez le lien vers le tableau entrant. Ensuite, vous renvoyez ce tableau à WordPress.

Voici comment :

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

Et c’est tout.

Si vous voulez changer l’emplacement du lien, vous pouvez le placer ailleurs dans le tableau en utilisant l’une des nombreuses fonctions de tableau PHP (ou même en changeant l’endroit où il est spécifié dans la fonction ci-dessus (premier ou dernier).

À partir de là, cependant, le lien des paramètres du plugin apparaîtra dans la page du plugin dans la zone d’administration de WordPress.