ilFavouritesDBRepository Class Reference

Collaboration diagram for ilFavouritesDBRepository:

Public Member Functions
	__construct (?ilDBInterface $db=null, ?ilTree $tree=null)
	add (int $user_id, int $ref_id)
	remove (int $user_id, int $ref_id)
	getFavouritesOfUser (int $user_id, ?array $a_types=null)
	Get all desktop items of user and specified type. More...
	ifIsFavourite (int $user_id, int $ref_id)
	loadData (int $user_id, array $ref_ids)
	removeFavouritesOfRefId (int $ref_id)
	removeFavouritesOfUser (int $user_id)

Static Public Attributes
static array	$is_desktop_item = []

Protected Attributes
ilDBInterface	$db
ilTree	$tree

Detailed Description

Author

Alexander Killing killi.nosp@m.ng@l.nosp@m.eifos.nosp@m..de

Definition at line 24 of file class.ilFavouritesDBRepository.php.

Constructor & Destructor Documentation

__construct()

ilFavouritesDBRepository::__construct	(	?ilDBInterface	$db = null,
		?ilTree	$tree = null
	)

Definition at line 31 of file class.ilFavouritesDBRepository.php.

      {
        global $DIC;
 
        $this->db = (is_null($db))
            ? $DIC->database()
            : $db;
        $this->tree = (is_null($tree))
            ? $DIC->repositoryTree()
            : $tree;
    }

References $db, $DIC, and $tree.

Member Function Documentation

add()

ilFavouritesDBRepository::add	(	int	$user_id,
		int	$ref_id
	)

Definition at line 46 of file class.ilFavouritesDBRepository.php.

                                                  : void
    {
        $db = $this->db;
 
        $type = ilObject::_lookupType($ref_id, true);
 
        $item_set = $db->queryF(
            'SELECT * FROM desktop_item WHERE ' .
            'item_id = %s AND type = %s AND user_id = %s',
            ['integer', 'text', 'integer'],
            [$ref_id, $type, $user_id]
        );
 
        // only insert if item is not already on desktop
        if (!$db->fetchAssoc($item_set)) {
            $db->manipulateF(
                'INSERT INTO desktop_item (item_id, type, user_id, parameters) VALUES ' .
                ' (%s,%s,%s,%s)',
                ['integer', 'text', 'integer', 'text'],
                [$ref_id, $type, $user_id, '']
            );
        }
    }

References $db, $ref_id, $user_id, ilObject\_lookupType(), ilDBInterface\fetchAssoc(), ilDBInterface\manipulateF(), and ilDBInterface\queryF().

Here is the call graph for this function:

getFavouritesOfUser()

ilFavouritesDBRepository::getFavouritesOfUser	(	int	$user_id,
		?array	$a_types = null
	)

Get all desktop items of user and specified type.

note: the implementation of this method is not good style (directly reading tables object_data and object_reference), must be revised someday...

Definition at line 89 of file class.ilFavouritesDBRepository.php.

                                                                             : array
    {
        $tree = $this->tree;
        $ilDB = $this->db;
 
        if (is_null($a_types)) {
            $item_set = $ilDB->queryF('SELECT obj.obj_id, obj.description, oref.ref_id, obj.title, obj.type ' .
                ' FROM desktop_item it, object_reference oref ' .
                ', object_data obj' .
                ' WHERE ' .
                'it.item_id = oref.ref_id AND ' .
                'oref.obj_id = obj.obj_id AND ' .
                'it.user_id = %s', ['integer'], [$user_id]);
            $items = $all_parent_path = [];
            while ($item_rec = $ilDB->fetchAssoc($item_set)) {
                if ($item_rec['type'] !== 'rolf' &&
                    $item_rec['type'] !== 'itgr' &&
                    $tree->isInTree((int) $item_rec['ref_id'])) { // due to bug 11508
                    $parent_ref = $tree->getParentId((int) $item_rec['ref_id']);
 
                    if (!isset($all_parent_path[$parent_ref])) {
                        if ($parent_ref > 0) {  // workaround for #0023176
                            $node = $tree->getNodeData($parent_ref);
                            $all_parent_path[$parent_ref] = $node['title'];
                        } else {
                            $all_parent_path[$parent_ref] = '';
                        }
                    }
 
                    $parent_path = $all_parent_path[$parent_ref];
 
                    $title = ilObject::_lookupTitle($item_rec['obj_id']);
                    $desc = ilObject::_lookupDescription($item_rec['obj_id']);
                    $items[$parent_path . $title . $item_rec['ref_id']] =
                        [
                            'ref_id' => (int) $item_rec['ref_id'],
                            'obj_id' => (int) $item_rec['obj_id'],
                            'type' => $item_rec['type'],
                            'title' => $title,
                            'description' => $desc,
                            'parent_ref' => (int) $parent_ref
                        ];
                }
            }
        } else {
            $items = [];
            foreach ($a_types as $a_type) {
                if ($a_type === 'itgr') {
                    continue;
                }
                $item_set = $ilDB->queryF(
                    'SELECT obj.obj_id, obj.description, oref.ref_id, obj.title FROM desktop_item it, object_reference oref ' .
                    ', object_data obj WHERE ' .
                    'it.item_id = oref.ref_id AND ' .
                    'oref.obj_id = obj.obj_id AND ' .
                    'it.type = %s AND ' .
                    'it.user_id = %s ' .
                    'ORDER BY title',
                    ['text', 'integer'],
                    [$a_type, $user_id]
                );
 
                while ($item_rec = $ilDB->fetchAssoc($item_set)) {
                    $title = ilObject::_lookupTitle($item_rec['obj_id']);
                    $desc = ilObject::_lookupDescription($item_rec['obj_id']);
                    $items[$title . $a_type . $item_rec['ref_id']] =
                        [
                            'ref_id' => (int) $item_rec['ref_id'],
                            'obj_id' => (int) $item_rec['obj_id'],
                            'type' => $a_type,
                            'title' => $title,
                            'description' => $desc
                        ];
                }
            }
        }
 
        return $items;
    }

