O que são os avisos de administração do WordPress (e como eles funcionam)?

Mesmo se você for novo no WordPress, estará familiarizado com os avisos do administrador. São as mensagens que aparecem em seu painel para informá-lo sobre atualizações, erros, alterações e muito mais.

Os avisos do administrador fornecem informações críticas sobre seu site, o que permite que você tome medidas oportunas. Além disso, se você é um desenvolvedor de temas ou plugins, saber como adicionar avisos de administração ao WordPress é importante, pois eles permitem que você comunique facilmente mensagens aos seus usuários.

Neste artigo, veremos os diferentes tipos de avisos de administrador que você pode usar. Falaremos sobre situações em que faz sentido usar avisos de administração e, em seguida, ensinaremos como adicioná-los ao WordPress. Vamos ao trabalho!

Quais são os diferentes tipos de avisos de administração no WordPress?

Você deve ter notado que nem todos os avisos de administração do WordPress têm a mesma aparência. Por padrão, o WordPress usa quatro estilos diferentes, dependendo da finalidade dos avisos exibidos:

1. Sucesso. Este é o tipo de aviso que você verá ao fazer alterações em seu site (como uma instalação ou ativação de plug-in) e ele será executado sem problemas.
2. Erro. Como o próprio nome indica, você verá esse tipo de mensagem se houver algo errado com seu site. Normalmente, isso é usado quando um plugin ou tema gera um erro.
3. Aviso. Você verá esse tipo de aviso aparecer quando um plug-in ou componente do site estiver funcionando, mas não funcionar conforme o esperado.
4. Em formação. Esse tipo de aviso do administrador é perfeito para comunicar informações simples.

Como mencionamos anteriormente, essas quatro classificações são estilos que você pode usar para avisos de administração. Cada aviso individual funciona da mesma forma sob o capô, para que você veja apenas uma diferença visual. aqui estão alguns exemplos:

Se você planeja adicionar avisos de administração personalizados ao seu site (ou a um plugin ou tema em que está trabalhando), é importante seguir a mesma classificação. O esquema de cores simples pode ajudar os usuários a identificar rapidamente quais avisos devem ser priorizados. Por exemplo, se virmos um aviso vermelho (um erro) ou amarelo (um aviso), sabemos que algo está errado.

Com isso em mente, vamos falar sobre quando faz sentido usar os avisos de administração do WordPress.

Por que você deve adicionar avisos de administração personalizados do WordPress?

Os avisos do administrador no WordPress são sobre usabilidade e podem fornecer aos usuários feedback e informações críticas. Por exemplo, avisos de sucesso. Se você atualizar uma das configurações do seu plug-in e salvar as alterações, o aviso de sucesso fornecerá uma confirmação visual do processo:

Para seu próprio site, adicionar avisos personalizados pode não ser necessário, a menos que vários usuários tenham acesso ao painel. Nesse caso, você pode usar avisos informativos para fornecer atualizações rápidas aos membros de sua equipe.

Avisos de administração do WordPress para desenvolvedores de plugins e temas

Muitos desenvolvedores de plugins também usam avisos administrativos para comunicar informações importantes a seus usuários. Eles também são normalmente usados ​​para promover a funcionalidade premium do plugin ou tema.

Tenha em mente que nem todos os usuários gostam de ser bombardeados com avisos de administração. Durante anos, houve um debate saudável na comunidade WordPress sobre a maneira como os desenvolvedores usam os avisos.

O uso inadequado de avisos administrativos pode (e resultou) em uma reação significativa em alguns casos. Em poucas palavras, você precisa ter cuidado com as situações em que decide implementar os avisos do administrador. Na próxima seção, discutiremos como adicionar avisos do administrador e forneceremos algumas dicas para padronizá-los.

DICA: Gerenciando avisos de administrador no WordPress

Se você tiver muitos avisos de administrador no seu WordPress, mas não quiser descartá-los antes de lê-los (quando tiver tempo), mas eles estiverem distraindo você, use o plugin Admin Notices Manager para mover todos os avisos de administração em uma central local e lê-los em sua própria conveniência.

Como adicionar avisos de administração no WordPress (2 maneiras)

Vamos agora ensiná-lo a adicionar avisos de administração no WordPress de duas maneiras. Primeiro, veremos a abordagem manual e, em seguida, mostraremos como adicionar avisos de administrador usando um plug-in.

1. Adicione avisos de administrador manualmente

Como o WordPress já fornece estilos padrão para avisos de administração, adicionar novas notificações ao seu site não é tão complicado quanto você imagina. Isso ocorre porque você pode usar 'ganchos' existentes para chamar diferentes estilos de alerta.

