Services/Search/classes/class.ilSearchResult.php

Go to the documentation of this file.

<?php
/*
        +-----------------------------------------------------------------------------+
        | ILIAS open source                                                           |
        +-----------------------------------------------------------------------------+
        | Copyright (c) 1998-2001 ILIAS open source, University of Cologne            |
        |                                                                             |
        | This program is free software; you can redistribute it and/or               |
        | modify it under the terms of the GNU General Public License                 |
        | as published by the Free Software Foundation; either version 2              |
        | of the License, or (at your option) any later version.                      |
        |                                                                             |
        | This program 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 General Public License for more details.                                |
        |                                                                             |
        | You should have received a copy of the GNU General Public License           |
        | along with this program; if not, write to the Free Software                 |
        | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
        +-----------------------------------------------------------------------------+
*/
define('DEFAULT_SEARCH',0);
define('ADVANCED_SEARCH',1);

class ilSearchResult
{
        var $permission = 'visible';

        var $user_id;
        var $entries = array();
        var $results = array();
        var $observers = array();

        // OBJECT VARIABLES
        var $ilias;
        var $ilAccess;

        // Stores info if MAX HITS is reached or not
        var $limit_reached = false;


        var $result;
        function ilSearchResult($a_user_id = 0)
        {
                global $ilias,$ilAccess,$ilDB,$ilUser;

                $this->ilAccess =& $ilAccess;
                if($a_user_id)
                {
                        $this->user_id = $a_user_id;
                }
                else
                {
                        $this->user_id = $ilUser->getId();
                }

                $this->__initSearchSettingsObject();
                $this->setMaxHits($this->search_settings->getMaxHits());

                $this->db =& $ilDB;
        }

        function setRequiredPermission($a_permission)
        {
                $this->permission = $a_permission;
        }
        
        function getRequiredPermission()
        {
                return $this->permission;
        }


        function setUserId($a_user_id)
        {
                $this->user_id = $a_user_id;
        }
        function getUserId()
        {
                return $this->user_id;
        }

        function getEntries()
        {
                return $this->entries ? $this->entries : array();
        }

        function isLimitReached()
        {
                return $this->limit_reached ? true : false;
        }

        function setMaxHits($a_max_hits)
        {
                $this->max_hits = $a_max_hits;
        }
        function getMaxHits()
        {
                return $this->max_hits;
        }


        function addEntry($a_obj_id,$a_type,$found,$a_child_id = 0)
        {
                // Create new entry if it not exists
                if(!$this->entries[$a_obj_id])
                {
                        $this->entries[$a_obj_id]['obj_id'] = $a_obj_id;
                        $this->entries[$a_obj_id]['type'] = $a_type;
                        $this->entries[$a_obj_id]['found'] = $found;

                        if($a_child_id and $a_child_id != $a_obj_id)
                        {
                                $this->entries[$a_obj_id]['child'][$a_child_id] = $a_child_id;
                        }
                }
                else
                {
                        // replace or add child ('pg','st') id
                        if($a_child_id and $a_child_id != $a_obj_id)
                        {
                                $this->entries[$a_obj_id]['child'][$a_child_id] = $a_child_id;
                        }

                        // UPDATE FOUND
                        $counter = 0;
                        foreach($found as $position)
                        {
                                if($position)
                                {
                                        $this->entries[$a_obj_id]['found'][$counter] = $position;
                                }
                                $counter++;
                        }
                }
                return true;
        }

        function numEntries()
        {
                return count($this->getEntries());
        }

        function mergeEntries(&$result_obj)
        {
                foreach($result_obj->getEntries() as $entry)
                {
                        $this->addEntry($entry['obj_id'],$entry['type'],$entry['found']);
                        $this->__updateEntryChilds($entry['obj_id'],$entry['child']);
                }
                return true;
        }

