User Trigger

This document will explain how to add an IFTTT “User Trigger” to a Plone folder. The User Trigger will send a triggering event to IFTTT when content in or below the folder is edited, including information about who changed it. This allows creation of IFTTT applets to, for example, log the edit information to Slack or a Google spreadsheet.

Note: For the trigger to work, an IFTTT secret key must be configured for the site as described at Configure a Plone Site with an IFTTT Secret Key.

Add User Trigger

Follow the steps given below to add a User Trigger to any folder.

  1. Traverse to the desired folder.
  2. From the IFTTT menu select Add IFTTT User Trigger.
_images/select_actions.png
  1. Fill out the form with the required values and click Add. Note that the event name will be used in the URL that will trigger IFTTT, so it must be a URL-friendly name (no spaces or special characters).
_images/fill_form2.png

Behind the Scenes

Collective.ifttt uses Plone content rules to implement IFTTT triggers. For those who are interested, this section explains what happens behind the scenes.

After the Add form gets filled in, a new content rule is dynamically created and applied to the folder. See the Rules menu on the left bar to see all the folder’s content rules.

_images/rule_tab2.png

The new content rule will be triggered by a Plone Object Modified event. It will have one condition defined for each content type selected, and one action, IFTTT Trigger. This action will trigger IFTTT with an event named according to what was filled out on the Add form.

Data Sent to IFTTT

The event sent to IFTTT by the User Trigger will contain the following 3 payload data items for the content object that was edited:

  • Title
  • URL
  • Username of the person who modified the content