Roman Fink

Como adicionar um link para o Personalizador num tema de blocos WordPress

O WordPress esconde a ligação Personalizar quando está ativo um tema de blocos. Em Apresentação aparecem Temas e Editor, e mais nada. O Personalizador continua a funcionar: abra /wp-admin/customize.php e ele carrega. Uma função no functions.php repõe a ligação no menu. Verifiquei isto no WordPress 7.1.4.

Porque falta a ligação

O WordPress adiciona Apresentação → Personalizar em dois casos: o tema ativo é um tema clássico, ou o tema ou um plugin regista as suas próprias opções do Personalizador com o hook customize_register. Um tema de blocos sem um plugin desses fica sem ligação.

Adicionar a ligação

Cole este código no functions.php do seu tema. Se o tema recebe atualizações, ponha o código num tema filho: uma atualização substitui o functions.php.

PHP
function add_customize_menu_link() {
    add_submenu_page(
        'themes.php', // Parent menu slug (Appearance)
        'Customize', // Page title
        'Customize', // Menu title
        'manage_options', // Capability required to access
        '/customize.php' // URL to link to
    );
}

add_action('admin_menu', 'add_customize_menu_link');

Só os administradores veem o novo item. No menu aparece como «Customize»; esse texto pode ser alterado no código.

Ligação Personalizar no menu Apresentação do painel do WordPress

O favicon já não precisa do Personalizador

Em abril de 2024, quando escrevi a primeira versão deste artigo, eu definia o ícone do site (favicon) no Personalizador. Desde o WordPress 6.5 a mesma opção está em Opções → Geral → Ícone do site.

O sítio antigo: Personalizador → Identidade do site → Ícone do site.

Painel Identidade do site no Personalizador com a opção Ícone do site

Se o logótipo e o ícone forem a mesma imagem, selecione o bloco Logótipo do site no Editor do site e ative Utilizar como ícone do site na barra lateral de definições do bloco.

Quando a ligação ainda é útil

Use o código se quem gere o site ainda abre o Personalizador, por exemplo para editar lá o CSS adicional. O CSS do Personalizador é guardado por tema: depois de mudar de tema, o CSS do tema antigo deixa de ser carregado. O Editor do site tem o seu próprio campo: Estilos → CSS adicional.

Se um plugin regista opções no Personalizador, o WordPress mostra a ligação por si só. Nesse caso dispense o código, ou o menu fica com duas ligações para o Personalizador.

Configuro e adapto temas de blocos para clientes. Veja Contrate-me.

Roman Fink