Salsa Campaigns for Australian Politicians

This plugin allows users of Salsa's CRM system to run campaigns targeting Australia Federal Politicians via their Wordpress site.

It uses code from wp-jalapeno and if you want to run any other types of campaign you should use that plugin.

Set up

You need to set up targets in Salsa that match the name of every Federal politician and you need to provide some settings on the plugin settings page of your Wordpress site.

These settings include your Salsa access details and an OpenAustralia API key, which is used to get the details of current Federal MPs.

There is also a setting to specify the custom field you use for your supporter's state. This is because many Australian Salsa customers are forced to create a custom field as Salsa does not support states outside of the US.

If you don't want to record the state of people taking action just leave this out and it will be ignored. The values of your custom field must match three letter state codes or the state will not be recorded (i.e. ACT, NSW, etc.).

Multi-content targeted actions

If you want to run a campaign that has different suggested content based on the target's party you need to set up different content sets.

The way the plugin works is that it searches for a content set called the name of the party of the target and if it can't find one, it just uses the first one listed.

So, if you want custom content for Labor party MPs, set up a content set called "Australian Labor Party". Remember that if the plugin can't find a content set for the target's party, it will just use the first one it finds so it is a good idea to have a generic message as the first content set.

Running a campaign

When you want to run a campaign, set it up like you would any other Salsa Campaign except you don't need to select any targets. The plugin finds targets based on their name and only works with current Federal MPs.

The plugin uses the name of the action to get the sample subject and content for the email so it must be unique. Once you've got the action ready you can insert the campaign into your Wordpress site using the shortcode [salsa-campaign name="My campaign"].

If you'd like to only target MPs from one of the houses of parliament (the House of Representatives or Senate) you can add the shortcode variable "house", for example [salsa-campaign name="My campaign" house="representatives"].

If you've configured your action correctly it should now allow users of your site to:

1. Enter their postcode to locate their Federal MPs
2. Select which MP they'd like to email
3. Enter their details and message to the MP
4. Have it sent via Salsa actions, with their details added to your supporter database

Constraints

There's a few constraints when using this plugin:

• No HTML email (Salsa Campaigns do not support this)
• Campaigns must have unique names

Credits

• Henare Degan
• Mikey Leung

This plugin was built with support from the Australian Youth Climate Coalition and The Oaktree Foundation.

Changelog

0.0.1 - Initial release