Como adicionar avisos de administração personalizados no WordPress (2 métodos fáceis)

Frequentemente, nossos leitores nos perguntam como podem adicionar avisos de administração personalizados no WordPress.

O núcleo, os temas e os plug-ins do WordPress exibem avisos de administração, como erros ou avisos aos usuários no painel. Se você for um administrador de site do WordPress, também poderá criar avisos personalizados para informar os membros da sua equipe sobre informações importantes sobre o site.

Neste artigo, mostraremos como você pode adicionar facilmente avisos de administração personalizados no WordPress.

Por que adicionar avisos de administração personalizados no WordPress?

Os avisos do administrador são notificações dentro da área de administração do WordPress que informam os usuários sobre informações importantes. Os exemplos incluem erros, avisos, alertas ou mensagens de sucesso relacionadas ao núcleo, aos plug-ins ou aos temas do WordPress.

Embora essas notificações sejam um recurso interno do WordPress, você também pode criar notificações personalizadas para o administrador em seu painel.

Por exemplo, digamos que você esteja trabalhando em um site WordPress para clientes que não estão familiarizados com a plataforma. Você pode adicionar avisos de administração para exibir informações úteis na área de administração do WordPress.

Alguns outros exemplos de uso de avisos personalizados do administrador incluem:

• Informar aos membros da equipe quando o site não estará disponível por estar em modo de manutenção.
• Orientar escritores ou editores a navegar pelo fluxo de trabalho editorial no painel, caso você administre um site com vários autores.
• Lembrar aos usuários o que fazer e o que não fazer ao gerenciar tarefas, conteúdo e mídia no WordPress.

Em suma, os avisos personalizados do administrador podem ser úteis para comunicar mensagens a você ou a outros usuários que trabalham no seu site. Dito isso, você precisará usá-los com sabedoria, pois o excesso de avisos pode ser irritante.

Agora, vamos ver como você pode adicionar seus avisos de administração personalizados no WordPress. Mostraremos dois métodos, e você pode usar os links rápidos abaixo para pular para o método que deseja usar:

Método 1: Adicionar avisos de administração personalizados do WordPress com um plug-in

Esse método usa o plug-in WP Custom Admin Interface. Ele permite que você personalize o painel do WordPress de acordo com suas preferências, incluindo a exibição de avisos de administração personalizados.

A primeira etapa é instalar e ativar o plug-in da interface WP Custom Admin. Para obter instruções passo a passo, consulte nosso guia sobre como instalar um plug-in do WordPress.

Em seguida, vá para Custom Admin Interface “ Admin Notice. Como você pode ver, a página de configurações do plug-in é bastante semelhante à do Classic Editor.

Agora você precisa rolar para baixo e inserir sua mensagem de aviso de administrador.

Você pode usar texto simples e/ou as opções de shortcode disponíveis para você, que estão localizadas acima do editor visual.

Se você usar o segundo método, a mensagem gerará conteúdo dinamicamente com base nos códigos de acesso fornecidos. Portanto, se você usar o shortcode [WEBSITE_URL], o shortcode será substituído pelo nome de domínio do seu site.

Além disso, sinta-se à vontade para adicionar uma imagem ou outros arquivos de mídia ou estilizar o texto usando a barra de ferramentas acima da caixa de texto.

Descendo, você pode escolher a cor do aviso personalizado do administrador. As opções padrão são:

• Verde para mensagens de sucesso
• Azul para avisos de informações não urgentes, mas importantes
• Amarelo para mensagens de aviso
• Vermelho para mensagens de erro

Outra coisa que você pode personalizar é a data final do aviso ou quando o aviso deve ser desativado. Sinta-se à vontade para deixá-la em branco se não houver data de expiração.

Você também pode tornar a mensagem descartável, o que é recomendado para notificações que usam as cores verde ou azul. Para avisos ou erros, talvez você queira continuar a exibi-los até que o problema seja resolvido, dependendo do problema.

Por fim, você pode tornar o aviso visível para todos ou apenas para determinados usuários. Se escolher a última opção, poderá clicar no botão “+” para especificar para quais funções de usuário o aviso deve ficar invisível.

Quando estiver satisfeito com o aviso personalizado do administrador, basta clicar em “Save All Settings” (Salvar todas as configurações).

E é isso!

Para ver a aparência do aviso personalizado do administrador, basta acessar qualquer página do painel do WordPress. A mensagem deve estar na parte superior da tela.

Método 2: Adicionar avisos de administração personalizados do WordPress com código

Embora o plug-in WP Custom Admin Interface seja fácil de usar, ele inclui muitos recursos adicionais que podem não estar relacionados às suas necessidades. Isso pode parecer um exagero se você estiver interessado apenas em criar avisos de administração personalizados.

Além disso, a interface de administração personalizada do WP só permite que você exiba um aviso personalizado de cada vez. Se você quiser exibir vários avisos em diferentes páginas do painel de administração do WordPress, o plug-in pode não ser uma opção adequada.

Em vez disso, você pode adicionar manualmente um aviso de administração personalizado no WordPress usando código. Isso permite que você se concentre apenas na adição do aviso personalizado, sem nenhum material extra, e pode exibir vários avisos, se necessário.

Se a codificação no WordPress parece assustadora, não se preocupe. Mostraremos a você uma maneira fácil e segura de inserir código personalizado, que é usar o WPCode. É o melhor e mais fácil plugin de snippet de código personalizado para iniciantes do mercado.

Com o WPCode, você pode inserir e gerenciar códigos facilmente sem interagir diretamente com os arquivos principais do WordPress. Dessa forma, as chances de quebrar seu site são zero ou nenhuma.

