Gerenciador de Campos de Checkout – Obtendo Metadados

A extensão Gerenciador de Campos de Checkout permite criar campos personalizados para o seu formulário de checkout. Isso facilita a coleta de dados dos seus clientes. Você pode vê-los facilmente na página Histórico de Pagamentos, mas e se você quiser que eles sejam impressos no recibo para o cliente ver? Este documento ajudará com isso.

Exemplo de Botões de Rádio

Neste exemplo, usaremos um campo personalizado de botões de rádio, intitulado “Você está satisfeito com este processo de compra?”. A chave de metadados para este campo foi gerada automaticamente como are_you_happy_with_this_purchase_process, e simplesmente criamos uma opção de resposta Sim/Não. Veja abaixo.

Como renderizaremos essas informações no recibo do cliente, vamos dar uma olhada nesse modelo. O modelo que queremos é chamado shortcode-receipt.php. Leia nossa documentação sobre como mover este modelo para o seu tema.

Perto do topo desse arquivo, você encontrará este código:

$payment = get_post( $edd_receipt_args['id'] );

que cria um objeto para este pagamento. No restante deste arquivo, podemos agora encontrar o ID deste pagamento em $payment->ID.

No exemplo acima, a Chave de Metadados é are_you_happy_with_this_purchase_process. Agora que temos o ID e a Chave de Metadados, podemos obter o valor com este código:

get_post_meta( $payment->ID, 'are_you_happy_with_this_purchase_process', true )

Observação: o ‘true’ no exemplo acima indica que esperamos um único valor de get_post_meta(). O Gerenciador de Campos de Checkout retorna um único valor para todos os tipos de campo que oferece.

Imprimindo no Recibo

No exemplo acima, obtivemos o valor que queríamos, mas agora queremos renderizá-lo de forma agradável nos recibos. Em shortcode-receipt.php, você encontrará uma tabela HTML com um ID CSS de edd_purchase_receipt. Você pode copiar esta tabela e alterar os valores. Aqui está um exemplo de um cabeçalho de tabela:

	 Then we can print a table row for the above question, like this:
Multi-answer Example

	 Some field types allow for multiple answers from a customer. Check boxes allow the customer to select multiple things for example. This is still stored as a single item in meta data; it’s a single array with multiple key/value pairs.  How it gets rendered is slightly different from above, however.

	 Here’s a custom field asking the customer what their favorite animal is:

	 

	 Rendering it in our HTML table would look like this:
ID, 'favorite_animal', true ) as $animal ) {
            $animals .= '
' . $animal . '
' . "n"; 
        }

	// print out the table row, wrapping the results in unordered list tags, and escaping with wp_kses_post()
    ?>
    

	 As you can see it’s only slightly more complicated than the first example.
Wrapping Up

	 Putting together the two code samples from above, we end up with something like this:

    

        

            

        
    
    




    

    
ID ), 'are_you_happy_with_this_purchase_process', true ) ) ); ?>








    

    






ID, 'favorite_animal', true ) as $animal ) {
                $animals .= '
' . $animal . '
' . "n"; 
            }

        // print out the table row, wrapping the results in unordered list tags, and escaping with wp_kses_post()
        ?>
        

    

        

            

        
    
    


    

        

        
ID ), 'are_you_happy_with_this_purchase_process', true ) ) ); ?>
    

    

        

        

    
    

O que ficará assim:

Pontos Principais

• Para renderizar as respostas dos Campos Personalizados em seus recibos, copie o arquivo shortcode-receipt.php para o seu tema e coloque seu código lá
• Obter os dados é simplesmente fazer uma chamada get_post_meta() na Chave de Metadados fornecida na área administrativa
• Todas as chaves do Gerenciador de Campos Personalizados são armazenadas como únicas na tabela post_meta.

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.