        function diffEntriesFromResult(&$result_obj)
        {
                $new_entries = $this->getEntries();
                $this->entries = array();

                foreach($result_obj->getResults() as $result)
                {
                        $obj_id = $result['obj_id'];
                        if(isset($new_entries[$obj_id]))
                        {
                                $this->addEntry($new_entries[$obj_id]['obj_id'],
                                                                $new_entries[$obj_id]['type'],
                                                                $new_entries[$obj_id]['found']);
                                $this->__updateEntryChilds($new_entries[$obj_id]['obj_id'],
                                                                         $new_entries[$obj_id]['child']);
                        }
                }
        }

        function intersectEntries(&$result_obj)
        {
                $new_entries = $this->getEntries();
                $this->entries = array();

                foreach($result_obj->getEntries() as $entry)
                {
                        $obj_id = $entry['obj_id'];
                        if(isset($new_entries[$obj_id]))
                        {
                                $this->addEntry($new_entries[$obj_id]['obj_id'],
                                                                $new_entries[$obj_id]['type'],
                                                                $new_entries[$obj_id]['found']);

                                $this->__updateEntryChilds($new_entries[$obj_id]['obj_id'],
                                                                         $new_entries[$obj_id]['child']);
                        }
                }
        }


        function addResult($a_ref_id,$a_obj_id,$a_type)
        {
                $this->results[$a_ref_id]['ref_id'] = $a_ref_id;
                $this->results[$a_ref_id]['obj_id'] = $a_obj_id;
                $this->results[$a_ref_id]['type']       = $a_type;
        }

        function getResults()
        {
                return $this->results ? $this->results : array();
        }


        function getUniqueResults()
        {
                $obj_ids = array();
                foreach($this->results as $result)
                {
                        if(in_array($result['obj_id'],$obj_ids))
                        {
                                continue;
                        }
                        $obj_ids[] = $result['obj_id'];
                        $objects[] = $result;
                }
                return $objects ? $objects : array();
        }

        function getResultsForPresentation()
        {
                foreach($this->getResults() as $result)
                {
                        switch($result['type'])
                        {
                                // learning material
                                case "sahs":
                                case "lm":
                                case "dbk":
                                case "htlm":
                                        $type = "lres";
                                        break;

                                default:
                                        $type = $result['type'];
                                        break;
                        }
                        $title = ilObject::_lookupTitle($result['obj_id']);
                        $description = ilObject::_lookupDescription($result['obj_id']);

                        $presentation_result[$type][] = array('ref_id' => $result['ref_id'],
                                                                                                  'title' => $title,
                                                                                                  'description' => $description,
                                                                                                  'type' => $result['type'],
                                                                                                  'obj_id' => $result['obj_id'],
                                                                                                  'child' => $result['child']);
                }
                return $presentation_result ? $presentation_result : array();
        }