References $db, $ilDB, $tree, $user_id, ilObject\_lookupDescription(), ilObject\_lookupTitle(), ilTree\getNodeData(), ilTree\getParentId(), ILIAS\Repository\int(), and ilTree\isInTree().

Here is the call graph for this function:

ifIsFavourite()

ilFavouritesDBRepository::ifIsFavourite	(	int	$user_id,
		int	$ref_id
	)

Definition at line 170 of file class.ilFavouritesDBRepository.php.

                                                            : bool
    {
        $db = $this->db;
        $user_identification = $user_id . ':' . $ref_id;
        if (!isset(self::$is_desktop_item[$user_identification])) {
            $item_set = $db->queryF(
                'SELECT item_id FROM desktop_item WHERE ' .
                'item_id = %s AND user_id = %s',
                ['integer', 'integer'],
                [$ref_id, $user_id]
            );
 
            if ($db->fetchAssoc($item_set)) {
                self::$is_desktop_item[$user_identification] = true;
            } else {
                self::$is_desktop_item[$user_identification] = false;
            }
        }
 
        return self::$is_desktop_item[$user_identification];
    }

References $db, $ref_id, $user_id, ilDBInterface\fetchAssoc(), and ilDBInterface\queryF().

Here is the call graph for this function:

loadData()

ilFavouritesDBRepository::loadData	(	int	$user_id,
		array	$ref_ids
	)

Definition at line 193 of file class.ilFavouritesDBRepository.php.

                                                          : void
    {
        $db = $this->db;
        if (!is_array($ref_ids)) {
            return;
        }
 
        $load_ref_ids = [];
        foreach ($ref_ids as $ref_id) {
            $user_identification = $user_id . ':' . $ref_id;
            if (!isset(self::$is_desktop_item[$user_identification])) {
                $load_ref_ids[] = $ref_id;
            }
        }
 
        if (count($load_ref_ids) > 0) {
            $item_set = $db->query('SELECT item_id FROM desktop_item WHERE ' .
                $db->in('item_id', $load_ref_ids, false, 'integer') .
                ' AND user_id = ' . $db->quote($user_id, 'integer'));
            while ($r = $db->fetchAssoc($item_set)) {
                self::$is_desktop_item[$user_id . ':' . $r['item_id']] = true;
            }
            foreach ($load_ref_ids as $ref_id) {
                $user_identification = $user_id . ':' . $ref_id;
                if (!isset(self::$is_desktop_item[$user_identification])) {
                    self::$is_desktop_item[$user_id . ':' . $ref_id] = false;
                }
            }
        }
    }

References $db, $ref_id, $user_id, ilDBInterface\fetchAssoc(), ilDBInterface\in(), ilDBInterface\query(), and ilDBInterface\quote().

Here is the call graph for this function:

remove()

ilFavouritesDBRepository::remove	(	int	$user_id,
		int	$ref_id
	)

Definition at line 71 of file class.ilFavouritesDBRepository.php.

                                                     : void
    {
        $db = $this->db;
 
        $db->manipulateF(
            'DELETE FROM desktop_item WHERE ' .
            ' item_id = %s AND user_id = %s',
            ['integer', 'integer'],
            [$ref_id, $user_id]
        );
    }

References $db, $ref_id, $user_id, and ilDBInterface\manipulateF().

Here is the call graph for this function:

removeFavouritesOfRefId()

ilFavouritesDBRepository::removeFavouritesOfRefId

(

int

$ref_id

)

Definition at line 225 of file class.ilFavouritesDBRepository.php.

                                                        : void
    {
        $db = $this->db;
 
        $db->manipulateF(
            'DELETE FROM desktop_item WHERE ' .
            ' item_id = %s',
            ['integer'],
            [$ref_id]
        );
    }

References $db, $ref_id, and ilDBInterface\manipulateF().

Here is the call graph for this function:

removeFavouritesOfUser()

ilFavouritesDBRepository::removeFavouritesOfUser

(

int

$user_id

)

Definition at line 238 of file class.ilFavouritesDBRepository.php.

                                                        : void
    {
        $db = $this->db;
 
        $db->manipulateF(
            'DELETE FROM desktop_item WHERE ' .
            ' user_id = %s',
            ['integer'],
            [$user_id]
        );
    }

References $db, $user_id, and ilDBInterface\manipulateF().

Here is the call graph for this function:

Field Documentation

$db

ilDBInterface ilFavouritesDBRepository::$db

protected

Definition at line 28 of file class.ilFavouritesDBRepository.php.

Referenced by __construct(), add(), getFavouritesOfUser(), ifIsFavourite(), loadData(), remove(), removeFavouritesOfRefId(), and removeFavouritesOfUser().

$is_desktop_item

array ilFavouritesDBRepository::$is_desktop_item = []

static

Definition at line 27 of file class.ilFavouritesDBRepository.php.

$tree

ilTree ilFavouritesDBRepository::$tree

protected

Definition at line 29 of file class.ilFavouritesDBRepository.php.

Referenced by __construct(), and getFavouritesOfUser().

---

The documentation for this class was generated from the following file:

• components/ILIAS/Dashboard/Favourites/classes/class.ilFavouritesDBRepository.php