web-dev-qa-db-fra.com

Écran de positionnement (contextuel) Onglets d'aide

L'utilisation de la nouvelle classe WP_Screen facilite l'ajout de texte d'aide à un écran.

<?php
add_action( "load-{$somepage}", 'wpse_load_reading' );
function wpse_load_reading()
{
    get_current_screen()->add_help_tab( array(
        'id'        => 'my-help-tab',
        'title'     => __( 'My Title' ),
        'content'   => __( 'Help Content' )
    ) );
}

C'est parfait pour les pages personnalisées. Mais lors de l'ajout d'un onglet d'aide à un écran existant, disons options-reading.php, il se produit un phénomène étrange.

Le hook load-options-reading.php se déclenche avant que la page intégrée WP ajoute ses propres onglets d'aide. En d'autres termes, l'ajout d'un onglet d'aide à un écran existant place tous les onglets d'aide intégrés au bas de la liste.

Voici du code, si vous souhaitez essayer ceci:

<?php
add_action( "load-options-reading.php", 'wpse_load_reading2' );
function wpse_load_reading2()
{
    get_current_screen()->add_help_tab( array(
        'id'        => 'my-help-tab',
        'title'     => __( 'My Title' ),
        'content'   => __( 'Why is this tab above the built in tab?' )
    ) );
}

Est-il possible de réorganiser les onglets d'aide sur un écran?

MODIFIER:

J'ai trouvé un moyen de contourner ça. Les onglets d'aide par défaut sont ajoutés avant que le fichier admin-header.php soit inclus.

Vous pouvez donc vous connecter à load-{$built_in_page}, puis à une fonction admin_head qui se charge de configurer vos onglets d’aide.

<?php
add_action( 'load-options-reading.php', 'wpse45210_load' );
function wpse45210_load()
{
    add_action( 'admin_head', 'wpse45210_add_help' );
}

function wpse45210_add_help()
{
    get_current_screen()->add_help_tab( array(
        'id'        => 'my-help-tab',
        'title'     => __( 'My Title' ),
        'content'   => __( 'This tab is below the built in tab.' )
    ) );
}

Semble un peu comme un hack. Y a-t-il un meilleur moyen?

contextual-help
8
chrisguitarguy

Comme @Mamaduka l'a suggéré, vous pouvez vous connecter à admin_head-{$page_hook} et y ajouter l'aide contextuelle. admin_head se déclenche après l'ajout des onglets d'aide contextuelle par défaut.

<?php
add_action( 'admin_head-options-reading.php', 'wpse45210_add_help' );
function wpse45210_add_help()
{
    get_current_screen()->add_help_tab( array(
        'id'        => 'my-help-tab',
        'title'     => __( 'My Title' ),
        'content'   => __( 'This tab is below the built in tab.' )
    ) );
}
5
chrisguitarguy

Utilisez l'action admin_head-$hook_suffix, c'est la même méthode qui supprime simplement l'action exta et le rappel.

6
Mamaduka

Jesupposetu as trois chances:

  1. Utilisez WP_Screen->$_help_tabs pour les réorganiser manuellement.
  2. Saisissez les onglets d'aide existants, enregistrez-les temporairement ailleurs. Utilisez ensuite WP_Screen->remove_help_tab( $id ), puis rajoutez-les manuellement.
  3. Utilisez le filtre admin_head pour remplir les onglets de l'aide ou ne pas utiliser l'un des filtres ou des crochets qui se déclenchent avant dans admin-header.php.
1
kaiser