* * and Bettina Gille [ceb@phpgroupware.org] * * Category manager * * Copyright (C) 2000, 2001 Joseph Engo, Bettina Gille * * Copyright (C) 2002, 2003 Bettina Gille * * ------------------------------------------------------------------------ * * This library is part of the phpGroupWare API * * http://www.phpgroupware.org * * ------------------------------------------------------------------------ * * This library is free software; you can redistribute it and/or modify it * * under the terms of the GNU Lesser General Public License as published by * * the Free Software Foundation; either version 2.1 of the License, * * or any later version. * * This library is distributed in the hope that it will be useful, but * * WITHOUT ANY WARRANTY; without even the implied warranty of * * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * * See the GNU Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * * along with this library; if not, write to the Free Software Foundation, * * Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA * \**************************************************************************/ /* $Id$ */ /*! @class categories @abstract class adds ability for applications to make use of categories @discussion examples can be found in notes app */ class categories { var $account_id; var $app_name; var $cats; var $db; var $total_records; var $grants; /*! @function categories @abstract constructor for categories class @param $accountid account id @param $app_name app name defaults to current app */ function categories($accountid = '',$app_name = '') { $account_id = get_account_id($accountid); if (!$app_name) { $app_name = $GLOBALS['phpgw_info']['flags']['currentapp']; } $this->account_id = $account_id; $this->app_name = $app_name; $this->db = $GLOBALS['phpgw']->db; $this->db2 = $this->db; $this->grants = $GLOBALS['phpgw']->acl->get_grants($app_name); } /*! @function filter @abstract ? @param $type string @result string either subs or mains */ function filter($type) { switch ($type) { case 'subs': $s = ' AND cat_parent != 0'; break; case 'mains': $s = ' AND cat_parent = 0'; break; case 'appandmains': $s = " AND cat_appname='" . $this->app_name . "' AND cat_parent =0"; break; case 'appandsubs': $s = " AND cat_appname='" . $this->app_name . "' AND cat_parent !=0"; break; case 'noglobal': $s = " AND cat_appname != '" . $this->app_name . "'"; break; case 'noglobalapp': $s = " AND cat_appname = '" . $this->app_name . "' AND cat_owner != " . $this->account_id; break; default: return False; } return $s; } /*! @function total @abstract returns the total number of categories for app, subs or mains @param $for one of either 'app' 'subs' or 'mains' @result integer count of categories */ function total($for = 'app') { switch($for) { case 'app': $w = " WHERE cat_appname='" . $this->app_name . "'"; break; case 'appandmains': $w = " WHERE cat_appname='" . $this->app_name . "' AND cat_parent =0"; break; case 'appandsubs': $w = " WHERE cat_appname='" . $this->app_name . "' AND cat_parent !=0"; break; case 'subs': $w = " WHERE cat_parent != 0"; break; case 'mains': $w = " WHERE cat_parent = 0"; break; default: return False; } $this->db->query("SELECT COUNT(cat_id) FROM phpgw_categories $w",__LINE__,__FILE__); $this->db->next_record(); return $this->db->f(0); } function db2cats() { while ($this->db->next_record()) { $cats[] = array ( 'cat_id' => $this->db->f('cat_id'), 'owner' => $this->db->f('cat_owner'), 'access' => $this->db->f('cat_access'), 'app_name' => $this->db->f('cat_appname'), 'main' => $this->db->f('cat_main'), 'level' => $this->db->f('cat_level'), 'parent' => $this->db->f('cat_parent'), 'name' => $this->db->f('cat_name'), 'descr' => $this->db->f('cat_description'), 'data' => $this->db->f('cat_data'), 'last_mod' => $this->db->f('last_mod') ); } return $cats; } /*! @function return_array @abstract return an array populated with categories @param $type string defaults to 'all' @param $start ? @param $limit ? @param $query string defaults to '' @param $sort string sort order, either defaults to 'ASC' @param $order order by @param $globals True or False, includes the global phpgroupware categories or not @result $cats array */ function return_array($type,$start,$limit = True,$query = '',$sort = '',$order = '',$globals = False, $parent_id = '',$lastmod = -1,$column = '') { $start = intval($start); $parent_id = intval($parent_id); $query = $this->db->db_addslashes($query); if ($globals) { $global_cats = " OR cat_appname='phpgw'"; } $filter = $this->filter($type); if (!$sort) { $sort = 'ASC'; } if ($order) { $ordermethod = " ORDER BY $order $sort"; } else { $ordermethod = ' ORDER BY cat_main, cat_level, cat_name ASC'; } if ($this->account_id == -1) { $grant_cats = ' cat_owner=-1 '; } else { if (is_array($this->grants)) { $grants = $this->grants; while(list($user) = each($grants)) { $public_user_list[] = $user; } reset($public_user_list); $grant_cats = ' (cat_owner=' . $this->account_id . " OR cat_owner=-1 OR cat_access='public' AND cat_owner in(" . implode(',',$public_user_list) . ')) '; } else { $grant_cats = ' cat_owner=' . $this->account_id . ' OR cat_owner=-1 '; } } if ($parent_id > 0) { $parent_filter = ' AND cat_parent=' . $parent_id; } if ($query) { $querymethod = " AND (cat_name LIKE '%$query%' OR cat_description LIKE '%$query%')"; } if($lastmod && $lastmod >= 0) { $querymethod .= ' AND last_mod > ' . $lastmod; } if ($column) { switch($column) { case 'cat_id': $table_column = ' cat_id '; break; case 'owner': $table_column = ' cat_owner '; break; case 'access': $table_column = ' cat_access '; break; case 'app_name': $table_column = ' cat_appname '; break; case 'main': $table_column = ' cat_main '; break; case 'parent': $table_column = ' cat_parent '; break; case 'name': $table_column = ' cat_name '; break; case 'descr': $table_column = ' cat_description '; break; case 'data': $table_column = ' cat_data '; break; case 'last_mod': $table_column = ' last_mod '; break; default: $table_column = ' cat_id '; break; } } else { $table_column = ' * '; } $sql = "SELECT $table_column from phpgw_categories WHERE (cat_appname='" . $this->app_name . "' AND" . $grant_cats . $global_cats . ')' . $parent_filter . $querymethod . $filter; $this->db2->query($sql,__LINE__,__FILE__); $this->total_records = $this->db2->num_rows(); if ($limit) { $this->db->limit_query($sql . $ordermethod,$start,__LINE__,__FILE__); } else { $this->db->query($sql . $ordermethod,__LINE__,__FILE__); } if ($column) { while ($this->db->next_record()) { $cats[] = array ( "$column" => $this->db->f(0) ); } } else { return $this->db2cats(); } } function return_sorted_array($start,$limit = True,$query = '',$sort = '',$order = '',$globals = False, $parent_id = '') { $start = intval($start); $parent_id = intval($parent_id); $query = $this->db->db_addslashes($query); if ($globals) { $global_cats = " OR cat_appname='phpgw'"; } if (!$sort) { $sort = 'ASC'; } if ($order) { $ordermethod = " ORDER BY $order $sort"; } else { $ordermethod = ' ORDER BY cat_name ASC'; } if ($this->account_id == '-1') { $grant_cats = ' cat_owner=-1 '; } else { if (is_array($this->grants)) { $grants = $this->grants; while(list($user) = each($grants)) { $public_user_list[] = $user; } reset($public_user_list); $grant_cats = " (cat_owner='" . $this->account_id . "' OR cat_owner='-1' OR cat_access='public' AND cat_owner in(" . implode(',',$public_user_list) . ")) "; } else { $grant_cats = " cat_owner='" . $this->account_id . "' or cat_owner='-1' "; } } $parent_select = ' AND cat_parent=' . $parent_id; if ($query) { $querymethod = " AND (cat_name LIKE '%$query%' OR cat_description LIKE '%$query%') "; } $sql = "SELECT * from phpgw_categories WHERE (cat_appname='" . $this->app_name . "' AND" . $grant_cats . $global_cats . ")" . $querymethod; $this->db2->query($sql . $parent_select,__LINE__,__FILE__); //$total_mains = $this->db2->num_rows(); $this->total_records = $this->db2->num_rows(); if ($limit) { $this->db->limit_query($sql . $parent_select . $ordermethod,$start,__LINE__,__FILE__); } else { $this->db->query($sql . $parent_select . $ordermethod,__LINE__,__FILE__); } $cats = $this->db2cats(); $num_cats = count($cats); for ($i=0;$i < $num_cats;$i++) { $sub_select = ' AND cat_parent=' . $cats[$i]['cat_id'] . ' AND cat_level=' . ($cats[$i]['level']+1); /*$this->db2->query($sql . $sub_select,__LINE__,__FILE__); $total_subs += $this->db2->num_rows(); if ($limit) { $this->db->limit_query($sql . $sub_select . $ordermethod,$start,__LINE__,__FILE__); } else {*/ $this->db->query($sql . $sub_select . $ordermethod,__LINE__,__FILE__); //} $subcats = $this->db2cats(); $num_subcats = count($subcats); if ($num_subcats != 0) { $newcats = array(); for ($k = 0; $k <= $i; $k++) { $newcats[$k] = $cats[$k]; } for ($k = 0; $k < $num_subcats; $k++) { $newcats[$k+$i+1] = $subcats[$k]; } for ($k = $i+1; $k < $num_cats; $k++) { $newcats[$k+$num_subcats] = $cats[$k]; } $cats = $newcats; $num_cats = count($cats); } } //$this->total_records = count($cats); //$this->total_records = $total_mains + $total_subs; return $cats; } /*! @function return_single @abstract return single @param $id integer id of category @result $cats array populated with */ function return_single($cat_id = '') { $this->db->query('SELECT * FROM phpgw_categories WHERE cat_id=' . intval($cat_id),__LINE__,__FILE__); list($cat) = $this->db2cats(); return $cat; } /*! @function formatted_list @abstract return into a select box, list or other formats @param $format currently only supports select (select box) @param $type string - subs or mains @param $selected - cat_id or array with cat_id values @param $globals True or False, includes the global phpgroupware categories or not @result $s array - populated with categories */ function formatted_list($format,$type = 'all',$selected = '',$globals = True,$site_link = 'site',$self = '') { if(is_array($format)) { $temp_format = $format['format']; $type = (isset($format['type'])?$format['type']:'all'); $selected = (isset($format['selected'])?$format['selected']:''); $self = (isset($format['self'])?$format['self']:''); $globals = (isset($format['globals'])?$format['globals']:True); $site_link = (isset($format['site_link'])?$format['site_link']:'site'); settype($format,'string'); $format = ($temp_format?$temp_format:'select'); unset($temp_format); } if (!is_array($selected)) { $selected = explode(',',$selected); } if ($type != 'all') { $cats = $this->return_array($type,$start,False,$query,$sort,$order,$globals); } else { $cats = $this->return_sorted_array($start,False,$query,$sort,$order,$globals); } if($self) { for ($i=0;$istrip_html($cat['name']); if ($cat['app_name'] == 'phpgw') { $s .= ' <' . lang('Global') . '>'; } if ($cat['owner'] == '-1') { $s .= ' <' . lang('Global') . ' ' . lang($this->app_name) . '>'; } $s .= '' . "\n"; } return $s; } if ($format == 'list') { $space = '  '; $s = '' . "\n"; if ($this->total_records > 0) { for ($i=0;$icommon->image('phpgwapi','roter_pfeil') . '">'; } if (($cats[$i]['level'] == 0) && !in_array($cats[$i]['cat_id'],$selected)) { $image_set = ''; } $space_set = str_repeat($space,$cats[$i]['level']); $s .= '' . "\n"; $s .= '' . "\n"; $s .= '' . "\n" . '' . "\n"; } } $s .= '
' . $image_set . '' . $space_set . '' . $GLOBALS['phpgw']->strip_html($cats[$i]['name']) . '
' . "\n"; return $s; } } function formatted_xslt_list($data) { if(is_array($data)) { $format = (isset($data['format'])?$data['format']:'filter'); $type = (isset($data['type'])?$data['type']:'all'); $selected = (isset($data['selected'])?$data['selected']:''); $self = (isset($data['self'])?$data['self']:''); $globals = (isset($data['globals'])?$data['globals']:True); } if (!is_array($selected)) { $selected = explode(',',$selected); } if ($type != 'all') { $cats = $this->return_array($type,$start,False,$query,$sort,$order,$globals); } else { $cats = $this->return_sorted_array($start,False,$query,$sort,$order,$globals); } switch($format) { case 'select': $GLOBALS['phpgw']->xslttpl->add_file($GLOBALS['phpgw']->common->get_tpl_dir('phpgwapi','default') . SEP . 'cat_select'); break; case 'filter': $GLOBALS['phpgw']->xslttpl->add_file($GLOBALS['phpgw']->common->get_tpl_dir('phpgwapi','default') . SEP . 'cat_filter'); break; } if($self) { for ($i=0;$istrip_html($cat['name']); if ($cat['app_name'] == 'phpgw') { $name .= ' <' . lang('Global') . '>'; } if ($cat['owner'] == '-1') { $name .= ' <' . lang('Global') . ' ' . lang($this->app_name) . '>'; } $cat_list[] = array ( 'cat_id' => $cat['cat_id'], 'name' => $name, 'selected' => $sel_cat ); } return $cat_list; } /*! @function add @abstract add categories @param $cat_name category name @param $cat_parent category parent @param $cat_description category description defaults to '' @param $cat_data category data defaults to '' */ function add($values) { if ($values['parent'] && $values['parent'] != 0) { $values['main'] = intval($this->id2item(array('cat_id' => $values['parent'],'item' => 'main'))); $values['level'] = intval($this->id2item(array('cat_id' => $values['parent'],'item' => 'level'))+1); } $values['descr'] = $this->db->db_addslashes($values['descr']); $values['name'] = $this->db->db_addslashes($values['name']); if (isset($values['cat_id'])) { $id_col = 'cat_id,'; $id_val = $values['cat_id'].','; } $this->db->query("INSERT INTO phpgw_categories (${id_col}cat_parent,cat_owner,cat_access,cat_appname,cat_name,cat_description,cat_data," . "cat_main,cat_level,last_mod) VALUES ($id_val" . intval($values['parent']) . "," . $this->account_id . ",'" . $values['access'] . "','" . $this->app_name . "','" . $values['name'] . "','" . $values['descr'] . "','" . $values['data'] . "'," . $values['main'] . "," . $values['level'] . "," . time() . ")",__LINE__,__FILE__); $max = $this->db->get_last_insert_id('phpgw_categories','cat_id'); if (!$values['parent'] || $values['parent'] == 0) { $this->db->query("UPDATE phpgw_categories SET cat_main=" . $max . " WHERE cat_id=" . $max,__LINE__,__FILE__); } return $max; } /*! @function delete @abstract delete category @param $cat_id int - category id */ function delete($data) { if(is_array($data)) { $cat_id = $data['cat_id']; $drop_subs = (isset($data['drop_subs'])?$data['drop_subs']:False); $modify_subs = (isset($data['modify_subs'])?$data['modify_subs']:False); } if ($cat_id > 0) { if ($drop_subs) { $subdelete = ' OR cat_parent=' . $cat_id . ' OR cat_main=' . $cat_id; } if ($modify_subs) { $cats = $this->return_sorted_array('',False,'','','',False, $cat_id); $new_parent = $this->id2item(array('cat_id' => $cat_id,'item' => 'parent')); for ($i=0;$idb->query('UPDATE phpgw_categories set cat_level=0, cat_parent=0, cat_main=' . intval($cats[$i]['cat_id']) . ' WHERE cat_id=' . intval($cats[$i]['cat_id']) . "' AND cat_appname='" . $this->app_name . "'",__LINE__,__FILE__); $new_main = $cats[$i]['cat_id']; } else { if ($new_main) { $update_main = ',cat_main=' . $new_main; } if ($cats[$i]['parent'] == $cat_id) { $update_parent = ',cat_parent=' . $new_parent; } $this->db->query('UPDATE phpgw_categories set cat_level=' . ($cats[$i]['level']-1) . $update_main . $update_parent . ' WHERE cat_id=' . intval($cats[$i]['cat_id']) . "' AND cat_appname='" . $this->app_name . "'",__LINE__,__FILE__); } } } $this->db->query('DELETE FROM phpgw_categories WHERE cat_id=' . $cat_id . $subdelete . "' AND cat_appname='" . $this->app_name . "'",__LINE__,__FILE__); } } function subs($parent,&$subs,&$main) { if (!is_array($main)) { $this->db->query('SELECT * from phpgw_categories WHERE cat_main=' . $main,__LINE__,__FILE__); $main = $this->db2cats(); //echo "main: "; _debug_array($main); } reset($main); for ($n = 0; $n < count($main); $n++) { $cat = $main[$n]; if ($cat['parent'] == $parent) { //echo "Adding($cat[cat_id])
"; $subs[$cat['cat_id']] = $cat; $this->subs($cat['cat_id'],$subs,$main); } } } function reparent($values) { $id = $values['cat_id']; $parent = $values['parent']; $old_parent = $values['old_parent']; $main = $old_parent ? intval($this->id2name($old_parent,'main')) : $id; //echo "

