Wordpress

mu-plugins no WordPress: onde colocar snippets em vez do functions.php

Você cola um snippet no fim do functions.php, funciona, e três semanas depois o tema atualiza e o código sumiu junto. Ou pior: faltou um ponto e vírgula e o site inteiro ficou branco, painel incluído. O lugar desse tipo de código é wp-content/mu-plugins, a pasta dos must-use plugins.

Um arquivo com cabeçalho de plugin

A pasta não vem pronta na instalação. Crie ela já com o dono certo, senão o passo seguinte esbarra em permissão:

sudo -u www-data mkdir -p /var/www/seusite/html/wp-content/mu-plugins
sudo -u www-data nano /var/www/seusite/html/wp-content/mu-plugins/00-ajustes.php
<?php
/**
 * Plugin Name: Ajustes do site
 * Description: Snippets que não podem sumir na atualização do tema.
 */if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

add_filter( 'xmlrpc_enabled', '__return_false' );

add_filter( 'wp_robots', function ( $robots ) {
    $robots['max-image-preview'] = 'large';
    return $robots;
} );

O wp_get_mu_plugins() lê a pasta apontada por WPMU_PLUGIN_DIR, ordena os nomes com sort() e o wp-settings.php dá include_once em cada .php — antes dos plugins comuns e bem antes do tema. Não existe botão de desativar na lista do painel, o arquivo sobrevive a atualização de tema e continua valendo se alguém trocar o tema inteiro amanhã.

O que muda em relação a um plugin normal

  • Só entra arquivo .php na raiz da pasta; subpasta é ignorada, a não ser que um arquivo da raiz faça o require.
  • A ordem de carregamento é alfabética, por causa daquele sort(). É para isso que serve o prefixo 00- no nome.
  • register_activation_hook() nunca dispara aqui: ele só pendura o callback na ação activate_{plugin}, e esse evento não existe para must-use. Nada de criar tabela ou gravar opção de instalação nesse arquivo.

Para conferir se o WordPress enxergou, rode sudo -u www-data wp plugin list --status=must-use. E não se iluda com a proteção: erro de sintaxe aqui derruba o site igual, com o agravante de você não poder desativar pelo painel. Passe um php -l 00-ajustes.php antes de sair da tela.

Post Recentes

Varnish VCL Magento 2.4.8: gerar o default.vcl com ACL de purge e probe

VCL copiado de tutorial velho não aceita PURGE do admin e não tem probe, então o Varnish serve página de…

21 minutos atrás

Teste de carga no checkout com k6: o script, a leitura do resultado e a hora de parar

Um script k6 que coloca produto no carrinho e abre o checkout do WooCommerce, com thresholds que abortam o teste…

6 horas atrás

Descrição de produto no ChatGPT: o prompt com ficha técnica que não inventa medida

Com a ficha técnica colada no prompt e uma regra para marcar o que falta, o ChatGPT para de inventar…

22 horas atrás

Magento 2 config:set: gravar configuração só num website ou store view

Mude uma configuração apenas para um website pela linha de comando, com --scope e --scope-code, e entenda a herança que…

1 dia atrás

Capturar erro fatal no PHP com register_shutdown_function

Estouro de memória e timeout não caem no try/catch e a página fica branca. Registre um shutdown handler com error_get_last…

2 dias atrás

CLAUDE.md para projeto WordPress: as regras que evitam o Claude Code quebrar o tema

O CLAUDE.md que funciona em projeto WordPress é curto: versões, onde o Claude Code pode mexer, comandos do projeto e…

4 dias atrás