Twist & Twirl Consulting is an official Constant Contact Technology Partner ctct logo horiz color CMYK

CCJ Campaigns is a Joomla component that displays a list of email campaigns from a Constant Contact account, with links through which they can all be viewed.

You could use this, for example, to show a list of your organization's newsletters.

There are options to choose how many email campaigns to display and a way to filter based on the title of the campaign.

Please click the link above to download.


How To Use It


1. Installation

After you download the component, you will install it the same way as any other Joomla component.

2. Connecting

After installation, when you visit the component backend administration page, it will look like this:

ccj campaigns screenshot 1

Click on the button to connect to your Constant Contact account (you will only need to do this when you first install the component).

This will redirect to a page that asks for your Constant Contact login information.   Enter it and press the "Login" button to continue.  If you get a message from Constant Contact about enabling cookies in your browser, make sure you've enabled all cookies including third-party cookies (the Constant Contact login authorization cookies are considered third-party in this situation because they're coming from a different source than your own site).

Then Constant Contact will ask you to confirm that you want to allow "Twist & Twirl Consulting CCJ Campaigns" to access your Constant Contact data (it can take several seconds to display this question, depending on the load on the CC servers).   Click "Allow" (yes, you want to allow the component access to your data or you wouldn't be installing it).

3. Configuration

After connecting, you'll see the component administration page:

ccj ss 2

Disconnecting: if you ever need to switch to a new Constant Contact account, you can disconnect using this button, and then reconnect using another account as described above.

Number of campaigns to show: If you wish to limit your display to, say, the 10 most recent campaigns, you can set that here.  Note that the component will always display this number of most recent campaigns.  If you leave it at 0 (zero), it will display all the campaigns available in your Constant Contact account (there is currently a limit of 50 campaigns; we expect to lift that limit in a future release).

String to match in campaign subject: if you enter something here, the component will only display campaigns containing this string in their subject.  For example, if you often send out both newsletters and event reminders, you can use "Newsletter" (assuming your campaign newsletters use that term in their subjects) to display only the newsletters.   Note that the component only pays attention to the subject of each campaign, which is what your email recipients would see; it does not display or consider the title of the campaign, which is what you see in your list of campaigns in your Constant Contact account administration page.  (The title is often something like "Copy of March Newsletter" or something intended only for yourself).

Format of dates: This is for displaying dates in a format appropriate to your international region.  The default is "Long MDY", which is appropriate for the United States, and looks something like "February 27th, 2015".  "MDY" would be "Feb 27, 2015", "DMY" would be "27 Feb 2015", and "YMD" would be "2015 Feb 27".

Cache time: the data obtained from your Constant Contact account will be cached for this number of minutes before re-contacting Constant Contact.  This keeps your site from slowing down dramatically, and prevents you from flooding the Constant Contact API with requests every time someone displays a page on your site.  Constant Contact limits us in the number of API calls we can make per day, so you are required to have caching turned on; the minimum is 5 minutes.   This means that if you send out a new campaign or make some other change in your Constant Contact account, it won't show up on your website for this period of time.  If you need to see something faster, you can use the "Flush Cache" button, and the latest data will be pulled from Constant Contact the next time the component is displayed on the frontend.   Please do not ask us "I made a change in Constant Contact, why didn't it show up" - this is the reason, and you can just use "Flush Cache" if you don't want to wait for the cache to expire.

Credits: whether or not to display the "Powered by CCJ Campaigns" credit at the bottom of the frontend component page.

Display at top of frontend page:  here you can set up some content to be displayed at the top of the frontend component page (your newsletter logo, a description of what you're displaying with this component, or whatever you want).

Display at bottom of frontend page: similar to the previous item, but displayed at the bottom of the page (your own credit, for example).

4. Making it show up

After you have the component set up, time to make it display on the frontend of your site.  As with other Joomla components, you do this with a menu item.  So create a new menu item in the appropriate menu for your site, and then for the "Menu Item Type" hit the "Select" button, open up the "CCJ Campaigns" tab in the list of menu item types, and choose "CCJ Campaigns".  Then after you set the other parameters for the menu item as you wish and hit "Save and Close", when you refresh the frontend of your site and choose the new menu item, you'll see the CCJ Campaigns component display your list of campaigns.