/campaigning

A Ruby Gem to access the Campaing Monitor API (http://www.campaignmonitor.com/api/v2/) using SOAP protocol.

Primary LanguageRubyMIT LicenseMIT

Campaigning

This is a Ruby (1.8) wrapper around CampaignMonitor API v2(www.campaignmonitor.com/api/v2/) using SOAP.

Pre-requisites

An account with Campaign Monitor and the API Key (www.campaignmonitor.com).

Resources

Dependencies

This gem requires the following gems:

Soap4r (1.5.8)

Jeweler (http://technicalpickles.com/posts/craft-the-perfect-gem-with-jeweler)

Installing

sudo gem install gnumarcelo-campaigning -s http://gems.github.com

Configuring your API key

require 'campaigning'
CAMPAIGN_MONITOR_API_KEY = '_put_here_your_api_key_'

Usage

This gem provides a set of classes to access all available information on Campaign Monitor.

These are the list of classes:

Campaigning, Campaigning::Client, Campaigning::Campaign, Campaigning::List and Campaigning::Subscriber

The examples below assumes you have set CAMPAIGN_MONITOR_API_KEY constant with your Campaign monitor API.

Sample use of the Client class:

#Here is how to get a list of all clients...
clients = Campaigning::Client.get_all_clients

#Here is how to create a brand new subscriber list for an Client
client = Campaigning::Client.find_by_name("Client One Company")
list = Campaigning::List.create!(
  :clientID => client.clientID,
  :title => "List of people from Brazil",
  :confirmOptIn => false
)

For further examples please check at the sample directory.

What if I found a BUG?

If you found a bug in the Campaigning wrapper, it’s easy to report it on the like below:

http://github.com/gnumarcelo/campaigning/issues

Copyright © 2009 Marcelo Menezes. See LICENSE for details.