Usar a nova classe WP_Screen
facilita muito a adição de texto de ajuda a uma tela.
<?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' )
) );
}
Isso é ótimo para páginas personalizadas. Mas ao adicionar uma guia de ajuda a uma tela existente, digamos options-reading.php
, alguma estranheza acontece.
O gancho load-options-reading.php
é acionado antes que a página WP incorporada inclua suas próprias guias de ajuda. Em outras palavras, adicionar uma guia de ajuda a uma tela existente faz com que todas as guias de ajuda incorporadas fiquem na parte inferior da lista.
Aqui está um código, se você quiser tentar:
<?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?' )
) );
}
Existe alguma maneira de reordenar as guias de ajuda em uma tela?
EDITAR:
Encontrou uma maneira de contornar isso. As guias de ajuda padrão são adicionadas antes que o arquivo admin-header.php
seja incluído.
Assim, você pode conectar-se a load-{$built_in_page}
e, a partir daí, ligar uma função admin_head
, que cuida da configuração de suas guias de ajuda.
<?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.' )
) );
}
Parece uma espécie de hack. Existe uma maneira melhor?