Entrar
Começar

Documentação do Easy Digital Downloads

Documentação, Materiais de Referência e Tutoriais para Easy Digital Downloads 

Gerenciador de Campos de Checkout: Visão Geral e Configuração

Você gostaria de fazer uma pergunta aos seus clientes no checkout e manter a resposta com o pedido deles? O Checkout Fields Manager permite que você adicione seus próprios campos ao checkout do Easy Digital Downloads. Você decide onde cada resposta é armazenada, quem pode vê-la e o que acontece se um cliente pedir para você excluí-la.

Antes de começar, certifique-se de que o Easy Digital Downloads e o recurso Checkout Fields Manager estejam instalados e ativados em seu site WordPress.

⚠️ Requisitos: O Checkout Fields Manager é um recurso do Easy Digital Downloads Pro e requer uma licença Professional Pass ou superior.


Construindo Seu Formulário de Finalização de Compra

Para começar, abriremos o construtor de formulários e adicionaremos uma pergunta própria.

Com o Checkout Fields Manager ativo (Downloads » Extensões), um novo item Checkout Form aparece perto do final do seu menu Downloads. Para abrir o construtor, vá para Downloads » Checkout Form.

O item de menu Checkout Form no Easy Digital Downloads.

O construtor é dividido ao meio. Seus campos de checkout atuais estão listados na coluna central. Os tipos de campo que você pode adicionar ficam no painel Add Custom Fields à direita.

Construtor de formulários de checkout do EDD Checkout Fields Manager.

Toda nova loja começa com 3 campos que o Easy Digital Downloads precisa para processar um pedido: Nome, Sobrenome e Endereço de E-mail. Você pode reordená-los arrastando, mas não pode removê-los.

O painel à direita oferece 22 tipos de campo, desde texto simples e listas suspensas até upload de arquivos, reCAPTCHA e um honeypot para capturar bots.

Painel de Tipos de Campo de Checkout EDD

Para uma descrição completa do que cada tipo faz e quando usá-lo, consulte a documentação Checkout Fields Manager field types.

Adicionando um Campo

Para adicionar um campo, clique em seu tipo no painel Add Custom Fields. O campo é anexado à parte inferior do seu formulário e abre pronto para ser configurado.

Painel intitulado Adicionar Campos Personalizados mostrando uma grade de duas colunas de botões de tipo de campo com contorno azul (Texto, Área de Texto, E-mail, URL, Data, etc.).

Cada campo tem o mesmo punhado de opções principais. O Field Label (Rótulo do Campo) é o texto que seu cliente vê, o Help text (Texto de Ajuda) aparece abaixo dele, e o Size (Tamanho) define a largura da entrada. Mude Required (Obrigatório) para Yes (Sim) se um cliente não puder concluir o pedido sem responder.

Campo de checkout rotulado 'Como você nos conheceu' com texto de ajuda 'Isso nos ajuda a saber quais canais estão funcionando' em um painel de configurações.

Quando tiver adicionado tudo o que precisa, clique em Save (Salvar) na parte superior do formulário.

Editor de campos do formulário de checkout com botões Salvar e Expandir todos os campos no Easy Digital Downloads.

Seu campo agora está ativo no checkout. Antes de sair do construtor, no entanto, há mais uma decisão que muda como a resposta se comporta pelo resto de sua vida útil.


Escolhendo Onde os Dados do Campo São Armazenados

Várias das opções de campo mais úteis ficam ocultas atrás de uma divulgação em vez de no painel principal. Dentro de qualquer campo, role até Advanced Settings (Configurações Avançadas) e clique nele para expandir.

Painel de configurações avançadas do Gerenciador de Campos de Checkout no Easy Digital Downloads.

Expandir isso revela mais cinco opções. Duas delas são a Meta Key (Chave Meta) e o CSS Class Name (Nome da Classe CSS) do campo. O restante controla se ele aparece no front-end, se aparece em exportações e onde seus dados são armazenados.

