holm/egroupware
1
1
Fork 0
forked from extern/egroupware
Code Issues Pull Requests Packages Projects Releases Wiki Activity
9e20212b3e
egroupware/notifications/inc/class.notifications_email.inc.php

193 lines
6.3 KiB
PHP
Raw Normal View History

Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
<?php
/**
* eGroupWare - Notifications
*
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* @package notifications
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
* @subpackage backends
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
* @link http://www.egroupware.org
* @author Christian Binder <christian@jaytraxx.de>
added version
2008-07-30 08:49:55 +02:00
* @version $Id$
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
*/
/**
* User notification via email.
*/
enabled class autoloading for notifications, let admins enable or disable notification backends, security fixes for email and egwpopup backend, unified link arrays used for notifications
2008-01-30 19:58:00 +01:00
class notifications_email implements notifications_iface {
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
/**
* Appname
*/
const _appname = 'notifications';
added version
2008-07-30 08:49:55 +02:00
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
/**
* holds account object for user who sends the message
*
* @var object
*/
private $sender;
added version
2008-07-30 08:49:55 +02:00
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
/**
* holds account object for user to notify
*
* @var object
*/
private $recipient;
added version
2008-07-30 08:49:55 +02:00
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
/**
* holds config object (sitewide application config)
*
* @var object
*/
private $config;
added version
2008-07-30 08:49:55 +02:00
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
/**
* holds preferences object of user to notify
*
allow to add attachments by giving a path, instead of a string, eg. egw_vfs::PREFIX.$path for a vfs path in $path
2011-06-23 11:05:25 +02:00
* @var preferences
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
*/
private $preferences;
/**
* holds mail object
*
allow to add attachments by giving a path, instead of a string, eg. egw_vfs::PREFIX.$path for a vfs path in $path
2011-06-23 11:05:25 +02:00
* @var send
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
*/
private $mail;
added version
2008-07-30 08:49:55 +02:00
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
/**
enabled class autoloading for notifications, let admins enable or disable notification backends, security fixes for email and egwpopup backend, unified link arrays used for notifications
2008-01-30 19:58:00 +01:00
* constructor of notifications_email
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
*
notification-app is now ready for non-eGW users as sender and recipients. deleted the old-style sending part from bo_tracking. this is not needed anymore.
2007-12-10 09:26:29 +01:00
* @param object $_sender
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
* @param object $_recipient
notification-app is now ready for non-eGW users as sender and recipients. deleted the old-style sending part from bo_tracking. this is not needed anymore.
2007-12-10 09:26:29 +01:00
* @param object $_config
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
* @param object $_preferences
*/
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
public function __construct($_sender, $_recipient, $_config = null, $_preferences = null) {
if(!is_object($_sender)) { throw new Exception("no sender given."); }
if(!is_object($_recipient)) { throw new Exception("no recipient given."); }
$this->sender = $_sender;
$this->recipient = $_recipient;
$this->config = $_config;
$this->preferences = $_preferences;
rewrite of r33861, a bit more elegant
2011-02-21 17:30:27 +01:00
if(is_object($this->mail))
make sure the mail object is ALWAYS created new, as it may cause problems with the sender information, if notification is running as cronjob and trying to notify users with different senderinformation
2011-02-21 13:12:29 +01:00
{
unset($this->mail);
}
rewrite of r33861, a bit more elegant
2011-02-21 17:30:27 +01:00
$this->mail = new send();
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
}
added version
2008-07-30 08:49:55 +02:00
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
/**
* sends notification
*
* @param array $_messages
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
* @param string $_subject
* @param array $_links
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
* @param array $_attachments
*/
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
public function send(array $_messages, $_subject = false, $_links = false, $_attachments = false) {
seed header on notification-mail with installid and keyword = notification-mail
2014-05-13 17:01:24 +02:00
//$_messages['plain'] = $_messages['plain']."\nSent By:".php_uname();
//$_messages['html'] = $_messages['html']."\n<hr>\n Sent by:".php_uname();
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
$body_plain = $_messages['plain'].$this->render_links($_links, false, $this->preferences->external_mailclient);
enabled class autoloading for notifications, let admins enable or disable notification backends, security fixes for email and egwpopup backend, unified link arrays used for notifications
2008-01-30 19:58:00 +01:00
$body_html = "<html><body>\n".$_messages['html'].$this->render_links($_links, true, $this->preferences->external_mailclient)."</body>\n</html>\n";
added version
2008-07-30 08:49:55 +02:00
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
$this->mail->ClearAddresses();
$this->mail->ClearAttachments();
notification-app is now ready for non-eGW users as sender and recipients. deleted the old-style sending part from bo_tracking. this is not needed anymore.
2007-12-10 09:26:29 +01:00
$this->mail->AddAddress($this->recipient->account_email, $this->recipient->account_fullname);
seed header on notification-mail with installid and keyword = notification-mail
2014-05-13 17:01:24 +02:00
$this->mail->AddCustomHeader('X-EGroupware-type: notification-mail');
$this->mail->AddCustomHeader('X-EGroupware-Install: '.$GLOBALS['egw_info']['server']['install_id'].'@'.$GLOBALS['egw_info']['server']['default_domain']);
//$this->mail->AddCustomHeader('X-EGroupware-URL: notification-mail');
//$this->mail->AddCustomHeader('X-EGroupware-Tracker: notification-mail');
rework sender/from/replyTo Information on notification
2014-11-18 11:50:35 +01:00
//error_log(__METHOD__.__LINE__."preparing notification message via email.".array2string($this->mail));
if (!$this->mail->From)
{
$this->mail->From = $this->sender->account_email;
$this->mail->FromName = $this->sender->account_fullname;
}
else
{
if ($this->sender->account_email)
{
$this->mail->ClearReplyTos();
$this->mail->AddReplyTo($this->sender->account_email,$this->sender->account_fullname);
// as we set the replyTo, we set (fake) the FromName accordingly
if ($this->sender->account_fullname) $this->mail->FromName = $this->sender->account_fullname;
}
}
//error_log(__METHOD__.__LINE__."preparing notification message via email.".array2string($this->mail));
allow to add attachments by giving a path, instead of a string, eg. egw_vfs::PREFIX.$path for a vfs path in $path
2011-06-23 11:05:25 +02:00
$this->mail->Subject = $_subject;
* Calendar: fixed since last update missing event details, notification iCal adds description with (required) *~*~*~*~*~*~*~*~*~* separator, extended has description before event details and links
2012-08-21 16:49:26 +02:00
// add iCal invitation as mulitpart alternative for calendar notifications
* Calendar Notification: handle calendar requests correctly as multipart/alternative; one part text/plain the other part text/calendar
2011-05-26 11:47:31 +02:00
if ($_attachments && stripos($_attachments[0]->type,"text/calendar; method=")!==false)
{
* Calendar Notification: handle calendar requests correctly as multipart/alternative; adding AltExtended to phpmailer; beware parts of multipartAlternative must be in decreasing order of preference (text/calendar as the last part)
2011-05-26 15:26:09 +02:00
$this->mail->AltExtended = $_attachments[0]->string;
$this->mail->AltExtendedContentType = $_attachments[0]->type;
unset($_attachments[0]);
query new notifications right after login and therefore also show up as "active" in session-status
2014-10-09 10:21:40 +02:00
$this->mail->Body = $body_plain;
}
else
{
$this->mail->IsHTML();
$this->mail->Body = $body_html;
$this->mail->AltBody = $body_plain;
* notification: if sending meeting requests: only send the text/plain part, as outlook interprets the html part as meeting description
2012-01-06 12:34:15 +01:00
}
allow to add attachments by giving a path, instead of a string, eg. egw_vfs::PREFIX.$path for a vfs path in $path
2011-06-23 11:05:25 +02:00
if(is_array($_attachments) && count($_attachments) > 0)
{
foreach($_attachments as $attachment)
{
if ($attachment->string)
{
$this->mail->AddStringAttachment($attachment->string, $attachment->filename, $attachment->encoding, $attachment->type);
}
elseif($attachment->path)
{
$this->mail->AddAttachment($attachment->path, $attachment->filename, $attachment->encoding, $attachment->type);
}
* Calendar Notification: handle calendar requests correctly as multipart/alternative; adding AltExtended to phpmailer; beware parts of multipartAlternative must be in decreasing order of preference (text/calendar as the last part)
2011-05-26 15:26:09 +02:00
}
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
}
rework sender/from/replyTo Information on notification
2014-11-18 11:50:35 +01:00
//error_log(__METHOD__.__LINE__."about sending notification message via email.".array2string($this->mail));
allow to add attachments by giving a path, instead of a string, eg. egw_vfs::PREFIX.$path for a vfs path in $path
2011-06-23 11:05:25 +02:00
if(!$error=$this->mail->Send())
{
rework sender/from/replyTo Information on notification
2014-11-18 11:50:35 +01:00
//error_log(__METHOD__.__LINE__." Failed sending notification message via email.$error".array2string($this->mail->ErrorInfo));
more debug information for notification failure
2008-12-09 15:02:15 +01:00
throw new Exception("Failed sending notification message via email.$error".print_r($this->mail->ErrorInfo,true));
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
}
}
added version
2008-07-30 08:49:55 +02:00
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
/**
* renders plaintext/html links from given link array
*
* @param array $_links
* @param boolean $_render_html
* @param boolean $_render_external
* @return plain or html rendered link(s) as complete string
*/
private function render_links($_links = false, $_render_html = false, $_render_external = true) {
if(!is_array($_links) || count($_links) == 0) { return false; }
added version
2008-07-30 08:49:55 +02:00
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
// provide defaults if given arguments are null
// php distinguishes between missing and present(null) arguments
if(is_null($_render_html)) { $_render_html = false; }
if(is_null($_render_external)) { $_render_external = true; }
enabled class autoloading for notifications, let admins enable or disable notification backends, security fixes for email and egwpopup backend, unified link arrays used for notifications
2008-01-30 19:58:00 +01:00
$newline = $_render_html ? "<br />" : "\n";
made all methods from html class static and removed the unnecessary singleton
2008-03-09 15:35:48 +01:00
$hruler = $_render_html ? html::hr() : '';
added version
2008-07-30 08:49:55 +02:00
enabled class autoloading for notifications, let admins enable or disable notification backends, security fixes for email and egwpopup backend, unified link arrays used for notifications
2008-01-30 19:58:00 +01:00
$rendered_links = array();
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
foreach($_links as $link) {
enabled class autoloading for notifications, let admins enable or disable notification backends, security fixes for email and egwpopup backend, unified link arrays used for notifications
2008-01-30 19:58:00 +01:00
if($_render_external || ! $link->popup) { $link->view['no_popup'] = 1; }
made all methods from html class static and removed the unnecessary singleton
2008-03-09 15:35:48 +01:00
$url = html::link('/index.php', $link->view);
enabled class autoloading for notifications, let admins enable or disable notification backends, security fixes for email and egwpopup backend, unified link arrays used for notifications
2008-01-30 19:58:00 +01:00
// do not expose sensitive data
$url = preg_replace('/(sessionid|kp3|domain)=[^&]+&?/','',$url);
// complete missing protocol and domain part if needed
if ($url{0} == '/' && $_render_external) {
$url = ($_SERVER['HTTPS'] || $GLOBALS['egw_info']['server']['enforce_ssl'] ? 'https://' : 'http://').
($GLOBALS['egw_info']['server']['hostname'] ? $GLOBALS['egw_info']['server']['hostname'] : $_SERVER['HTTP_HOST']).$url;
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
}
fixed: links rendered through both html::link and html::a_href get a wrong url
2009-10-09 21:51:25 +02:00
$a_href = '<a href="'.$url.'" target="_blank">'.$link->text.'</a>';
$rendered_links[] = $_render_html ? $a_href : $url;
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
}
enabled class autoloading for notifications, let admins enable or disable notification backends, security fixes for email and egwpopup backend, unified link arrays used for notifications
2008-01-30 19:58:00 +01:00
return $hruler.$newline.lang('Linked entries:').$newline.implode($newline,$rendered_links);
little re-design of notifications: cleaned up relation between main class and backends. main class is responsible for notification routing. backends are responsible for sending one message to one user. relocated ajax functions to a separate file.
2007-12-18 16:53:38 +01:00
}
Extended notification-app and egwpopup. Added winpopup-backend and email-backend. PHP5.1+ is now mandatory in trunk. For more infos look at the egw-developers list.
2007-11-22 09:29:16 +01:00
}
Reference in New Issue Copy Permalink