* * and Bettina Gille [ceb@phpgroupware.org] * * Handles limiting number of rows displayed * * Copyright (C) 2000, 2001 Joseph Engo * * Copyright (C) 2002, 2003 Joseph Engo, 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$ */ /* $Source$ */ /*! @class nextmatchs @abstract */ class nextmatchs { var $maxmatches; var $action; var $template; var $extra_filters = array(); function nextmatchs($website=False) { if(!$website) { $this->template = createobject('phpgwapi.Template',PHPGW_TEMPLATE_DIR); $this->template->set_file(array( '_nextmatchs' => 'nextmatchs.tpl' )); $this->template->set_block('_nextmatchs','nextmatchs'); $this->template->set_block('_nextmatchs','filter'); $this->template->set_block('_nextmatchs','form'); $this->template->set_block('_nextmatchs','icon'); $this->template->set_block('_nextmatchs','link'); $this->template->set_block('_nextmatchs','search'); $this->template->set_block('_nextmatchs','cats'); $this->template->set_block('_nextmatchs','search_filter'); $this->template->set_block('_nextmatchs','cats_search_filter'); } if(isset($GLOBALS['phpgw_info']['user']['preferences']['common']['maxmatchs']) && intval($GLOBALS['phpgw_info']['user']['preferences']['common']['maxmatchs']) > 0) { $this->maxmatches = intval($GLOBALS['phpgw_info']['user']['preferences']['common']['maxmatchs']); } else { $this->maxmatches = 15; } if(isset($GLOBALS['HTTP_GET_VARS']['menuaction'])) { $this->action = $GLOBALS['HTTP_GET_VARS']['menuaction']; } } /*! @function get_var @abstract Fetch commonly-used GP(C) vars @discussion This calls get_var() from functions.inc.php */ function get_var() { return array( get_var('filter',array('GLOBAL','POST','GET')), get_var('qfield',array('GLOBAL','POST','GET')), get_var('start',array('GLOBAL','POST','GET')), get_var('order',array('GLOBAL','POST','GET')), get_var('sort',array('GLOBAL','POST','GET')) ); } /*! @function set_icon @abstract ? @param $align ? @param $img_src ? @param $label ? */ function set_icon($align,$img,$label) { switch(strtolower($GLOBALS['phpgw_info']['user']['account_lid'])) { case 'ceb': $border = 2; break; default: $border = 0; break; } $var = array( 'align' => $align, 'img' => $GLOBALS['phpgw']->common->image('phpgwapi',$img), 'label' => lang($label), 'border' => $border ); $this->template->set_var($var); return $this->template->fp('out','link'); } /*! @function page @abstract ? */ function page($extravars='') { if($extravars && is_string($extravars) && substr($extravars,0,1)!='&') { $extras = '&'.$extravars; } elseif($extravars && is_array($extravars)) { @reset($extravars); while(list($var,$value) = each($extravars)) { if($var != 'menuaction') { $t_extras[] = $var.'='.$value; } } $extras = implode($t_extras,'&'); } return $GLOBALS['phpgw']->link('/index.php','menuaction='.$this->action.$extras); } /*! @function set_link @abstract ? @param $img_src ? @param $label ? @param $link ? @param $extravars ? */ function set_link($align,$img,$link,$alt,$extravars) { $hidden = ''; while(list($var,$value) = each($extravars)) { if((is_int($value) && $value == 0) || $value) { // if(is_int($value)) // { // $param = intval($value); // } // else // { $param = '"'.$value.'"'; // } $hidden .= ' '."\n"; } } $border = 0; $var = Array( 'align' => $align, 'action' => ($this->action?$this->page():$GLOBALS['phpgw']->link($link)), 'form_name' => $img, 'hidden' => substr($hidden,0,strlen($hidden)-1), 'img' => $GLOBALS['phpgw']->common->image('phpgwapi',$img), 'label' => $alt, 'border' => $border, 'start' => $extravars['start'] ); $this->template->set_var($var); return $this->template->fp('out','form'); } /*! @function show_tpl @abstract ? @param $sn ? @param $start ? @param $total ? @param $extra ? @param $twidth ? @param $bgtheme ? @param $search_obj ? @param $filter_obj ? @param $showsearch ? */ function show_tpl($sn,$localstart,$total,$extra, $twidth, $bgtheme,$search_obj=0,$filter_obj=1,$showsearch=1,$yours=0,$cat_id=0,$cat_field='fcat_id') { list($filter,$qfield,$start,$order,$sort) = $this->get_var(); $start = $localstart; $cats = CreateObject('phpgwapi.categories'); $extravars = Array(); $extravars = $this->split_extras($extravars,$extra); $var = array( 'form_action' => ($this->action?$this->page($extra):$GLOBALS['phpgw']->link($sn, $extra)), 'lang_category' => lang('Category'), 'lang_all' => lang('All'), 'lang_select' => lang('Select'), 'cat_field' => $cat_field, 'categories' => $cats->formated_list('select','all',$cat_id,'True'), 'filter_value' => $filter, 'qfield' => $qfield, 'start_value' => $start, 'order_value' => $order, 'sort_value' => $sort, 'query_value' => urlencode(stripslashes($GLOBALS['query'])), 'table_width' => $twidth, 'th_bg' => $GLOBALS['phpgw_info']['theme']['th_bg'], 'left' => $this->left($sn,$start,$total,$extra), 'search' => ($showsearch?$this->search($search_obj):''), 'filter' => ($filter_obj?$this->filter($filter_obj,$yours):''), 'right' => $this->right($sn,$start,$total,$extra) ); $this->template->set_var($var); $this->template->parse('cats','cats'); $this->template->parse('cats_search_filter_data','cats_search_filter'); return $this->template->fp('out','nextmatchs'); } function split_extras($extravars,$extradata) { if($extradata) { if(is_string($extradata)) { $extraparams = explode('&',$extradata); $c_extraparams = count($extraparams) + 1; for($i=0;$i<$c_extraparams;$i++) { if($extraparams[$i]) { list($var,$value) = explode('=',$extraparams[$i]); if($var != 'menuaction') { $extravars[$var] = $value; } else { $this->action = $value; } } } } elseif(is_array($extradata)) { while(list($var,$value) = each($extradata)) { if($var != 'menuaction') { $extravars[$var] = $value; } else { $this->action = $value; } } } } return $extravars; } function extras_to_string($extra) { if(is_array($extra)) { @reset($extra); while(list($var,$value) = each($extra)) { $t_extras[] = $var . '=' . $value; } $extra_s = '&' . implode('&',$t_extras); } return $extra_s; } /*! @function left @abstract ? @param $scriptname ? @param $start ? @param $total ? @param $extradate ? */ function left($scriptname,$start,$total,$extradata = '') { list($filter,$qfield,,$order,$sort) = $this->get_var(); $extravars = Array( 'order' => $order, 'filter' => $filter, 'q_field' => $qfield, 'sort' => $sort, 'query' => urlencode(stripslashes($GLOBALS['query'])) ); $extravars = $this->split_extras($extravars,$extradata); $ret_str = ''; if (($start != 0) && ($start > $this->maxmatches)) { $extravars['start'] = 0; $ret_str .= $this->set_link('left','first.png',$scriptname,lang('First page'),$extravars); } else { $ret_str .= $this->set_icon('left','first-grey.png',lang('First page')); } if ($start != 0) { // Changing the sorting order screaws up the starting number if (($start - $this->maxmatches) < 0) { $extravars['start'] = 0; } else { $extravars['start'] = ($start - $this->maxmatches); } $ret_str .= $this->set_link('left','left.png',$scriptname,lang('Previous page'),$extravars); } else { $ret_str .= $this->set_icon('left','left-grey.png',lang('Previous page')); } return $ret_str; } /* left() */ /*! @function right @abstract ? @param $scriptname ? @param $start ? @param $total ? @param $extradate ? */ function right($scriptname,$start,$total,$extradata = '') { list($filter,$qfield,,$order,$sort) = $this->get_var(); $extravars = Array( 'order' => $order, 'filter' => $filter, 'q_field' => $qfield, 'sort' => $sort, 'query' => urlencode(stripslashes($GLOBALS['query'])) ); $extravars = $this->split_extras($extravars,$extradata); $ret_str = ''; if (($total > $this->maxmatches) && ($total > $start + $this->maxmatches)) { $extravars['start'] = ($start + $this->maxmatches); $ret_str .= $this->set_link('right','right.png',$scriptname,lang('Next page'),$extravars); } else { $ret_str .= $this->set_icon('right','right-grey.png',lang('Next page')); } if (($start != $total - $this->maxmatches) && (($total - $this->maxmatches) > ($start + $this->maxmatches))) { $extravars['start'] = ($total - $this->maxmatches); $ret_str .= $this->set_link('right','last.png',$scriptname,lang('Last page'),$extravars); } else { $ret_str .= $this->set_icon('right','last-grey.png',lang('Last page')); } return $ret_str; } /* right() */ /*! @function search_filter @abstract ? @param $search_obj default 0 */ function search_filter($search_obj=0,$filter_obj=1,$yours=0,$link='',$extra='') { list($filter,$qfield,$start,$order,$sort) = $this->get_var(); $start = $localstart; $var = array( 'form_action' => ($this->action?$this->page($extra):$GLOBALS['phpgw']->link($sn, $extra)), 'filter_value' => $filter, 'qfield' => $qfield, 'start_value' => $start, 'order_value' => $order, 'sort_value' => $sort, 'query_value' => urlencode(stripslashes($GLOBALS['query'])), 'th_bg' => $GLOBALS['phpgw_info']['theme']['th_bg'], 'search' => $this->search($search_obj), 'filter' => ($filter_obj?$this->filter($filter_obj,$yours):'') ); $this->template->set_var($var); return $this->template->fp('out','search_filter'); } /*! @function cats_search_filter @abstract ? @param $search_obj default 0 */ function cats_search_filter($search_obj=0,$filter_obj=1,$yours=0,$cat_id=0,$cat_field='fcat_id',$link='',$extra='') { list($filter,$qfield,$start,$order,$sort) = $this->get_var(); $start = $localstart; $cats = CreateObject('phpgwapi.categories'); $var = array( 'form_action' => ($this->action?$this->page($extra):$GLOBALS['phpgw']->link($sn, $extra)), 'lang_category' => lang('Category'), 'lang_all' => lang('All'), 'lang_select' => lang('Select'), 'cat_field' => $cat_field, 'categories' => $cats->formated_list('select','all',$cat_id,'True'), 'filter_value' => $filter, 'qfield' => $qfield, 'start_value' => $start, 'order_value' => $order, 'sort_value' => $sort, 'query_value' => urlencode(stripslashes($GLOBALS['query'])), 'th_bg' => $GLOBALS['phpgw_info']['theme']['th_bg'], 'search' => $this->search($search_obj), 'filter' => ($filter_obj?$this->filter($filter_obj,$yours):'') ); $this->template->set_var($var); return $this->template->fp('out','cats_search_filter'); } /*! @function search @abstract ? @param $search_obj default 0 */ function search($search_obj=0) { if(is_array($search_obj)) { $params = $search_obj; $s_query = stripslashes($params['query']); $search_obj = $params['search_obj']; } else { $_query = stripslashes($GLOBALS['query']); } // If the place a '"' in there search, it will mess everything up // Our only option is to remove it if (ereg('"',$_query)) { $_query = ereg_replace('"','',$_query); } $var = array ( 'query_value' => stripslashes($_query), 'lang_search' => lang('Search') ); if (is_array($search_obj)) { $var['searchby'] = $this->searchby($search_obj); } $this->template->set_var($var); return $this->template->fp('out','search'); } /* search() */ /*! @function filterobj @abstract ? @param $filtertable @param $indxfieldname ? @param $strfieldname ? */ function filterobj($filtertable, $idxfieldname, $strfieldname) { $filter_obj = array(array('none','show all')); $index = 0; $GLOBALS['phpgw']->db->query("SELECT $idxfieldname, $strfieldname FROM $filtertable",__LINE__,__FILE__); while($GLOBALS['phpgw']->db->next_record()) { $index++; $filter_obj[$index][0] = $GLOBALS['phpgw']->db->f($idxfieldname); $filter_obj[$index][1] = $GLOBALS['phpgw']->db->f($strfieldname); } return $filter_obj; } /* filterobj() */ /*! @function searchby @abstract ? @param $search_obj ? */ function searchby($search_obj) { $qfield = get_var('qfield',Array('GET','POST')); $str = ''; if (is_array($search_obj)) { $indexlimit = count($search_obj); for ($index=0; $index<$indexlimit; $index++) { if ($qfield == '') { $qfield = $search_obj[$index][0]; } $str .= ''; } $str = '' . "\n"; } return $str; } /* searchby() */ /*! @function filter @abstract ? @param $filter_obj */ function filter($filter_obj,$yours=0) { if (is_array($yours)) { $params = $yours; $filter = $params['filter']; $yours = $params['yours']; } else { $filter = $GLOBALS['HTTP_POST_VARS']['filter'] ? $GLOBALS['HTTP_POST_VARS']['filter'] : $GLOBALS['HTTP_GET_VARS']['filter']; } if (is_long($filter_obj)) { if ($filter_obj == 1) { // $user_groups = $GLOBALS['phpgw']->accounts->membership($GLOBALS['phpgw_info']['user']['account_id']); $indexlimit = count($user_groups); if ($yours) { $filter_obj = array ( array('none',lang('Show all')), array('yours',lang('Only yours')), array('private',lang('private')) ); } else { $filter_obj = array ( array('none',lang('Show all')), array('private',lang('private')) ); } while (is_array($this->extra_filters) && list(,$efilter) = each($this->extra_filters)) { $filter_obj[] = $efilter; } for ($index=0; $index<$indexlimit; $index++) { $filter_obj[2+$index][0] = $user_groups[$index]['account_id']; $filter_obj[2+$index][1] = 'Group - ' . $user_groups[$index]['account_name']; } } } if (is_array($filter_obj)) { $str = ''; $indexlimit = count($filter_obj); for ($index=0; $index<$indexlimit; $index++) { if ($filter == '') { $filter = $filter_obj[$index][0]; } $str .= ' '."\n"; } $str = ' '; $this->template->set_var('select',$str); $this->template->set_var('lang_filter',lang('Filter')); } return $this->template->fp('out','filter'); } /* filter() */ /* replacement for function filter */ function new_filter($data=0) { if(is_array($data)) { $filter = (isset($data['filter'])?$data['filter']:''); $format = (isset($data['format'])?$data['format']:'all'); } else { //$filter = get_var('filter',Array('GET','POST')); $filter = $data; $format = 'all'; } switch($format) { case 'yours': $filter_obj = array ( array('none',lang('show all')), array('yours',lang('only yours')) ); break; case 'private': $filter_obj = array ( array('none',lang('show all')), array('private',lang('only private')) ); break; default: $filter_obj = array ( array('none',lang('show all')), array('yours',lang('only yours')), array('private',lang('only private')) ); } $str = ''; $indexlimit = count($filter_obj); for($index=0; $index<$indexlimit; $index++) { if($filter == '') { $filter = $filter_obj[$index][0]; } $str .= ' '."\n"; } $str = ' '; $this->template->set_var('select',$str); $this->template->set_var('lang_filter',lang('Filter')); return $this->template->fp('out','filter'); } /* filter() */ /*! @function alternate_row_color @abstract alternate row colour @param $currentcolor default '' */ function alternate_row_color($currentcolor = '') { if (! $currentcolor) { $currentcolor = $GLOBALS['tr_color']; } if ($currentcolor == $GLOBALS['phpgw_info']['theme']['row_on']) { $GLOBALS['tr_color'] = $GLOBALS['phpgw_info']['theme']['row_off']; } else { $GLOBALS['tr_color'] = $GLOBALS['phpgw_info']['theme']['row_on']; } return $GLOBALS['tr_color']; } // If you are using the common bgcolor="{tr_color}" // This function is a little cleanier approch /*! @function template_alternate_row_color @abstract ? @param $tpl ? */ function template_alternate_row_color(&$tpl) { $tpl->set_var('tr_color',$this->alternate_row_color()); } /*! @function show_sort_order @abstract ? @param $sort ? @param $var ? @param $order ? @param $program ? @param $text ? @param $extra default '' */ function show_sort_order($sort,$var,$order,$program,$text,$extra='',$build_a_href=True) { list($filter,$qfield,$start) = $this->get_var(); if (($order == $var) && ($sort == 'ASC')) { $sort = 'DESC'; } elseif (($order == $var) && ($sort == 'DESC')) { $sort = 'ASC'; } else { $sort = 'ASC'; } if (is_array($extra)) { $extra = $this->extras_to_string($extra); } $extravar = 'order='.$var.'&sort='.$sort.'&filter='.$filter.'&qfield='.$qfield.'&start='.$start.'&query='.urlencode(stripslashes($GLOBALS['query'])).$extra; $link = ($this->action?$this->page($extravar):$GLOBALS['phpgw']->link($program,$extravar)); if ($build_a_href) { return '' . $text . ''; } else { return $link; } } function show_hits($total_records='',$start=0) { if ($total_records > $this->maxmatches) { if ($start + $this->maxmatches > $total_records) { $end = $total_records; } else { $end = $start + $this->maxmatches; } return lang('showing %1 - %2 of %3',($start + 1),$end,$total_records); } else { return lang('showing %1',$total_records); } } /*! @function show_sort_order_imap @abstract ? @param $old_sort : the current sort value @param $new_sort : the sort value you want if you click on this @param $default_order : users preference for ordering list items (force this when a new [different] sorting is requested) @param $order : the current order (will be flipped if old_sort = new_sort) @param $program : script file name @param $text : Text the link will show @param $extra : any extra stuff you want to pass, url style */ function show_sort_order_imap($old_sort,$new_sort,$default_order,$order,$program,$text,$extra='') { if(is_array($extra)) { $extra = $this->extras_to_string($extra); } if($old_sort == $new_sort) { // alternate order, like on outkrook, click on present sorting reverses order if((int)$order == 1) { $our_order = 0; } elseif((int)$order == 0) { $our_order = 1; } else { // we should never get here $our_order = 1; } } else { //user has selected a new sort scheme, reset the order to users default $our_order = $default_order; } $extravar = 'order='.$our_order.'&sort='.$new_sort.$extra; $link = ($this->action?$this->page($extravar):$GLOBALS['phpgw']->link($program,$extravar)); return '' .$text .''; } /*! @function nav_left_right_imap @abstract same code as left and right (as of Dec 07, 2001) except all combined into one function @param feed_vars : array with these elements:
start total cmd_prefix cmd_suffix @return array, combination of functions left and right above, with these elements: first_page prev_page next_page last_page @author: jengo, some changes by Angles */ function nav_left_right_imap($feed_vars) { $return_array = Array( 'first_page' => '', 'prev_page' => '', 'next_page' => '', 'last_page' => '' ); $out_vars = array(); // things that might change $out_vars['start'] = $feed_vars['start']; // things that stay the same $out_vars['common_uri'] = $feed_vars['common_uri']; $out_vars['total'] = $feed_vars['total']; // first page if(($feed_vars['start'] != 0) && ($feed_vars['start'] > $this->maxmatches)) { $out_vars['start'] = 0; $return_array['first_page'] = $this->set_link_imap('left','first.png',lang('First page'),$out_vars); } else { $return_array['first_page'] = $this->set_icon_imap('left','first-grey.png',lang('First page')); } // previous page if($feed_vars['start'] != 0) { // Changing the sorting order screaws up the starting number if(($feed_vars['start'] - $this->maxmatches) < 0) { $out_vars['start'] = 0; } else { $out_vars['start'] = ($feed_vars['start'] - $this->maxmatches); } $return_array['prev_page'] = $this->set_link_imap('left','left.png',lang('Previous page'),$out_vars); } else { $return_array['prev_page'] = $this->set_icon_imap('left','left-grey.png',lang('Previous page')); } // re-initialize the out_vars // things that might change $out_vars['start'] = $feed_vars['start']; // next page if(($feed_vars['total'] > $this->maxmatches) && ($feed_vars['total'] > $feed_vars['start'] + $this->maxmatches)) { $out_vars['start'] = ($feed_vars['start'] + $this->maxmatches); $return_array['next_page'] = $this->set_link_imap('right','right.png',lang('Next page'),$out_vars); } else { $return_array['next_page'] = $this->set_icon_imap('right','right-grey.png',lang('Next page')); } // last page if(($feed_vars['start'] != $feed_vars['total'] - $this->maxmatches) && (($feed_vars['total'] - $this->maxmatches) > ($feed_vars['start'] + $this->maxmatches))) { $out_vars['start'] = ($feed_vars['total'] - $this->maxmatches); $return_array['last_page'] = $this->set_link_imap('right','last.png',lang('Last page'),$out_vars); } else { $return_array['last_page'] = $this->set_icon_imap('right','last-grey.png',lang('Last page')); } return $return_array; } /*! @function set_link_imap @abstract ? @param $img_src ? @param $label ? @param $link ? @param $extravars ? */ function set_link_imap($align,$img,$alt_text,$out_vars) { $img_full = $GLOBALS['phpgw']->common->image('phpgwapi',$img); $image_part = ''.$alt_text.''; return ''.$image_part.''; } function set_icon_imap($align,$img,$alt_text) { $img_full = $GLOBALS['phpgw']->common->image('phpgwapi',$img); return ''.$alt_text.''."\r\n"; } } // End of nextmatchs class ?>