Notification in Contacter plugin

The Notification function was added for plugin version 1.0.5. It allows you to send notifications when submitting or deleting a record by specific email, administrator or specific user role. This feature is very useful if you always want to be aware of any records updates on the site.

The main settings fields for the notification

Trigger

The Trigger is a WordPress action(s) which are observed by the plugin. This event in which notifications will be sent.

Triggers list of the notification
  • Contacter Record Added – fires when a new Contacter Record submitted. Once a form with a voice message is sent from the site, the administrator or other recipient specified in the settings will receive notifications about this.
  • Contacter Record Removed – fires when a new Contacter Record deleted. Once any message is deleted, the administrator or other recipient specified in the settings will receive notifications about this.

Carriers

The Carrier delivers the Notification. There are available three types:

Different types of Carriers
  • Email – sending a text notification by email. You can configure the subject, body and recipient.
  • Webhook – is a method of augmenting or altering the behavior of a web page or web application with custom callbacks. It can be used by advanced users for extended functionality.
  • Webhook JSON – the same as Webhook but using JSON. It can be used by advanced users for extended functionality.

Merge Tags

This is a tiny bit of a dynamic information. You can think of it as a placeholder. The tags are used to add to fields when creating notifications. There are available Merge Tags:

  • {record_url} – a tag that adds a link to edit and manage the current record. The tag is available for the trigger “Contacter Record Added“.
  • {record_title} – a tag that adds the title of the current record. The tag is available for the trigger “Contacter Record Added” and Contacter Record Removed
  • {record_audio} – a tag adds a link to the record file. The tag is available for the trigger “Contacter Record Added“.
  • {record_id} – a tag that adds the record id. The tag is available for the trigger “Contacter Record Removed“.

How to create a new Email notification

  • Go to Contacter>Notification > Add New Notification
  • Add a title of the Notification
  • Select the Trigger according to your needs
  • Add New Carrier>select Email and fill the required fields
    • Subject – enter the title of your notification. You can use available Merge Tags(right sidebar of the page) for the field.
    • Body – enter your text message and available Merge Tags(right sidebar of the page) for the message body.
    • Recipients – select the notification recipients. It can be a specific email, administrator email, user or specific user role.
  • Save