powered byiMasterstutoriais · referência · código em portuguêsPatrocínio
PHP

WordPress 7.2 muda hooks de application password, Howdy e menu do Appearance

O Make WordPress Core publicou em 19 de novembro de 2026 a lista de mudanças miúdas no código do WordPress 7.2: notificação por e-mail em application password, dados sem barra invertida, WP_DEBUG ligado por padrão no ambiente local e alterações na barra de admin.

Por Thiago VilelaColunista7 min de leitura
Imagem gerada por IA

Este texto cobre o post de developer notes do Make WordPress Core publicado em 19 de novembro de 2026 sobre o WordPress 7.2. No fim, você vai saber quais hooks mudaram de assinatura, qual código antigo passa a gerar aviso de depreciação e como auditar um plugin antes de liberar a atualização. Os exemplos abaixo rodam em instalações com PHP 7.4 ou superior, o mínimo exigido pelo core.

E-mail automático quando um application password é criado

A partir do WordPress 7.2, toda vez que WP_Application_Passwords::create_new_application_password() tem sucesso, a função wp_application_password_created_notification() dispara um e-mail para o dono da conta. Não importa se a senha foi gerada na tela de perfil, na tela Authorize Application ou via REST API: o aviso sai sempre, exceto quando o usuário não existe, o e-mail é inválido ou a senha não tem nome.

Duas coisas mudam para quem mantém plugin que já lida com application passwords:

  • Se o seu plugin já envia uma notificação própria para esse evento, agora o usuário pode receber dois e-mails para a mesma ação.
  • Se você quer manter o comportamento anterior só para certas aplicações, dá para filtrar por app_id.
php
// Pula a notificação para senhas criadas por uma aplicação específica.
add_filter(
 'wp_send_application_password_created_email',
 static function ( $send, $user, $new_item ) {
 if ( 'b1c4a7e2-5f3d-4e8a-9c21-7d6f0e3b2a14' === $new_item['app_id'] ) {
 return false;
 }

 return $send;
 },
 10,
 3
);

Para desligar o aviso por completo, retorne false nesse filtro em todas as situações ou remova o callback com remove_action( 'wp_create_application_password', 'wp_application_password_created_notification' );. O segundo filtro, wp_application_password_created_email, deixa reescrever to, subject, message e headers antes do envio por wp_mail().

Dados do application password chegam sem barra invertida

Antes do 7.2, create_new_application_password() e update_application_password() recebiam dados com slash (como sempre esperaram) e repassavam isso sem tratar para as actions wp_create_application_password e wp_update_application_password. Resultado: um nome como Bob's App chegava ao callback como Bob\'s App, inclusive no e-mail novo descrito acima.

No WordPress 7.2, os dois métodos chamam wp_unslash() antes de usar o input. Isso muda o que o seu código recebe:

  • Callback que já fazia wp_unslash() manualmente nessas actions passa a remover barras invertidas reais do nome. Tire essa chamada.
  • Código que chama create_new_application_password() ou update_application_password() direto, com valor cru, precisa envolver o dado em wp_slash(), porque o contrato do método continua esperando dado com slash.
php
$created = WP_Application_Passwords::create_new_application_password(
 $user_id,
 wp_slash(
 array(
 'name' => $name,
 'app_id' => $app_id,
 )
 )
);

Se o seu plugin tem testes que comparam o name recebido na action com um literal fixo, é hora de atualizar o fixture: o valor que chega agora já está sem slash.

WP_DEBUG ligado por padrão no ambiente local

Quando WP_DEBUG não está definido em wp-config.php, o WordPress decide o valor pelo tipo de ambiente (WP_ENVIRONMENT_TYPE). A tabela abaixo mostra o que muda:

Tipo de ambienteWP_DEBUG antes do 7.2WP_DEBUG no 7.2
localfalsetrue
developmenttruetrue
stagingfalsefalse
productionfalsefalse

Isso só afeta quem define WP_ENVIRONMENT_TYPE como local (por constante ou variável de ambiente) e não define WP_DEBUG explicitamente. Como WP_DEBUG_DISPLAY continua true por padrão, esses ambientes agora exibem notice, warning e aviso de depreciação do PHP na tela. Se isso pegar sua equipe de surpresa, declare os valores no wp-config.php:

php
// Mantém debug ligado, mas grava em log em vez de mostrar na tela.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'WP_DEBUG_LOG', true );

register_site_meta() fecha a API de meta para multisite

Post meta, term meta, comment meta e user meta já tinham função de registro dedicada. O WordPress 7.2 adiciona o par para site meta (a tabela blogmeta, em instalações multisite):

php
add_action(
 'init',
 static function () {
 if ( ! is_multisite() ) {
 return;
 }

 register_site_meta(
 'my_plugin_site_tier',
 array(
 'type' => 'string',
 'single' => true,
 'default' => 'standard',
 'sanitize_callback' => 'sanitize_key',
 )
 );
 }
);

// Depois, em qualquer ponto do código:
$tier = get_site_meta( $site_id, 'my_plugin_site_tier', true );

Essas funções vivem em wp-includes/ms-site.php, carregado só em instalações multisite. Se seu plugin roda em single-site e multisite, cheque is_multisite() antes de chamar register_site_meta(). Vale notar que get_object_subtype() agora reconhece o tipo 'blog', então meta registrado com 'object_subtype' => 'blog' passa a ser resolvido corretamente por get_registered_metadata() e sanitize_meta(), algo que antes do 7.2 só funcionava sem subtype.

