Aggiunta di un collegamento alle impostazioni del plug-in

Ogni volta che stai creando un plug-in che introduce un sottomenu e stai utilizzando le API appropriate, creerai una pagina di amministrazione (indipendentemente dal fatto che abbia o meno impostazioni).

Quando lo fai, tuttavia, puoi anche introdurre un collegamento alle impostazioni del plug-in. Questi sono i collegamenti che appaiono sotto il nome del plug-in nella dashboard del plug-in.

Se il tuo plug-in introduce la sua voce di sottomenu, è probabile che introduca la propria pagina delle impostazioni. E se stai cercando di associare questa pagina al link delle impostazioni del tuo plug-in, è davvero facile da fare.

Collegamento alle impostazioni del plug-in

Innanzitutto, potrebbe essere utile rivedere l’ hook plugin_action_links fornito da WordPress.

Come afferma il Codice:

Applicato all’elenco dei link da visualizzare nella pagina dei plugin (accanto ai link di attivazione/disattivazione).

Da lì, dovrai definire la tua funzione e quindi creare un collegamento alla pagina delle impostazioni.

Tutto quello che devi sapere è quanto segue:

1. la funzione di callback accetta un array di collegamenti che renderà,
2. l’URL della pagina delle impostazioni

Da lì, aggiungi semplicemente un collegamento alla pagina delle impostazioni del plug-in e aggiungi il collegamento all’array in arrivo. Quindi restituisci quell’array a WordPress.

Ecco come :

<?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 questo è tutto.

Se vuoi cambiare la posizione del collegamento, puoi posizionarlo altrove nell’array usando una delle tante funzioni di array PHP (o anche cambiando dove è specificato nella funzione sopra (prima o ultima).

Da qui, tuttavia, il collegamento alle impostazioni del plug-in apparirà nella pagina del plug-in nell’area di amministrazione di WordPress.