Esta pequena aba « Ajuda Que está no canto superior direito do painel de administração do WordPress, que quando clicado revela informações úteis sobre as várias páginas de administração e como elas funcionam, é chamado de guia de ajuda sensível ao contexto.

Primeiro de tudo, se você nunca instalou o WordPress, descubra Como instalar um blog WordPress passos 7 et Como encontrar, instalar e ativar um tema WordPress em seu blog 

Então, voltemos ao porquê de estarmos aqui.

Esta ajuda é contextual porque as informações que exibe pertencem à página de administração que está sendo exibida no momento.

Por exemplo, quando a guia de Ajuda sensível ao contexto é clicada na tela de edição do artigo, informações sobre como várias tarefas são reveladas, incluindo os seguintes exemplos:

Ajuda contextual do Wordpress

Se você é um desenvolvedor de plugins ou tema WordPress, ele ajudará você a fornecer documentação rápida para seus usuários, o que reduzirá suas perguntas de suporte ao cliente.

Quando um tipo de postagem personalizado e uma página de configurações do tema WordPress ou plugin são criados, não há guia de ajuda contextual por padrão. Portanto, neste tutorial, você aprenderá como adicionar um às páginas de administração mencionadas acima.

Leia também o nosso 5 passos para criar melhor conteúdo para o seu blog

Adicionada guia de ajuda contextual no painel

Os métodos add_help_tab () "E" set_help_sidebar () »Da classe WP_Screen permitem adicionar um menu de ajuda contextual e uma barra lateral à guia Ajuda em uma página de administração.

A função abaixo adicionará três menus à guia de ajuda sensível ao contexto de uma página de administração.

Por enquanto, a função "sp_help_tabs" não é exibida em nenhuma página de administração porque você ainda não definiu a (s) página (s) onde ela será exibida.

function sp_help_tabs() {

    $screen = get_current_screen();

    $screen->add_help_tab(
        array(
            'id'      => 'sp_overview',
            'title'   => 'Aperçu',
            'content' => '<p>Aperçu de votre plugin</p>'
        )
    );

    $screen->add_help_tab(
        array(
            'id'      => 'sp_faq',
            'title'   => 'FAQ',
            'content' => '<p>Foire aux questions</p>'
        )
    );

    $screen->add_help_tab(
        array(
            'id'      => 'sp_support',
            'title'   => 'Assistance',
            'content' => '<p>Assisance</p>'
        )
    );
}

Abaixo está uma captura de tela da guia de Ajuda sensível ao contexto quando adicionada a uma página de administração.

Também dê uma olhada em Como criar screenshots no WordPress

Exemplo de um menu de contexto wordpress

A função get_current_screen () »Retorna um objeto« WP_Screen Da página de administração atualmente aberta, e seu valor é salvo na variável $ tela.

O método add_help_tab () ”, Que aceita as configurações abaixo, é chamado três vezes para adicionar três menus à ajuda contextual na tela.

  • ID : um identificador único para a guia. Deve ser seguro em HTML e não deve conter espaços.
  • Título: título da guia.
  • Conteúdo: conteúdo da guia de ajuda. Talvez em texto simples ou HTML.
  • Lembrete: a função deve ser chamada para exibir o conteúdo desta página.

Pela descrição do parâmetro acima, você pode ver que o terceiro e o quarto parâmetros estão relacionados - eles lidam com a exibição do conteúdo da guia. Enquanto o primeiro é uma string contendo o conteúdo em formato de texto ou HTML, o último é uma função de retorno de chamada que ecoa ou imprime o conteúdo da guia.

Descubra também Como personalizar a área de administração do seu blog WordPress

A função de retorno de chamada aceita dois argumentos " $ tela "E" $ guia " Enquanto o primeiro é o assunto " WP_Screen "Da página atual e da última, uma matriz de argumentos e seus valores da função" add_help_tab () ".

