README.rdoc in patientslikeme-campaign_monitor-1.2 vs README.rdoc in patientslikeme-campaign_monitor-1.2.1

- old
+ new

@@ -1,18 +1,52 @@ = campaign_monitor -This library provides access to the Campaign Monitor API (http://www.campaignmonitor.com/api) +This RubyGem provides access to the Campaign Monitor API (http://www.campaignmonitor.com/api). +Campaign Monitor recently made some changes to their API. + +This fork makes the following changes: + + * host changed from http://app.campaignmonitor.com to http://api.createsend.com + * ID values are no longer sent #to_i because they are hex strings + * added support for subscribers with custom fields using SOAP API + * refactored gemspec to build on github + * misc. cleanup and refactoring + + == Pre-requisites -An account with Campaign Monitor and the API Key. Accounts are free and can be obtained from -http://www.campaignmonitor.com +An account with Campaign Monitor and the API Key. Accounts are free and can be created at +http://www.campaignmonitor.com. == Resources -Install +=== Install +gem install patientslikeme-campaign_monitor -* gem install patientslikeme-campaign_monitor +=== Git Repository +http://github.com/patientslikeme/campaign_monitor -Git Repository -* http://github.com/patientslikeme/campaign_monitor +== Usage + + cm = CampaignMonitor.new # assumes you've set CAMPAIGN_MONITOR_API_KEY in your project + + for client in cm.clients + for list in client.lists + client.name # => returns the name + + # modify a subscriber list + list.add_subscriber(email, name, custom_fields_hash) + list.remove_subscriber(email) + list.add_and_resubscribe(email, name, custom_fields_hash) + + # get subscriber list details + subscribers = list.active_subscribers(since_time) + unsubscribed = list.unsubscribed(since_time) + bounced = list.bounced(since_time) + end + + for campaign in client.campaigns + + end + end