Quando entrega um site WordPress a um cliente, o painel padrão costuma sobrecarregar. Está cheio de avisos de upsell, menus que o editor nunca deve usar, e jargão que gera tickets em vez de conteúdo. Um dashboard genérico diz que instalou um tema. Um dashboard personalizado diz que construiu uma ferramenta de trabalho.
Este guia é para programadores que entregam a editores, gestores de loja e papéis de cliente. Cobrimos enqueue de CSS e JS de admin, limpeza de menus, verificações de capability, isolamento em must-use-plugin, e como não partir ecrãs de núcleo. Referência: admin_enqueue_scripts e admin_menu no Developer Handbook.
Porque personalizar o admin reduz suporte
Depois de entregar uma loja WooCommerce com page builder, o cliente vê dezenas de itens de menu e usa três. O resto gera perguntas. Remover Ferramentas, Definições e editores de ficheiros para quem não tem manage_options reduz mail do tipo «parti alguma coisa». Onboarding fica mais curto: uma página de Suporte com documentação e checklist de publicação.
Isole o código num must-use-plugin
Não coloque regras de admin só em functions.php do tema filho. Quando o cliente muda a pele, as regras desaparecem. Código de agência que deve sobreviver à troca de tema vive em wp-content/mu-plugins/.
Capability antes de tocar no menu
Verifique current_user_can antes de remover menus ou registar páginas. Esconder um link não remove a capability - quem conhece o URL ainda entra. Para restrição real combine UI limpa com papéis corretos.
Limpeza de menu e toolbar
Remova itens que o papel não precisa. Não remova ecrãs críticos de conteúdo por estética. Na toolbar, retire atalhos que levam a upsells ou a ecrãs perigosos para editores.
Enqueue correto
Use admin_enqueue_scripts com o gancho e o $hook_suffix certos. Evite injectar CSS global que parte o editor de blocos. Não use admin_head para folhas grandes.
Widgets do dashboard
Substitua a consola de boas-vindas genérica por um widget com links de documentação, contacto de suporte e estado de staging. Remova widgets de news que só distraem.
Checklist de entrega
Mu-plugin no repositório. Menus testados por papel. Enqueue limitado aos ecrãs certos. Sem file editors para clientes. Documentação na página de suporte. Staging verificado após update de core.
Conclusão
Personalização de admin é produto, não cosmética. Menos menus perigosos, mais caminhos claros, menos suporte.
Erros frequentes
CSS largo que esconde botões do Gutenberg. Remover WooCommerce → Pedidos a shop managers. Meter white-label num plugin que o cliente pode desativar. Esquecer multisite.
Exemplo de fluxo PT
Uma redação com quatro editores e um administrador de agência: após remover Definições e Plugins para editores, os tickets de «o que é isto?» caíram. O ganho foi de superfície de risco, não de cores.
Testes
Inicie sessão com cada papel em staging. Clique em cada menu restante. Confirme que REST e AJAX ainda funcionam para o trabalho diário.
Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 1. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 2. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 3. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 4. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 5. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 6. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 7. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 8. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 9. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 10. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 11. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 12. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 13. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 14. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 15. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 16. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 17. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 18. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 19. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 20. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 21. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 22. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 23. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 24. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 25. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 26. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 27. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 28. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 29. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Nota 30. ## Relação com login white-label
Mantenha a mesma marca no wp-login e no admin. Tokens de cor partilhados evitam a sensação de dois produtos.
Papéis e capacidades em detalhe
Mapear shop_manager, editor e author antes de esconder menus. Um gestor de loja precisa de Pedidos e Produtos; raramente precisa de Themes. Um editor precisa de Páginas e Media; raramente precisa de Plugins. Documente a matriz no README do mu-plugin.
Compatibilidade com o editor de blocos
Evite CSS que esconda a list view, o inspetor ou a barra de publicação. Teste com um padrão de página real do cliente. Quebrar o Gutenberg por estética de white-label custa mais suporte do que o menu original.
Atualizações e regressão
Após cada major do WordPress, volte a entrar com cada papel em staging. Hooks de menu e markup de ecrãs mudam. Reserve tempo de regressão no contrato de manutenção - personalização de admin sem regressão apodrece em silêncio.
Multisite e agências
Em redes multisite, personalize por site ou por rede com cuidado. Um mu-plugin de rede que esconde menus globalmente pode partir lojas que precisam de ecrãs diferentes. Prefira módulos por cliente com documentação no inventário da agência.
Handoff ao cliente
Inclua no pacote de entrega: ficheiro mu-plugin, matriz de papéis, capturas do dashboard limpo, e contacto de suporte. Sem handoff, a personalização vira magia que ninguém ousa tocar no update seguinte.






