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   var $pid;
  40
  41
  42   function filter($filename)
  43   {
  44     global $config;
  45
  46     // Load eventually passed filename
  47     if (!$this->load($filename)) {
  48       die("Cannot parse $filename!");
  49     }
  50
  51     $this->pid= preg_replace("/[^0-9]/", "", microtime(TRUE));
  52   }
  53
  54
  55   function load($filename)
  56   {
  57     $contents = file_get_contents($filename);
  58     $this->xmlData= xml::xml2array($contents, 1);
  59
  60     if (!isset($this->xmlData['filterdef'])) {
  61       return false;
  62     }
  63
  64     $this->xmlData= $this->xmlData["filterdef"];
  65
  66     // Load filter
  67     if (isset($this->xmlData['search'])) {
  68       if (!isset($this->xmlData['search']['query'][0])){
  69         $this->xmlData['search']['query']= array($this->xmlData['search']['query']);
  70       }
  71
  72       // Move information
  73       $entry= $this->xmlData['search'];
  74       $this->scopeMode= $entry['scope'];
  75       if ($entry['scope'] == "auto") {
  76         $this->scope= "one";
  77       } else {
  78         $this->scope= $entry['scope'];
  79       }
  80       $this->query= $entry['query'];
  81     } else {
  82       return false;
  83     }
  84
  85     // Transfer initial value
  86     if (isset($this->xmlData['definition']['initial']) && $this->xmlData['definition']['initial'] == "true"){
  87       $this->initial= true;
  88     }
  89
  90     // Transfer category
  91     if (isset($this->xmlData['definition']['category'])){
  92       $this->category= $this->xmlData['definition']['category'];
  93     }
  94
  95     // Generate formular data
  96     if (isset($this->xmlData['element'])) {
  97       if (!isset($this->xmlData['element'][0])){
  98         $this->xmlData['element']= array($this->xmlData['element']);
  99       }
 100       foreach ($this->xmlData['element'] as $element) {
 101
 102         // Ignore elements without type
 103         if (!isset($element['type']) || !isset($element['tag'])) {
 104           next;
 105         }
 106
 107         $tag= $element['tag'];
 108
 109         // Fix arrays
 110         if (isset($element['value']) && !isset($element['value'][0])) {
 111           $element['value']= array($element['value']);
 112         }
 113
 114         // Store element for quick access
 115         $this->elements[$tag] = $element;
 116
 117         // Preset elementValues with default values if exist
 118         if (isset($element['default']) && !is_array($element['default'])) {
 119           $this->elementValues[$tag] = $element['default'];
 120         } else {
 121           $this->elementValues[$tag] = "";
 122         }
 123
 124         // Does this element react on alphabet links?
 125         if (isset($element['alphabet']) && $element['alphabet'] == "true") {
 126           $this->alphabetElements[]= $tag;
 127         }
 128       }
 129
 130       uasort($this->elements, 'strlenSort');
 131       $this->elements= array_reverse($this->elements);
 132
 133     }
 134
 135     return true;
 136   }
 137
 138
 139   function getTextfield($element)
 140   {
 141     $tag= $element['tag'];
 142     $size= 30;
 143     if (isset($element['size'])){
 144       $size= $element['size'];
 145     }
 146     $maxlength= 30;
 147     if (isset($element['maxlength'])){
 148       $maxlength= $element['maxlength'];
 149     }
 150     $result= "<input class='filter_textfield' id='$tag' name='$tag' type='text' size='$size' maxlength='maxlength' value='".$this->elementValues[$tag]."'>";
 151     if (isset($element['autocomplete'])) {
 152       $frequency= "0.5";
 153       $characters= "1";
 154       if (isset($element['autocomplete']['frequency'])) {
 155         $frequency= $element['autocomplete']['frequency'];
 156       }
 157       if (isset($element['autocomplete']['characters'])) {
 158         $characters= $element['autocomplete']['characters'];
 159       }
 160       $result.= "<div id='autocomplete$tag' class='autocomplete'></div>".
 161                 "<script type='text/javascript'>".
 162                 "new Ajax.Autocompleter('$tag', 'autocomplete$tag', 'autocomplete.php', { minChars: $characters, frequency: $frequency });".
 163                 "</script>";
 164
 165        $this->autocompleters[$tag]= $element['autocomplete'];
 166     }
 167     return $result;
 168   }
 169
 170
 171   function getCheckbox($element)
 172   {
 173     $tag= $element['tag'];
 174     $checked= "";
 175     if ($this->elementValues[$tag] == "true") {
 176       $checked= " checked";
 177     }
 178
 179     $result= "<input class='filter_checkbox' id='$tag' name='$tag' type='checkbox' onClick='document.mainform.submit();' value='true'$checked>";
 180     return $result;
 181   }
 182
 183
 184   function getCombobox($element)
 185   {
 186     $result= "<select name='".$element['tag']."' size='1' onClick='document.mainform.submit();'>";
 187
 188     // Fill with presets
 189     foreach ($element['value'] as $value) {
 190       $selected= "";
 191       if ($this->elementValues[$element['tag']] == $value['key']) {
 192         $selected= " selected";
 193       }
 194
 195       // Handle translations
 196       $result.= "<option value='".$value['key']."'$selected>"._($value['label'])."</option>";
 197     }
 198
 199     // Use autocompleter for additional data
 200     if (isset($element['autocomplete'])) {
 201       $list= $this->getCompletitionList($element['autocomplete'], $element['tag']);
 202       foreach ($list as $value) {
 203         $selected= "";
 204         if ($this->elementValues[$element['tag']] == $value) {
 205           $selected= " selected";
 206         }
 207         $result.= "<option value='$value'$selected>$value</option>";
 208       }
 209     }
 210
 211     $result.= "</select>";
 212
 213     return $result;
 214   }
 215
 216
 217   function getCurrentBase()
 218   {
 219     if (isset($this->search->base) && (string)$this->search->scope != "auto") {
 220       return false;
 221     }
 222
 223     return $this->base;
 224   }
 225
 226
 227   function getCurrentScope()
 228   {
 229     if (isset($this->search->scope) && (string)$this->search->scope != "auto") {
 230       return (string)$this->search->scope;
 231     }
 232
 233     return $this->scope;
 234   }
 235
 236
 237   function setConverter($field, $hook)
 238   {
 239     $this->converter[$field]= $hook;
 240   }
 241
 242
 243   function setObjectStorage($storage)
 244   {
 245     $this->objectStorage= $storage;
 246   }
 247
 248
 249   function setBase($base)
 250   {
 251     $this->base= $base;
 252   }
 253
 254
 255   function setCurrentScope($scope)
 256   {
 257     $this->scope= $scope;
 258   }
 259
 260
 261   function renderAlphabet($columns= 10)
 262   {
 263     // Return pre-rendered alphabet if available
 264     if ($this->alphabet) {
 265       return ($this->alphabet);
 266     }
 267
 268     $characters= _("*ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789");
 269     $alphabet= "";
 270     $c= 0;
 271
 272     /* Fill cells with charaters */
 273     for ($i= 0, $l= mb_strlen($characters, 'UTF8'); $i<$l; $i++){
 274       if ($c == 0){
 275         $alphabet.= "<tr>";
 276       }
 277
 278       $ch = mb_substr($characters, $i, 1, "UTF8");
 279       $alphabet.= "<td><a class=\"alphaselect\" href=\"main.php?plug=".
 280         validate($_GET['plug'])."&amp;filter=".$ch."\">&nbsp;".$ch."&nbsp;</a></td>";
 281
 282       if ($c++ == $columns){
 283         $alphabet.= "</tr>";
 284         $c= 0;
 285       }
 286     }
 287
 288     /* Fill remaining cells */
 289     while ($c++ <= $columns){
 290       $alphabet.= "<td>&nbsp;</td>";
 291     }
 292
 293     /* Save alphabet */
 294     $this->alphabet= "<table width='100%'>$alphabet</table>";
 295
 296     return ($this->alphabet);
 297   }
 298
 299
 300   function renderApply()
 301   {
 302     return ("<input type='submit' name='apply' value='"._("Apply filter")."'>");
 303   }
 304
 305
 306   function renderScope()
 307   {
 308     $checked= $this->scope == "sub"?" checked":"";
 309     return "<input type='checkbox' id='SCOPE' name='SCOPE' value='1' onClick='document.mainform.submit();'$checked>&nbsp;<LABEL for='SCOPE'>"._("Search in subtrees")."</LABEL>";
 310   }
 311
 312
 313   function render()
 314   {
 315     $smarty= get_smarty();
 316     $smarty->assign("ALPHABET", $this->renderAlphabet());
 317     $smarty->assign("APPLY", $this->renderApply());
 318     $smarty->assign("SCOPE", $this->renderScope());
 319
 320     // Load template and replace elementsHtml[]
 321     foreach ($this->elements as $tag => $element) {
 322       $htmlCode= "";
 323       switch ($element['type']) {
 324         case "textfield":
 325           $htmlCode = $this->getTextfield($element);
 326           break;
 327
 328         case "checkbox":
 329           $htmlCode = $this->getCheckbox($element);
 330           break;
 331
 332         case "combobox":
 333           $htmlCode = $this->getCombobox($element);
 334           break;
 335
 336         default:
 337           die ("Unknown element type specified!");
 338       }
 339       $smarty->assign("$tag", $htmlCode);
 340     }
 341
 342     // Load template
 343     return ("<input type='hidden' name='FILTER_PID' value='".$this->pid."'>".$smarty->fetch(get_template_path($this->xmlData['definition']['template'], true)));
 344   }
 345
 346
 347   function query()
 348   {
 349     global $class_mapping;
 350     $result= array();
 351
 352     // Return empty list if initial is not set
 353     if (!$this->initial) {
 354       $this->initial= true;
 355       return $result;
 356     }
 357
 358     // Go thru all queries and merge results
 359     foreach ($this->query as $query) {
 360       if (!isset($query['backend']) || !isset($query['filter']) || !isset($query['attribute'])) {
 361         die("No backend specified in search config.");
 362       }
 363
 364       // Is backend available?
 365       $backend= "filter".$query['backend'];
 366       if (!isset($class_mapping["$backend"])) {
 367         die("Invalid backend specified in search config.");
 368       }
 369
 370       // Load filter and attributes
 371       $filter= $query['filter'];
 372       $attributes= $query['attribute'];
 373
 374       // Generate final filter
 375       foreach ($this->elements as $tag => $element) {
 376         if (!isset($element['set']) || !isset($element['unset'])) {
 377           continue;
 378         }
 379
 380         // Handle converters if present
 381         if (isset($this->converter[$tag])) {
 382           preg_match('/([^:]+)::(.*)$/', $this->converter[$tag], $m);
 383           $e_set= call_user_func(array($m[1], $m[2]), preg_replace('/\$/', $this->elementValues[$tag], is_array($element['set'])?"":$element['set']));
 384           $e_unset= call_user_func(array($m[1], $m[2]), preg_replace('/\$/', $this->elementValues[$tag], is_array($element['unset'])?"":$element['unset']));
 385         } else {
 386           $e_set= is_array($element['set'])?"":$element['set'];
 387           $e_unset= is_array($element['unset'])?"":$element['unset'];
 388         }
 389
 390         if ($this->elementValues[$tag] == "") {
 391           $e_unset= preg_replace('/\$/', normalizeLdap($this->elementValues[$tag]), $e_unset);
 392           $filter= preg_replace("/\\$$tag/", $e_unset, $filter);
 393         } else {
 394           $e_set= preg_replace('/\$/', normalizeLdap($this->elementValues[$tag]), $e_set);
 395           $filter= preg_replace("/\\$$tag/", $e_set, $filter);
 396         }
 397       }
 398
 399       $result= array_merge($result, call_user_func(array($backend, 'query'), $this->base, $this->scope, $filter, $attributes, $this->category, $this->objectStorage));
 400     }
 401
 402     return ($result);
 403   }
 404
 405
 406   function isValid()
 407   {
 408     foreach ($this->elements as $tag => $element) {
 409       if (isset($element->regex)){
 410         if (!preg_match('/'.(string)$element->regex.'/', $this->elementValues[$tag])){
 411           return false;
 412         }
 413       }
 414     }
 415     return true;
 416   }
 417
 418
 419   function update()
 420   {
 421     /* React on alphabet links if needed */
 422     if (isset($_GET['filter'])){
 423       $s= mb_substr(validate($_GET['filter']), 0, 1, "UTF8");
 424       foreach ($this->alphabetElements as $tag) {
 425         $this->elementValues[$tag]= $s;
 426       }
 427     }
 428
 429     if (isset($_POST['FILTER_PID']) && $_POST['FILTER_PID'] == $this->pid) {
 430       // Load post values and adapt filter, base and scope accordingly - but
 431       // only if we didn't get a _GET
 432       foreach ($this->elements as $tag => $element) {
 433         if (isset($_POST[$tag])){
 434           $this->elementValues[$tag]= validate($_POST[$tag]);
 435         } else {
 436           $this->elementValues[$tag]= "";
 437         }
 438       }
 439
 440       // Save scope if needed
 441       if ($this->scopeMode == "auto") {
 442         $this->scope= isset($_POST['SCOPE'])?"sub":"one";
 443       }
 444     }
 445
 446   }
 447
 448
 449   function getCompletitionList($config, $tag, $value="*")
 450   {
 451     global $class_mapping;
 452     $res= array();
 453
 454     // Is backend available?
 455     $backend= "filter".$config['backend'];
 456     if (!isset($class_mapping["$backend"])) {
 457       die("Invalid backend specified in search config.");
 458     }
 459
 460     // Load filter and attributes
 461     $filter= $config['filter'];
 462     $attributes= $config['attribute'];
 463     if (!is_array($attributes)) {
 464       $attributes= array($attributes);
 465     }
 466
 467     // Make filter
 468     $filter= preg_replace("/\\$$tag/", normalizeLDAP($value), $filter);
 469     if (isset($config['base']) && isset($config['scope']) && isset($config['category'])) {
 470       $result= call_user_func(array($backend, 'query'), $config['base'], $config['scope'], $filter, $attributes,
 471                            $config["category"], $config["objectStorage"]);
 472     } else {
 473       $result= call_user_func(array($backend, 'query'), $this->base, $this->scope, $filter, $attributes,
 474                            $this->category, $this->objectStorage);
 475     }
 476
 477     foreach ($result as $entry) {
 478       foreach ($attributes as $attribute) {
 479         if (is_array($entry[$attribute])) {
 480           for ($i= 0; $i<$entry[$attribute]['count']; $i++) {
 481             if (mb_stristr($entry[$attribute][$i], $value)) {
 482               $res[]= $entry[$attribute][$i];
 483             }
 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   function getObjectBase($dn)
 524   {
 525     global $config;
 526     $base= "";
 527
 528     // Try every object storage
 529     $storage= $this->objectStorage;
 530     if (!is_array($storage)){
 531       $storage= array($storage);
 532     }
 533     foreach ($storage as $location) {
 534       $pattern= "/^[^,]+,".preg_quote($location, '/')."/i";
 535       $base= preg_replace($pattern, '', $dn);
 536     }
 537
 538     /* Set to base, if we're not on a correct subtree */
 539     if (!isset($config->idepartments[$base])){
 540       $base= $config->current['BASE'];
 541     }
 542
 543     return $base;
 544   }
 545
 546
 547 }
 548
 549 // Sort elements for element length to allow proper replacing later on
 550 function strlenSort($a, $b) {
 551   if (strlen($a['tag']) == strlen($b['tag'])) {
 552     return 0;
 553   }
 554   return (strlen($a['tag']) < strlen($b['tag']) ? -1 : 1);
 555 }
 556
 557 ?>