gosa-core/include/class_filter.inc

   1 <?php
   2 /*
   3  * This code is part of GOsa (http://www.gosa-project.org)
   4  * Copyright (C) 2003-2008 GONICUS GmbH
   5  *
   6  * ID: $$Id$$
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  */
  22
  23 class filter {
  24
  25   var $xmlData;
  26   var $elements= array();
  27   var $elementValues= array();
  28   var $alphabetElements= array();
  29   var $autocompleter= array();
  30   var $category= "";
  31   var $objectStorage= array();
  32   var $base= "";
  33   var $scope= "";
  34   var $query;
  35   var $initial= false;
  36   var $scopeMode= "auto";
  37   var $alphabet= null;
  38   var $converter= array();
  39
  40
  41   function filter($filename)
  42   {
  43     global $config;
  44
  45     // Load eventually passed filename
  46     if (!$this->load($filename)) {
  47       die("Cannot parse $filename!");
  48     }
  49   }
  50
  51
  52   function load($filename)
  53   {
  54     $contents = file_get_contents($filename);
  55     $this->xmlData= xml::xml2array($contents, 1);
  56
  57     if (!isset($this->xmlData['filter'])) {
  58       return false;
  59     }
  60
  61     $this->xmlData= $this->xmlData["filter"];
  62
  63     // Load filter
  64     if (isset($this->xmlData['search'])) {
  65       if (!isset($this->xmlData['search']['query'][0])){
  66         $this->xmlData['search']['query']= array($this->xmlData['search']['query']);
  67       }
  68
  69       // Move information
  70       $entry= $this->xmlData['search'];
  71       $this->scopeMode= $entry['scope'];
  72       if ($entry['scope'] == "auto") {
  73         $this->scope= "one";
  74       } else {
  75         $this->scope= $entry['scope'];
  76       }
  77       $this->query= $entry['query'];
  78     } else {
  79       return false;
  80     }
  81
  82     // Transfer initial value
  83     if (isset($this->xmlData['definition']['initial']) && $this->xmlData['definition']['initial'] == "true"){
  84       $this->initial= true;
  85     }
  86
  87     // Transfer category
  88     if (isset($this->xmlData['definition']['category'])){
  89       $this->category= $this->xmlData['definition']['category'];
  90     }
  91
  92     // Generate formular data
  93     if (isset($this->xmlData['element'])) {
  94       if (!isset($this->xmlData['element'][0])){
  95         $this->xmlData['element']= array($this->xmlData['element']);
  96       }
  97       foreach ($this->xmlData['element'] as $element) {
  98
  99         // Ignore elements without type
 100         if (!isset($element['type']) || !isset($element['tag'])) {
 101           next;
 102         }
 103
 104         $tag= $element['tag'];
 105
 106         // Fix arrays
 107         if (isset($element['value']) && !isset($element['value'][0])) {
 108           $element['value']= array($element['value']);
 109         }
 110
 111         // Store element for quick access
 112         $this->elements[$tag] = $element;
 113
 114         // Preset elementValues with default values if exist
 115         if (isset($element['default']) && !is_array($element['default'])) {
 116           $this->elementValues[$tag] = $element['default'];
 117         } else {
 118           $this->elementValues[$tag] = "";
 119         }
 120
 121         // Does this element react on alphabet links?
 122         if (isset($element['alphabet']) && $element['alphabet'] == "true") {
 123           $this->alphabetElements[]= $tag;
 124         }
 125       }
 126
 127       // Sort elements for element length to allow proper replacing later on
 128       function strlenSort($a, $b) {
 129         if (strlen($a['tag']) == strlen($b['tag'])) {
 130           return 0;
 131         }
 132        return (strlen($a['tag']) < strlen($b['tag']) ? -1 : 1);
 133       }
 134       uasort($this->elements, 'strlenSort');
 135       $this->elements= array_reverse($this->elements);
 136
 137     }
 138
 139     return true;
 140   }
 141
 142
 143   function getTextfield($element)
 144   {
 145     $tag= $element['tag'];
 146     $size= 30;
 147     if (isset($element['size'])){
 148       $size= $element['size'];
 149     }
 150     $maxlength= 30;
 151     if (isset($element['maxlength'])){
 152       $maxlength= $element['maxlength'];
 153     }
 154     $result= "<input class='filter_textfield' id='$tag' name='$tag' type='text' size='$size' maxlength='maxlength' value='".$this->elementValues[$tag]."'>";
 155     if (isset($element['autocomplete'])) {
 156       $frequency= "0.5";
 157       $characters= "1";
 158       if (isset($element['autocomplete']['frequency'])) {
 159         $frequency= $element['autocomplete']['frequency'];
 160       }
 161       if (isset($element['autocomplete']['characters'])) {
 162         $characters= $element['autocomplete']['characters'];
 163       }
 164       $result.= "<div id='autocomplete$tag' class='autocomplete'></div>".
 165                 "<script type='text/javascript'>".
 166                 "new Ajax.Autocompleter('$tag', 'autocomplete$tag', 'autocomplete.php', { minChars: $characters, frequency: $frequency });".
 167                 "</script>";
 168
 169        $this->autocompleters[$tag]= $element['autocomplete'];
 170     }
 171     return $result;
 172   }
 173
 174
 175   function getCheckbox($element)
 176   {
 177     $tag= $element['tag'];
 178     $checked= "";
 179     if ($this->elementValues[$tag] == "true") {
 180       $checked= " checked";
 181     }
 182
 183     $result= "<input class='filter_checkbox' name='$tag' type='checkbox' onClick='document.mainform.submit();' value='true'$checked>";
 184     return $result;
 185   }
 186
 187
 188   function getCombobox($element)
 189   {
 190     $result= "<select name='".$element['tag']."' size='1' onClick='document.mainform.submit();'>";
 191
 192     // Fill with presets
 193     foreach ($element['value'] as $value) {
 194       $selected= "";
 195       if ($this->elementValues[$element['tag']] == $value['key']) {
 196         $selected= " selected";
 197       }
 198
 199       // Handle translations
 200       $result.= "<option value='".$value['key']."'$selected>"._($value['label'])."</option>";
 201     }
 202
 203     // Use autocompleter for additional data
 204     if (isset($element['autocomplete'])) {
 205       $list= $this->getCompletitionList($element['autocomplete'], $element['tag']);
 206       foreach ($list as $value) {
 207         $selected= "";
 208         if ($this->elementValues[$element['tag']] == $value) {
 209           $selected= " selected";
 210         }
 211         $result.= "<option value='$value'$selected>$value</option>";
 212       }
 213     }
 214
 215     $result.= "</select>";
 216
 217     return $result;
 218   }
 219
 220
 221   function getCurrentBase()
 222   {
 223     if (isset($this->search->base) && (string)$this->search->scope != "auto") {
 224       return false;
 225     }
 226
 227     return $this->base;
 228   }
 229
 230
 231   function getCurrentScope()
 232   {
 233     if (isset($this->search->scope) && (string)$this->search->scope != "auto") {
 234       return (string)$this->search->scope;
 235     }
 236
 237     return $this->scope;
 238   }
 239
 240
 241   function setConverter($field, $hook)
 242   {
 243     $this->converter[$field]= $hook;
 244   }
 245
 246
 247   function setObjectStorage($storage)
 248   {
 249     $this->objectStorage= $storage;
 250   }
 251
 252
 253   function setBase($base)
 254   {
 255     $this->base= $base;
 256   }
 257
 258
 259   function setCurrentScope($scope)
 260   {
 261     $this->scope= $scope;
 262   }
 263
 264
 265   function renderAlphabet($columns= 10)
 266   {
 267     // Return pre-rendered alphabet if available
 268     if ($this->alphabet) {
 269       return ($this->alphabet);
 270     }
 271
 272     $characters= _("*ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789");
 273     $alphabet= "";
 274     $c= 0;
 275
 276     /* Fill cells with charaters */
 277     for ($i= 0, $l= mb_strlen($characters, 'UTF8'); $i<$l; $i++){
 278       if ($c == 0){
 279         $alphabet.= "<tr>";
 280       }
 281
 282       $ch = mb_substr($characters, $i, 1, "UTF8");
 283       $alphabet.= "<td><a class=\"alphaselect\" href=\"main.php?plug=".
 284         validate($_GET['plug'])."&amp;filter=".$ch."\">&nbsp;".$ch."&nbsp;</a></td>";
 285
 286       if ($c++ == $columns){
 287         $alphabet.= "</tr>";
 288         $c= 0;
 289       }
 290     }
 291
 292     /* Fill remaining cells */
 293     while ($c++ <= $columns){
 294       $alphabet.= "<td>&nbsp;</td>";
 295     }
 296
 297     /* Save alphabet */
 298     $this->alphabet= "<table width='100%'>$alphabet</table>";
 299
 300     return ($this->alphabet);
 301   }
 302
 303
 304   function renderApply()
 305   {
 306     return ("<input type='submit' name='apply' value='"._("Apply filter")."'>");
 307   }
 308
 309
 310   function renderScope()
 311   {
 312     $checked= $this->scope == "sub"?" checked":"";
 313     return "<input type='checkbox' name='SCOPE' value='1' onClick='document.mainform.submit();'$checked>&nbsp;"._("Search in subtrees");
 314   }
 315
 316
 317   function render()
 318   {
 319     $smarty= get_smarty();
 320     $smarty->assign("ALPHABET", $this->renderAlphabet());
 321     $smarty->assign("APPLY", $this->renderApply());
 322     $smarty->assign("SCOPE", $this->renderScope());
 323
 324     // Load template and replace elementsHtml[]
 325     foreach ($this->elements as $tag => $element) {
 326       $htmlCode= "";
 327       switch ($element['type']) {
 328         case "textfield":
 329           $htmlCode = $this->getTextfield($element);
 330           break;
 331
 332         case "checkbox":
 333           $htmlCode = $this->getCheckbox($element);
 334           break;
 335
 336         case "combobox":
 337           $htmlCode = $this->getCombobox($element);
 338           break;
 339
 340         default:
 341           die ("Unknown element type specified!");
 342       }
 343       $smarty->assign("$tag", $htmlCode);
 344     }
 345
 346     // Load template
 347     return ("<input type='hidden' name='FILTER_LOADED' value='1'>".$smarty->fetch(get_template_path($this->xmlData['definition']['template'], true)));
 348   }
 349
 350
 351   function query()
 352   {
 353     global $class_mapping;
 354     $result= array();
 355
 356     // Go thru all queries and merge results
 357     foreach ($this->query as $query) {
 358       if (!isset($query['backend']) || !isset($query['filter']) || !isset($query['attribute'])) {
 359         die("No backend specified in search config.");
 360       }
 361
 362       // Is backend available?
 363       $backend= "filter".$query['backend'];
 364       if (!isset($class_mapping["$backend"])) {
 365         die("Invalid backend specified in search config.");
 366       }
 367
 368       // Load filter and attributes
 369       $filter= $query['filter'];
 370       $attributes= $query['attribute'];
 371
 372       // Generate final filter
 373       foreach ($this->elements as $tag => $element) {
 374         if (!isset($element['set']) || !isset($element['unset'])) {
 375           continue;
 376         }
 377
 378         // Handle converters if present
 379         if (isset($this->converter[$tag])) {
 380           preg_match('/([^:]+)::(.*)$/', $this->converter[$tag], $m);
 381           $e_set= call_user_func(array($m[1], $m[2]), preg_replace('/\$/', $this->elementValues[$tag], is_array($element['set'])?"":$element['set']));
 382           $e_unset= call_user_func(array($m[1], $m[2]), preg_replace('/\$/', $this->elementValues[$tag], is_array($element['unset'])?"":$element['unset']));
 383         } else {
 384           $e_set= is_array($element['set'])?"":$element['set'];
 385           $e_unset= is_array($element['unset'])?"":$element['unset'];
 386         }
 387
 388         if ($this->elementValues[$tag] == "") {
 389           $e_unset= preg_replace('/\$/', normalizeLdap($this->elementValues[$tag]), $e_unset);
 390           $filter= preg_replace("/\\$$tag/", $e_unset, $filter);
 391         } else {
 392           $e_set= preg_replace('/\$/', normalizeLdap($this->elementValues[$tag]), $e_set);
 393           $filter= preg_replace("/\\$$tag/", $e_set, $filter);
 394         }
 395       }
 396
 397       $result= array_merge($result, call_user_func(array($backend, 'query'), $this->base, $this->scope, $filter, $attributes, $this->category, $this->objectStorage));
 398     }
 399
 400     return ($result);
 401   }
 402
 403
 404   function isValid()
 405   {
 406     foreach ($this->elements as $tag => $element) {
 407       if (isset($element->regex)){
 408         if (!preg_match('/'.(string)$element->regex.'/', $this->elementValues[$tag])){
 409           return false;
 410         }
 411       }
 412     }
 413     return true;
 414   }
 415
 416
 417   function update()
 418   {
 419
 420     /* React on alphabet links if needed */
 421     if (isset($_GET['filter'])){
 422       $s= mb_substr(validate($_GET['filter']), 0, 1, "UTF8")."*";
 423       if ($s == "**"){
 424         $s= "*";
 425       }
 426       foreach ($this->alphabetElements as $tag) {
 427         $this->elementValues[$tag]= $s;
 428       }
 429     }
 430
 431     if (isset($_POST['FILTER_LOADED'])) {
 432       // Load post values and adapt filter, base and scope accordingly - but
 433       // only if we didn't get a _GET
 434       foreach ($this->elements as $tag => $element) {
 435         if (isset($_POST[$tag])){
 436           $this->elementValues[$tag]= validate($_POST[$tag]);
 437         } else {
 438           $this->elementValues[$tag]= "";
 439         }
 440       }
 441
 442       // Save scope if needed
 443       if ($this->scopeMode == "auto") {
 444         $this->scope= isset($_POST['SCOPE'])?"sub":"one";
 445       }
 446     }
 447
 448   }
 449
 450
 451   function getCompletitionList($config, $tag, $value="*")
 452   {
 453     global $class_mapping;
 454     $res= array();
 455
 456     // Is backend available?
 457     $backend= "filter".$config['backend'];
 458     if (!isset($class_mapping["$backend"])) {
 459       die("Invalid backend specified in search config.");
 460     }
 461
 462     // Load filter and attributes
 463     $filter= $config['filter'];
 464     $attributes= $config['attribute'];
 465     if (!is_array($attributes)) {
 466       $attributes= array($attributes);
 467     }
 468
 469     // Make filter
 470     $filter= preg_replace("/\\$$tag/", normalizeLDAP($value), $filter);
 471     if (isset($config['base']) && isset($config['scope']) && isset($config['category'])) {
 472       $result= call_user_func(array($backend, 'query'), $config['base'], $config['scope'], $filter, $attributes,
 473                            $config["category"], $config["objectStorage"]);
 474     } else {
 475       $result= call_user_func(array($backend, 'query'), $this->base, $this->scope, $filter, $attributes,
 476                            $this->category, $this->objectStorage);
 477     }
 478
 479     foreach ($result as $entry) {
 480       foreach ($attributes as $attribute) {
 481         if (is_array($entry[$attribute])) {
 482           for ($i= 0; $i<$entry[$attribute]['count']; $i++) {
 483             $res[]= $entry[$attribute][$i];
 484           }
 485         } else {
 486           $res[]= $entry[$attribute];
 487         }
 488       }
 489     }
 490
 491     return $res;
 492   }
 493
 494
 495   function processAutocomplete()
 496   {
 497     global $class_mapping;
 498     $result= array();
 499
 500     // Introduce maximum number of entries
 501     $max= 25;
 502
 503     foreach ($this->autocompleters as $tag => $config) {
 504       if(isset($_POST[$tag])){
 505         $result= $this->getCompletitionList($config, $tag, $_POST[$tag]);
 506         $result= array_unique($result);
 507         asort($result);
 508
 509         echo '<ul>';
 510         foreach ($result as $entry) {
 511           echo '<li>'.$entry.'</li>';
 512           if ($max-- == 0) {
 513             break;
 514           }
 515         }
 516
 517         echo '</ul>';
 518       }
 519     }
 520   }
 521
 522
 523 }
 524
 525 ?>