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.