Para obter mais informações sobre o WPCode, consulte nossa análise do WPCode.

A primeira etapa para usar o WPCode é instalar e ativar o plugin. Se você precisar de alguma orientação, consulte nosso artigo sobre como instalar um plug-in do WordPress.

Em seguida, basta acessar Code Snippets “ + Add Snippet. Em Add Your Custom Code (New Snippet), clique em ‘Use snippet’.

Agora, vá em frente e insira um título para o snippet de código personalizado para que você possa identificá-lo facilmente e editá-lo posteriormente, se necessário. Pode ser algo como “Aviso personalizado do administrador”.

Em seguida, altere o tipo de código para “PHP Snippet”.

Depois de fazer isso, basta copiar e colar o código a seguir na caixa Code Preview (Visualização de código):

function wpb_admin_notice() {
	echo // Customize the message below as needed
	'<div class="notice notice-warning is-dismissible">
	<p>Important! We will not be publishing any new articles during the holidays. Please save your articles as drafts for the time being.</p>
	</div>'; 
}
add_action( 'admin_notices', 'wpb_admin_notice' );

Esta é a aparência da tela:

Esse código define uma função chamada wpb_admin_notice() no WordPress. Dentro dessa função, há uma instrução echo que gera uma mensagem de aviso em uma caixa estilizada.

Abaixo dessa declaração está <div class="notice notice-warning is-dismissible">. Essa é uma classe CSS que especifica o tipo de aviso do administrador, que, nesse caso, é um aviso. Por esse motivo, a caixa de aviso terá uma borda amarela.

Você também pode substituir a linha de código notice-warning por notice-error (vermelho), notice-info (azul) e notice-success (verde).

Abaixo da classe CSS está o conteúdo real do aviso. Aqui, a mensagem informa aos usuários que nenhum artigo novo será publicado durante os feriados e os aconselha a salvar os artigos como rascunhos por enquanto. Você pode substituir o texto entre as tags HTML <p> e </p> pelo seu próprio texto.

A linha add_action('admin_notices', 'wpb_admin_notice'); vincula essa função à ação 'admin_notices' no WordPress. Isso significa que o aviso de advertência será exibido na área de administração do WordPress, fornecendo informações importantes a todos os usuários.

Depois de inserir o código, role para baixo até a seção Inserção. Certifique-se de que o método de inserção seja “Auto Insert” e o local seja “Admin Only”.

Essas configurações garantirão que o snippet seja executado automaticamente apenas na área de administração do WordPress.

Depois disso, basta tornar o snippet de código “Ativo” e clicar em “Salvar snippet”.

Esta é a aparência do aviso de administração personalizado em nosso site de teste:

Exibição do aviso de administrador personalizado com base na função do usuário

Se você quiser criar um aviso de administrador personalizado que seja visível apenas para determinadas funções de usuário, também poderá fazer isso com o WPCode.

Aqui está um exemplo de código:

function wpb_admin_notice_editor() {
    // Get the current admin page
    global $pagenow;
    // Specify the admin pages where the notice should appear
	$admin_pages = [ 'index.php' ];
	// Get the current user
	$user = wp_get_current_user();
    // Check if the current page is in the specified admin pages and the user has the 'editor' role
    if ( in_array( $pagenow, $admin_pages ) && in_array( 'editor', (array) $user->roles ) ) {
		// Display a warning notice for editors
		echo
		'<div class="notice notice-warning is-dismissible">
			<p>Reminder! Do not save published posts as drafts after you update them. Just click the Update button without changing to the draft status. Thanks.</p>
		</div>';
	}
}
// Hook the function to display the notice in the admin area
add_action( 'admin_notices', 'wpb_admin_notice_editor' );

Esse código do WordPress define a função wpb_admin_notice_editor()que exibe um aviso de advertência na área de administração para usuários com a função de editor.

O código primeiro recupera a página de administração atual que está sendo visualizada usando $pagenow global;. Ele especifica que o aviso deve ser exibido em páginas wp-admin específicas, como o painel (index.php), por meio da matriz $admin_pages.

Se quiser que o aviso seja exibido em outras páginas da área de administração, basta adicionar o slug da página, como plugins.php para Plugins e edit.php para Posts e Páginas.

Apenas certifique-se de separar os slugs com uma vírgula e uma aspa simples, como em $admin_pages = [ 'index.php' , 'plugins.php', 'edit.php' ];.

Depois disso, o código reúne informações sobre o usuário conectado no momento com $user = wp_get_current_user();.

O código então verifica se a página atual está nas páginas de administração especificadas e se o usuário tem a função “editor” usando if ( in_array( $pagenow, $admin_pages ) && in_array( 'editor', (array) $user->roles ) ) {.

Se ambas as condições forem atendidas, ele exibirá um aviso de advertência.

Esta é a aparência do nosso aviso de administrador personalizado usando o código acima:

A criação de notificações personalizadas e direcionadas para o administrador requer algum conhecimento de codificação do WordPress. Se você estiver interessado em se aprofundar nesse tópico, recomendamos a leitura destes guias:

• O que são Hooks no WordPress?
• O que é Ação no WordPress?
• O que é um filtro no WordPress?

Esperamos que este artigo tenha ajudado você a aprender como adicionar avisos de administração personalizados no WordPress. Talvez você também queira consultar nosso guia sobre como codificar um site ou nossa seleção de especialistas sobre os melhores plug-ins do WordPress para expandir seu site.

Se você gostou deste artigo, inscreva-se em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.