Version 5


All about email event notifications

Created by: Stephan Borg, Last modification: 07 May 2005 (05:22 UTC) by Stephan Borg


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. They currently don't work as far as I'm aware (:eek:)
  2. The overlap functionality with the Wiki pages Watches
  3. 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).
  4. Notifications have a currently unused field called object - defaults to '*'
  5. Notification engine is not pluggable ie currently hard-coded to notify by emails only (MikeW suggests Jabber notifications)
  6. 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
Page History
13 May 2005 (22:21 UTC)
Stephan Borg80.77.199.1616
Current • Source
Stephan Borg218.214.1.1135
View • Compare • Difference • Source
Stephan Borg218.214.1.1134
View • Compare • Difference • Source