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.
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.
// 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()ouupdate_application_password()direto, com valor cru, precisa envolver o dado emwp_slash(), porque o contrato do método continua esperando dado com slash.
$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 ambiente | WP_DEBUG antes do 7.2 | WP_DEBUG no 7.2 |
|---|---|---|
| local | false | true |
| development | true | true |
| staging | false | false |
| production | false | false |
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:
// 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):
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:
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:
| Item | Chave no 7.1 | Chave no 7.2 |
|---|---|---|
| Themes | 5 | 5 |
| Add Theme | não existia | 6 |
| Editor / Design / Patterns | 6 | 7 |
| Customize | 7 | 8 |
| Widgets (temas clássicos) | 8 | 9 |
| Fonts | 9 | 10 |
| Menus | 10 | 11 |
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:
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:
composer require --dev szepeviktor/phpstan-wordpress phpstan/extension-installer
vendor/bin/phpstan analyse --level=5 wp-content/plugins/meu-pluginCom 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
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.
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.