Onde esses metadados devem ser armazenados é a opção que decide como a resposta se comporta ao longo do tempo.

Metadados de Pagamento anexa a resposta a um único pedido. Isso serve para qualquer coisa que possa diferir de compra para compra, como uma nota sobre o produto ou um número de ordem de compra. É o padrão e a escolha certa na maioria das vezes.

Metadados do Usuário anexa a resposta à conta do cliente. Isso serve para detalhes que permanecem os mesmos em todos os pedidos, como um número de telefone ou um endereço de e-mail secundário. Armazenado dessa forma, o valor aparece no registro do cliente e é preenchido previamente na próxima vez que ele comprar. Os clientes também podem atualizá-lo por conta própria através do shortcode do editor de perfil.

Formulário de configurações do gerenciador de campos de checkout: 'Onde este meta deve ser armazenado' com opções de rádio 'Meta de Pagamento' (selecionado) e 'Meta de Usuário'; aviso sobre alteração do local de armazenamento; campo 'Nome da Classe CSS' abaixo.

Tornando a Opção de Meta de Usuário Disponível

Se você não vir a opção Metadados do Usuário, é porque os clientes em sua loja podem finalizar a compra sem uma conta. Sem uma conta, não há nada a que a resposta possa ser anexada.

Para mudar isso, vá para Downloads » Configurações » Pagamentos » Checkout. Mude Registro de Cliente para Clientes devem fazer login ou criar uma conta para comprar.

Painel de configurações de Checkout do EDD mostrando a caixa de texto de Registro de Cliente com texto de exemplo destacado.

⚠️ Requisitos: Apenas Clientes devem fazer login ou criar uma conta para comprar desbloqueia o armazenamento de Metadados do Usuário. Registrar automaticamente novas contas de usuário cria contas, mas não disponibiliza a opção.

Mantendo um Campo Fora de Suas Exportações

Também dentro de Configurações AvançadasMostrar em CSVs exportados controla se as respostas do campo são incluídas quando você exporta seus pedidos. Desativar isso é útil para campos que você nunca quer em uma planilha, como um honeypot ou uma nota interna.

Configuração do Gerenciador de Campos de Checkout do EDD para mostrar na exportação csv.

Para mais informações sobre a exportação em si, veja o documento exportando dados de pagamento.


Definindo Opções de Privacidade para Cada Campo

Cada campo tem seu próprio bloco de Configurações de Privacidade. Ele controla como os dados desse campo são tratados quando um cliente exerce seus direitos de privacidade através das ferramentas integradas do WordPress.

Configurações de privacidade de campo de checkout do EDD.

Mostrar campo na Exportação de Privacidade decide se a resposta é incluída quando um cliente solicita uma cópia de seus dados pessoais. Está ativado por padrão.

Ação de Apagar Dados Privados decide o que acontece quando um cliente solicita a exclusão. Anonimizar é o padrão e substitui o valor por um equivalente embaralhado, o que mantém seus relatórios intactos. Excluir remove o valor completamente, e Nenhuma Ação o deixa intocado.

Alguns campos contêm informações pessoais, como Primeiro Nome ou Endereço de E-mail. Neles, os controles são definidos para você e aparecem como uma breve explicação em vez de uma configuração editável.

Painel de formulário de checkout mostrando o campo Endereço de Email, a entrada de tamanho e as Configurações de Privacidade com notas sobre exportação de dados pessoais e anonimização em solicitações de exclusão.

ℹ️ Nota: As Configurações de Privacidade se aplicam a campos armazenados como Metadados de Pagamento. Campos armazenados como Metadados do Usuário são cobertos pelo próprio gerenciamento de dados do usuário do WordPress.


Configurando as Opções do Gerenciador de Campos de Finalização de Compra

Juntamente com o construtor de formulários, o Gerenciador de Campos de Checkout adiciona sua própria seção de configurações. Para encontrá-lo, vá para Downloads » Configurações » Extensões e clique em Gerenciador de Campos de Checkout.

