All about email event notifications

Created by: Stephan Borg, Last modification: 13 May 2005 (22:21 UTC)


The notifications library is designed to send out event emails, when an event occurs, to anyone who has registered for that event.


Event types are registered by the packages in their <package>/tiki_setup_inc.php file (usually just after the registerMenu() function.
{CODE()}$gTikiSystem->registerNotifyEvent( array( "user_registers" => tra("A user registers") ) );{CODE}
This registers the event, and allows it to be displayed in the Administration / Kernel / Notification options, on a per package basis.

To retrieve an array of email addresses registered for your event, use the following code:
{CODE()}$emails = $notificationlib->get_mail_events('user_registers','*');{CODE}
Currently, you have to write your own email code, but I would like to add another function to $notificationlib to help out.


  1. The overlap functionality with the Wiki pages Watches
  2. They don't have direct associations with the users_users table and its email addresses.
    • Should an email address change, this is not propagate to the existing list of notifications.
    • Linking Notifications with the users_users table, would prevent anonymous users from registering notifications (this could be a good thing, but should be optional).
  3. Notification engine is not pluggable ie currently hard-coded to notify by emails only (MikeW suggests Jabber notifications)
  4. Current event email code is left up to the caller - add another function to kernel/notification_lib.php to simplify the emailing process.


  1. Store TIKI_CONTENT_GUID with each record to identify content type
  2. Store content_id with each record to identify the Liberty content record</package>



by , 10 May 2005 (21:04 UTC)
  Page 1 of 1  1