grthtrhthjhtyjytjytkergtrhtrjytjerhrfh4:24 29/09/2026.
--------------------------------------------------------------------------
*/
/** @file
* @brief
*/
if (!defined('GLPI_ROOT')) {
die("Sorry. You can't access this file directly");
}
/**
* Class which manages notification events
**/
class NotificationEvent extends CommonDBTM {
static function getTypeName($nb=0) {
return _n('Event', 'Events', $nb);
}
/**
* @param $itemtype
* @param $options array to pass to showFromArray or $value
**/
static function dropdownEvents($itemtype, $options=array()) {
$p['name'] = 'event';
$p['display'] = true;
$p['value'] = '';
$p['display_emptychoice'] = true;
if (is_array($options) && count($options)) {
foreach ($options as $key => $val) {
$p[$key] = $val;
}
}
$events = array();
$target = NotificationTarget::getInstanceByType($itemtype);
if ($target) {
$events = $target->getAllEvents();
}
return Dropdown::showFromArray($p['name'], $events, $p);
}
/**
* retrieve the label for an event
*
* @since version 0.83
*
* @param $itemtype string name of the type
* @param $event string name of the event
*
* @return string
**/
static function getEventName($itemtype, $event) {
$events = array();
$target = NotificationTarget::getInstanceByType($itemtype);
if ($target) {
$events = $target->getAllEvents();
if (isset($events[$event])) {
return $events[$event];
}
}
return NOT_AVAILABLE;
}
/**
* Raise a notification event event
*
* @param $event the event raised for the itemtype
* @param $item the object which raised the event
* @param $options array of options used
* @param $label used for debugEvent() (default '')
**/
static function raiseEvent($event, $item, $options=array(), $label='') {
global $CFG_GLPI;
//If notifications are enabled in GLPI's configuration
if ($CFG_GLPI["use_mailing"]) {
$email_processed = array();
$email_notprocessed = array();
//Get template's information
$template = new NotificationTemplate();
$notificationtarget = NotificationTarget::getInstance($item,$event,$options);
if (!$notificationtarget) {
return false;
}
$entity = $notificationtarget->getEntity();
//Foreach notification
foreach (Notification::getNotificationsByEventAndType($event, $item->getType(), $entity)
as $data) {
$targets = getAllDatasFromTable('glpi_notificationtargets',
'notifications_id = '.$data['id']);
$notificationtarget->clearAddressesList();
//Process more infos (for example for tickets)
$notificationtarget->addAdditionnalInfosForTarget();
$template->getFromDB($data['notificationtemplates_id']);
$template->resetComputedTemplates();
//Set notification's signature (the one which corresponds to the entity)
$template->setSignature(Notification::getMailingSignature($entity));
$notify_me = false;
if (Session::isCron()) {
// Cron notify me
$notify_me = true;
} else {
// Not cron see my pref
$notify_me = $_SESSION['glpinotification_to_myself'];
}
//Foreach notification targets
foreach ($targets as $target) {
//Get all users affected by this notification
$notificationtarget->getAddressesByTarget($target,$options);
foreach ($notificationtarget->getTargets() as $user_email => $users_infos) {
if ($label
|| $notificationtarget->validateSendTo($event, $users_infos, $notify_me)) {
//If the user have not yet been notified
if (!isset($email_processed[$users_infos['language']][$users_infos['email']])) {
//If ther user's language is the same as the template's one
if (isset($email_notprocessed[$users_infos['language']]
[$users_infos['email']])) {
unset($email_notprocessed[$users_infos['language']]
[$users_infos['email']]);
}
$options['item'] = $item;
if ($tid = $template->getTemplateByLanguage($notificationtarget,
$users_infos, $event,
$options)) {
//Send notification to the user
if ($label == '') {
$datas = $template->getDataToSend($notificationtarget, $tid,
$users_infos, $options);
$datas['_notificationtemplates_id'] = $data['notificationtemplates_id'];
$datas['_itemtype'] = $item->getType();
$datas['_items_id'] = $item->getID();
$datas['_entities_id'] = $entity;
Notification::send($datas);
} else {
$notificationtarget->getFromDB($target['id']);
echo "| ".$label." | ";
echo "".$notificationtarget->getNameID()." | ";
echo "".sprintf(__('%1$s (%2$s)'), $template->getName(),
$users_infos['language'])." | ";
echo "".$users_infos['email']." | ";
echo "
";
}
$email_processed[$users_infos['language']][$users_infos['email']]
= $users_infos;
} else {
$email_notprocessed[$users_infos['language']][$users_infos['email']]
= $users_infos;
}
}
}
}
}
}
}
unset($email_processed);
unset($email_notprocessed);
$template = null;
return true;
}
/**
* Display debug information for an object
*
* @param $item the object
* @param $options array
**/
static function debugEvent($item, $options=array()) {
echo "";
echo "
";
echo "| "._n('Notification', 'Notifications', Session::getPluralNumber()).
" | (".$item->getTypeName(1).") |
|---|
";
$events = array();
if ($target = NotificationTarget::getInstanceByType(get_class($item))) {
$events = $target->getAllEvents();
if (count($events)>0) {
echo "| ".self::getTypeName(Session::getPluralNumber()).' | '._n('Recipient', 'Recipients', Session::getPluralNumber())." | ";
echo ""._n('Notification template', 'Notification templates', Session::getPluralNumber())." | ".
""._n('Email', 'Emails', Session::getPluralNumber())." |
|---|
";
foreach ($events as $event => $label) {
self::raiseEvent($event, $item, $options, $label);
}
} else {
echo "| ".__('No item to display')." |
";