[DOCU-92] Email campaign tool integration Created: 14/Dec/10  Updated: 06/Jan/15  Resolved: 06/Jan/15

Status: Closed
Project: Documentation
Component/s: content
Affects Version/s: None
Fix Version/s: None

Type: Task Priority: Neutral
Reporter: Antti Hietala Assignee: Ruth Stocks
Resolution: Obsolete Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Attachments: PNG File subsctibe-paragraph-test.png    
Template:
Acceptance criteria:
Empty
Task DoR:
Empty
Date of First Response:

 Description   

Document how to integrate Magnolia with a third party email campaign tool such as Campaign Monitor or MailChimp. How to compose newsletters as pages and send them to a subscriber list with the third party tool.



 Comments   
Comment by Boris Kraft [ 14/Dec/10 ]

Is this the same as the Campaign Monitor integration documentation? The current docs http://documentation.magnolia-cms.com/modules/newsletter.html and http://store.magnolia-cms.com/module-list/magnolia/newsletter.html are still too limited.

Comment by Ruth Stocks [ 02/Jan/11 ]

I have updated the module page - http://docuauthor.magnolia-cms.com/modules/newsletter.html and added an article to cook book - http://docuauthor.magnolia-cms.com/cookbook/STK-newsletters-CampaignMonitor.html. I had a number of issues.

Re module page

  1. When you test the form in the author instance by entering a valid email address, it indicates that the form was submitted successfully but also says "session expired - you need to start over (link)" and the green bars disappear. The start over link brings up the form again and resubmission gives the same result as the first attempt (see attached screenshot).
  1. With the exception of the above, the module seems to be working, and the above may be a result of a bug. I say this because in the Campaign Monitor account, you get a single API key and can create different client accounts, which have unique Client IDs. I created two client accounts and when I enter the different client ID’s, the stkNewsletterSubscribe dialog picks up the lists unique to the different client accounts, so I assume the integration is working. There is nothing relevant in my error logs.
  1. I have said in the intro paragraph that the email addresses collected on the site are automatically transferred to the external service (i.e. the lists created there). I think that this is (or should be) the case, but I was unable to verify this, probably for the reasons stated above.
  1. I can find no reference in Campaign Monitor to a ‘defaultListId’, which is provided for in /modules/newsletter/subscriptionService. I left the default key in the configuration and this didn’t seem to affect anything. Perhaps it is no longer applicable?
  1. I tried to figure out how to get the module working with Mail Chimp. Generating the API key was simple, but they don’t seem to use any of the other data nodes required in /modules/newsletter/subscriptionService. It seems to me that the class is ‘CampaignMonitor-specific’ and a different external service would require a unique class, but I am not too sure about this.

Re the cook book page

  1. I am stuck on the STK part. I want to amend or create a template that only renders main area of the large article template (header already has a toc). This will almost replicate the Magnolia newsletter page at http://www.magnolia-cms.com/our-company/news/newsletter/newsletter-16.newsletter. I can’t figure out how to configure this in the STK and would appreciate some help. I tried disabling all areas except mainArea, but you can’t disable the header and footer areas as they are rendered automatically by main.ftl.
  1. As the article stands the screenshots conflict. I used Magnolia’s actual newsletter page for some because I couldn’t get mine to work. I will fix this as soon as my STK issues are resolved.
Comment by Ruth Stocks [ 06/Jan/15 ]

To be documented with Newsletter module Docu-334

Generated at Mon Feb 12 01:05:50 CET 2024 using Jira 9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b.