        function filter($a_root_node,$check_and)
        {
                global $tree;

                $this->__initSearchSettingsObject();

                // get ref_ids and check access
                $counter = 0;
                foreach($this->getEntries() as $entry)
                {
                        if($check_and and in_array(0,$entry['found']))
                        {
                                continue;
                        }
                        // Types like role, rolt, user do not need rbac checks
                        $type = ilObject::_lookupType($entry['obj_id']);
                        if($type == 'rolt' or $type == 'usr' or $type == 'role')
                        {
                                if($this->callListeners($entry['obj_id'],$entry))
                                {
                                        $this->addResult($entry['obj_id'],$entry['obj_id'],$type);
                                        $counter += count($entry['child']);
                                        // Stop if maximum of hits is reached
                                        if(++$counter > $this->getMaxHits())
                                        {
                                                $this->limit_reached = true;
                                                return true;
                                        }
                                }
                                continue;
                        }

                        // Rbac objects
                        foreach(ilObject::_getAllReferences($entry['obj_id']) as $ref_id)
                        {
                                $type = ilObject::_lookupType($ref_id, true);
                                if($this->ilAccess->checkAccessOfUser($this->getUserId(),
                                                                                                          $this->getRequiredPermission(),
                                                                                                          '',
                                                                                                          $ref_id,
                                                                                                          $type,
                                                                                                          $entry['obj_id']))
                                {
                                        if($a_root_node == ROOT_FOLDER_ID or $tree->isGrandChild($a_root_node,$ref_id))
                                        {
                                                // Call listeners
                                                if($this->callListeners($ref_id,$entry))
                                                {
                                                        $this->addResult($ref_id,$entry['obj_id'],$type);
                                                        $this->__updateResultChilds($ref_id,$entry['child']);
                                                        
                                                        $counter += count($entry['child']);
                                                        // Stop if maximum of hits is reached
                                                        if(++$counter > $this->getMaxHits())
                                                        {
                                                                $this->limit_reached = true;
                                                                return true;
                                                        }
                                                }
                                        }
                                }
                        }
                }
                return false;
        }

        
        function filterResults($a_root_node)
        {
                global $tree;

                $tmp_results = $this->getResults();
                $this->results = array();
                foreach($tmp_results as $result)
                {
                        if($tree->isGrandChild($a_root_node,$result['ref_id']) and $tree->isInTree($result['ref_id']))
                        {
                                $this->addResult($result['ref_id'],$result['obj_id'],$result['type']);
                                $this->__updateResultChilds($result['ref_id'],$result['child']);
                        }
                }

                return true;
        }


        function save($a_type = DEFAULT_SEARCH)
        {
                if ($this->getUserId() and $this->getUserId() != ANONYMOUS_USER_ID)
                {
                        $query = "DELETE FROM usr_search WHERE usr_id = '".$this->getUserId()."' ".
                                "AND search_type = '".$a_type."'";
                        $this->db->query($query);


                        $query = "INSERT INTO usr_search ".
                                "VALUES('".$this->getUserId()."','".addslashes(serialize($this->getResults()))."','".$a_type."')";

                        $res = $this->db->query($query);

                        return true;
                }

                return false;
        }
        function read($a_type = DEFAULT_SEARCH)
        {
                if($this->getUserId() and $this->getUserId() != ANONYMOUS_USER_ID)
                {
                        $query = "SELECT search_result FROM usr_search ".
                                "WHERE usr_id = '".$this->getUserId()."' ".
                                "AND search_type = '".$a_type."'";

                        $res = $this->db->query($query);

                        if($res->numRows())
                        {
                                $row = $res->fetchRow(DB_FETCHMODE_OBJECT);
                                $this->results = unserialize(stripslashes($row->search_result));
                        }
                }
        }

        // PRIVATE
        function __updateEntryChilds($a_obj_id,$a_childs)
        {
                if($this->entries[$a_obj_id] and is_array($a_childs))
                {
                        foreach($a_childs as $child_id)
                        {
                                if($child_id)
                                {
                                        $this->entries[$a_obj_id]['child'][$child_id] = $child_id;
                                }
                        }
                        return true;
                }
                return false;
        }
        function __updateResultChilds($a_ref_id,$a_childs)
        {
                if($this->results[$a_ref_id] and is_array($a_childs))
                {
                        foreach($a_childs as $child_id)
                        {
                                $this->results[$a_ref_id]['child'][$child_id] = $child_id;
                        }
                        return true;
                }
                return false;
        }



        function __initSearchSettingsObject()
        {
                include_once 'Services/Search/classes/class.ilSearchSettings.php';

                $this->search_settings = new ilSearchSettings();
        }

        function addObserver(&$a_class,$a_method)
        {
                $this->observers[] = array('class' => $a_class,
                                                                   'method' => $a_method);
                return true;
        }
        function callListeners($a_ref_id,&$a_data)
        {
                foreach($this->observers as $observer)
                {
                        $class =& $observer['class'];
                        $method = $observer['method'];

                        if(!$class->$method($a_ref_id,$a_data))
                        {
                                return false;
                        }
                }
                return true;
        }
} // END class.Search
?>