forked from extern/egroupware
320 lines
8.5 KiB
PHP
320 lines
8.5 KiB
PHP
|
<?php
|
||
|
/**
|
||
|
* eGroupWare: GroupDAV access: addressbook handler
|
||
|
*
|
||
|
* @link http://www.egroupware.org
|
||
|
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
|
||
|
* @package addressbook
|
||
|
* @subpackage groupdav
|
||
|
* @author Ralf Becker <RalfBecker-AT-outdoor-training.de>
|
||
|
* @copyright (c) 2007/8 by Ralf Becker <RalfBecker-AT-outdoor-training.de>
|
||
|
* @version $Id$
|
||
|
*/
|
||
|
|
||
|
require_once(EGW_INCLUDE_ROOT.'/addressbook/inc/class.bocontacts.inc.php');
|
||
|
|
||
|
/**
|
||
|
* eGroupWare: GroupDAV access: addressbook handler
|
||
|
*/
|
||
|
class addressbook_groupdav extends groupdav_handler
|
||
|
{
|
||
|
/**
|
||
|
* bo class of the application
|
||
|
*
|
||
|
* @var vcaladdressbook
|
||
|
*/
|
||
|
var $bo;
|
||
|
|
||
|
var $filter_prop2cal = array(
|
||
|
'UID' => 'uid',
|
||
|
//'NICKNAME',
|
||
|
'EMAIL' => 'email',
|
||
|
'FN' => 'n_fn',
|
||
|
);
|
||
|
|
||
|
/**
|
||
|
* Charset for exporting data, as some clients ignore the headers specifying the charset
|
||
|
*
|
||
|
* @var string
|
||
|
*/
|
||
|
var $charset = 'utf-8';
|
||
|
|
||
|
function __construct($debug=null)
|
||
|
{
|
||
|
parent::__construct('addressbook',$debug);
|
||
|
|
||
|
$this->bo =& new bocontacts();
|
||
|
|
||
|
// SoGo Connector for Thunderbird works only with iso-8859-1!
|
||
|
if (strpos($_SERVER['HTTP_USER_AGENT'],'Thunderbird') !== false) $charset = 'iso-8859-1';
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Handle propfind in the addressbook folder
|
||
|
*
|
||
|
* @param string $path
|
||
|
* @param array $options
|
||
|
* @param array &$files
|
||
|
* @param int $user account_id
|
||
|
* @param string $id=''
|
||
|
* @return mixed boolean true on success, false on failure or string with http status (eg. '404 Not Found')
|
||
|
*/
|
||
|
function propfind($path,$options,&$files,$user,$id='')
|
||
|
{
|
||
|
if ($user) $filter = array('contact_owner' => $user);
|
||
|
|
||
|
// process REPORT filters or multiget href's
|
||
|
if (($id || $options['root']['name'] != 'propfind') && !$this->_report_filters($options,$filter,$id))
|
||
|
{
|
||
|
return false;
|
||
|
}
|
||
|
error_log(__METHOD__."($path,$options,,$user,$id) filter=".str_replace(array("\n",' '),'',print_r($filter,true)));
|
||
|
// check if we have to return the full calendar data or just the etag's
|
||
|
if (!($address_data = $options['props'] == 'all' && $options['root']['ns'] == groupdav::CARDDAV))
|
||
|
{
|
||
|
foreach($options['props'] as $prop)
|
||
|
{
|
||
|
if ($prop['name'] == 'address-data')
|
||
|
{
|
||
|
$address_data = true;
|
||
|
break;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
if ($address_data)
|
||
|
{
|
||
|
$handler = self::_get_handler();
|
||
|
}
|
||
|
if (($contacts =& $this->bo->search(array(),$address_data ? false : array('id','modified','etag'),'contact_id','','',False,'AND',false,$filter)))
|
||
|
{
|
||
|
foreach($contacts as $contact)
|
||
|
{
|
||
|
$props = array(
|
||
|
HTTP_WebDAV_Server::mkprop('getetag',$this->get_etag($contact)),
|
||
|
HTTP_WebDAV_Server::mkprop('getcontenttype', 'text/x-vcard'),
|
||
|
);
|
||
|
if ($address_data)
|
||
|
{
|
||
|
$props[] = HTTP_WebDAV_Server::mkprop(groupdav::CARDDAV,'address-data',$handler->getVCard($contact,$this->charset));
|
||
|
}
|
||
|
$files['files'][] = array(
|
||
|
'path' => '/addressbook/'.$contact['id'],
|
||
|
'props' => $props,
|
||
|
);
|
||
|
}
|
||
|
}
|
||
|
return true;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Process the filters from the CalDAV REPORT request
|
||
|
*
|
||
|
* @param array $options
|
||
|
* @param array &$cal_filters
|
||
|
* @param string $id
|
||
|
* @return boolean true if filter could be processed, false for requesting not here supported VTODO items
|
||
|
*/
|
||
|
function _report_filters($options,&$filters,$id)
|
||
|
{
|
||
|
if ($options['filters'])
|
||
|
{
|
||
|
foreach($options['filters'] as $filter)
|
||
|
{
|
||
|
switch($filter['name'])
|
||
|
{
|
||
|
case 'comp-filter':
|
||
|
error_log(__METHOD__."($path,...) comp-filter='{$filter['attrs']['name']}'");
|
||
|
switch($filter['attrs']['name'])
|
||
|
{
|
||
|
}
|
||
|
break;
|
||
|
case 'prop-filter':
|
||
|
error_log(__METHOD__."($path,...) prop-filter='{$filter['attrs']['name']}'");
|
||
|
$prop_filter = $filter['attrs']['name'];
|
||
|
break;
|
||
|
case 'text-match':
|
||
|
error_log(__METHOD__."($path,...) text-match: $prop_filter='{$filter['data']}'");
|
||
|
if (!isset($this->filter_prop2cal[strtoupper($prop_filter)]))
|
||
|
{
|
||
|
error_log(__METHOD__."($path,".str_replace(array("\n",' '),'',print_r($options,true)).",,$user) unknown property '$prop_filter' --> ignored");
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
switch($filter['attrs']['match-type'])
|
||
|
{
|
||
|
default:
|
||
|
case 'equals':
|
||
|
$filters[$this->filter_prop2cal[strtoupper($prop_filter)]] = $filter['data'];
|
||
|
break;
|
||
|
case 'substr': // ToDo: check RFC4790
|
||
|
$filters[] = $this->filter_prop2cal[strtoupper($prop_filter)].' LIKE '.$GLOBALS['egw']->db->quote($filter['data']);
|
||
|
break;
|
||
|
}
|
||
|
}
|
||
|
unset($prop_filter);
|
||
|
break;
|
||
|
case 'param-filter':
|
||
|
error_log(__METHOD__."($path,...) param-filter='{$filter['attrs']['name']}'");
|
||
|
break;
|
||
|
default:
|
||
|
error_log(__METHOD__."($path,".str_replace(array("\n",' '),'',print_r($options,true)).",,$user) unknown filter --> ignored");
|
||
|
break;
|
||
|
}
|
||
|
}
|
||
|
}
|
||
|
// multiget --> fetch the url's
|
||
|
if ($options['root']['name'] == 'addressbook-multiget')
|
||
|
{
|
||
|
$ids = array();
|
||
|
foreach($options['other'] as $option)
|
||
|
{
|
||
|
if ($option['name'] == 'href')
|
||
|
{
|
||
|
$parts = explode('/',$option['data']);
|
||
|
if (is_numeric($id = array_pop($parts))) $ids[] = $id;
|
||
|
}
|
||
|
}
|
||
|
$filters['id'] = $ids;
|
||
|
//error_log(__METHOD__."($path,,,$user) addressbook-multiget: ids=".implode(',',$ids));
|
||
|
}
|
||
|
elseif ($id)
|
||
|
{
|
||
|
if (is_numeric($id))
|
||
|
{
|
||
|
$filters['id'] = $id;
|
||
|
}
|
||
|
else
|
||
|
{
|
||
|
$filters['uid'] = basename($id,'.vcf');
|
||
|
}
|
||
|
}
|
||
|
return true;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Handle get request for an event
|
||
|
*
|
||
|
* @param array &$options
|
||
|
* @param int $id
|
||
|
* @return mixed boolean true on success, false on failure or string with http status (eg. '404 Not Found')
|
||
|
*/
|
||
|
function get(&$options,$id)
|
||
|
{
|
||
|
if (!is_array($contact = $this->_common_get_put_delete('GET',$options,$id)))
|
||
|
{
|
||
|
return $contact;
|
||
|
}
|
||
|
$handler = self::_get_handler();
|
||
|
$options['data'] = $handler->getVCard($id,$this->charset);
|
||
|
$options['mimetype'] = 'text/x-vcard; charset='.$this->charset;
|
||
|
header('Content-Encoding: identity');
|
||
|
header('ETag: '.$this->get_etag($contact));
|
||
|
return true;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Handle put request for an event
|
||
|
*
|
||
|
* @param array &$options
|
||
|
* @param int $id
|
||
|
* @param int $user=null account_id of owner, default null
|
||
|
* @return mixed boolean true on success, false on failure or string with http status (eg. '404 Not Found')
|
||
|
*/
|
||
|
function put(&$options,$id,$user=null)
|
||
|
{
|
||
|
$ok = $this->_common_get_put_delete('PUT',$options,$id);
|
||
|
if (!is_null($ok) && !is_array($ok))
|
||
|
{
|
||
|
return $ok;
|
||
|
}
|
||
|
$handler = self::_get_handler();
|
||
|
$contact = $handler->vcardtoegw($options['content']);
|
||
|
if (!is_null($ok))
|
||
|
{
|
||
|
$contact['id'] = $id;
|
||
|
}
|
||
|
// SoGo does not set the uid attribut, but uses it as id
|
||
|
elseif (strlen($id) > 10 && !$contact['uid'])
|
||
|
{
|
||
|
$contact['uid'] = basename($id,'.vcf');
|
||
|
}
|
||
|
$contact['etag'] = self::etag2value($this->http_if_match);
|
||
|
|
||
|
if (!($ok = $this->bo->save($contact)))
|
||
|
{
|
||
|
if ($ok === 0)
|
||
|
{
|
||
|
return '412 Precondition Failed';
|
||
|
}
|
||
|
return false;
|
||
|
}
|
||
|
|
||
|
header('ETag: '.$this->get_etag($contact));
|
||
|
if (is_null($ok))
|
||
|
{
|
||
|
header($h='Location: '.$this->base_uri.'/addressbook/'.$contact['id']);
|
||
|
error_log(__METHOD__."($method,,$id) header('$h'): 201 Created");
|
||
|
return '201 Created';
|
||
|
}
|
||
|
return true;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Get the handler and set the supported fields
|
||
|
*
|
||
|
* @return vcaladdressbook
|
||
|
*/
|
||
|
private function _get_handler()
|
||
|
{
|
||
|
include_once(EGW_INCLUDE_ROOT.'/addressbook/inc/class.vcaladdressbook.inc.php');
|
||
|
$handler =& new vcaladdressbook();
|
||
|
if (strpos($_SERVER['HTTP_USER_AGENT'],'KHTML') !== false)
|
||
|
{
|
||
|
$handler->setSupportedFields('KDE');
|
||
|
}
|
||
|
return $handler;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Handle delete request for an event
|
||
|
*
|
||
|
* @param array &$options
|
||
|
* @param int $id
|
||
|
* @return mixed boolean true on success, false on failure or string with http status (eg. '404 Not Found')
|
||
|
*/
|
||
|
function delete(&$options,$id)
|
||
|
{
|
||
|
if (!is_array($event = $this->_common_get_put_delete('DELETE',$options,$id)))
|
||
|
{
|
||
|
return $event;
|
||
|
}
|
||
|
if ($this->bo->delete($id,self::etag2value($this->http_if_match)) === 0)
|
||
|
{
|
||
|
return '412 Precondition Failed';
|
||
|
}
|
||
|
return $ok;
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Read a contact
|
||
|
*
|
||
|
* @param string/id $id
|
||
|
* @return array/boolean array with entry, false if no read rights, null if $id does not exist
|
||
|
*/
|
||
|
function read($id)
|
||
|
{
|
||
|
return $this->bo->read($id);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Check if user has the neccessary rights on a contact
|
||
|
*
|
||
|
* @param int $acl EGW_ACL_READ, EGW_ACL_EDIT or EGW_ACL_DELETE
|
||
|
* @param array/int $contact contact-array or id
|
||
|
* @return boolean null if entry does not exist, false if no access, true if access permitted
|
||
|
*/
|
||
|
function check_access($acl,$contact)
|
||
|
{
|
||
|
return $this->bo->check_perms($acl,$contact);
|
||
|
}
|
||
|
}
|