Lägga till en plugin-inställningslänk

När du bygger ett plugin som introducerar en undermeny, och du använder rätt API:er, kommer du att skapa en administrationssida (oavsett om den har inställningar eller inte).

När du gör detta kan du dock också introducera en länk för plugininställningar. Det här är länkarna som visas under namnet på plugin-programmet från i plugin-instrumentpanelen.

Om ditt plugin introducerar sitt undermenyobjekt introducerar det troligen sin egen inställningssida. Och om du vill associera den här sidan med din plugin-inställningslänk är det verkligen enkelt att göra.

Länk för plugininställningar

Först kan det vara bra att granska plugin_action_links- kroken som WordPress tillhandahåller.

Som Codex säger:

Tillämpas på listan över länkar som ska visas på pluginsidan (bredvid länkarna aktivera/avaktivera).

Därifrån måste du definiera din funktion och sedan skapa en länk till inställningssidan.

Allt du behöver veta är följande:

1. återuppringningsfunktionen accepterar en rad länkar som den kommer att rendera,
2. URL:en till din inställningssida

Därifrån lägger du helt enkelt till en länk till din plugin-inställningssida och lägger till länken till den inkommande arrayen. Sedan returnerar du den arrayen till WordPress.

Så här gör du :

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

Och det är allt.

Om du vill ändra var länken finns kan du placera den någon annanstans i arrayen med en av de många PHP-arrayfunktionerna (eller till och med ändra var den är specificerad i funktionen ovan (första eller sista).

Härifrån kommer dock länken för plugininställningar att visas på pluginsidan i WordPress administrationsområde.