arckinteractive/mailgun_mailin

Turns inbound emails into new site content

1.0.0 2016-08-18 12:46 UTC

Requires

• arckinteractive/mailgun: ~2.0
• composer/installers: ^1.0.8

GPL-2.0

• Ismayil Khayredinov

• plugin
• email
• notification
• elgg

README

Allows users to post new content by emailing it

Supports new:

• Blogs
• Bookmarks
• Files
• Discussions

Customizations

Adding a custom parser

To add a new content type to supported items, register a handler for 'mailin:types','mailgun' and add your type definition to the list. Type definition contains a callable handler and a list of allowed fields:

elgg_register_plugin_hook_handler('mailin:types', 'mailgun', function($hook, $type, $return) {

	$return['event'] = [
		'handler' => 'my_mailin_event_parser',
		'fields' => [
			'date',
			'location',
			'description',
		],
	];
});

function my_mailin_event_parser(\ArckInteractive\Mailgun\Message $message, $fields) {

	$date = strtotime($fields['date']);
	$location = $fields['location'];

	if (!$date || !$location) {
		return false;
	}

	// save the event
	// note that this will be performed via cron, so there is no logged in user
	// you will need to set ignored access after checking container/edit permissions

	return true;
}

Once this is set, the user will see a EVENT type with a list of fields in their settings: Settings > Content Mail-In.

Users can then send an email in the following format:

**Subject**
EVENT: Birthday party

**Message**
DATE: August 10, 2017 10:00
LOCATION: Some venue
DESCRIPTION:
I am hosting a birthday party, so come help me celebrate