Criar páginas de admin customizadas com o ACF PRO é montar telas de configuração próprias no painel do WordPress, com campos que valem para o site inteiro em vez de ficarem presos a um post. O recurso de Options Pages do ACF PRO cria o item de menu, e você desenha os campos globais que controlam logo, contatos ou textos do tema. O resultado é um painel de configurações com a cara do projeto, fácil para o cliente editar sem mexer em código. Este guia faz parte do hub de ACF PRO da FULL e mostra o passo a passo real, do registro da página à leitura do valor no site.

O que é uma página de opções do ACF PRO

Uma página de opções do ACF PRO é uma tela de admin que você cria no painel para guardar configurações globais do site, como logo, telefone e redes sociais, em campos que não pertencem a nenhum post. O ACF PRO registra o item de menu, e você anexa um grupo de campos a essa página.

Na prática, você cria a Options Page pelo recurso do ACF PRO, monta um grupo de campos e aponta a regra de localização para essa página, depois lê cada valor no tema indicando que a fonte é option. Assim, um único lugar controla dados que aparecem em todo o site, como o rodapé. Nos atendimentos da FULL sobre ACF PRO, o tropeço campeão é ler o campo sem informar a fonte option, o que devolve vazio porque o valor não está em um post, e sim na página de opções global.

Legenda: a Options Page do ACF PRO guarda campos globais que valem para o site inteiro.

Quando vale uma página de opções em vez de campos no post

Vale criar uma página de opções quando o dado vale para o site todo e não para um conteúdo específico, quando o cliente precisa editar configurações globais sem tocar no tema ou quando você quer centralizar logo, contatos e textos fixos num só lugar, e vale o campo no post quando o dado muda de conteúdo para conteúdo. A página de opções rende com dados globais.

Use este teste antes de criar. Diga SIM à página de opções se o dado aparece em todo o site e tem um único valor, como o telefone do rodapé ou o link do Instagram. Diga NÃO se cada post tem o seu próprio valor, porque aí o campo pertence ao conteúdo, não a uma tela global. O encaixe ideal é a central de configurações do tema. Para entender os tipos de campo que você vai usar nessa tela, a referência dos plugins do WordPress ajuda a planejar a estrutura.

Pré-requisitos antes de criar a página de admin

Antes de criar a página de admin você precisa de duas peças no lugar, o ACF PRO instalado e ativo, porque as Options Pages são um recurso exclusivo da versão paga, e a definição de quais configurações globais a tela vai guardar, e a falta de qualquer uma trava a montagem do painel próprio. Sem o ACF PRO, o recurso de página de opções nem aparece no menu.

Checklist de prontidão antes de começar:

• ACF PRO instalado e ativado, com a licença válida.
• A lista de configurações globais que a página vai controlar.
• Os tipos de campo definidos para cada configuração, como texto ou imagem.
• Acesso ao tema para ler os valores no front-end depois.
• Permissão de administrador para registrar páginas e grupos de campos.
• Um plano de onde cada valor vai aparecer no site.
• Backup do site antes de mexer no tema para exibir os campos.

Pense no conjunto como o painel de controle de uma casa: a página de opções é o quadro central onde ficam os interruptores gerais, os campos são os botões de cada função, e a leitura no tema é o fio que liga o botão à lâmpada certa. Sem o fio indicando a fonte global, o botão é apertado mas a luz não acende em lugar nenhum.

Como criar a página de admin customizada em 5 passos

Criar a página de admin customizada segue cinco passos, do registro da página à leitura do valor no site, e respeitar a ordem evita o erro mais comum: preencher o campo e lê-lo sem informar a fonte option. Cada passo liga uma ponta, da tela ao tema. Confirme antes que o ACF PRO está ativo, porque a Options Page depende dele.

Passo 1: Registre a página de opções

Crie a Options Page pelo recurso do ACF PRO, definindo o título do menu e a posição dele no painel, porque é esse registro que faz a tela de configurações aparecer no admin. Nas versões recentes, o ACF PRO permite registrar a página pela interface, sem código; quem prefere pode usar a função acf_add_options_page() no tema. Escolha um nome claro, como Configurações do Site, para o cliente encontrar fácil. Esse passo cria o lugar onde os campos globais vão morar, então pense na hierarquia do menu antes de seguir. Confirme que o item surgiu no menu do admin antes de criar os campos que ele vai abrigar.

Passo 2: Crie o grupo de campos da página

No ACF PRO, crie um grupo de campos com cada configuração global que a página vai guardar, escolhendo o tipo certo para cada uma, imagem para o logo, texto para o telefone, URL para as redes, porque é esse grupo que dá forma à tela de opções. Nomeie os campos com clareza, já que é por esses nomes que você vai ler os valores no tema depois. Mantenha a tela organizada em abas ou grupos, para o cliente não se perder entre dezenas de campos. Salve o grupo, deixando a estrutura pronta para ser anexada à página de opções no passo seguinte.

Passo 3: Aponte o grupo à página de opções

Nas regras de localização do grupo de campos, escolha que ele apareça na página de opções criada no passo 1, porque é essa ligação que faz os campos surgirem na tela de admin certa. Sem a regra correta, o grupo fica salvo mas não aparece em lugar nenhum, e a página de opções abre vazia. Selecione a Options Page específica na condição, não um post ou página comum. Abra a tela de configurações no admin e confirme que todos os campos aparecem prontos para preencher. Preencha um valor de teste em cada um, porque o tema só vai exibir algo se houver dado salvo na página de opções.

