Esta etiqueta se utiliza junto con la etiqueta MM_Form. Genera campos de formulario con los que el usuario puede interactuar para introducir datos.
Atributos
Los tipos de campo disponibles y otros atributos variarán en función del tipo de formulario principal. Este artículo trata de los atributos y ejemplos de uso para el tipo de formulario Checkout.
checkout
tipo (opcional) – Indicates the type of form field to create. Acceptable values are input, hidden, custom or custom-hidden. The default value is ‘input’.
entrada– Form fields of type ‘input’ output a standard HTML form element that the user can interact with to enter in information. Based on the value ‘name’ attribute MemberMouse will render the appropriate HTML form element.
For example, a dropdown will be rendered for selecting a Country and an input field will be rendered for entering in their first name. The ‘name’ attribute is required for input form fields.oculto– Form fields of type ‘hidden’ output a hidden HTML element which indicates to MemberMouse that the ‘name’ associated with this form field can be ignored when validating the form.
For example, when purchasing a product, billing address is required by default so MemberMouse won’t allow the user to proceed until a billing address has been provided. By using a form field of type hidden for billing address, you’re instructing MemberMouse to allow the form to be submitted without providing a billing address. This is useful when you want to provide a minimal checkout form in cases where you don’t require certain information. The ‘name’ attribute is required for hidden form fields. The ‘value’ attribute is optional.personalizado– Form fields of type ‘custom’ output an HTML form element that the user can interact with to enter in information associated with custom fields you’ve configured in MemberMouse. The ‘id’ attribute is required for custom form fields. The ‘isRequired’ attribute is optional.oculto personalizado– Form fields of type ‘custom-hidden’ output a hidden HTML form element that stores data associated with custom fields you’ve configured in MemberMouse. The ‘id’ attribute is required for custom form fields. The ‘isRequired’ attribute is optional.
Hidden custom fields are perfect for storing information related to the order that the user doesn’t enter.
For example, you could track the ad name they came from, which keyword they used to find your product, etc. All you need to do is pass a querystring parameter to the page in the following format: ‘cf_{ID}’ where ‘{ID}’ is replaced by the ID of the custom field.
Here’s an example: http://mysite.com/checkout?cf_1=banner-1&cf_2=marketing. In this example, we’re passing ‘banner-1’ as the value for the custom field with ID 1 and ‘marketing’ as the value for the custom field with ID 2.nombre(condicional en función del tipo de campo) – This field is required for ‘input’ and ‘hidden’ field types. It indicates what data is being collected in the field.
A continuación figura una tabla de valores aceptables.
If a field is optional this means you don’t have to include it in the form. If it’s required, you have to include it in the form, but in a number of cases you can hide required fields from being seen by setting the type to hidden.
Certain names are valid for both ‘input’ and ‘hidden’ field types while others are valid just for ‘input’ fields.
| Valor | Descripción | Opcional | Tipos de campo válidos |
firstName | Collects the user’s first name | No | entrada, oculto |
apellido | Collects the user’s last name | No | entrada, oculto |
correo electrónico | Collects the user’s email address | No | entrada |
email-confirmar | Obliga al usuario a confirmar su dirección de correo electrónico | Sí | entrada |
nombre de usuario | Collects the user’s username | Sí | entrada |
teléfono | Collects the user’s phone number | No | entrada, oculto |
contraseña | Collects the user’s password | No | entrada, oculto |
captcha | Obliga al usuario a rellenar un campo captcha para su validación | Sí | entrada |
dirección de facturación | Collects the user’s billing address | No | entrada, oculto |
facturaciónCity | Collects the user’s billing city | No | entrada, oculto |
billingState | Collects the user’s billing state | No | entrada, oculto |
billingZipCode | Collects the user’s billing zip code | No | entrada, oculto |
facturaciónPaís | Collects the user’s billing country | No | entrada, oculto |
shippingAddress | Collects the user’s shipping address | No | entrada, oculto |
envíoCiudad | Collects the user’s shipping city | No | entrada, oculto |
shippingState | Collects the user’s shipping state | No | entrada, oculto |
shippingZipCode | Collects the user’s shipping zip code | No | entrada, oculto |
shippingCountry | Collects the user’s shipping country | No | entrada, oculto |
shippingMethod | Recoge el método de envío que el usuario desea utilizar | No | entrada, oculto |
shippingSameAsBilling | Outputs a checkbox the user can click to indicate whether or not they want to provide a shipping address that’s different from their billing address. | No | entrada |
ccNúmero | Collects the user’s credit card number | No | entrada |
ccFecha de caducidad | Collects the expiration date associated with the user’s credit card number | No | entrada |
ccCódigoSeguridad | Collects the security code associated with the user’s credit card number | No | entrada |
código de cupón | Recoge el código de cupón que el usuario quiere aplicar al pedido | Sí | entrada |
regalo | Genera una casilla de verificación en la que el usuario puede hacer clic para indicar si el producto que se está comprando es un regalo. | Sí | entrada |
clase(condicional en función del tipo de campo) – This field is optional for ‘input’ and ‘custom’ fields. It indicates the CSS class that should be used for the field.valor(condicional en función del tipo de campo) – This field is optional for ‘hidden’ fields. It specifies the default data to set for the field specified in the ‘name’ attribute.id(condicional en función del tipo de campo) – This field is required for ‘custom’ and ‘custom-hidden’ fields. It specifies the ID of the custom field to collect data for.isRequired(condicional en función del tipo de campo) – This field is optional for ‘custom’ and ‘custom-hidden’ fields. It indicates whether the custom field should be required. Acceptable values are ‘true’ and ‘false’. The default value is ‘false’. This attribute can also be use on ‘input’ fields that can be hidden. This includes firstName, lastName, phone, password, billingAddress, billingCity, billingState, billingZipCode, billingCountry, shippingAddress, shippingCity, shippingState,shippingZipCode.por defecto(condicional basado en el nombre del campo) – This field is optional when the ‘name’ is set to ‘shippingMethod’. Here you can specify the key of the shipping method to use as the default. Read this article to aprenda a buscar la clave de método de envío.customAttributes(condicional en función del tipo de campo) – This field is optional for ‘input’ fields. This attribute can be used to add additional HTML attributes to the HTML input field generated by MemberMouse. Whatever is set in this attribute will be added to the HTML verbatim. For example, if you do the following:
[MM_Form_Field type='input' name='nombre' customAttributes='placeholder="Nombre"']
Se generará el siguiente HTML:
<input type="text" id="mm_field_first_name" name="mm_field_first_name" class="mm-textField" placeholder="First Name">
Ejemplo de uso completo
[MM_Form type='checkout']
Campos de entrada:
Nombre: [MM_Form_Field type='input' name='firstName']
Apellidos: [MM_Form_Field type='input' name='apellido']
Campos ocultos:
[MM_Form_Field type='hidden' name='dirección de facturación']
[MM_Form_Field type='hidden' name='ciudad_de_facturación']
[MM_Form_Field type='hidden' name='billingState' value='TX']
[MM_Form_Field type='hidden' name='billingCountry' value='US']
Campos personalizados:
Cumpleaños: [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']
...otras SmartTags del formulario...
[/MM_Form]

