Agregar un enlace de configuración del complemento

Cada vez que esté creando un complemento que presente un submenú, y esté utilizando las API adecuadas, estará creando una página de administración (ya sea que tenga o no configuraciones).

Sin embargo, al hacer esto, también puede introducir un enlace de configuración del complemento. Estos son los enlaces que aparecen bajo el nombre del complemento en el panel de control del complemento.

Si su complemento presenta su elemento de submenú, es probable que presente su propia página de configuración. Y si está buscando asociar esta página con el enlace de configuración de su complemento, es realmente fácil de hacer.

Enlace de configuración del complemento

Primero, puede ser útil revisar el gancho plugin_action_links que proporciona WordPress.

Como dice el Codex:

Se aplica a la lista de enlaces para mostrar en la página de complementos (junto a los enlaces de activación/desactivación).

A partir de ahí, deberá definir su función y luego crear un enlace a la página de configuración.

Todo lo que necesitas saber es lo siguiente:

1. la función de devolución de llamada acepta una matriz de los enlaces que va a representar,
2. la URL de su página de configuración

A partir de ahí, simplemente agregue un enlace a la página de configuración de su complemento y agregue el enlace a la matriz entrante. Luego devuelve esa matriz a WordPress.

Así es como :

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

Y eso es.

Si desea cambiar la ubicación del enlace, puede colocarlo en otro lugar de la matriz utilizando una de las muchas funciones de matriz de PHP (o incluso cambiar el lugar donde se especifica en la función anterior (primero o último).

Sin embargo, desde aquí, el enlace de configuración del complemento aparecerá en la página del complemento en el área de administración de WordPress.