History: Activity Notifications

            ! {{page}}

Activity Notifcations is an experimental feature for ((Tiki15)) which has evolved from the Activity Stream feature to allow Direct Notifications to be created using the same format and screens that are used for the Activity Stream. 

Activity Notifications are sent to a user's personalized stream. 

!! Creating an Activity Notification
Like an Activity Stream Rule, you create an Activity Notification using the "Record Event" button. 

You then check "is an Activity Notification" checkbox and you have the option to set a priority for the notification (Low, High, or Critical).

You must also identify which users should receive this notification. This is done by inputting special syntax which Tiki reads to fetch the users.   

!! Syntax for Notification Recipient
{FANCYTABLE(head="__Parameter__|__Options/Syntax__|__Explanation__|__Version__" sortable="n")}
user|"user"|This fetches the "user" parameter from the event arguments and sends the notification to that user.|15.x
object|"object"|This fetches the "object" parameter from the event arguments and sends the notification to that user. (Note: the object must be a user to work)|15.x
parent_comment_user|"parent_comment_user"|This fetches the "parent_comment_user" parameter from the event arguments and sends the notification to that user. (This is typically used in a case when we want to notify a user that someone has responded to their comment)|15.x
trackeritem:fieldId|"trackeritem:43"| This fetches the user in the identified field of the trackeritem (in this example, field 43) and send that user (or users) a notification. (Note: The field should be a user field). |15.x
groupmember|"groupmember"|This is used in conjunction with the organic groups addon. It fetches all members of a particular group and sends them a notifcation. The event arguments must contain a parameter for "groupname"|15.x
groupmanagers|"groupmanagers"|This is used in conjunction with the organic groups addon. It fetches all managers/leaders of a particular group and sends them a notifcation. The event arguments must contain a parameter for "groupname"|15.x
{FANCYTABLE}

!!Areas to improve
!!!No User Notification Management for these
At the current time there is nothing developed to allow a user to manage or reprioritize these notifications. These notifications are set across the site and a user cannot disable them. 
!!!The "Notification Recipient" section
We probably want to expand on the "Notification Recipient" section a bit to make it more user friendly since it's a little bit hackish right now. A dropdown with the various options could be interesting.
Also, being able to input any argument within an event could make a lot of sense too. (Ex: instead of having to predefine "parent_comment_user" in the options, we could just check if it exists as a parameter in arguments and if it does, we could send the notification to that user. )
!!!Editing the Notification
Editing the Notification doesn't load the details to the popup. You have to click "Advanced" to see and edit the details. Something to work on as well.