O "Howdy" saiu do topo da barra de admin

O item de topo my-account na barra de admin mostrava Howdy, Nome com avatar. No WordPress 7.2 ele mostra só o nome e o avatar; a saudação Howdy, %s migrou para dentro do submenu, no item user-info.

Isso quebra qualquer código que fazia str_replace() em busca da palavra "Howdy" no título do nó my-account: ela não está mais lá. Dois caminhos para ajustar:

php
add_action(
 'admin_bar_menu',
 static function ( WP_Admin_Bar $wp_admin_bar ) {
 $node = $wp_admin_bar->get_node( 'my-account' );

 if ( ! $node ) {
 return;
 }

 $wp_admin_bar->add_node(
 array(
 'id' => 'my-account',
 'title' => esc_html__( 'Signed in as', 'my-plugin' ) . ' ' . $node->title,
 )
 );
 },
 9992
);

O core adiciona o nó my-account na prioridade 9991 do hook admin_bar_menu; use prioridade 9992 ou maior para alterar o título depois que ele existe. Se o seu CSS estiliza #wp-admin-bar-user-info .username, confira se a regra respeita o atributo hidden: o core já oculta esse span quando o display name é igual ao login.

Add Theme volta ao Appearance, e os índices numéricos mudam

Em instalações single-site, Appearance > Add Theme voltou a existir como item de submenu, exigindo a capability install_themes. Ele entra na posição 6 de $submenu['themes.php'], empurrando os itens seguintes:

ItemChave no 7.1Chave no 7.2
Themes55
Add Themenão existia6
Editor / Design / Patterns67
Customize78
Widgets (temas clássicos)89
Fonts910
Menus1011

Se seu plugin lê, substitui ou remove entradas de $submenu['themes.php'] por chave numérica, ele agora mexe em outro item sem querer. A correção é trocar o índice numérico por busca de slug:

php
add_action(
 'admin_menu',
 static function () {
 // Remove o item Add Theme.
 remove_submenu_page( 'themes.php', 'theme-install.php' );
 },
 999
);

remove_submenu_page() e funções equivalentes que buscam por slug não são afetadas pela mudança de posição; só código que indexa $submenu['themes.php'][6] diretamente precisa de revisão.

Constantes de compressão de script removidas

load-scripts.php e load-styles.php não comprimem saída desde a versão 4.9.9. O WordPress 7.2 remove o código morto que ainda lia essas configurações: COMPRESS_SCRIPTS, COMPRESS_CSS e ENFORCE_GZIP deixam de ter qualquer efeito, e compression_test() fica depreciada, disparando aviso quando WP_DEBUG está ligado. Se o seu wp-config.php ou algum mu-plugin ainda define essas constantes ou chama essa função, pode remover: elas já não faziam nada de prático havia anos, e agora ficam barulhentas no log.

Como auditar o plugin antes de liberar a atualização

Para pegar essas chamadas depreciadas e usos de hook que mudaram de contrato antes que o cliente reclame, rode PHPStan com os stubs do WordPress:

bash
composer require --dev szepeviktor/phpstan-wordpress phpstan/extension-installer
vendor/bin/phpstan analyse --level=5 wp-content/plugins/meu-plugin

Com os stubs carregados, o PHPStan sinaliza chamada a compression_test() e a outras funções marcadas @deprecated, além de apontar onde seu código ainda chama wp_unslash() manualmente dentro dos callbacks de wp_create_application_password e wp_update_application_password (procure essas duas strings no relatório e revise cada ocorrência à mão, já que o PHPStan não sabe qual é o contexto do hook). Rodar essa análise num branch de teste antes do merge é mais barato do que descobrir a quebra em produção.

Próximo passo

O post original do Make WordPress Core (categoria "Miscellaneous Developer Changes") lista os tickets do Trac e os commits (r63582, r64253, r65361, r64115, r63603, r64312, r64519, r64352, r64603, r64485, r64486) para quem quer o histórico completo de cada mudança. Para dúvida específica de hook, o guia de referência é o developer.wordpress.org, e a conversa ao vivo sobre essas mudanças acontece no canal #core do Slack de contribuidores, nas reuniões de quarta-feira às 15h UTC.

Fonte: Make WordPress Core

PatrocínioContinue estudando PHPTrilhas completas, projetos e exercícios na DevMedia.Travou em algum passo?Pergunte no Fórum iMastersPoste o trecho de código e o erro: a comunidade responde.Notícias da stackO que saiu de novo, no iMastersLançamentos, versões e eventos do ecossistema dev.

Este artigo foi escrito por Thiago Vilela. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.

Thiago Vilela

Editor virtual de PHP do Linha de Código. Escreve o PHP moderno — tipos, enums, readonly, match — com Laravel, Symfony, Composer e PHPStan, e o WordPress do lado de quem programa plugin e tema. Fala com quem herdou um sistema PHP 5 e precisa levá-lo para a versão com suporte sem parar a empresa.

Mais de Thiago Vilela

Próximos passoso que estudar a partir daqui

  1. você está aquiWordPress 7.2 muda hooks de application password, Howdy e menu do Appearance
  2. mesmo autorLaravel 13.43 traz validação por JSON Schema e retry configurável em filasPHP · 1 min
  3. mesmo autorSymfony 8.2 adiciona locks de aviso nativos para MySQL e MariaDBPHP · 1 min

Newsletter

Os melhores tutoriais da semana, no seu e-mail

Toda semana, os tutoriais novos das sete stacks e o guia de referência que vale guardar. Gratuita, sem spam.