Esses dois argumentos serão úteis se você quiser exibir o conteúdo na guia sob certas condições. Por exemplo, você pode já ter o conteúdo que precisa para exibir, então você pode apenas exibir o canal. No entanto, você pode ter que manipular algo para adquirir esse conteúdo, o que torna o uso de um retorno de chamada mais apropriado.

Um exemplo do uso do callback:

function sp_help_tabs() {

    $screen = get_current_screen();

    $screen->add_help_tab(
        array(
            'id'       => 'sp_overview',
            'title'    => 'Aperçu',
            'callback' => function ( $screen, $tab ) {
                echo '<p>Aperçu de votre onglet</p>';
            }
        )
    );
}

No código acima, uma função anônima é usada como retorno de chamada. Uma função nomeada também pode ser usada da seguinte maneira:

function sp_help_tabs() {

    $screen = get_current_screen();

    $screen->add_help_tab(
        array(
            'id'       => 'sp_overview',
            'title'    => 'Aperçu',
            'callback' => 'overview_content'
        )
    );
}

function overview_content( $screen, $tab ) {
    echo '<p>Aperçu de votre plugin.</p>';
}

Ambos: "conteúdo" e "retorno de chamada" podem ser combinados com o primeiro exibido antes deste.

function sp_help_tabs() {

    $screen = get_current_screen();

    $screen->add_help_tab(
        array(
            'id'       => 'sp_overview',
            'title'    => 'Aperçu',
            'content'  => '<p>Aperçu de votre plugin</p>',
            'callback' => function () {
                echo '<p>Plus de détails sur le plugin</p>';
            }
        )
    );
}

Para adicionar uma barra lateral usando a ajuda de contexto na tela, use " WP_Screen E o método dele set_help_sidebar Como segue:

function sp_help_tabs() {

    $screen = get_current_screen();

    $screen->add_help_tab(
        array(
            'id'      => 'sp_overview',
            'title'   => 'Aperçu',
            'content' => '<p>Aperçu de votre plugin</p>'
        )
    );

    $screen->add_help_tab(
        array(
            'id'      => 'sp_faq',
            'title'   => 'FAQ',
            'content' => '<p>Foire aux questions</p>'
        )
    );

    $screen->add_help_tab(
        array(
            'id'      => 'sp_support',
            'title'   => 'Asistance',
            'content' => '<p>Tout sur l'assistance</p>'
        )
    );

    // Add a sidebar to contextual help.
    $screen->set_help_sidebar( 'Cette section sera ajoutée à la sidebar.' );
}

Para adicionar a guia de ajuda contextual a um tipo de publicação "livro", conecte a função "sp_help_tabs" às ações "load-edit.php" e "load-post.php". Em seguida, execute uma verificação condicional para ter certeza de que está em um tipo de postagem personalizado para "livro", como:

add_action( "load-edit.php", 'sp_help_tabs' );
add_action( "load-post.php", 'sp_help_tabs' );


function sp_help_tabs() {

    $screen = get_current_screen();

    $screen_ids = array( 'edit-book', 'book' );

    if ( ! in_array( $screen->id, $screen_ids ) ) {
        return;
    }

    $screen->add_help_tab(
        array(
            'id'      => 'sp_overview',
            'title'   => 'Aperçu',
            'content' => '<p>Aperçu de votre plugin</p>'
        )
    );

    $screen->add_help_tab(
        array(
            'id'      => 'sp_faq',
            'title'   => 'FAQ',
            'content' => '<p>Foire aux questions</p>'
        )
    );


    $screen->add_help_tab(
        array(
            'id'      => 'sp_support',
            'title'   => 'Assistance',
            'content' => '<p>Section pour l'assistance</p>'
        )
    );


    // Add a sidebar to contextual help.
    $screen->set_help_sidebar( 'Cette section sera ajoutée à la sdeibar.' );
}

A função sp_help_tabs () "Estava pendurado" Load-edit.php »E« Load-post.php Porque você deseja que a guia de ajuda contextual apareça nas listas de publicação (página que lista a publicação pertencente ao tipo de publicação) e a página de edição (página de administração onde uma publicação é editada, salva e publicada).

