Plugina sätete lingi lisamine

Kui loote pistikprogrammi, mis tutvustab alammenüüd, ja kasutate õigeid API-sid, loote halduslehe (olenemata sellest, kas sellel on sätted või mitte).

Seda tehes saate aga lisada ka pistikprogrammi sätete lingi. Need on lingid, mis kuvatakse pistikprogrammi armatuurlaual plugina nime all.

Kui teie pistikprogramm tutvustab oma alammenüüüksust, siis tõenäoliselt tutvustab see oma seadete lehte. Ja kui soovite seda lehte oma pistikprogrammi seadete lingiga seostada, on seda väga lihtne teha.

Pistikprogrammi seadete link

Esiteks võib olla kasulik vaadata üle WordPressi pakutav konks plugin_action_links .

Nagu Codex ütleb:

Rakendatakse pistikprogrammide lehel kuvatavate linkide loendile (aktiveerimis-/deaktiveerimislinkide kõrval).

Sealt peate määratlema oma funktsiooni ja seejärel looma lingi seadete lehele.

Kõik, mida pead teadma, on järgmine.

1. tagasihelistamise funktsioon aktsepteerib rida linke, mida see renderdab,
2. teie seadete lehe URL

Sealt lisate lihtsalt lingi oma pistikprogrammi seadete lehele ja lisate lingi sissetulevasse massiivi. Seejärel tagastate massiivi WordPressi.

Tehke järgmist.

<?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 see ongi kõik.

Kui soovite muuta lingi asukohta, saate selle paigutada massiivi mujale, kasutades ühte paljudest PHP massiivi funktsioonidest (või isegi muutes seda, kus see ülaltoodud funktsioonis on määratud (esimene või viimane).

Siit aga kuvatakse pistikprogrammi sätete link WordPressi haldusala pistikprogrammi lehel.