De qualquer forma, você precisará adicionar alguns snippets de código ao seu site. Há duas abordagens que você pode adotar quando se trata de implementar manualmente os avisos do administrador:

1. Adicione o código ao arquivo functions.php do seu tema ativo.
2. Crie um plugin de código personalizado para WordPress que inclua o código do aviso.

Qual abordagem você usará dependerá do que você planeja usar para os avisos do administrador. Aqui está um exemplo rápido de um aviso de administrador personalizado que exibe a mensagem "Você está na página de configurações!":

function notice_example(){
    global $pagenow;
    if ( $pagenow == 'options-general.php' ) {
         echo '<div class="notice notice-warning is-dismissible">
             <p>You are on the settings page!</p>
         </div>';
    }
}
add_action('admin_notices', 'notice_example');

Aqui, estamos registrando uma nova função chamada notice_example . Esta função verifica se você está atualmente na página de configurações do WordPress. Se estiver, ele exibirá a mensagem "Você está na página de configurações!" mensagem usando o estilo de aviso do administrador.

Você também notará o parâmetro is-dismissible . Isso permite que o usuário final descarte ou feche o aviso, o que é sempre recomendado. Isto é o que parece:

Se você deseja criar avisos de administração personalizados para ações específicas, dê uma olhada no manual do desenvolvedor do WordPress, que inclui todas as informações necessárias. Além disso, os autores de temas devem dar uma olhada na página do WPTRT no GitHub. Isso fornece uma classe personalizada para ajudá-lo a criar avisos de administração padronizados que são dispensáveis ​​para o usuário final por padrão.

Em seguida, vamos ver como usar um plugin para criar avisos de administração do WordPress.

2. Use um plug-in para adicionar avisos de administração personalizados

Não há muitos plugins que permitem configurar avisos de administração personalizados no WordPress. Isso ocorre porque a funcionalidade geralmente está além das necessidades da maioria dos usuários de plugins, e os avisos do administrador são melhores codificados no núcleo do seu projeto.

Mesmo assim, nossa opção recomendada aqui é KJM Admin Notices:

Depois de instalar o plug-in, você pode configurar novos avisos administrativos acessando a nova guia Avisos em seu painel:

Clique em Add Notice e você poderá usar o editor do WordPress para montar a mensagem desejada. Com este plugin, você pode dividir os avisos em duas partes. O título aparecerá com mais destaque e seu corpo inclui o texto que aparece logo abaixo:

Depois de publicar um aviso, você o verá aparecer automaticamente na parte superior da página em que estiver:

Depois de personalizar a mensagem do seu aviso, você pode decidir quais funções de usuário poderão vê-la:

Esse recurso torna o plugin uma opção fantástica se você estiver trabalhando com uma grande equipe, já que você tem controle total sobre quem vê cada mensagem. Além disso, o plug-in também permite que você altere alguns aspectos da aparência de seus avisos. Por exemplo, você pode optar por ocultar seu título, quem o publicou e até alterar suas cores:

Como acontece com qualquer outro conteúdo que você cria usando o editor do WordPress, você pode salvar seus avisos de administração como rascunhos ou agendá-los em vez de publicá-los imediatamente. Por fim, você pode alterar o estilo padrão que seus avisos usam por meio do menu Notice Cats à direita:

Para o nosso exemplo, usamos o estilo SUCCESS . No entanto, lembre-se de que você deve alterar o estilo que usa dependendo do tipo de aviso do administrador que deseja enviar.

Adicionar avisos de administração personalizados no WordPress

Prestar atenção aos avisos do administrador pode ajudá-lo a garantir que seu site esteja sempre na melhor forma possível. Além de manter seu site, saber como adicionar avisos de administração no WordPress é fundamental se você planeja criar temas ou plugins personalizados.

Existem duas maneiras de adicionar avisos de administração no WordPress, que são:

1. Adicione avisos de administrador manualmente usando código.
2. Use um plug-in para adicionar avisos de administração personalizados.

Dica do usuário: Se você deseja apenas mais controle sobre os avisos de administração existentes ou garantir que não perca nenhum aviso importante, não se esqueça de usar o Gerenciador de avisos de administrador para gerenciar todos os avisos de administração no WordPress. Com este plugin, você poderá acessar rapidamente uma 'caixa de entrada' de avisos do administrador que inclui todos os avisos. O resultado é uma experiência mais limpa para o usuário final, enquanto ainda recebe informações vitais para eles.