Passo 4: Leia o valor no tema

No arquivo do tema onde o dado deve aparecer, leia o campo informando que a fonte é a página de opções, usando get_field('nome_do_campo', 'option'), porque o segundo parâmetro option é o que diz ao ACF para buscar na tela global e não em um post. Esquecer esse parâmetro é o erro número um e devolve um valor vazio. Coloque a leitura no rodapé, no cabeçalho ou onde a configuração faz sentido. Se um campo do tipo Clone não traz o valor esperado na leitura, veja como corrigir o Clone Field que não funciona no ACF PRO, que costuma estar por trás de campos globais vazios.

Passo 5: Organize o menu e teste com o cliente

Ajuste a posição e o ícone da página no menu do admin para o cliente achar a tela com facilidade, depois faça um teste completo, editando um valor e conferindo que ele muda no site, porque só esse ciclo prova que a configuração global funciona ponta a ponta. Peça a alguém sem acesso técnico para editar um campo e ver o resultado. Verifique também no celular, já que muita gente edita o site pelo painel mobile. Se o cache do site segura o valor antigo após a edição, veja como corrigir o cache de campos dinâmicos do ACF no WP Rocket antes de entregar o painel.

Legenda: cada passo liga uma ponta, do registro da tela à leitura do campo global.

Erros comuns ao criar a página de admin

Os três erros mais comuns ao criar a página de admin são ler o campo sem o parâmetro option, esquecer de apontar a regra de localização para a página e duplicar o item de menu. O primeiro é o mais frequente: o campo está preenchido na tela de opções, mas a leitura sem informar option busca em um post inexistente e devolve vazio, então nada aparece no site.

O segundo erro é criar o grupo de campos e não ligar a regra de localização à Options Page, o que deixa a tela de configurações sem campos para preencher. A correção é conferir a condição de localização do grupo. O terceiro caso é registrar a página duas vezes, pela interface e por código, criando dois menus iguais. Quando um campo global some depois de uma atualização do ACF, vale ver como corrigir o custom meta do ACF que não exibe, que cobre os casos de valor que deixa de aparecer.

Como manter a página de admin em produção

Manter a página de admin em produção exige cuidar de duas frentes, a estabilidade dos nomes de campo e a consistência das leituras no tema a cada atualização, porque renomear um campo quebra todas as leituras que apontavam para ele e uma atualização do ACF pode mexer no comportamento das Options Pages. A tela global controla dados que aparecem no site inteiro, então um campo quebrado afeta muitas páginas de uma vez.

Evite renomear os campos da página de opções depois que o tema já os lê, porque a leitura busca pelo nome e perde o valor se ele mudar. Depois de cada atualização do ACF PRO, abra a tela de configurações e confira que os valores continuam salvos e visíveis no site. Para licenciar o ACF PRO em vários projetos sem comprar avulso, o guia de licença de plugin para múltiplos sites mostra o caminho do bundle.

Como a FULL faz isso em escala

A FULL padroniza a criação de páginas de admin com ACF PRO porque acompanha mais de 150 mil sites WordPress, e telas de configuração global, com logo, contatos e textos do tema, aparecem em quase todo projeto, onde remontar a Options Page em cada site vira gargalo. Em vez de licença avulsa do ACF PRO por instalação, a ferramenta entra no bundle e o padrão de painel de configurações fica replicável de um site para outro.

No plano PRO da FULL, por R$849, o ACF PRO já vem no pacote para até dez sites, o que dá R$85 por site em vez de pagar cada licença separada. Para quem entrega muitos sites com painel próprio, a gente vê isso trocar um custo recorrente espalhado por um padrão único: a mesma Options Page e o mesmo grupo de campos globais são exportados e reaproveitados de um projeto para outro, sem remontar a tela do zero a cada cliente. É a economia que só aparece quando o stack é o mesmo em toda a base.

Checklist final da página de admin

O checklist final da página de admin confirma, em uma passada, que a tela global guarda os dados e o site os exibe antes de você entregar o painel ao cliente. Rode esta lista depois do passo 5 e a cada atualização grande do ACF PRO, porque é nessas atualizações que o comportamento das Options Pages costuma mudar.

Antes de declarar pronto, confirme:

• A Options Page aparece no menu do admin com nome e posição claros.
• O grupo de campos tem a regra de localização apontada para a página.
• Todos os campos globais aparecem prontos para preencher na tela.
• A leitura no tema usa o parâmetro option em cada campo.
• Editar um valor na página de opções muda o resultado no site.
• Não há item de menu duplicado para a mesma página.
• O painel é fácil de editar para quem não é técnico, inclusive no celular.

Se qualquer item falhar, principalmente a leitura com option, volte ao passo correspondente antes de entregar o painel.

Perguntas frequentes sobre páginas de admin com o ACF PRO

Próximos passos para um painel de configurações sob medida

Criar páginas de admin customizadas com o ACF PRO é, no fundo, dar ao site uma central de configurações próprias: registre a página, monte os campos globais, ligue a regra de localização e, acima de tudo, leia cada valor com o parâmetro option. A leitura sem option é o que faz o campo parecer vazio, então confira essa fonte em todas as leituras. Para padronizar o ACF PRO em vários sites sem licença avulsa, conheça os planos da FULL, e para continuar aprendendo, o FULL Academy reúne os tutoriais de WordPress em um só lugar.