Form Field SmartTag™ (MM_Form_Field) - Formulário de checkout

Essa tag é usada em conjunto com a tag MM_Form. Ela gera campos de formulário com os quais o usuário pode interagir para inserir dados.

Atributos

Os tipos de campos disponíveis e outros atributos variam de acordo com o tipo de formulário pai. Este artigo trata dos atributos e exemplos de uso do tipo de formulário Checkout.

checkout

tipo (opcional) - Indica o tipo de campo de formulário a ser criado. Os valores aceitáveis são input, hidden, custom ou custom-hidden. O valor padrão é "input".

• entrada - Os campos de formulário do tipo 'input' geram um elemento de formulário HTML padrão com o qual o usuário pode interagir para inserir informações. Com base no valor do atributo 'name', o MemberMouse renderizará o elemento de formulário HTML apropriado.
  
  Por exemplo, um menu suspenso será renderizado para selecionar um país e um campo de entrada será renderizado para inserir o primeiro nome. O atributo "name" é obrigatório para campos de formulário de entrada.
  
  
• oculto - Os campos de formulário do tipo 'hidden' geram um elemento HTML oculto que indica ao MemberMouse que o 'nome' associado a esse campo de formulário pode ser ignorado durante a validação do formulário.
  
  Por exemplo, ao comprar um produto, o endereço de cobrança é obrigatório por padrão, de modo que o MemberMouse não permitirá que o usuário prossiga até que um endereço de cobrança tenha sido fornecido. Ao usar um campo de formulário do tipo oculto para o endereço de cobrança, você está instruindo o MemberMouse a permitir que o formulário seja enviado sem fornecer um endereço de cobrança. Isso é útil quando você deseja fornecer um formulário de checkout mínimo nos casos em que não são necessárias determinadas informações. O atributo "name" é obrigatório para campos de formulário ocultos. O atributo "value" é opcional.
  
  
• personalizado - Os campos de formulário do tipo "personalizado" geram um elemento de formulário HTML com o qual o usuário pode interagir para inserir informações associadas aos campos personalizados que você configurou no MemberMouse. O atributo "id" é obrigatório para campos de formulário personalizados. O atributo "isRequired" é opcional.
  
  
• oculto personalizado - Os campos de formulário do tipo 'custom-hidden' geram um elemento de formulário HTML oculto que armazena dados associados aos campos personalizados que você configurou no MemberMouse. O atributo "id" é obrigatório para campos de formulário personalizados. O atributo "isRequired" é opcional.
  
  Os campos personalizados ocultos são perfeitos para armazenar informações relacionadas ao pedido que o usuário não insere.
  
  Por exemplo, você pode rastrear o nome do anúncio de onde eles vieram, qual palavra-chave eles usaram para encontrar seu produto etc. Tudo o que você precisa fazer é passar um parâmetro querystring para a página no seguinte formato: 'cf_{ID}' onde '{ID}' é substituído pelo ID do campo personalizado.
  
  Aqui está um exemplo: http://mysite.com/checkout?cf_1=banner-1&cf_2=marketing. Neste exemplo, estamos passando "banner-1" como o valor do campo personalizado com ID 1 e "marketing" como o valor do campo personalizado com ID 2.
  
  
• nome (condicional com base no tipo de campo) - Esse campo é obrigatório para os tipos de campo "input" e "hidden". Ele indica quais dados estão sendo coletados no campo.
  
  Abaixo está uma tabela de valores aceitáveis.
  
  Se um campo for opcional, isso significa que você não precisa incluí-lo no formulário. Se for obrigatório, você terá de incluí-lo no formulário, mas, em vários casos, poderá ocultar os campos obrigatórios para que não sejam vistos, definindo o tipo como oculto.
  
  Alguns nomes são válidos para os tipos de campo "input" e "hidden", enquanto outros são válidos apenas para os campos "input".

• classe (condicional com base no tipo de campo) - Esse campo é opcional para os campos "input" e "custom". Ele indica a classe CSS que deve ser usada para o campo.
  
  
• valor (condicional com base no tipo de campo) - Esse campo é opcional para campos "ocultos". Ele especifica os dados padrão a serem definidos para o campo especificado no atributo "name".
  
  
• id (condicional com base no tipo de campo) - Esse campo é obrigatório para campos "personalizados" e "ocultos personalizados". Ele especifica a ID do campo personalizado para o qual coletar dados.
  
  
• isRequired (condicional com base no tipo de campo) - Esse campo é opcional para os campos "custom" e "custom-hidden". Ele indica se o campo personalizado deve ser obrigatório. Os valores aceitáveis são "true" e "false". O valor padrão é "false". Esse atributo também pode ser usado em campos de "entrada" que podem ser ocultos. Isso inclui firstName, lastName, phone, password, billingAddress, billingCity, billingState, billingZipCode, billingCountry, shippingAddress, shippingCity, shippingState, shippingZipCode.
  
  
• padrão (condicional com base no nome do campo) - Esse campo é opcional quando o "name" é definido como "shippingMethod". Aqui você pode especificar a chave do método de envio a ser usado como padrão. Leia este artigo para Saiba como pesquisar a chave do método de envio.
  
  
• customAttributes (condicional com base no tipo de campo) - Esse campo é opcional para campos de "entrada". Esse atributo pode ser usado para adicionar atributos HTML adicionais ao campo de entrada HTML gerado pelo MemberMouse. Tudo o que for definido nesse atributo será adicionado ao HTML literalmente. Por exemplo, se você fizer o seguinte:

[MM_Form_Field type='input' name='firstName' customAttributes='placeholder="First Name"']

O seguinte HTML será gerado:

<input type="text" id="mm_field_first_name" name="mm_field_first_name" class="mm-textField" placeholder="First Name">

Exemplo de uso completo

[MM_Form type='checkout']

Campos de entrada:
Primeiro nome: [MM_Form_Field type='input' name='firstName']
Last Name (Sobrenome): [MM_Form_Field type='input' name='lastName']

Campos ocultos:
[MM_Form_Field type='hidden' name='billingAddress']
[MM_Form_Field type='hidden' name='billingCity']
[MM_Form_Field type='hidden' name='billingState' value='TX']
[MM_Form_Field type='hidden' name='billingCountry' value='US']

Campos personalizados:
Birthday (Aniversário): [MM_Form_Field type='custom' id='1' isRequired='true']
Altura: [MM_Form_Field type='custom' id='3' isRequired='false']

Campo personalizado oculto:
[MM_Form_Field type='custom-hidden' id='5']

...outras SmartTags de formulário...
[/MM_Form]