MailChimp ya ofrece todo lo necesario para utilizar los formularios de suscripción con Ajax. Pero viene con un problemilla: hay que cargar varios scripts externos. Para todos los que esta idea no nos gusta ni un pelo, MailChimp ofrece un API JSON excelente para comunicaciones Ajax. En este tutorial vamos a aprender a enviar un formulario de suscripción MailChimp con Ajax utilizando jQuery. Como es una solicitud cross-domain, utilizaremos el formato JSONP para el intercambio de datos.

1

El formulario

Para el formulario podemos utilizar el HTML generado desde la interfaz de MailChimp o puedes crear el tuyo propio. Por ejemplo, este es el que yo utilizo en el formulario de suscripción que puedes en esta misma página:

<form action="https://cybmeta.us8.list-manage.com/subscribe/post?u=e64350b5b9ffb665f6bcb3179&amp;id=ddf5e05cc8" method="post" id="subscription-form" role="form">
    <div class="form-group">
        <label for="mce-EMAIL" class="sr-only">Email address</label>
        <input type="email" placeholder="Introduce tu email" name="EMAIL" id="mce-EMAIL" class="form-control input-lg">
    </div>
    <div style="display:none;" class="alert notification-container small"></div>
    <div style="position: absolute; left: -5000px;"><input type="text" value="" tabindex="-1" name="b_e64350b5b9ffb665f6bcb3179_ddf5e05cc8"></div>
    <button id="mailchimp-submit" data-original-text="Suscribir" name="submit" class="btn btn-primary btn-lg btn-block" type="submit">Suscribir</button>
</form>

He tomado el formulario “Ultra Slim” directamente de MailChimp. Sólo he modificado el HTML para ajustarlo al marcado de mi CSS, lo importante del formulario se deja tal cual (los atributos action, method, name). Sólo he añadido el div de clase notification-container dónde pondré los mensajes recibidos en la respuesta Ajax. Si tomas el formulario estándar de MailChimp acuérdate de eliminar la carga de scripts externos.

2

API JSON de MailChimp

El API JSON de MailChimp está poco documentada y es bastante difícil de encontrar. Para acceder a ella toma la URL del action del formulario y cambia post por post-json. Por ejemplo:

https://cybmeta.us8.list-manage.com/subscribe/post?u=e64350b5b9ffb665f6bcb3179&id=ddf5e05cc8

por

https://cybmeta.us8.list-manage.com/subscribe/post-json?u=e64350b5b9ffb665f6bcb3179&id=ddf5e05cc8

A esta URL será a la que enviaremos la solicitud Ajax. Pero ojo, no pongas esta URL como action del formulario (como dicen en otros tutoriales) o no te funcionará para usuarios sin javascript. Esta URL la utilizaremos en el parámetro url de la función $.ajax de jQuery.

La respuesta JSON obtenida tiene esta estructura:

{
    "result":"error|success",
     "msg":"Mensaje de error o éxito"
}
3

Envío via Ajax

Ya tenemos el formulario, tenemos la URL a la que hacer la solicitud Ajax, y tenemos la estructura de la respuesta. Ya sólo nos queda el código jQuery que nos haga la magia.

//Al hacer click en el botón del formulario
$('#mailchimp-submit').on('click', function(e) {

     e.preventDefault();

     var submit_input = $('#mailchimp-submit');
     var notification_container = form.find('.notification-container');

     submit_input.html('Suscribiendo...');

      $.ajax({
          // Cambia por la URL de tu lista de correo
          url: "//cybmeta.us8.list-manage.com/subscribe/post-json?u=e64350b5b9ffb665f6bcb3179&id=ddf5e05cc8",
          // Serializamos los datos del formulario para pasarlos a pares query=value
          data: form.serialize(),
          dataType: 'jsonp',
          // Nombre de la función callback requerido por el API de MailChimp
          jsonp: 'c'
       }).done(function(data){
     
            if (data.result != "success") {
                    //Si el resultado no es "sucsess" mostramos el mensaje
                    //Y devolvemos el botón de envío a su estado original
                    notification_container.html(data.msg).show();
                    submit_input.html(submit_input.attr('data-original-text'));
            } else {
                    //Si el resultado es "sucsess" mostramos el mensaje
                    //Y escondemos el botón de envío
                    notification_container.html('¡Hecho! Comprueba tu bandeja de entrada para confirmar la suscripción.').show();
                    submit_input.hide();
            }

        }).fail(function(err){
                //Ha habido algún error en la comunicación
                notification_container.html("Lo sentimos. No se pudo conectar con el servidor de registro. Por favor, inténtalo de nuevo pasados unos minutos.").show();
                submit_input.html(submit_input.attr('data-original-text'));
            
        });
});

Puedes personalizar a tu gusto, como en los mejores restaurantes. Por ejemplo, yo he añadido algunos efectos y cambios de clase CSS según el resultado. Este es el código que estoy utilizando en el formulario de la newsletter de esta web (compatible con jQuery.noConflict()):

(function($){
 
  $('#mailchimp-submit').on('click', function(e) {
    e.preventDefault();
    send_form($('#subscription-form'));
  });
 
  function send_form(form) {
 
    var email_input = $('#mce-EMAIL');
    var submit_input = $('#mailchimp-submit');
    var notification_container = form.find('.notification-container');
 
    email_input.removeClass('has-error');
    submit_input.css('background-image', 'url("https://cybmeta-8224.kxcdn.com/wp-content/plugins/mailing/images/loading.gif")').css('background-repeat', 'no-repeat').html('Suscribiendo...');
 
    $.ajax({
      url: "//cybmeta.us8.list-manage.com/subscribe/post-json?u=e64350b5b9ffb665f6bcb3179&id=ddf5e05cc8",
      data: form.serialize(),
      dataType: 'jsonp',
      jsonp: 'c'
    })
    .done(function(data){
 
      if (data.result != "success") {
        submit_input.css('background-image', 'none').html(submit_input.attr('data-original-text'));
        email_input.addClass('has-error');
        notification_container.addClass('alert-danger').html(data.msg).show();
      } else {
        email_input.removeClass('has-error');
        notification_container.removeClass('alert-danger').addClass('alert-success').html('¡Hecho! Comprueba tu bandeja de entrada para confirmar la suscripción.').show();
        submit_input.hide();
      }
    })
    .fail(function(err){
      notification_container.addClass('alert-danger').html("Lo sentimos. No se pudo conectar con el servidor de registro. Por favor, inténtalo de nuevo pasados unos minutos.").show();
      submit_input.css('background-image', 'none').html(submit_input.attr('data-original-text'));
    });
 
    return form;
  } 
 
})(jQuery);

Ya está listo. Ya podemos utilizar el formulario de suscripción de MailChimp con Ajax. Más fácil imposible, aunque seguro que se puede hacer mejor. Si tienes sugerencias, no te las quedes.