Página de configurações do Easy Digital Downloads mostrando a aba Extensões com uma linha de extensões incluindo Gerenciador de Campos de Checkout, Licenciamento de Software e Envio Simples.

A seção abrange o que seus clientes veem após a compra, além das suas chaves reCAPTCHA.

Configurações do Gerenciador de Campos de Checkout do Easy Digital Downloads.

Configurando o reCAPTCHA

O campo reCAPTCHA precisa de um par de chaves antes de funcionar. Cole as suas em Chave do Site reCAPTCHA v3 e Chave Secreta reCAPTCHA v3, e então salve.

Painel de Configurações de Checkout do EDD para chaves reCAPTCHA v3.

O Gerenciador de Campos de Checkout usa o reCAPTCHA v3, portanto, certifique-se de selecionar v3 ao criar suas chaves com o Google. A versão 3 pontua o tráfego silenciosamente em segundo plano, o que significa que o campo reCAPTCHA nunca aparece no seu checkout para clientes reais. Ele também é ignorado para gateways que processam o pagamento em seu próprio site, como o PayPal.

ℹ️ Observação: Se sua loja ainda tiver um par de chaves v2 mais antigo salvo, esses campos permanecem visíveis até que você adicione ambas as chaves v3. Assim que você salvar um par v3, as chaves mais antigas são removidas para você.


Mostrando Respostas na Confirmação de Compra

Por padrão, seus clientes não veem suas próprias respostas novamente após o checkout. Para mostrá-las, ative Mostrar informações enviadas na Confirmação de Compra? nas configurações do Gerenciador de Campos de Checkout.

Ativá-lo revela uma segunda configuração, Texto do Cabeçalho da Confirmação de Compra, que é o título impresso acima das respostas. Ele lê Informações a menos que você o altere.

Campo de texto do cabeçalho de confirmação de compra do Easy Digital Downloads.

Seu campo personalizado agora aparece na página de checkout para os clientes preencherem.

Um campo personalizado adicionado à página de checkout do Easy Digital Downloads usando o Gerenciador de Campos de Checkout.

Após a compra, as respostas deles aparecem sob o seu título.

Campo personalizado do EDD na página de confirmação de compra.

ℹ️ Observação: 7 tipos de campo são omitidos da confirmação de propósito. Eles não contêm respostas que valham a pena mostrar de volta a um cliente: oculto, HTML, quebra de seção, reCAPTCHA, gancho de ação, honeypot e Termos e Condições.


Visualizando e Editando Dados Enviados

As respostas armazenadas como Metadados de Pagamento aparecem no próprio pedido. Para encontrá-las, vá para Downloads » Pedidos e abra um pedido.

Campo personalizado na tela de pedidos no Easy Digital Downloads.

Esses valores são editáveis, não apenas visíveis, então você pode corrigir um erro de digitação do cliente sem pedir que ele refaça o pedido. Altere o valor e salve o pedido.

As respostas armazenadas como Metadados de Usuário aparecem no cliente em vez disso, em Downloads » Clientes, e no editor de perfil que seus clientes usam.

Adicionando Respostas aos Seus E-mails

A resposta de cada campo está disponível em seus recibos de compra e notificações de venda para administradores como uma tag de modelo. A tag é a Chave de Metadados do campo, envolvida por chaves, então um campo com uma chave de metadados de company_name se torna {company_name} .

A chave de metadados de cada campo fica dentro de suas Configurações Avançadas, ao lado da opção de armazenamento. Se você a deixou em branco ao criar o campo, o Gerenciador de Campos de Checkout gerou uma a partir do rótulo do seu campo.

ℹ️ Observação: Evite alterar uma chave de metadados depois que os clientes começarem a responder ao campo. As respostas salvas sob a chave antiga não serão mais encontradas.


Exportando e Importando Seu Formulário

Depois que seu formulário for criado, você não precisará recriá-lo manualmente em nenhum outro lugar. Para mover ou fazer backup de um formulário, vá para Downloads » Ferramentas » Gerenciador de Campos de Checkout.

