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) - Indica el tipo de campo de formulario a crear. Los valores aceptables son input, hidden, custom o custom-hidden. El valor por defecto es 'input'.
entrada
- Los campos de formulario de tipo 'input' generan un elemento de formulario HTML estándar con el que el usuario puede interactuar para introducir información. En función del valor del atributo 'name', MemberMouse mostrará el elemento de formulario HTML adecuado.
Por ejemplo, se mostrará un desplegable para seleccionar un país y un campo de entrada para introducir su nombre. El atributo "name" es obligatorio en los campos de entrada.oculto
- Los campos de formulario de tipo 'hidden' producen un elemento HTML oculto que indica a MemberMouse que el 'name' asociado a este campo de formulario puede ser ignorado al validar el formulario.
Por ejemplo, al comprar un producto, la dirección de facturación es obligatoria por defecto, por lo que MemberMouse no permitirá que el usuario continúe hasta que se haya proporcionado una dirección de facturación. Al utilizar un campo de formulario de tipo oculto para la dirección de facturación, está indicando a MemberMouse que permita el envío del formulario sin proporcionar una dirección de facturación. Esto resulta útil cuando se desea proporcionar un formulario de pago mínimo en casos en los que no se requiere cierta información. El atributo 'name' es obligatorio para los campos de formulario ocultos. El atributo 'value' es opcional.personalizado
- Los campos de formulario de tipo "personalizado" generan un elemento de formulario HTML con el que el usuario puede interactuar para introducir información asociada a los campos personalizados que ha configurado en MemberMouse. El atributo 'id' es obligatorio para los campos de formulario personalizados. El atributo 'isRequired' es opcional.oculto personalizado
- Los campos de formulario de tipo 'custom-hidden' dan salida a un elemento de formulario HTML oculto que almacena los datos asociados a los campos personalizados que ha configurado en MemberMouse. El atributo 'id' es obligatorio para los campos de formulario personalizados. El atributo 'isRequired' es opcional.
Los campos personalizados ocultos son perfectos para almacenar información relacionada con el pedido que el usuario no introduce.
Por ejemplo, puede rastrear el nombre del anuncio del que proceden, la palabra clave que han utilizado para encontrar su producto, etc. Todo lo que tiene que hacer es pasar un parámetro querystring a la página con el siguiente formato: 'cf_{ID}' donde '{ID}' se sustituye por el ID del campo personalizado.
He aquí un ejemplo: http://mysite.com/checkout?cf_1=banner-1&cf_2=marketing. En este ejemplo, estamos pasando 'banner-1' como valor para el campo personalizado con ID 1 y 'marketing' como valor para el campo personalizado con ID 2.nombre
(condicional en función del tipo de campo) - Este campo es obligatorio para los tipos de campo "entrada" y "oculto". Indica qué datos se están recopilando en el campo.
A continuación figura una tabla de valores aceptables.
Si un campo es opcional significa que no tienes que incluirlo en el formulario. Si es obligatorio, tiene que incluirlo en el formulario, pero en varios casos puede ocultar los campos obligatorios para que no se vean estableciendo el tipo en oculto.
Algunos nombres son válidos tanto para los campos de entrada como para los ocultos, mientras que otros sólo son válidos para los campos de entrada.
Valor | Descripción | Opcional | Tipos de campo válidos |
firstName | Recoge el nombre del usuario | No | entrada , oculto |
apellido | Recoge el apellido del usuario | No | entrada , oculto |
correo electrónico | Recoge la dirección de correo electrónico del usuario | No | entrada |
email-confirmar | Obliga al usuario a confirmar su dirección de correo electrónico | Sí | entrada |
nombre de usuario | Recoge el nombre de usuario del usuario | Sí | entrada |
teléfono | Recoge el número de teléfono del usuario | No | entrada , oculto |
contraseña | Recoge la contraseña del usuario | No | entrada , oculto |
captcha | Obliga al usuario a rellenar un campo captcha para su validación | Sí | entrada |
dirección de facturación | Recoge la dirección de facturación del usuario | No | entrada , oculto |
facturaciónCity | Recoge la ciudad de facturación del usuario | No | entrada , oculto |
billingState | Recoge el estado de facturación del usuario | No | entrada , oculto |
billingZipCode | Recoge el código postal de facturación del usuario | No | entrada , oculto |
facturaciónPaís | Recoge el país de facturación del usuario | No | entrada , oculto |
shippingAddress | Recoge la dirección de envío del usuario | No | entrada , oculto |
envíoCiudad | Recoge la ciudad de envío del usuario | No | entrada , oculto |
shippingState | Recoge el estado de envío del usuario | No | entrada , oculto |
shippingZipCode | Recoge el código postal de envío del usuario | No | entrada , oculto |
shippingCountry | Recoge el país de envío del usuario | No | entrada , oculto |
shippingMethod | Recoge el método de envío que el usuario desea utilizar | No | entrada , oculto |
shippingSameAsBilling | Genera una casilla de verificación en la que el usuario puede hacer clic para indicar si desea o no proporcionar una dirección de envío diferente de su dirección de facturación. | No | entrada |
ccNúmero | Recoge el número de tarjeta de crédito del usuario | No | entrada |
ccFecha de caducidad | Recoge la fecha de caducidad asociada al número de tarjeta de crédito del usuario | No | entrada |
ccCódigoSeguridad | Recoge el código de seguridad asociado al número de tarjeta de crédito del usuario | 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) - Este campo es opcional para los campos 'input' y 'custom'. Indica la clase CSS que debe utilizarse para el campo.valor
(condicional en función del tipo de campo) - Este campo es opcional para los campos "ocultos". Especifica los datos predeterminados que se establecerán para el campo especificado en el atributo 'name'.id
(condicional en función del tipo de campo) - Este campo es obligatorio para los campos "personalizados" y "personalizados-ocultos". Especifica el ID del campo personalizado para el que se van a recopilar datos.isRequired
(condicional en función del tipo de campo) - Este campo es opcional para los campos 'custom' y 'custom-hidden'. Indica si el campo personalizado debe ser obligatorio. Los valores aceptables son "true" y "false". El valor por defecto es "false". Este atributo también se puede utilizar en campos 'input' que se pueden ocultar. Esto incluye firstName, lastName, phone, password, billingAddress, billingCity, billingState, billingZipCode, billingCountry, shippingAddress, shippingCity, shippingState,shippingZipCode.por defecto
(condicional basado en el nombre del campo) - Este campo es opcional cuando 'name' está configurado como 'shippingMethod'. Aquí puede especificar la clave del método de envío que se utilizará por defecto. Lea este artículo para aprenda a buscar la clave de método de envío.customAttributes
(condicional en función del tipo de campo) - Este campo es opcional para los campos 'input'. Este atributo puede utilizarse para añadir atributos HTML adicionales al campo de entrada HTML generado por MemberMouse. Lo que se establezca en este atributo se añadirá al HTML literalmente. Por ejemplo, si hace lo siguiente
[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]