hypejunction/hypenotifications

Enhanced on-site and off-site notifications

hypeNotifications for Elgg

, _(*1)

, _(*2)

Features

• Facebook-style site notifications
• Email digest: users can specify at which interval they receive notifications for each type
• A tool to update preferred notification methods for all site users
• Leverages Zend_Mail (email library used in core) to send out HTML emails
• Allows to configure email transports (Sendmail, SMTP, File Transport)
• Allows to send file attachments
• Inlines CSS styles for improved email client experience
• Simpler testing experience: catch all email address, email/domain whitelist

Usage

Notification preferences

Go to Admin > Administer > Utilities > Notification Methods to update personal and subscription notification preferences globally., _(*3)

Developer Notes

Notification event types

Notification event types can be filtered using 'notification_events','notifications' hook. Users will be given an option to unsubscribe from notifications about these events or batch them into a digest. Note that some instant notification events should not be added this list, e.g. password reset and other account related notifications should remain instant., _(*4)

Notification Testing

You can disable outgoing email by switching to File Transport in plugin settings, this will instead write email as txt files to the filestore under /notifications_log/zend/, _(*5)

Sample SMTP config for GMail

To use GMail as your SMTP relay, you will likely need to Allow less secure apps: https://support.google.com/accounts/answer/6010255?hl=en, _(*6)

Host: smtp.gmail.com Port: 587 Secure Connection: TLS Auth: SMTP with AUTH LOGIN Username: Password: , _(*7)

Sample SMTP config for SendGrid

Host: smtp.sendgrid.com Port: 587 Secure Connection: TLS Auth: SMTP with AUTH LOGIN Username: apikey Password: , _(*8)

File Attachments

To add attachments to your email, add an array of ElggFile objects to notification parameters:, _(*9)

notify_user($to, $from, $subject, $body, array(
    'attachments' => array(
        $file1, $file2,
    )
));