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' onChange='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 setComboBoxOptions($tag, $options)
 218   {
 219     if (isset($this->elements[$tag]) && $this->elements[$tag]['type'] == "combobox") {
 220
 221       $this->elements[$tag]['value']= array();
 222       foreach ($options as $key => $label) {
 223         $this->elements[$tag]['value'][]= array('label' => $label, 'key' => $key);
 224       }
 225     }
 226   }
 227
 228
 229   function getCurrentBase()
 230   {
 231     if (isset($this->search->base) && (string)$this->search->scope != "auto") {
 232       return false;
 233     }
 234
 235     return $this->base;
 236   }
 237
 238
 239   function getCurrentScope()
 240   {
 241     if (isset($this->search->scope) && (string)$this->search->scope != "auto") {
 242       return (string)$this->search->scope;
 243     }
 244
 245     return $this->scope;
 246   }
 247
 248
 249   function setConverter($field, $hook)
 250   {
 251     $this->converter[$field]= $hook;
 252   }
 253
 254
 255   function setObjectStorage($storage)
 256   {
 257     $this->objectStorage= $storage;
 258   }
 259
 260
 261   function setBase($base)
 262   {
 263     $this->base= $base;
 264   }
 265
 266
 267   function setCurrentScope($scope)
 268   {
 269     $this->scope= $scope;
 270   }
 271
 272
 273   function renderAlphabet($columns= 10)
 274   {
 275     // Return pre-rendered alphabet if available
 276     if ($this->alphabet) {
 277       return ($this->alphabet);
 278     }
 279
 280     $characters= _("*ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789");
 281     $alphabet= "";
 282     $c= 0;
 283
 284     /* Fill cells with charaters */
 285     for ($i= 0, $l= mb_strlen($characters, 'UTF8'); $i<$l; $i++){
 286       if ($c == 0){
 287         $alphabet.= "<tr>";
 288       }
 289
 290       $ch = mb_substr($characters, $i, 1, "UTF8");
 291       $alphabet.= "<td><a class=\"alphaselect\" href=\"main.php?plug=".
 292         validate($_GET['plug'])."&amp;filter=".$ch."\">&nbsp;".$ch."&nbsp;</a></td>";
 293
 294       if ($c++ == $columns){
 295         $alphabet.= "</tr>";
 296         $c= 0;
 297       }
 298     }
 299
 300     /* Fill remaining cells */
 301     while ($c++ <= $columns){
 302       $alphabet.= "<td>&nbsp;</td>";
 303     }
 304
 305     /* Save alphabet */
 306     $this->alphabet= "<table width='100%'>$alphabet</table>";
 307
 308     return ($this->alphabet);
 309   }
 310
 311
 312   function renderApply()
 313   {
 314     return ("<input type='submit' name='apply' value='"._("Apply filter")."'>");
 315   }
 316
 317
 318   function renderScope()
 319   {
 320     $checked= $this->scope == "sub"?" checked":"";
 321     return "<input type='checkbox' id='SCOPE' name='SCOPE' value='1' onClick='document.mainform.submit();'$checked>&nbsp;<LABEL for='SCOPE'>"._("Search in subtrees")."</LABEL>";
 322   }
 323
 324
 325   function render()
 326   {
 327     $smarty= get_smarty();
 328     $smarty->assign("ALPHABET", $this->renderAlphabet());
 329     $smarty->assign("APPLY", $this->renderApply());
 330     $smarty->assign("SCOPE", $this->renderScope());
 331
 332     // Load template and replace elementsHtml[]
 333     foreach ($this->elements as $tag => $element) {
 334       $htmlCode= "";
 335       switch ($element['type']) {
 336         case "textfield":
 337           $htmlCode = $this->getTextfield($element);
 338           break;
 339
 340         case "checkbox":
 341           $htmlCode = $this->getCheckbox($element);
 342           break;
 343
 344         case "combobox":
 345           $htmlCode = $this->getCombobox($element);
 346           break;
 347
 348         default:
 349           die ("Unknown element type specified!");
 350       }
 351       $smarty->assign("$tag", $htmlCode);
 352     }
 353
 354     // Load template
 355     return ("<input type='hidden' name='FILTER_PID' value='".$this->pid."'>".$smarty->fetch(get_template_path($this->xmlData['definition']['template'], true)));
 356   }
 357
 358
 359   function query()
 360   {
 361     global $class_mapping;
 362     $result= array();
 363
 364     // Return empty list if initial is not set
 365     if (!$this->initial) {
 366       $this->initial= true;
 367       return $result;
 368     }
 369
 370     // Go thru all queries and merge results
 371     foreach ($this->query as $query) {
 372       if (!isset($query['backend']) || !isset($query['filter']) || !isset($query['attribute'])) {
 373         die("No backend specified in search config.");
 374       }
 375
 376       // Is backend available?
 377       $backend= "filter".$query['backend'];
 378       if (!isset($class_mapping["$backend"])) {
 379         die("Invalid backend specified in search config.");
 380       }
 381
 382       // Load filter and attributes
 383       $filter= $query['filter'];
 384       $attributes= $query['attribute'];
 385
 386       // Generate final filter
 387       foreach ($this->elements as $tag => $element) {
 388         if (!isset($element['set']) || !isset($element['unset'])) {
 389           continue;
 390         }
 391
 392         // Handle converters if present
 393         if (isset($this->converter[$tag])) {
 394           preg_match('/([^:]+)::(.*)$/', $this->converter[$tag], $m);
 395           $e_set= call_user_func(array($m[1], $m[2]), preg_replace('/\$/', $this->elementValues[$tag], is_array($element['set'])?"":$element['set']));
 396           $e_unset= call_user_func(array($m[1], $m[2]), preg_replace('/\$/', $this->elementValues[$tag], is_array($element['unset'])?"":$element['unset']));
 397         } else {
 398           $e_set= is_array($element['set'])?"":$element['set'];
 399           $e_unset= is_array($element['unset'])?"":$element['unset'];
 400         }
 401
 402         if ($this->elementValues[$tag] == "") {
 403           $e_unset= preg_replace('/\$/', normalizeLdap($this->elementValues[$tag]), $e_unset);
 404           $filter= preg_replace("/\\$$tag/", $e_unset, $filter);
 405         } else {
 406           $e_set= preg_replace('/\$/', normalizeLdap($this->elementValues[$tag]), $e_set);
 407           $filter= preg_replace("/\\$$tag/", $e_set, $filter);
 408         }
 409       }
 410
 411       $result= array_merge($result, call_user_func(array($backend, 'query'), $this->base, $this->scope, $filter, $attributes, $this->category, $this->objectStorage));
 412     }
 413
 414     return ($result);
 415   }
 416
 417
 418   function isValid()
 419   {
 420     foreach ($this->elements as $tag => $element) {
 421       if (isset($element->regex)){
 422         if (!preg_match('/'.(string)$element->regex.'/', $this->elementValues[$tag])){
 423           return false;
 424         }
 425       }
 426     }
 427     return true;
 428   }
 429
 430
 431   function update()
 432   {
 433     /* React on alphabet links if needed */
 434     if (isset($_GET['filter'])){
 435       $s= mb_substr(validate($_GET['filter']), 0, 1, "UTF8");
 436       foreach ($this->alphabetElements as $tag) {
 437         $this->elementValues[$tag]= $s;
 438       }
 439     }
 440
 441     if (isset($_POST['FILTER_PID']) && $_POST['FILTER_PID'] == $this->pid) {
 442       // Load post values and adapt filter, base and scope accordingly - but
 443       // only if we didn't get a _GET
 444       foreach ($this->elements as $tag => $element) {
 445         if (isset($_POST[$tag])){
 446           $this->elementValues[$tag]= validate($_POST[$tag]);
 447         } else {
 448           $this->elementValues[$tag]= "";
 449         }
 450       }
 451
 452       // Save scope if needed
 453       if ($this->scopeMode == "auto") {
 454         $this->scope= isset($_POST['SCOPE'])?"sub":"one";
 455       }
 456     }
 457
 458   }
 459
 460
 461   function getCompletitionList($config, $tag, $value="*")
 462   {
 463     global $class_mapping;
 464     $res= array();
 465
 466     // Is backend available?
 467     $backend= "filter".$config['backend'];
 468     if (!isset($class_mapping["$backend"])) {
 469       die("Invalid backend specified in search config.");
 470     }
 471
 472     // Load filter and attributes
 473     $filter= $config['filter'];
 474     $attributes= $config['attribute'];
 475     if (!is_array($attributes)) {
 476       $attributes= array($attributes);
 477     }
 478
 479     // Make filter
 480     $filter= preg_replace("/\\$$tag/", normalizeLdap($value), $filter);
 481     if (isset($config['base']) && isset($config['scope']) && isset($config['category'])) {
 482       $result= call_user_func(array($backend, 'query'), $config['base'], $config['scope'], $filter, $attributes,
 483                            $config["category"], $config["objectStorage"]);
 484     } else {
 485       $result= call_user_func(array($backend, 'query'), $this->base, $this->scope, $filter, $attributes,
 486                            $this->category, $this->objectStorage);
 487     }
 488
 489     foreach ($result as $entry) {
 490       foreach ($attributes as $attribute) {
 491         if (is_array($entry[$attribute])) {
 492           for ($i= 0; $i<$entry[$attribute]['count']; $i++) {
 493             if (mb_stristr($entry[$attribute][$i], $value)) {
 494               $res[]= $entry[$attribute][$i];
 495             }
 496           }
 497         } else {
 498           $res[]= $entry[$attribute];
 499         }
 500       }
 501     }
 502
 503     return $res;
 504   }
 505
 506
 507   function processAutocomplete()
 508   {
 509     global $class_mapping;
 510     $result= array();
 511
 512     // Introduce maximum number of entries
 513     $max= 25;
 514
 515     foreach ($this->autocompleters as $tag => $config) {
 516       if(isset($_POST[$tag])){
 517         $result= $this->getCompletitionList($config, $tag, $_POST[$tag]);
 518         $result= array_unique($result);
 519         asort($result);
 520
 521         echo '<ul>';
 522         foreach ($result as $entry) {
 523           echo '<li>'.$entry.'</li>';
 524           if ($max-- == 0) {
 525             break;
 526           }
 527         }
 528
 529         echo '</ul>';
 530       }
 531     }
 532   }
 533
 534
 535   function getObjectBase($dn)
 536   {
 537     global $config;
 538     $base= "";
 539
 540     // Try every object storage
 541     $storage= $this->objectStorage;
 542     if (!is_array($storage)){
 543       $storage= array($storage);
 544     }
 545     foreach ($storage as $location) {
 546       $pattern= "/^[^,]+,".preg_quote($location, '/')."/i";
 547       $base= preg_replace($pattern, '', $dn);
 548     }
 549
 550     /* Set to base, if we're not on a correct subtree */
 551     if (!isset($config->idepartments[$base])){
 552       $base= $config->current['BASE'];
 553     }
 554
 555     return $base;
 556   }
 557
 558
 559 }
 560
 561 // Sort elements for element length to allow proper replacing later on
 562 function strlenSort($a, $b) {
 563   if (strlen($a['tag']) == strlen($b['tag'])) {
 564     return 0;
 565   }
 566   return (strlen($a['tag']) < strlen($b['tag']) ? -1 : 1);
 567 }
 568
 569 ?>