{"id":10943,"date":"2023-10-01T16:14:52","date_gmt":"2023-10-01T23:14:52","guid":{"rendered":"https:\/\/membermouse.com\/?post_type=ht_kb&amp;p=10943"},"modified":"2023-10-01T16:14:52","modified_gmt":"2023-10-01T23:14:52","slug":"campo-de-formulario-smarttag-mm_form_field-formulario-de-checkout","status":"publish","type":"ht_kb","link":"https:\/\/membermouse.com\/pt\/documentos-3-2\/campo-de-formulario-smarttag-mm_form_field-formulario-de-checkout\/","title":{"rendered":"Form Field SmartTag\u2122 (MM_Form_Field) - Formul\u00e1rio de checkout"},"content":{"rendered":"<p>Essa tag \u00e9 usada em conjunto com a tag MM_Form. Ela gera campos de formul\u00e1rio com os quais o usu\u00e1rio pode interagir para inserir dados.<\/p>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\">Atributos<\/h5>\n\n\n\n<p>Os tipos de campos dispon\u00edveis e outros atributos variam de acordo com o tipo de formul\u00e1rio pai. Este artigo trata dos atributos e exemplos de uso do tipo de formul\u00e1rio Checkout.<\/p>\n\n\n\n<h6 class=\"wp-block-heading\"><strong>checkout<\/strong><\/h6>\n\n\n\n<p><code>tipo<\/code>&nbsp;(<em>opcional<\/em>) - Indica o tipo de campo de formul\u00e1rio a ser criado. Os valores aceit\u00e1veis s\u00e3o input, hidden, custom ou custom-hidden. O valor padr\u00e3o \u00e9 \"input\".<\/p>\n\n\n\n<div style=\"height:5px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>entrada<\/code>&nbsp;- Os campos de formul\u00e1rio do tipo 'input' geram um elemento de formul\u00e1rio HTML padr\u00e3o com o qual o usu\u00e1rio pode interagir para inserir informa\u00e7\u00f5es. Com base no valor do atributo 'name', o MemberMouse renderizar\u00e1 o elemento de formul\u00e1rio HTML apropriado. <br><br>Por exemplo, um menu suspenso ser\u00e1 renderizado para selecionar um pa\u00eds e um campo de entrada ser\u00e1 renderizado para inserir o primeiro nome. O atributo \"name\" \u00e9 obrigat\u00f3rio para campos de formul\u00e1rio de entrada.<br><br><\/li>\n\n\n\n<li><code>oculto<\/code>&nbsp;- Os campos de formul\u00e1rio do tipo 'hidden' geram um elemento HTML oculto que indica ao MemberMouse que o 'nome' associado a esse campo de formul\u00e1rio pode ser ignorado durante a valida\u00e7\u00e3o do formul\u00e1rio. <br><br>Por exemplo, ao comprar um produto, o endere\u00e7o de cobran\u00e7a \u00e9 obrigat\u00f3rio por padr\u00e3o, de modo que o MemberMouse n\u00e3o permitir\u00e1 que o usu\u00e1rio prossiga at\u00e9 que um endere\u00e7o de cobran\u00e7a tenha sido fornecido. Ao usar um campo de formul\u00e1rio do tipo oculto para o endere\u00e7o de cobran\u00e7a, voc\u00ea est\u00e1 instruindo o MemberMouse a permitir que o formul\u00e1rio seja enviado sem fornecer um endere\u00e7o de cobran\u00e7a. Isso \u00e9 \u00fatil quando voc\u00ea deseja fornecer um formul\u00e1rio de checkout m\u00ednimo nos casos em que n\u00e3o s\u00e3o necess\u00e1rias determinadas informa\u00e7\u00f5es. O atributo \"name\" \u00e9 obrigat\u00f3rio para campos de formul\u00e1rio ocultos. O atributo \"value\" \u00e9 opcional.<br><br><\/li>\n\n\n\n<li><code>personalizado<\/code>&nbsp;- Os campos de formul\u00e1rio do tipo \"personalizado\" geram um elemento de formul\u00e1rio HTML com o qual o usu\u00e1rio pode interagir para inserir informa\u00e7\u00f5es associadas aos campos personalizados que voc\u00ea configurou no MemberMouse. O atributo \"id\" \u00e9 obrigat\u00f3rio para campos de formul\u00e1rio personalizados. O atributo \"isRequired\" \u00e9 opcional.<br><br><\/li>\n\n\n\n<li><code>oculto personalizado<\/code>&nbsp;- Os campos de formul\u00e1rio do tipo 'custom-hidden' geram um elemento de formul\u00e1rio HTML oculto que armazena dados associados aos campos personalizados que voc\u00ea configurou no MemberMouse. O atributo \"id\" \u00e9 obrigat\u00f3rio para campos de formul\u00e1rio personalizados. O atributo \"isRequired\" \u00e9 opcional. <br><br>Os campos personalizados ocultos s\u00e3o perfeitos para armazenar informa\u00e7\u00f5es relacionadas ao pedido que o usu\u00e1rio n\u00e3o insere. <br><br>Por exemplo, voc\u00ea pode rastrear o nome do an\u00fancio de onde eles vieram, qual palavra-chave eles usaram para encontrar seu produto etc. Tudo o que voc\u00ea precisa fazer \u00e9 passar um par\u00e2metro querystring para a p\u00e1gina no seguinte formato: 'cf_{ID}' onde '{ID}' \u00e9 substitu\u00eddo pelo ID do campo personalizado. <br><br>Aqui est\u00e1 um exemplo: http:\/\/mysite.com\/checkout?cf_1=banner-1&amp;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.<br><br><\/li>\n\n\n\n<li><code>nome<\/code>&nbsp;(<em>condicional com base no tipo de campo<\/em>) - Esse campo \u00e9 obrigat\u00f3rio para os tipos de campo \"input\" e \"hidden\". Ele indica quais dados est\u00e3o sendo coletados no campo. <br><br>Abaixo est\u00e1 uma tabela de valores aceit\u00e1veis. <br><br>Se um campo for opcional, isso significa que voc\u00ea n\u00e3o precisa inclu\u00ed-lo no formul\u00e1rio. Se for obrigat\u00f3rio, voc\u00ea ter\u00e1 de inclu\u00ed-lo no formul\u00e1rio, mas, em v\u00e1rios casos, poder\u00e1 ocultar os campos obrigat\u00f3rios para que n\u00e3o sejam vistos, definindo o tipo como oculto. <br><br>Alguns nomes s\u00e3o v\u00e1lidos para os tipos de campo \"input\" e \"hidden\", enquanto outros s\u00e3o v\u00e1lidos apenas para os campos \"input\".<\/li>\n<\/ul>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td><strong>Valor<\/strong><\/td><td><strong>Descri\u00e7\u00e3o<\/strong><\/td><td><strong>Opcional<\/strong><\/td><td><strong>Tipos de campos v\u00e1lidos<\/strong><\/td><\/tr><tr><td><code>firstName<\/code><\/td><td>Coleta o primeiro nome do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>lastName<\/code><\/td><td>Coleta o sobrenome do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>e-mail<\/code><\/td><td>Coleta o endere\u00e7o de e-mail do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code><\/td><\/tr><tr><td><code>confirma\u00e7\u00e3o de e-mail<\/code><\/td><td>For\u00e7a o usu\u00e1rio a confirmar seu endere\u00e7o de e-mail<\/td><td>Sim<\/td><td><code>entrada<\/code><\/td><\/tr><tr><td><code>nome de usu\u00e1rio<\/code><\/td><td>Coleta o nome de usu\u00e1rio do usu\u00e1rio<\/td><td>Sim<\/td><td><code>entrada<\/code><\/td><\/tr><tr><td><code>telefone<\/code><\/td><td>Coleta o n\u00famero de telefone do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>senha<\/code><\/td><td>Coleta a senha do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>captcha<\/code><\/td><td>For\u00e7a o usu\u00e1rio a preencher um campo captcha para valida\u00e7\u00e3o<\/td><td>Sim<\/td><td><code>entrada<\/code><\/td><\/tr><tr><td><code>billingAddress<\/code><\/td><td>Coleta o endere\u00e7o de cobran\u00e7a do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>billingCity<\/code><\/td><td>Coleta a cidade de cobran\u00e7a do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>estado do faturamento<\/code><\/td><td>Coleta o estado de faturamento do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>billingZipCode<\/code><\/td><td>Coleta o c\u00f3digo postal de cobran\u00e7a do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>billingCountry<\/code><\/td><td>Coleta o pa\u00eds de cobran\u00e7a do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>shippingAddress<\/code><\/td><td>Coleta o endere\u00e7o de entrega do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>shippingCity<\/code><\/td><td>Coleta a cidade de envio do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>estado da remessa<\/code><\/td><td>Coleta o estado de envio do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>shippingZipCode<\/code><\/td><td>Coleta o c\u00f3digo postal de envio do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>shippingCountry<\/code><\/td><td>Coleta o pa\u00eds de envio do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>shippingMethod<\/code><\/td><td>Coleta o m\u00e9todo de envio que o usu\u00e1rio deseja usar<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code>,&nbsp;<code>oculto<\/code><\/td><\/tr><tr><td><code>shippingSameAsBilling<\/code><\/td><td>Gera uma caixa de sele\u00e7\u00e3o na qual o usu\u00e1rio pode clicar para indicar se deseja ou n\u00e3o fornecer um endere\u00e7o de entrega diferente do endere\u00e7o de cobran\u00e7a.<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code><\/td><\/tr><tr><td><code>ccN\u00famero<\/code><\/td><td>Coleta o n\u00famero do cart\u00e3o de cr\u00e9dito do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code><\/td><\/tr><tr><td><code>ccData de expira\u00e7\u00e3o<\/code><\/td><td>Coleta a data de expira\u00e7\u00e3o associada ao n\u00famero do cart\u00e3o de cr\u00e9dito do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code><\/td><\/tr><tr><td><code>ccSecurityCode<\/code><\/td><td>Coleta o c\u00f3digo de seguran\u00e7a associado ao n\u00famero do cart\u00e3o de cr\u00e9dito do usu\u00e1rio<\/td><td>N\u00e3o<\/td><td><code>entrada<\/code><\/td><\/tr><tr><td><code>c\u00f3digo do cupom<\/code><\/td><td>Coleta o c\u00f3digo de cupom que o usu\u00e1rio deseja aplicar ao pedido<\/td><td>Sim<\/td><td><code>entrada<\/code><\/td><\/tr><tr><td><code>presente<\/code><\/td><td>Gera uma caixa de sele\u00e7\u00e3o que o usu\u00e1rio pode clicar para indicar se o produto que est\u00e1 sendo comprado \u00e9 um presente.<\/td><td>Sim<\/td><td><code>entrada<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div style=\"height:30px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>classe<\/code>&nbsp;(<em>condicional com base no tipo de campo<\/em>) - Esse campo \u00e9 opcional para os campos \"input\" e \"custom\". Ele indica a classe CSS que deve ser usada para o campo.<br><br><\/li>\n\n\n\n<li><code>valor<\/code>&nbsp;(<em>condicional com base no tipo de campo<\/em>) - Esse campo \u00e9 opcional para campos \"ocultos\". Ele especifica os dados padr\u00e3o a serem definidos para o campo especificado no atributo \"name\".<br><br><\/li>\n\n\n\n<li><code>id<\/code>&nbsp;(<em>condicional com base no tipo de campo<\/em>) - Esse campo \u00e9 obrigat\u00f3rio para campos \"personalizados\" e \"ocultos personalizados\". Ele especifica a ID do campo personalizado para o qual coletar dados.<br><br><\/li>\n\n\n\n<li><code>isRequired<\/code>&nbsp;(<em>condicional com base no tipo de campo<\/em>) - Esse campo \u00e9 opcional para os campos \"custom\" e \"custom-hidden\". Ele indica se o campo personalizado deve ser obrigat\u00f3rio. Os valores aceit\u00e1veis s\u00e3o \"true\" e \"false\". O valor padr\u00e3o \u00e9 \"false\". Esse atributo tamb\u00e9m 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.<br><br><\/li>\n\n\n\n<li><code>padr\u00e3o<\/code>&nbsp;(<em>condicional com base no nome do campo<\/em>) - Esse campo \u00e9 opcional quando o \"name\" \u00e9 definido como \"shippingMethod\". Aqui voc\u00ea pode especificar a chave do m\u00e9todo de envio a ser usado como padr\u00e3o. Leia este artigo para&nbsp;<a rel=\"noreferrer noopener\" href=\"https:\/\/membermouse.com\/pt\/documentos-3-2\/definir-o-metodo-de-envio-padrao\/\" target=\"_blank\">Saiba como pesquisar a chave do m\u00e9todo de envio<\/a>.<br><br><\/li>\n\n\n\n<li><code>customAttributes<\/code>&nbsp;(<em>condicional com base no tipo de campo<\/em>) - Esse campo \u00e9 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\u00e1 adicionado ao HTML literalmente. Por exemplo, se voc\u00ea fizer o seguinte:<\/li>\n<\/ul>\n\n\n\n<div style=\"height:5px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"wp-block-code\"><code>[MM_Form_Field type='input' name='firstName' customAttributes='placeholder=\"First Name\"']<\/code><\/pre>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<p>O seguinte HTML ser\u00e1 gerado:<\/p>\n\n\n\n<div style=\"height:5px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;input type=\"text\" id=\"mm_field_first_name\" name=\"mm_field_first_name\" class=\"mm-textField\" placeholder=\"First Name\"&gt;<\/code><\/pre>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<h5 class=\"wp-block-heading\">Exemplo de uso completo<\/h5>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>\n\n\n\n<pre class=\"wp-block-code\"><code>[MM_Form type='checkout']\n\nCampos de entrada:\nPrimeiro nome: [MM_Form_Field type='input' name='firstName']\nLast Name (Sobrenome): [MM_Form_Field type='input' name='lastName']\n\nCampos ocultos:\n[MM_Form_Field type='hidden' name='billingAddress']\n[MM_Form_Field type='hidden' name='billingCity']\n[MM_Form_Field type='hidden' name='billingState' value='TX']\n[MM_Form_Field type='hidden' name='billingCountry' value='US']\n\nCampos personalizados:\nBirthday (Anivers\u00e1rio): [MM_Form_Field type='custom' id='1' isRequired='true']\nAltura: [MM_Form_Field type='custom' id='3' isRequired='false']\n\nCampo personalizado oculto:\n[MM_Form_Field type='custom-hidden' id='5']\n\n...outras SmartTags de formul\u00e1rio...\n[\/MM_Form]<\/code><\/pre>\n\n\n\n<div style=\"height:10px\" aria-hidden=\"true\" class=\"wp-block-spacer\"><\/div>","protected":false},"excerpt":{"rendered":"<p>Essa tag \u00e9 usada em conjunto com a tag MM_Form. Ela gera campos de formul\u00e1rio com os quais o usu\u00e1rio pode interagir para inserir dados. Atributos Os tipos de campo dispon\u00edveis e outros atributos ser\u00e3o...<\/p>","protected":false},"author":9645,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"om_disable_all_campaigns":false,"_strive_editorial_status":"not-started","_strive_copy_of":0,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"ht-kb-category":[181],"ht-kb-tag":[],"class_list":["post-10943","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-form-tags"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/ht-kb\/10943","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/users\/9645"}],"replies":[{"embeddable":true,"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/comments?post=10943"}],"version-history":[{"count":0,"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/ht-kb\/10943\/revisions"}],"wp:attachment":[{"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/media?parent=10943"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/ht-kb-category?post=10943"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/membermouse.com\/pt\/wp-json\/wp\/v2\/ht-kb-tag?post=10943"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}