reparent: $id/$main: $old_parent --> $parent

\n"; $subs = array(); $this->subs($id,$subs,$main); //echo "

subs($id) = "; _debug_array($subs); if (isset($subs[$parent])) { //echo "

new parent $parent is sub of $id

\n"; $parent = $subs[$parent]; $parent['old_parent'] = $parent['parent']; $parent['parent'] = intval($values['old_parent']); $this->reparent($parent); unset($parent['old_parent']); unset($parent['main']); $this->edit($parent); $this->reparent($values); return; } $new_main = $parent ? $this->id2name($parent,'main') : $id; $new_parent_level = $parent ? $this->id2name($parent,'level') : -1; $old_parent_level = $old_parent ? $this->id2name($old_parent,'level') : -1; $level_adj = $old_parent_level - $new_parent_level; reset($subs); //echo "new_main=$new_main,level_adj = $level_adj
"; while (list($n) = each($subs)) { $subs[$n]['main'] = $new_main; $subs[$n]['level'] -= $level_adj; //echo "

$n: id=".$subs[$n]['cat_id']." set main to $new_main, subs[$n] = \n"; _debug_array($subs[$n]); $this->edit($subs[$n]); } } /*! @function edit @abstract edit a category @param $cat_id int - category id @param $cat_parent category parent @param $cat_description category description defaults to '' @param $cat_data category data defaults to '' */ function edit($values) { if (isset($values['old_parent']) && $values['old_parent'] != $values['parent']) { //$this->delete(array('cat_id' => $values['cat_id'],'drop_subs' => False,'modify_subs' => True)); //return $this->add($values); $this->reparent($values); } if (!isset($values['main']) || !isset($values['level'])) { if ($values['parent'] && ($values['parent'] != 0)) { $values['main'] = intval($this->id2item(array('cat_id' => $values['parent'],'item' => 'main'))); $values['level'] = intval($this->id2item(array('cat_id' => $values['parent'],'item' => 'level'))+1); } else { $values['main'] = intval($values['cat_id']); $values['parent'] = $values['level'] = 0; // parent need to be set to 0, as it can be '' } } $values['descr'] = $this->db->db_addslashes($values['descr']); $values['name'] = $this->db->db_addslashes($values['name']); $sql = "UPDATE phpgw_categories SET cat_name='" . $values['name'] . "', cat_description='" . $values['descr'] . "', cat_data='" . $values['data'] . "', cat_parent=" . intval($values['parent']) . ", cat_access='" . $values['access'] . "', cat_main=" . $values['main'] . ", cat_level=" . $values['level'] . ", last_mod=" . time() . " WHERE cat_appname='" . $this->app_name . "' AND cat_id=" . intval($values['cat_id']); $this->db->query($sql,__LINE__,__FILE__); return intval($values['cat_id']); } function name2id($cat_name) { $this->db->query("SELECT cat_id FROM phpgw_categories WHERE cat_name='" . $this->db->db_addslashes($cat_name) . "' " ."AND cat_appname='" . $this->app_name . "' AND (cat_owner=" . $this->account_id ." OR cat_owner=-1)",__LINE__,__FILE__); if(!$this->db->num_rows()) { return 0; } $this->db->next_record(); return $this->db->f('cat_id'); } function id2name($cat_id = '', $item = 'name') { return $this->id2item(array('cat_id' => $cat_id,'item' => $item)); } function id2item($data) { if(is_array($data)) { $cat_id = $data['cat_id']; $item = (isset($data['item'])?$data['item']:'name'); } if ($cat_id == '') { return '--'; } switch($item) { case 'name': $value = 'cat_name'; break; case 'owner': $value = 'cat_owner'; break; case 'main': $value = 'cat_main'; break; case 'level': $value = 'cat_level'; break; case 'data': $value = 'cat_data'; break; case 'parent': $value = 'cat_parent'; break; } $this->db->query("SELECT $value FROM phpgw_categories WHERE cat_id=" . $cat_id,__LINE__,__FILE__); $this->db->next_record(); if ($this->db->f($value)) { return $this->db->f($value); } else { if ($item == 'name') { return '--'; } } } /*! @function exists @abstract used for checking if a category name exists @param $type subs or mains @param $cat_name category name @result boolean true or false */ function exists($type,$cat_name = '',$cat_id = '') { if(is_array($type)) { $temp_type = $type['type']; $cat_name = $type['cat_name'] ? $type['cat_name'] : ''; $cat_id = $type['cat_id'] ? $type['cat_id'] : ''; settype($type,'string'); $type = $temp_type; unset($temp_type); } $filter = $this->filter($type); if ($cat_name) { $cat_exists = " cat_name='" . $this->db->db_addslashes($cat_name) . "' "; } if ($cat_id) { $cat_exists = ' cat_parent=' . $cat_id; } if ($cat_name && $cat_id) { $cat_exists = " cat_name='" . $this->db->db_addslashes($cat_name) . "' AND cat_id != " . $cat_id; } $this->db->query("SELECT COUNT(cat_id) FROM phpgw_categories WHERE $cat_exists $filter",__LINE__,__FILE__); $this->db->next_record(); if ($this->db->f(0)) { return True; } else { return False; } } } ?>