O propósito do Gerenciador de Campos de Checkout é dar a você flexibilidade sobre quais dados você deseja coletar de seu cliente. Com isso em mente, o CFM oferece 22 tipos de campo diferentes para que você possa coletar dados da melhor maneira possível.
Elementos Comuns de Campo
Embora existam pouquíssimas opções de campo que ocorrem em todos os campos, há algumas que estão na maioria dos campos. Aqui estão exemplos:
Mostrar campo no checkout do frontend
Esta opção permite que você mostre o campo apenas no admin ou em ambos, no admin e no frontend do site. Aqui está um exemplo de um campo no construtor configurado para aparecer apenas no backend.
Aqui está o mesmo campo sendo renderizado na página de registro de Pagamento ( Downloads → Histórico de Pagamentos):
Este campo pode ser usado pelo administrador, enquanto o cliente pode nunca saber que ele existe.
Mostrar em CSVs exportados
Você pode optar por incluir este campo em CSVs exportados ou não
Onde este meta deve ser armazenado
Você pode optar por armazenar este meta em Meta de Pagamento (valores diferentes para todos os pedidos de um usuário específico) ou Meta de Usuário (mesmo valor para todos os pedidos de um usuário específico).
Observação: Se você não tiver "Exigir Login" ativado em suas configurações, a opção de armazenar os dados em Meta de Usuário não aparecerá porque seus usuários podem não ter contas de usuário nas quais armazenar os dados. Esta configuração pode ser encontrada navegando para Downloads → Configurações → Diversos → Checkout
Chave Meta
Este é o nome do campo meta no qual você deseja armazenar esses dados. Se você o deixar em branco ao criar o campo, um será criado para você com base no Rótulo do Campo.
Observação: Não altere a chave meta após criá-la. Se o fizer, quaisquer dados criados com a chave meta anterior serão perdidos.
Observação: Chaves meta não podem ter espaços. A convenção é substituir espaços por um sublinhado, mas um hífen também funcionará.
Nome da Classe CSS
Isso permite que você defina um nome de classe CSS personalizado apenas para este campo.
Tamanho
Todos os campos que são tipos de texto têm uma opção de tamanho (largura). Os resultados podem variar dependendo do tema usado.
Armazenando dados em meta de usuário
Como mencionado acima, você tem a opção de armazenar seu campo em Meta de Pagamento ou Meta de Usuário. Quaisquer dados armazenados em Meta de Usuário serão anexados ao usuário logado que está fazendo a compra e estarão disponíveis para esse usuário para uso futuro.
Um exemplo seria o número de telefone de um cliente. Uma vez armazenado em meta de usuário durante uma transação, quando esse cliente retornar e fizer outra transação enquanto estiver logado, o número de telefone dele já estará preenchido.
O cliente também terá acesso a campos personalizados anexados ao seu usuário em seu Editor de Perfil, criados pelo shortcode [edd_profile_editor].
Atenção: A opção de armazenar dados em meta de usuário só estará disponível se a opção “Exigir Login” estiver habilitada em Downloads → Configurações → Diversos → Checkout.
Opções de Tipo de Campo
Existem 22 tipos de campo para escolher:
Gancho de Ação
Isso é para desenvolvedores adicionarem elementos dinâmicos como quiserem. Ele oferece a chance de adicionar qualquer tipo de entrada que você queira adicionar neste formulário. A imagem abaixo mostra este campo com um exemplo de código usando o Nome do Hook “hookname”.
Exemplo de Código:
add_action('{hookname}', 'my_function_name}', 10, 4 );
// first param: Form Object
// second param: Save ID of payment if in scope, else -2
// third param: Save ID of user if in scope, else -2
// fourth param: Field Object
function my_function_name( $form, $payment_id, $user_id, $field ) {
// Do whatever you want here
}
Observação: Easy Digital Downloads não oferece suporte para codificação/desenvolvimento personalizado. Se necessário, recomendamos contratar um desenvolvedor através do Codeable para fazer as alterações personalizadas que você precisa.
Caixa de Seleção
Cria um conjunto padrão genérico de caixas de seleção.
País
Este campo permite que você apresente uma lista de países ao usuário. As opções de campo incluem todos os países atuais, e você tem a opção de adicionar ou remover para criar uma lista personalizada, se necessário.
Data
Este campo permite que o usuário final insira uma data e, opcionalmente, uma hora. Você pode escolher se a hora pode ser inserida e se a visualização inicial deve ser Dia, Mês ou Ano.
Este campo aparece como um campo de texto normal, mas valida a entrada, exigindo um endereço de e-mail válido.
Upload de Arquivo
Este campo cria um mecanismo de upload de arquivos e permite que você defina um tamanho máximo de arquivo, número máximo de arquivos e limite os tipos de arquivo para estes:
- Imagens (jpg, jpeg, gif, png, bmp)
- Áudio (mp3, wav, ogg, wma, mka, m4a, ra, mid, midi)
- Vídeos (avi, divx, flv, mov, ogv, mkv, mp4, m4v, divx, mpg, mpeg, mpe)
- PDF (pdf)
- Documentos do Office (doc, ppt, pps, xls, mdb, docx, xlsx, pptx, odt, odp, ods, odg, odc, odb, odf, rtf, txt)
- Arquivos Zip (zip, gz, gzip, rar, 7z)
- Arquivos Executáveis (exe)
- CSV (csv)
Primeiro Nome
Este campo cria um campo de texto com um tamanho padrão de 40 e não inclui opções para meta_key ou qualquer uma das funções de importação/exportação. Você também não pode criar mais de um campo de Nome e Sobrenome em um formulário.
Oculto
Este campo cria um campo de formulário oculto padrão. Ele tem APENAS opções para meta_key, meta_value e se deve ser apenas front-end ou ambos, front-end e back-end.
Honeypot
Este campo cria um campo vazio que apenas os bots podem ver e preencherão. Se for preenchido, a submissão do formulário é rejeitada. Mais informações sobre campos honeypot.
HTML
Este campo permite que você forneça um título e HTML arbitrário.
Sobrenome
Este campo é um campo de texto simples para o Sobrenome.
Atenção: Os formulários vêm com um campo de Sobrenome que não pode ser excluído, e você não pode adicionar um segundo, o que significa que você provavelmente nunca usará esta opção. Ocasionalmente, os campos de Sobrenome são removidos por acidente; esta opção permite restaurá-los.
Multiseleção
Este campo cria uma caixa de seleção múltipla padrão. Você pode especificar o texto de seleção padrão e criar quantas opções desejar.
Rádio
Este campo cria um conjunto padrão de botões de rádio. Você pode criar quantos desejar.
reCAPTCHA
Este campo cria uma ferramenta reCAPTCHA v3. Para que o reCAPTCHA funcione, você deve inserir sua chave de site e chave secreta no painel de configurações do EDD. Navegue até a página Downloads > Configurações > Extensões > Gerenciador de Campos de Checkout e adicione suas chaves de API lá.
Se você não tem chaves reCAPTCHA, você pode obtê-las aqui. Certifique-se de que, ao criar suas chaves de API, você selecione reCAPTCHA V3 na lista.
O reCAPTCHA v3 funciona silenciosamente, então você não verá este campo em seu formulário de checkout. O reCAPTCHA é desabilitado automaticamente para pagamentos fora do site, como o PayPal.
Repetir
Este campo cria um campo de texto e apresenta ao cliente a opção de criar quantos mais desejar. Abaixo está um exemplo da visualização no front-end.
Quebra de Seção
Este campo cria uma quebra de seção no formulário. Ele permite um título e uma descrição.
Selecionar
Este campo cria um campo de seleção suspenso padrão. Ele funciona exatamente como o Múltipla seleção acima, exceto que apenas uma opção pode ser escolhida pelo cliente.
Termos & Cond.
Este campo permite que você imprima um bloco de html contendo Termos e Condições, e também fornece uma caixa de seleção com um rótulo para o cliente clicar para concordar.
Texto
Este campo cria um campo de entrada de texto html padrão.
Área de Texto
Este campo cria uma área de texto html padrão. Você pode definir um número de colunas e linhas, texto de placeholder, um valor padrão e escolher entre textarea simples, textarea Rich ou textarea Teeny Rich.
URL
Este campo cria um campo de entrada de texto padrão, mas valida para uma URL.
Email do Usuário
Este campo cria um campo de entrada de texto padrão, mas valida para um endereço de e-mail. Ele se destina a receber o endereço de e-mail de um usuário do WordPress.
Observação: Semelhante ao Sobrenome, este campo já deve existir em seu formulário e você não pode adicionar um segundo. Esta opção existe apenas para que você possa substituir seu campo de e-mail se ele for acidentalmente removido.
Uso Geral
Uma vez que um tipo de campo é clicado, ele será adicionado à coluna principal no centro da tela e você terá várias opções para o campo. As opções exatas podem variar de um tipo de campo para outro, mas todos os campos compartilham algumas opções comuns:
- Obrigatório: Selecione “Sim” se você quiser que os clientes sejam obrigados a preencher os campos, ou “Não” se for opcional
- Rótulo do Campo: Este é o texto exibido como rótulo principal para o campo no checkout
- Texto de Ajuda: Este é o texto adicionado abaixo do campo no checkout para servir como uma explicação útil do que o cliente deve inserir
Depois de adicionar todos os campos que você precisa, basta clicar no botão “Salvar” localizado na área superior direita da tela. Uma vez salvo, seus campos serão exibidos no checkout.
Observações Importantes:
Existem alguns campos de checkout que não podem ser modificados por esta extensão:
1. Campos de Endereço de Cobrança. Estes são exigidos por gateways de pagamento com cartão de crédito e pelo sistema de impostos do EDD, portanto, não são permitidos para modificação.
2. O formulário de Cartão de Crédito usado por gateways de pagamento que processam cartões de crédito. Como é vital que esses campos apareçam exatamente como esperado pelo EDD, esses campos não podem ser modificados.
