Создайте базовую форму регистрации MailChimp с помощью своего API

редактировать:

С момента публикации этого ответа MailChimp выпустила версию 2 и 3 своего API. Версия 3 будет единственной поддерживаемой версией, начиная с 2017 года. Как только у меня будет возможность проверить его, я обновлю этот ответ для API версии 3.

---

MailChimp API v3. 0

согласно уведомлению в верхней части этой страницы, все предыдущие версии API не будет поддержку после 2016 года.

мое решение использует PHP в фоновом режиме для обработки API и jQuery для облегчения Ajax.

1) Загрузите PHP-оболочку, которая поддерживает API v3.0. На момент написания этой статьи в последних документах MailChimp нет ничего официального, поддерживающего v3.0, но некоторые из них перечислены на GitHub, поэтому я выбрал этот.

2) создайте следующий PHP файл,store-address.php, используя свой собственный ключ API и идентификатор списка, а также затем поместите его в тот же каталог, что и обертку с первого шага. Не забудьте следовать документации для вашей оболочки, но все они кажутся довольно похожими на это.

<?php // for MailChimp API v3.0

include('MailChimp.php');  // path to API wrapper downloaded from GitHub

use \DrewM\MailChimp\MailChimp;

function storeAddress() {

    $key        = "xxxxxxxxxxxxxxx-us1";
    $list_id    = "xxxxxx";

    $merge_vars = array(
        'FNAME'     => $_POST['fname'],
        'LNAME'     => $_POST['lname']
    );

    $mc = new MailChimp($key);

    // add the email to your list
    $result = $mc->post('/lists/'.$list_id.'/members', array(
            'email_address' => $_POST['email'],
            'merge_fields'  => $merge_vars,
            'status'        => 'pending'     // double opt-in
            // 'status'     => 'subscribed'  // single opt-in
        )
    );

    return json_encode($result);

}

// If being called via ajax, run the function, else fail

if ($_POST['ajax']) { 
    echo storeAddress(); // send the response back through Ajax
} else {
    echo 'Method not allowed - please ensure JavaScript is enabled in this browser';
}

3) Создайте свою HTML / CSS / JavaScript (jQuery) форму (это не обязательно быть на странице PHP, и посетитель никогда не увидит, что PHP используется в фоновом режиме.)

ответ находится в JSON, так что вам придется обрабатывать его правильно.

вот что мое выглядит так:

<form id="signup" action="index.html" method="get">
    First Name: <input type="text" name="fname" id="fname" />
    Last Name: <input type="text" name="lname" id="lname" />
    email Address (required): <input type="email" name="email" id="email" />
    <input type="submit" id="SendButton" name="submit" value="Submit" />
</form>
<div id="message"></div>

<script src="jquery.min.js"></script>
<script>
$(document).ready(function() {
    $('#signup').submit(function() {
        $("#message").html("Adding your email address...");
        $.ajax({
            url: 'inc/store-address.php', // proper url to your "store-address.php" file
            type: 'POST', // <- IMPORTANT
            data: $('#signup').serialize() + '&ajax=true',
            success: function(msg) {
                var message = $.parseJSON(msg),
                    result = '';
                if (message.status === 'pending') { // success
                    result = 'Success!  Please click the confirmation link that will be emailed to you shortly.';
                } else { // error
                    result = 'Error: ' + message.detail;
                }
                $('#message').html(result); // display the message
            }
        });
        return false;
    });
});
</script>

---

MailChimp API version 1:

(оригинальный ответ)

после некоторого поиска я нашел сайт, используя пример PHP с jQuery. Из этого я смог создать простую HTML-страницу с jQuery, содержащую основную форму регистрации. Файлы PHP "скрыты" в фоновом режиме, где пользователь никогда не видит их, но jQuery все еще может получить доступ & использовать.

1) Загрузите пример PHP 5 jQuery здесь... (EDIT: ссылки мертвы. Однако единственной важной частью является официальная оболочка API для PHP, которая доступна здесь.)

http://apidocs.mailchimp.com/downloads/mcapi-simple-subscribe-jquery.zip

если у вас есть только PHP 4, просто скачайте версию 1.2 MCAPI и замените соответствующий выше.

http://apidocs.mailchimp.com/downloads/mailchimp-api-class-1-2.zip

2) следуйте инструкциям в файле Readme, добавив свой ключ API и идентификатор списка в store-address.php файл в нужных местах.

3) Вы также можете собрать имя пользователя и/или другой информации. Вы должны добавить массив в store-address.php файл с использованием соответствующих переменных слияния.

вот что мое store-address.php файл выглядит так, где я также собираю имя, фамилию и тип электронной почты:

<?php

function storeAddress() {

    require_once('MCAPI.class.php');  // same directory as store-address.php

    // grab an API Key from http://admin.mailchimp.com/account/api/
    $api = new MCAPI('123456789-us2');

    $merge_vars = Array( 
        'EMAIL' => $_GET['email'],
        'FNAME' => $_GET['fname'], 
        'LNAME' => $_GET['lname']
    );

    // grab your List's Unique Id by going to http://admin.mailchimp.com/lists/
    // Click the "settings" link for the list - the Unique Id is at the bottom of that page. 
    $list_id = "123456a";

    if ($api->listSubscribe($list_id, $_GET['email'], $merge_vars , $_GET['emailtype'])) {
        // It worked!   
        return 'Success!&nbsp; Check your inbox or spam folder for a message containing a confirmation link.';
    } else {
        // An error ocurred, return error message   
        return '<b>Error:</b>&nbsp; ' . $api->errorMessage;
    }

}

// If being called via ajax, autorun the function
if($_GET['ajax']) { 
    echo storeAddress(); 
}

4) Создайте свою форму HTML / CSS / jQuery. Это не обязательно должно быть на странице PHP.

вот какой мой выглядит так:

<form id="signup" action="index.html" method="get">
    First Name: <input type="text" name="fname" id="fname" />
    Last Name: <input type="text" name="lname" id="lname" />
    email Address (required): <input type="email" name="email" id="email" />
    HTML: <input type="radio" name="emailtype" value="html" checked="checked" />
    Text: <input type="radio" name="emailtype" value="text" />
    <input type="submit" id="SendButton" name="submit" value="Submit" />
</form>
<div id="message"></div>

<script src="jquery.min.js"></script>
<script>
$(document).ready(function() {
    $('#signup').submit(function() {
        $("#message").html("Adding your email address...");
        $.ajax({
            url: 'inc/store-address.php', // proper url to your "store-address.php" file
            data: $('#signup').serialize() + '&ajax=true',
            success: function(msg) {
                $('#message').html(msg);
            }
        });
        return false;
    });
});
</script>

требуются куски...

• .HTML-код построенный как выше или подобный. С jQuery, внешний вид и параметры бесконечный.

• store-адрес.php файл загружен как часть примеров PHP на сайте Mailchimp и изменен с помощью вашего API KEY и LIST ID. Вам нужно добавить другие необязательные поля в массив.

• MCAPI.класс.php файл, загруженный с сайта Mailchimp (версия 1.3 для PHP 5 или версия 1.2 для PHP 4). Поместите его в тот же каталог, что и ваш store-адрес.php или вы должны обновить путь url в пределах store-адрес.php так что он может найти его.