egroupware_official/addressbook/inc/class.addressbook_tracking.inc.php

260 lines
6.3 KiB
PHP
Raw Normal View History

2007-06-06 10:18:45 +02:00
<?php
/**
* Addressbook - history and notifications
*
* @link http://www.egroupware.org
* @author Ralf Becker <RalfBecker-AT-outdoor-training.de>
* @package addressbook
2007-06-06 10:18:45 +02:00
* @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$
2007-06-06 10:18:45 +02:00
*/
/**
* Addressbook - tracking object
*/
class addressbook_tracking extends bo_tracking
{
/**
* Application we are tracking (required!)
*
* @var string
*/
var $app = 'addressbook';
/**
* Name of the id-field, used as id in the history log (required!)
*
* @var string
*/
var $id_field = 'id';
/**
* Name of the field with the creator id, if the creator of an entry should be notified
*
* @var string
*/
var $creator_field = 'creator';
/**
* 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(
);
2010-02-12 17:47:15 +01:00
/**
* Translate field name to label
*/
public $field2label = array(
// Custom fields added in constructor
);
2007-06-06 10:18:45 +02:00
/**
* 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;
2007-06-06 10:18:45 +02:00
/**
* Instance of the bocontacts class calling us
*
2007-06-06 10:18:45 +02:00
* @access private
* @var bocontacts
*/
var $contacts;
/**
* Constructor
*
* @param bocontacts &$bocontacts
* @return tracker_tracking
*/
function __construct(&$bocontacts)
2007-06-06 10:18:45 +02:00
{
parent::__construct(); // calling the constructor of the extended class
2007-06-06 10:18:45 +02:00
$this->contacts =& $bocontacts;
2010-02-08 18:53:47 +01:00
if (is_object($bocontacts->somain))
{
2010-02-08 18:53:47 +01:00
$this->field2history = array_combine($bocontacts->somain->db_cols, $bocontacts->somain->db_cols);
unset($this->field2history['modified']);
unset($this->field2history['modifier']);
unset($this->field2history['etag']);
}
2010-02-12 17:47:15 +01:00
$custom = config::get_customfields('addressbook', true);
if(is_array($custom)) {
foreach($custom as $name => $settings) {
$this->field2history['#'.$name] = '#'.$name;
$this->field2label['#'.$name] = $settings['label'];
}
}
2007-06-06 10:18:45 +02:00
}
2007-06-06 10:18:45 +02:00
/**
* 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)
2007-06-06 10:18:45 +02:00
{
//echo "<p>addressbook_tracking::get_config($name,".print_r($data,true).",...)</p>\n";
switch($name)
{
case 'copy':
if ($data['is_contactform'])
{
$copy = preg_split('/, ?/',$data['email_contactform']);
2009-09-29 09:54:11 +02:00
if ($data['email_copytoreceiver']) $copy[] = $data['email'];
return $copy;
2007-06-06 10:18:45 +02:00
}
break;
2007-06-06 10:18:45 +02:00
case 'sender':
if ($data['is_contactform'])
{
//echo "<p>addressbook_tracking::get_config($name,...) email={$data['email']}, n_given={$data['n_given']}, n_family={$data['n_family']}</p>\n";
return $data['email'] ? $data['n_given'].' '.$data['n_family'].' <'.$data['email'].'>' : null;
}
break;
}
return null;
}
2007-06-06 10:18:45 +02:00
/**
* Get the modified / new message (1. line of mail body) for a given entry, can be reimplemented
*
2007-06-06 10:18:45 +02:00
* @param array $data
* @param array $old
* @return string
*/
function get_message($data,$old)
{
if (!$data['modified'] || !$old)
{
return lang('New contact submitted by %1 at %2',
common::grab_owner_name($data['creator']),
$this->datetime($data['created']));
2007-06-06 10:18:45 +02:00
}
return lang('Contact modified by %1 at %2',
common::grab_owner_name($data['modifier']),
$this->datetime($data['modified']));
2007-06-06 10:18:45 +02:00
}
2007-06-06 10:18:45 +02:00
/**
* Get the subject of the notification
*
2007-06-06 10:18:45 +02:00
* @param array $data
* @param array $old
* @return string
*/
function get_subject($data,$old)
{
if ($data['is_contactform'])
{
$prefix = ($data['subject_contactform'] ? $data['subject_contactform'] : lang('Contactform')).': ';
}
return $prefix.$this->contacts->link_title($data);
2007-06-06 10:18:45 +02:00
}
2007-06-06 10:18:45 +02:00
/**
* Get the details of an entry
*
2007-06-06 10:18:45 +02:00
* @param array $data
*
2007-06-06 10:18:45 +02:00
* @return array of details as array with values for keys 'label','value','type'
*/
function get_details($data)
{
foreach($this->contacts->contact_fields as $name => $label)
{
if (!$data[$name] && $name != 'owner') continue;
switch($name)
{
case 'n_prefix': case 'n_given': case 'n_middle': case 'n_family': case 'n_suffix': // already in n_fn
case 'n_fileas': case 'id': case 'tid':
2007-06-06 10:18:45 +02:00
break;
case 'created': case 'modified':
$details[$name] = array(
'label' => $label,
'value' => $this->datetime($data[$name]),
2007-06-06 10:18:45 +02:00
);
break;
case 'bday':
if ($data[$name])
{
list($y,$m,$d) = explode('-',$data[$name]);
$details[$name] = array(
'label' => $label,
'value' => common::dateformatorder($y,$m,$d,true),
2007-06-06 10:18:45 +02:00
);
}
break;
case 'owner': case 'creator': case 'modifier':
$details[$name] = array(
'label' => $label,
'value' => common::grab_owner_name($data[$name]),
2007-06-06 10:18:45 +02:00
);
break;
case 'cat_id':
if ($data[$name])
{
$cats = array();
foreach(is_array($data[$name]) ? $data[$name] : explode(',',$data[$name]) as $cat_id)
{
$cats[] = $GLOBALS['egw']->cats->id2name($cat_id);
}
$details[$name] = array(
'label' => $label,
'value' => explode(', ',$cats),
);
}
case 'note':
$details[$name] = array(
'label' => $label,
'value' => $data[$name],
'type' => 'multiline',
);
break;
default:
$details[$name] = array(
'label' => $label,
'value' => $data[$name],
);
break;
}
}
if ($this->contacts->customfields)
{
foreach($this->contacts->customfields as $name => $custom)
{
if (!$header_done)
{
$details['custom'] = array(
'value' => lang('Custom fields').':',
'type' => 'reply',
);
$header_done = true;
}
$details['#'.$name] = array(
'label' => $custom['label'],
'value' => $custom['type'] == 'select' ? $custom['values'][$data['#'.$name]] : $data['#'.$name],
);
}
}
2007-06-06 10:18:45 +02:00
return $details;
}
2010-02-12 17:47:15 +01:00
}