forked from extern/egroupware
383 lines
13 KiB
PHP
383 lines
13 KiB
PHP
<?php
|
|
/**
|
|
* EGroupware Api: Contacts document merge
|
|
*
|
|
* @link http://www.egroupware.org
|
|
* @author Ralf Becker <RalfBecker-AT-outdoor-training.de>
|
|
* @package api
|
|
* @subpackage contacts
|
|
* @copyright (c) 2007-16 by Ralf Becker <RalfBecker-AT-outdoor-training.de>
|
|
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
|
|
* @version $Id$
|
|
*/
|
|
|
|
namespace EGroupware\Api\Contacts;
|
|
|
|
use EGroupware\Api;
|
|
|
|
// explicit import not namespaced classes
|
|
use calendar_boupdate; // we detect if it is not available
|
|
|
|
/**
|
|
* Contacts document merge
|
|
*/
|
|
class Merge extends Api\Storage\Merge
|
|
{
|
|
/**
|
|
* Functions that can be called via menuaction
|
|
*
|
|
* @var array
|
|
*/
|
|
var $public_functions = array(
|
|
'download_by_request' => true,
|
|
'show_replacements' => true,
|
|
"merge_entries" => true
|
|
);
|
|
|
|
/**
|
|
* Constructor
|
|
*/
|
|
function __construct()
|
|
{
|
|
parent::__construct();
|
|
|
|
// overwrite global export-limit, if an addressbook one is set
|
|
$this->export_limit = self::getExportLimit('addressbook');
|
|
|
|
// switch of handling of html formated content, if html is not used
|
|
$this->parse_html_styles = Api\Storage\Customfields::use_html('addressbook');
|
|
}
|
|
|
|
/**
|
|
* Get addressbook replacements
|
|
*
|
|
* @param int $id id of entry
|
|
* @param string &$content=null content to create some replacements only if they are use
|
|
* @param boolean $ignore_acl =false true: no acl check
|
|
* @return array|boolean
|
|
*/
|
|
protected function get_replacements($id,&$content=null,$ignore_acl=false)
|
|
{
|
|
if (!($replacements = $this->contact_replacements($id,'',$ignore_acl, $content)))
|
|
{
|
|
return false;
|
|
}
|
|
if($content && strpos($content, '$$#') !== false)
|
|
{
|
|
$this->cf_link_to_expand($this->contacts->read($id, $ignore_acl), $content, $replacements,'addressbook');
|
|
}
|
|
|
|
// Links
|
|
$replacements += $this->get_all_links('addressbook', $id, '', $content);
|
|
if (!(strpos($content,'$$calendar/') === false))
|
|
{
|
|
$replacements += $this->calendar_replacements($id,!(strpos($content,'$$calendar/-1/') === false));
|
|
}
|
|
return $replacements;
|
|
}
|
|
|
|
/**
|
|
* Return replacements for the calendar (next events) of a contact
|
|
*
|
|
* @param int $id contact-id
|
|
* @param boolean $last_event_too =false also include information about the last event
|
|
* @return array
|
|
*/
|
|
protected function calendar_replacements($id,$last_event_too=false)
|
|
{
|
|
if (!class_exists('calendar_boupdate')) return array();
|
|
|
|
$calendar = new calendar_boupdate();
|
|
|
|
// next events
|
|
$events = $calendar->search(array(
|
|
'start' => $calendar->now_su,
|
|
'users' => 'c'.$id,
|
|
'offset' => 0,
|
|
'num_rows' => 20,
|
|
'order' => 'cal_start',
|
|
'enum_recurring' => true
|
|
));
|
|
if (!$events)
|
|
{
|
|
$events = array();
|
|
}
|
|
if ($last_event_too==true)
|
|
{
|
|
$last = $calendar->search(array(
|
|
'end' => $calendar->now_su,
|
|
'users' => 'c'.$id,
|
|
'offset' => 0,
|
|
'num_rows' => 1,
|
|
'order' => 'cal_start DESC',
|
|
'enum_recurring' => true
|
|
));
|
|
$events['-1'] = $last ? array_shift($last) : array(); // returned events are indexed by cal_id!
|
|
}
|
|
$replacements = array();
|
|
$n = 1; // Returned events are indexed by cal_id, need to index sequentially
|
|
foreach($events as $key => $event)
|
|
{
|
|
// Use -1 for previous key
|
|
if($key < 0) $n = $key;
|
|
|
|
foreach($calendar->event2array($event) as $name => $data)
|
|
{
|
|
if (substr($name,-4) == 'date') $name = substr($name,0,-4);
|
|
$replacements['$$calendar/'.$n.'/'.$name.'$$'] = is_array($data['data']) ? implode(', ',$data['data']) : $data['data'];
|
|
}
|
|
foreach(array('start','end') as $what)
|
|
{
|
|
foreach(array(
|
|
'date' => $GLOBALS['egw_info']['user']['preferences']['common']['dateformat'],
|
|
'day' => 'l',
|
|
'time' => $GLOBALS['egw_info']['user']['preferences']['common']['timeformat'] == 12 ? 'h:i a' : 'H:i',
|
|
) as $name => $format)
|
|
{
|
|
$value = $event[$what] ? date($format,$event[$what]) : '';
|
|
if ($format == 'l') $value = lang($value);
|
|
$replacements['$$calendar/'.$n.'/'.$what.$name.'$$'] = $value;
|
|
}
|
|
}
|
|
$duration = ($event['end'] - $event['start'])/60;
|
|
$replacements['$$calendar/'.$n.'/duration$$'] = floor($duration/60).lang('h').($duration%60 ? $duration%60 : '');
|
|
|
|
++$n;
|
|
}
|
|
|
|
// Need to set some keys if there is no previous event
|
|
if($last_event_too && count($events['-1']) == 0) {
|
|
$replacements['$$calendar/-1/start$$'] = '';
|
|
$replacements['$$calendar/-1/end$$'] = '';
|
|
$replacements['$$calendar/-1/owner$$'] = '';
|
|
$replacements['$$calendar/-1/updated$$'] = '';
|
|
}
|
|
return $replacements;
|
|
}
|
|
|
|
/**
|
|
* Generate table with replacements for the preferences
|
|
*
|
|
*/
|
|
public function show_replacements()
|
|
{
|
|
$GLOBALS['egw_info']['flags']['app_header'] = lang('Addressbook').' - '.lang('Replacements for inserting contacts into documents');
|
|
$GLOBALS['egw_info']['flags']['nonavbar'] = (bool)$_GET['nonavbar'];
|
|
|
|
ob_start();
|
|
echo "<table width='90%' align='center'>\n";
|
|
echo '<tr><td colspan="4"><h3>'.lang('Contact fields:')."</h3></td></tr>";
|
|
|
|
$n = 0;
|
|
foreach($this->contacts->contact_fields as $name => $label)
|
|
{
|
|
if (in_array($name,array('tid','label','geo'))) continue; // dont show them, as they are not used in the UI atm.
|
|
|
|
if (in_array($name,array('email','org_name','tel_work','url')) && $n&1) // main values, which should be in the first column
|
|
{
|
|
echo "</tr>\n";
|
|
$n++;
|
|
}
|
|
if (!($n&1)) echo '<tr>';
|
|
echo '<td>{{'.$name.'}}</td><td>'.$label.'</td>';
|
|
if($name == 'cat_id')
|
|
{
|
|
if ($n&1) echo "</tr>\n";
|
|
echo '<td>{{categories}}</td><td>'.lang('Category path').'</td>';
|
|
$n++;
|
|
}
|
|
if ($n&1) echo "</tr>\n";
|
|
$n++;
|
|
}
|
|
|
|
echo '<tr><td colspan="4"><h3>'.lang('Custom fields').":</h3></td></tr>";
|
|
foreach($this->contacts->customfields as $name => $field)
|
|
{
|
|
echo '<tr><td>{{#'.$name.'}}</td><td colspan="3">'.$field['label']."</td></tr>\n";
|
|
}
|
|
|
|
echo '<tr><td colspan="4"><h3>'.lang('General fields:')."</h3></td></tr>";
|
|
foreach(array(
|
|
'link' => lang('HTML link to the current record'),
|
|
'links' => lang('Titles of any entries linked to the current record, excluding attached files'),
|
|
'attachments' => lang('List of files linked to the current record'),
|
|
'links_attachments' => lang('Links and attached files'),
|
|
'links/[appname]' => lang('Links to specified application. Example: {{links/infolog}}'),
|
|
'date' => lang('Date'),
|
|
'user/n_fn' => lang('Name of current user, all other contact fields are valid too'),
|
|
'user/account_lid' => lang('Username'),
|
|
'pagerepeat' => lang('For serial letter use this tag. Put the content, you want to repeat between two Tags.'),
|
|
'label' => lang('Use this tag for addresslabels. Put the content, you want to repeat, between two tags.'),
|
|
'labelplacement' => lang('Tag to mark positions for address labels'),
|
|
'IF fieldname' => lang('Example {{IF n_prefix~Mr~Hello Mr.~Hello Ms.}} - search the field "n_prefix", for "Mr", if found, write Hello Mr., else write Hello Ms.'),
|
|
'NELF' => lang('Example {{NELF role}} - if field role is not empty, you will get a new line with the value of field role'),
|
|
'NENVLF' => lang('Example {{NENVLF role}} - if field role is not empty, set a LF without any value of the field'),
|
|
'LETTERPREFIX' => lang('Example {{LETTERPREFIX}} - Gives a letter prefix without double spaces, if the title is empty for example'),
|
|
'LETTERPREFIXCUSTOM' => lang('Example {{LETTERPREFIXCUSTOM n_prefix title n_family}} - Example: Mr Dr. James Miller'),
|
|
) as $name => $label)
|
|
{
|
|
echo '<tr><td>{{'.$name.'}}</td><td colspan="3">'.$label."</td></tr>\n";
|
|
}
|
|
|
|
echo '<tr><td colspan="4"><h3>'.lang('EPL Only').":</h3></td></tr>";
|
|
echo '<tr><td>{{share}}</td><td colspan="3">'.lang('Public sharing URL')."</td></tr>\n";
|
|
|
|
Api\Translation::add_app('calendar');
|
|
echo '<tr><td colspan="4"><h3>'.lang('Calendar fields:')." # = 1, 2, ..., 20, -1</h3></td></tr>";
|
|
foreach(array(
|
|
'title' => lang('Title'),
|
|
'description' => lang('Description'),
|
|
'participants' => lang('Participants'),
|
|
'location' => lang('Location'),
|
|
'start' => lang('Start').': '.lang('Date').'+'.lang('Time'),
|
|
'startday' => lang('Start').': '.lang('Weekday'),
|
|
'startdate'=> lang('Start').': '.lang('Date'),
|
|
'starttime'=> lang('Start').': '.lang('Time'),
|
|
'end' => lang('End').': '.lang('Date').'+'.lang('Time'),
|
|
'endday' => lang('End').': '.lang('Weekday'),
|
|
'enddate' => lang('End').': '.lang('Date'),
|
|
'endtime' => lang('End').': '.lang('Time'),
|
|
'duration' => lang('Duration'),
|
|
'category' => lang('Category'),
|
|
'priority' => lang('Priority'),
|
|
'updated' => lang('Updated'),
|
|
'recur_type' => lang('Repetition'),
|
|
'access' => lang('Access').': '.lang('public').', '.lang('private'),
|
|
'owner' => lang('Owner'),
|
|
) as $name => $label)
|
|
{
|
|
if(in_array($name, array('start',
|
|
'end')) && $n & 1) // main values, which should be in the first column
|
|
{
|
|
echo "</tr>\n";
|
|
$n++;
|
|
}
|
|
if(!($n & 1))
|
|
{
|
|
echo '<tr>';
|
|
}
|
|
echo '<td>{{calendar/#/' . $name . '}}</td><td>' . $label . '</td>';
|
|
if($n & 1)
|
|
{
|
|
echo "</tr>\n";
|
|
}
|
|
$n++;
|
|
}
|
|
echo "</table>\n";
|
|
|
|
$GLOBALS['egw']->framework->render(ob_get_clean());
|
|
}
|
|
|
|
/**
|
|
* Get a list of placeholders provided.
|
|
*
|
|
* Placeholders are grouped logically. Group key should have a user-friendly translation.
|
|
*/
|
|
public function get_placeholder_list($prefix = '')
|
|
{
|
|
// Specific order for these ones
|
|
$placeholders = [
|
|
'contact' => [],
|
|
'details' => [
|
|
$this->prefix($prefix, 'categories', '{') => lang('Category path'),
|
|
$this->prefix($prefix, 'note', '{') => $this->contacts->contact_fields['note'],
|
|
$this->prefix($prefix, 'id', '{') => $this->contacts->contact_fields['id'],
|
|
$this->prefix($prefix, 'owner', '{') => $this->contacts->contact_fields['owner'],
|
|
$this->prefix($prefix, 'private', '{') => $this->contacts->contact_fields['private'],
|
|
$this->prefix($prefix, 'cat_id', '{') => $this->contacts->contact_fields['cat_id'],
|
|
],
|
|
|
|
];
|
|
|
|
// Iterate through the list & switch groups as we go
|
|
// Hopefully a little better than assigning each field to a group
|
|
$group = 'contact';
|
|
foreach($this->contacts->contact_fields as $name => $label)
|
|
{
|
|
if(in_array($name, array('tid', 'label', 'geo')))
|
|
{
|
|
continue;
|
|
} // dont show them, as they are not used in the UI atm.
|
|
|
|
switch($name)
|
|
{
|
|
case 'adr_one_street':
|
|
$group = 'business';
|
|
break;
|
|
case 'adr_two_street':
|
|
$group = 'private';
|
|
break;
|
|
case 'tel_work':
|
|
$group = 'phone';
|
|
break;
|
|
case 'email':
|
|
case 'email_home':
|
|
$group = 'email';
|
|
break;
|
|
case 'freebusy_uri':
|
|
$group = 'details';
|
|
}
|
|
$marker = $this->prefix($prefix, $name, '{');
|
|
if(!array_filter($placeholders, function ($a) use ($marker)
|
|
{
|
|
return array_key_exists($marker, $a);
|
|
}))
|
|
{
|
|
$placeholders[$group][$marker] = $label;
|
|
}
|
|
}
|
|
|
|
// Correctly formatted address by country / preference
|
|
$placeholders['business'][$this->prefix($prefix, 'adr_one_formatted', '{')] = "Formatted business address";
|
|
$placeholders['private'][$this->prefix($prefix, 'adr_two_formatted', '{')] = "Formatted private address";
|
|
|
|
$group = 'customfields';
|
|
foreach($this->contacts->customfields as $name => $field)
|
|
{
|
|
$placeholders[$group][$this->prefix($prefix, '#' . $name, '{')] = $field['label'];
|
|
}
|
|
return $placeholders;
|
|
}
|
|
|
|
/**
|
|
* Get insert-in-document action with optional default document on top
|
|
*
|
|
* Overridden from parent to change the insert-in-email actions so we can
|
|
* have a custom action handler.
|
|
*
|
|
* @param string $dirs Directory(s comma or space separated) to search
|
|
* @param int $group see nextmatch_widget::egw_actions
|
|
* @param string $caption ='Insert in document'
|
|
* @param string $prefix ='document_'
|
|
* @param string $default_doc ='' full path to default document to show on top with action == 'document'!
|
|
* @param int|string $export_limit =null export-limit, default $GLOBALS['egw_info']['server']['export_limit']
|
|
* @return array see nextmatch_widget::egw_actions
|
|
*/
|
|
public static function document_action($dirs, $group=0, $caption='Insert in document', $prefix='document_', $default_doc='',
|
|
$export_limit=null)
|
|
{
|
|
$actions = parent::document_action($dirs, $group, $caption, $prefix, $default_doc, $export_limit);
|
|
|
|
// Change merge into email actions so we can customize them
|
|
static::customise_mail_actions($actions);
|
|
|
|
return $actions;
|
|
}
|
|
|
|
protected static function customise_mail_actions(&$action)
|
|
{
|
|
if(strpos($action['egw_open'], 'edit-mail') === 0)
|
|
{
|
|
unset($action['confirm_multiple']);
|
|
$action['onExecute'] = 'javaScript:app.addressbook.merge_mail';
|
|
}
|
|
else if ($action['children'])
|
|
{
|
|
foreach($action['children'] as &$child)
|
|
{
|
|
static::customise_mail_actions($child);
|
|
}
|
|
}
|
|
}
|
|
}
|