Hinzufügen eines Plugin-Einstellungslinks

Immer wenn Sie ein Plugin erstellen, das ein Untermenü einführt, und Sie die richtigen APIs verwenden, erstellen Sie eine Verwaltungsseite (unabhängig davon, ob sie Einstellungen hat oder nicht).

Wenn Sie dies tun, können Sie jedoch auch einen Plugin-Einstellungslink einfügen. Dies sind die Links, die unter dem Namen des Plugins im Plugin-Dashboard erscheinen.

Wenn Ihr Plugin seinen Untermenüpunkt einführt, dann führt es wahrscheinlich eine eigene Einstellungsseite ein. Und wenn Sie diese Seite mit Ihrem Plugin-Einstellungslink verknüpfen möchten, ist das wirklich einfach.

Plugin-Einstellungen-Link

Zunächst kann es hilfreich sein, den von WordPress bereitgestellten Hook plugin_action_links zu überprüfen .

Wie der Kodex sagt:

Wird auf die Liste der Links angewendet, die auf der Plugin-Seite angezeigt werden sollen (neben den Aktivierungs-/Deaktivierungs-Links).

Von dort aus müssen Sie Ihre Funktion definieren und dann einen Link zur Einstellungsseite erstellen.

Alles, was Sie wissen müssen, ist Folgendes:

1. Die Callback-Funktion akzeptiert ein Array der Links, die sie rendern wird.
2. die URL zu Ihrer Einstellungsseite

Von dort aus fügen Sie einfach einen Link zu Ihrer Plugin-Einstellungsseite hinzu und fügen den Link dem eingehenden Array hinzu. Dann gibst du dieses Array an WordPress zurück.

So geht’s :

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

Und das ist es.

Wenn Sie ändern möchten, wo sich der Link befindet, können Sie ihn mit einer der vielen PHP-Array-Funktionen an einer anderen Stelle im Array platzieren (oder sogar ändern, wo er in der Funktion oben angegeben ist (erste oder letzte).

Von hier aus erscheint der Link für die Plugin-Einstellungen jedoch auf der Plugin-Seite im WordPress-Administrationsbereich.