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.
- 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:
- 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_field_FIELD_NAME} – a tag that is used to add content from additional form fields. Where you need to replace the FIELD_NAME with the name of the field whose content you want to use in the message.
For example, {record_field_mdp-contacter-first-name}, where mdp-contacter-first-name is a field name.
- {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
How to assign notifications to a specific form
Go to Contacter>Forms and create a new or edit an existing form. Find the Form notification option at the bottom of the edit page and select certain notifications.