Painel de Ferramentas do Easy Digital Downloads com seções para redefinir, exportar, importar campos de checkout e rotina de atualização.

Exportar Campos de Checkout baixa seu formulário completo como um arquivo JSON, e Importar Campos de Checkout carrega um de volta. Juntos, eles são a maneira mais rápida de mover um formulário concluído de um site de staging para um site ativo. A exportação também serve como backup antes de fazer grandes alterações.

Redefinir Formulário de Checkout retorna seu formulário aos 3 campos com os quais ele começou. Ele também corrige o raro caso em que seu checkout relata que nenhum formulário está definido.

Executar Rotina de Upgrade 2.0 Novamente executa novamente o upgrade que moveu dados antigos do Gerenciador de Campos de Checkout para seu formato atual. Normalmente, você não precisará dele, e nossa equipe de suporte o informará se precisar.

Para mais detalhes, consulte a documentação de importação e exportação de campos.


Trabalhando Com Outros Recursos

O recurso Amazon S3 altera o local para onde os uploads vão. Com ele ativo, os arquivos que um cliente envia através de um campo de Upload de Arquivo são armazenados em uma pasta chamada cfm dentro do seu bucket S3.

É isso! Agora você pode adicionar seus próprios campos ao checkout, escolher onde cada resposta será armazenada e decidir quem a verá. Você também pode mostrar ou ocultar um campo com base no que está no carrinho ou em quem está comprando. Para isso, confira a documentação de lógica condicional do Gerenciador de Campos de Checkout a seguir.

Observação: O Gerenciador de Campos de Checkout não suporta o recurso de Downloads Gratuitos.


FAQs sobre Configuração do Gerenciador de Campos de Finalização de Compra

Por que não há opção de Meta de Usuário no meu campo?

Sua loja permite que os clientes finalizem a compra sem uma conta, portanto, não há conta para armazenar a resposta. Para corrigir isso, vá para Downloads » Configurações » Pagamentos » Checkout. Mude Registro de Cliente para Clientes devem fazer login ou criar uma conta para comprar. Escolher Registrar automaticamente novas contas de usuário não é suficiente por si só.

Onde foi a configuração de Chave de Meta?

Ele está dentro das Configurações Avançadas de cada campo, junto com o nome da classe CSS, a opção de exportação e a escolha de armazenamento. Para revelá-los, clique em Configurações Avançadas dentro do campo.

Por que alguns dos meus campos estão faltando na confirmação da compra?

7 tipos de campo nunca aparecem lá: oculto, HTML, quebra de seção, reCAPTCHA, gancho de ação, honeypot e Termos e Condições. Nenhum deles contém uma resposta que seja significativa para mostrar a um cliente.

Posso editar a resposta de um cliente depois que ele fez o pedido?

Sim. Para fazer isso, abra o pedido em Downloads » Pedidos, altere o valor e salve. Esta é a maneira mais rápida de corrigir um erro de digitação sem pedir ao cliente para comprar novamente.

Preciso de chaves reCAPTCHA v2, além das v3?

Não. O Gerenciador de Campos de Finalização de Compra usa a v3, então um único par de chaves v3 é tudo o que você precisa. Se sua loja tiver chaves v2 antigas salvas, elas serão removidas assim que você salvar um par v3.

Minha resposta não apareceu logo após a finalização da compra. Ela foi perdida?

Não. A página de confirmação imprime seu cabeçalho assim que a página carrega, e então preenche as respostas assim que o pedido termina de processar. Isso pode deixar uma breve lacuna. As respostas também aparecem no recibo e no pedido em seu admin.

Este artigo foi útil?

Comece a vender hoje mesmo!

Junte-se a mais de 50.000 proprietários de lojas inteligentes e comece a usar a maneira mais fácil de vender produtos digitais com o WordPress.

Copyright © 2025 Sandhills Development, LLC

[universally_switcher]