1
0
mirror of https://github.com/EGroupware/egroupware.git synced 2024-12-19 05:01:12 +01:00
egroupware_official/emailadmin/inc/class.emailadmin_tracking.inc.php
2011-07-01 10:37:47 +00:00

282 lines
8.2 KiB
PHP

<?php
/**
* EMailAdmin - history
*
* @link http://www.egroupware.org
* @author Ralf Becker <RalfBecker-AT-outdoor-training.de>
* @package addressbook
* @copyright (c) 2007 by Ralf Becker <RalfBecker-AT-outdoor-training.de>
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* @version $Id: class.emailadmin_tracking.inc.php 29941 2010-04-22 15:39:32Z nathangray $
*/
/**
* EMailAdmin - tracking object
*/
class emailadmin_tracking extends bo_tracking
{
/**
* Application we are tracking (required!)
*
* @var string
*/
var $app = 'emailadmin';
/**
* Name of the id-field, used as id in the history log (required!)
*
* @var string
*/
var $id_field = 'ea_profile_id';
/**
* Name of the field with the creator id, if the creator of an entry should be notified
*
* @var string
*/
//var $creator_field = '';
/**
* Name of the field with the id(s) of assinged users, if they should be notified
*
* @var string
*/
//var $assigned_field = '';
/**
* Translate field-name to 2-char history status
*
* @var array
*/
var $field2history = array(
'ea_smtp_server' => 'ea_smtp_server',
'ea_smtp_type' => 'ea_smtp_type',
'ea_smtp_port' => 'ea_smtp_port',
'ea_smtp_auth' => 'ea_smtp_auth',
'ea_editforwardingaddress' => 'ea_editforwardingaddress',
'ea_smtp_ldap_server' => 'ea_smtp_ldap_server',
'ea_smtp_ldap_basedn' => 'ea_smtp_ldap_basedn',
'ea_smtp_ldap_admindn' => 'ea_smtp_ldap_admindn',
'ea_smtp_ldap_adminpw' => 'ea_smtp_ldap_adminpw',
'ea_smtp_ldap_use_default' => 'ea_smtp_ldap_use_default',
'ea_imap_server' => 'ea_imap_server',
'ea_imap_type' => 'ea_imap_type',
'ea_imap_port' => 'ea_imap_port',
'ea_imap_login_type' => 'ea_imap_login_type',
'ea_imap_tsl_auth' => 'ea_imap_tsl_auth',
'ea_imap_tsl_encryption' => 'ea_imap_tsl_encryption',
'ea_imap_enable_cyrus' => 'ea_imap_enable_cyrus',
'ea_imap_admin_user' => 'ea_imap_admin_user',
'ea_imap_admin_pw' => 'ea_imap_admin_pw',
'ea_imap_enable_sieve' => 'ea_imap_enable_sieve',
'ea_imap_sieve_server' => 'ea_imap_sieve_server',
'ea_imap_sieve_port' => 'ea_imap_sieve_port',
'ea_description' => 'ea_description',
'ea_default_domain' => 'ea_default_domain',
'ea_organisation_name' => 'ea_organisation_name',
'ea_user_defined_identities' => 'ea_user_defined_identities',
'ea_user_defined_accounts' => 'ea_user_defined_accounts',
'ea_order' => 'ea_order',
'ea_appname' => 'ea_appname',
'ea_group' => 'ea_group',
'ea_user' => 'ea_user',
'ea_active' => 'ea_active',
'ea_smtp_auth_username' => 'ea_smtp_auth_username',
'ea_smtp_auth_password' => 'ea_smtp_auth_password',
'ea_user_defined_signatures' => 'ea_user_defined_signatures',
'ea_default_signature' => 'ea_default_signature',
'ea_imap_auth_username' => 'ea_imap_auth_username',
'ea_imap_auth_password' => 'ea_imap_auth_password',
'ea_stationery_active_templates' => 'ea_stationery_active_templates'
);
/**
* Translate field name to label
*/
public $field2label = array(
'ea_smtp_server' => 'SMTP server',
'ea_smtp_type' => 'SMTP type',
'ea_smtp_port' => 'SMTP port',
'ea_smtp_auth' => 'SMTP authentification',
'ea_editforwardingaddress' => 'edit forwarding address',
'ea_smtp_ldap_server' => 'SMTP Ldap Server',
'ea_smtp_ldap_basedn' => '',
'ea_smtp_ldap_admindn' => '',
'ea_smtp_ldap_adminpw' => 'SMTP Ldap admin password',
'ea_smtp_ldap_use_default' => 'SMTP Ldap use default',
'ea_imap_server' => 'IMAP server',
'ea_imap_type' => 'IMAP type',
'ea_imap_port' => 'IMAP port',
'ea_imap_login_type' => 'IMAP login type',
'ea_imap_tsl_auth' => 'IMAP Tsl authentification',
'ea_imap_tsl_encryption' => 'IMAP Tsl encryption',
'ea_imap_enable_cyrus' => 'IMAP enable Cyrus',
'ea_imap_admin_user' => 'IMAP admin user',
'ea_imap_admin_pw' => 'IMAP admin password',
'ea_imap_enable_sieve' => 'IMAP enable Sieve',
'ea_imap_sieve_server' => 'IMAP Sieve server',
'ea_imap_sieve_port' => 'IMAP Sieve port',
'ea_description' => 'Description',
'ea_default_domain' => 'Default domain',
'ea_organisation_name' => 'Organisation',
'ea_user_defined_identities' => 'User defined identities',
'ea_user_defined_accounts' => 'User defined accounts',
'ea_order' => 'Order',
'ea_appname' => 'Application',
'ea_group' => 'Group',
'ea_user' => 'User',
'ea_active' => 'Active',
'ea_smtp_auth_username' => 'SMTP authentification user',
'ea_smtp_auth_password' => 'SMTP authentification password',
'ea_user_defined_signatures' => 'User defined signatures',
'ea_default_signature' => 'Default signature',
'ea_imap_auth_username' => 'IMAP authentification user',
'ea_imap_auth_password' => 'IMAP authentification password',
'ea_stationery_active_templates' => ''
);
/**
* Fields that contain passwords
*/
static $passwordFields = array(
'ea_smtp_auth_password',
'ea_imap_auth_password',
'ea_smtp_ldap_adminpw',
'ea_imap_admin_pw',
);
/**
* Should the user (passed to the track method or current user if not passed) be used as sender or get_config('sender')
*
* @var boolean
*/
var $prefer_user_as_sender = false;
/**
* Instance of the emailadmin_bo class calling us
*
* @access private
* @var emailadmin_bo
*/
var $emailadmin_bo;
/**
* Constructor
*
* @param emailadmin_bo &$emailadmin_bo
* @return tracker_tracking
*/
function __construct(&$emailadmin_bo)
{
parent::__construct(); // calling the constructor of the extended class
$this->emailadmin_bo =& $emailadmin_bo;
}
/**
* Tracks the changes in one entry $data, by comparing it with the last version in $old
*
* @param array $data current entry
* @param array $old=null old/last state of the entry or null for a new entry
* @param int $user=null user who made the changes, default to current user
* @param boolean $deleted=null can be set to true to let the tracking know the item got deleted or undeleted
* @param array $changed_fields=null changed fields from ealier call to $this->changed_fields($data,$old), to not compute it again
* @param boolean $skip_notification=false do NOT send any notification
* @return int|boolean false on error, integer number of changes logged or true for new entries ($old == null)
*/
public function track(array $data,array $old=null,$user=null,$deleted=null,array $changed_fields=null,$skip_notification=false)
{
foreach (self::$passwordFields as $k => $v)
{
if (is_array($data))
{
foreach($data as $key => &$dd)
{
if ($key == $v && !empty($dd))
{
$dd = $this->maskstring($dd);
}
}
}
if (is_array($old))
{
foreach($old as $ko => &$do)
{
//error_log(__METHOD__.__LINE__.$ko);
if ($ko == $v && !empty($do))
{
$do = $this->maskstring($do);
}
}
}
}
//error_log(__METHOD__.__LINE__.array2string($data));
//error_log(__METHOD__.__LINE__.array2string($old));
return parent::track($data,$old,$user,$deleted,$changed_fields,$skip_notifications);
}
private function maskstring($data)
{
$length =strlen($data);
$first = substr($data,0,1);
$last = substr($data,-1);
if ($length<3)
{
$data = str_repeat('*',$length);
}
else
{
$data = $first.str_repeat('*',($length-2>0?$length-2:1)).$last;
}
return $data;
}
/**
* Get a notification-config value
*
* @param string $what
* - 'copy' array of email addresses notifications should be copied too, can depend on $data
* - 'lang' string lang code for copy mail
* - 'sender' string send email address
* @param array $data current entry
* @param array $old=null old/last state of the entry or null for a new entry
* @return mixed
*/
function get_config($name,$data,$old=null)
{
return null;
}
/**
* Get the modified / new message (1. line of mail body) for a given entry, can be reimplemented
*
* @param array $data
* @param array $old
* @return string
*/
function get_message($data,$old)
{
return null;
}
/**
* Get the subject of the notification
*
* @param array $data
* @param array $old
* @return string
*/
function get_subject($data,$old)
{
return null;
}
/**
* Get the details of an entry
*
* @param array $data
*
* @return array of details as array with values for keys 'label','value','type'
*/
function get_details($data)
{
return null;
}
}