Veja nosso artigo sobre Como restaurar o modo de edição sem WordPress distração

Para certificar-se de adicionar a guia Ajuda de contexto ao tipo de postagem personalizada " livro ", Você pode usar a instrução condicional" if "dentro da função para garantir que o ID da tela atual seja de fato" edit-book "E" livro " Observe que o ID da tela é " edit-book "E" livro Nos colchetes Load-edit.php "E" Load-post.php Respectivamente.

Se você quiser que as guias de ajuda contextual exibidas na lista de livros e as telas de edição do livro sejam diferentes, conecte duas funções contendo o conteúdo da guia Load-edit.php "E" Load-post.php Como segue:

add_action( 'load-edit.php', 'post_listing_screen_help_tab' );

/**
 * Cette section sera ajouté au CPT book
 */
function post_listing_screen_help_tab() {

    $screen = get_current_screen();

    if ( 'edit-book' != $screen->id ) {
        return;
    }

    $screen->add_help_tab(
        array(
            'id'      => 'book_review',
            'title'   => 'Revue des livres',
            'content' => '<p>Ajouter une revue des livres ici</p>'
        )
    );

    // Add a sidebar to contextual help.
    $screen->set_help_sidebar( 'Cette section s'affichera sur la sidebar.' );
}

add_action( 'load-post.php', 'post_edit_screen_help_tab' );

/**
 * This will be added to the admin page for editing a post belonging to "book" CPT.
 */
function post_edit_screen_help_tab() {

    $screen = get_current_screen();

    if ( 'book' != $screen->id ) {
        return;
    }

    $screen->add_help_tab(
        array(
            'id'      => 'edit_book_review',
            'title'   => 'Modifier uner evue',
            'content' => '<p>Comment modifier une revue.</p>'
        )
    );

    // adds a sidebar to contextual help.
    $screen->set_help_sidebar( 'Cette section s'affichera sur la sidebar.' );
}

Como adicionar um menu de ajuda às páginas de configurações de plug-ins

Adicionando uma guia de ajuda a um plugin ou página de configurações de plugin tema WordPress é praticamente o mesmo processo de uma tela de formato de postagem personalizado.

A única diferença é o gancho no qual a função que contém a guia de ajuda sensível ao contexto será conectada, que neste caso é " hook_suffix ”Retornado por add_menu_page (). Se você estiver criando um menu de nível superior ou se for um submenu add_submenu_page ().

Descubra também nosso artigo sobre Alguns plugins do WordPress para redirecionar

O código abaixo cria um menu de nível superior para nosso plugin de demonstração e nossa guia de ajuda contextual que foi adicionada à página de configuração do plugin.

add_action( 'admin_menu', 'register_plugin_page' );

function register_plugin_page() {

    $hook_suffix = add_submenu_page( 'plugins.php', 'SitePoint Plugin', 'SitePoint', 'manage_options', 'sp-config', 'sp_plugin_page' );

    add_action( "load-$hook_suffix", 'sp_help_tabs' );
}

function sp_plugin_page() {
    /* Le code pour les réglages sera ajouté ici */
}

function sp_help_tabs() {

    $screen = get_current_screen();

    $screen->add_help_tab(
        array(
            'id'      => 'sp_overview',
            'title'   => 'Aperçu',
            'content' => '<p>Aperçu de votre thème ici</p>'
        )
    );

    $screen->add_help_tab(
        array(
            'id'      => 'sp_faq',
            'title'   => 'FAQ',
            'content' => '<p>Foire aux questions</p>'
        )
    );

    $screen->add_help_tab(
        array(
            'id'      => 'sp_support',
            'title'   => 'Assistance',
            'content' => '<p>Section d'assistance</p>'
        )
    );

    $screen->set_help_sidebar( 'Cette section sera ajoutée à la sidebar.' );
}

O " hook_suffix "Retornado por" add_menu_page () Foi gravado em uma variável $ hook_suffix Então usado com o prefixo " carregar Para formar uma ação load- $ hook_suffix Que foi usado para incluir nossa guia de ajuda sensível ao contexto usando o " sp_help_tabs () Na página de configurações do plug-in.

É tudo sobre o método bastante detalhado de como adicionar um menu de ajuda às páginas de configurações do plug-in.

Descubra também alguns plugins premium do WordPress  

Você pode usar outro WordPress plugins para dar uma aparência moderna e otimizar o manuseio do seu blog ou site.

Oferecemos a você aqui alguns plugins premium do WordPress que ajudarão você a fazer isso.

1. WooCommerce Multi Moeda

WooCommerce Multi Moeda é um WordPress Plugin premium bastante impressionante que permite exibir sua loja em várias moedas. Ele adiciona uma opção que permite ao usuário alternar entre moedas a qualquer momento. A mudança entre moedas é bastante rápida, o que a torna ainda mais conveniente.

Plug-in wordpress do switcher de moeda multi-moeda para Woocommerce

Como é provável que funcione com várias moedas, ter a capacidade de estar disponível em vários idiomas é apenas o próximo passo lógico.

Leia também o nosso 10 WordPress plugins e WooCommerce para usar várias moedas

WooCommerce Multi Moeda é, portanto, compatível com Polylang, WPML e muitos outros plug-ins. Ele também oferece um detector de região, que exibirá a moeda local do visitante.

Descarregar | Demo | hospedagem na web

2. Aparg SmartAd

Si Você quer ganhar algum dinheiro vendendo espaço publicitário em seu site, você veio ao lugar certo. a WordPress Plugin premium Aparg SmartAd é um plugin exclusivo de gerenciamento de anúncios, que oferece recursos exclusivos.

Plugin de gerenciamento de anúncios Wordpress Aparg smartad

Seu tempo de instalação e interface proporcionarão uma excelente experiência de usuário. É o único WordPress Plugin deste tipo, que possui um controle publicitário inteligente que lhe permitirá atingir o seu público-alvo.

Leia também Como escolher a palavra-chave que irá atrair visitantes no WordPress

Suas principais características são: Suporte Multilíngue, uma interface gráfica profissional, o suporte para multisite, gerenciamento inteligente de anúncios, 43 modelos de pop-up e 34 animações, totalmente personalizáveis, suporte para vários formatos de anúncios, capacidade de agendar anúncios, detecção automática de bloqueadores de anúncios, etc.

Descarregar | Demo | hospedagem na web

3. CommentPress

Comentário é um plugin poderoso e compacto para WordPress que permite inserir, editar e deletar comentários com rapidez e facilidade. CommentPress usa Ajax, jQuery e PHP para oferecer aos visitantes a possibilidade de inserir comentários sem precisar recarregar a página.

Comentários do Commentpress ajax inserir, editar e excluir comentários para o plugin wp wordpress

Este plugin tem muitas opções de personalização, finalmente dando a aparência e a aparência que você deseja. Possui um captcha para bloquear spam e traz mais segurança à sua seção de comentários.

Leia também nosso artigo sobre Como o marketing de conteúdo afeta o SEO do seu blog

Suas principais características são: a fácil inserção de comentários, a possibilidade de os usuários responderem a comentários específicos, a paginação de comentários, o gerenciamento completo da administração da seção de comentários, botões para fácil inserção de imagens, vídeos e links, um layout totalmente responsivo, um Captcha para proteger o formulário e evitar spam, e muito mais.

Descarregar | Demo | hospedagem na web

Recursos Recomendados

Descubra outros recursos recomendados para ajudá-lo a criar e gerenciar seu site.

Conclusão

Aqui ! É isso para este tutorial, espero que permita que você adicione um menu de ajuda contextual no WordPress. Não hesite em compartilhe com seus amigos em suas redes sociais favoritas

No entanto, você também pode consultar nossos recursos, se você precisar de mais elementos para realizar seus projetos de criação de sites da Internet, consultando nosso guia em Criação de blog WordPress.

Se você tiver sugestões ou comentários, deixe-os em nossa seção Comentários.

...