Plugin Settings -linkin lisääminen

Aina kun rakennat alivalikon esittelevää laajennusta ja käytät oikeita sovellusliittymiä, luot hallintasivun (riippumatta siitä, onko sillä asetuksia vai ei).

Kun teet tämän, voit kuitenkin myös ottaa käyttöön laajennuksen asetuslinkin. Nämä ovat linkit, jotka näkyvät laajennuksen nimen alla laajennuksen hallintapaneelissa.

Jos laajennus esittelee alivalikkokohtansa, se todennäköisesti esittelee oman asetussivunsa. Ja jos haluat liittää tämän sivun laajennusasetuksiin, se on todella helppoa.

Plugin Settings -linkki

Ensinnäkin voi olla hyödyllistä tarkastella WordPressin tarjoamaa plugin_action_links – koukkua.

Kuten Codex sanoo:

Käytetään liitännäissivulla näytettävien linkkien luetteloon (aktivointi-/deaktivointilinkkien vieressä).

Sieltä sinun on määritettävä toiminto ja luotava linkki asetussivulle.

Sinun tarvitsee vain tietää seuraava:

1. takaisinsoittotoiminto hyväksyy joukon linkkejä, jotka se aikoo hahmontaa,
2. URL-osoite asetussivullesi

Sieltä lisäät vain linkin laajennusasetussivullesi ja lisäät linkin saapuvaan taulukkoon. Sitten palautat taulukon WordPressiin.

Näin :

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

Ja siinä se.

Jos haluat muuttaa linkin sijaintia, voit sijoittaa sen muualle taulukkoon käyttämällä yhtä monista PHP-taulukkofunktioista (tai jopa muuttamalla sen sijaintia yllä olevassa funktiossa (ensimmäinen tai viimeinen).

Tästä eteenpäin laajennusasetusten linkki tulee kuitenkin näkyviin WordPressin hallinta-alueen laajennussivulle.