ilBadgeAssignment Class Reference

Class ilBadgeAssignment. More...

Collaboration diagram for ilBadgeAssignment:

Public Member Functions
	__construct ($a_badge_id=null, $a_user_id=null)
	getBadgeId ()
	getUserId ()
	getTimestamp ()
	setAwardedBy ($a_id)
	getAwardedBy ()
	setPosition ($a_value)
	getPosition ()
	store ()
	delete ()
	getImagePath (ilBadge $a_badge)
	getStaticUrl ()
	deleteStaticFiles ()

Static Public Member Functions
static	getNewCounter (int $a_user_id)
	Get new counter. More...
static	getLatestTimestamp (int $a_user_id)
	Get latest badge. More...
static	getInstancesByUserId ($a_user_id)
static	getInstancesByBadgeId ($a_badge_id)
static	getInstancesByParentId ($a_parent_obj_id)
static	getAssignedUsers ($a_badge_id)
static	exists ($a_badge_id, $a_user_id)
static	deleteByUserId ($a_user_id)
static	deleteByBadgeId ($a_badge_id)
static	deleteByParentId ($a_parent_obj_id)
static	updatePositions ($a_user_id, array $a_positions)
static	getBadgesForUser ($a_user_id, $a_ts_from, $a_ts_to)
	Get badges for user. More...
static	clearBadgeCache ($a_user_id)

Protected Member Functions
	setBadgeId ($a_value)
	setUserId ($a_value)
	setTimestamp ($a_value)
	importDBRow (array $a_row)
	read ($a_badge_id, $a_user_id)
	getPropertiesForStorage ()
	prepareJson ($a_url)
	bakeImage ($a_baked_image_path, $a_badge_image_path, $a_assertion_url)

Protected Attributes
	$db
	$badge_id
	$user_id
	$tstamp
	$awarded_by
	$pos
	$stored

Detailed Description

Class ilBadgeAssignment.

Author

Jörg Lützenkirchen luetz.nosp@m.enki.nosp@m.rchen.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 10 of file class.ilBadgeAssignment.php.

Constructor & Destructor Documentation

__construct()

ilBadgeAssignment::__construct	(		$a_badge_id = null,
			$a_user_id = null
	)

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

References $DIC, read(), setBadgeId(), and setUserId().

    {
        global $DIC;

        $this->db = $DIC->database();
        if ($a_badge_id &&
            $a_user_id) {
            $this->setBadgeId($a_badge_id);
            $this->setUserId($a_user_id);
            
            $this->read($a_badge_id, $a_user_id);
        }
    }

Here is the call graph for this function:

Member Function Documentation

bakeImage()

ilBadgeAssignment::bakeImage (   $a_baked_image_path,   $a_badge_image_path,   $a_assertion_url  )

protected

Definition at line 444 of file class.ilBadgeAssignment.php.

Referenced by prepareJson().

    {
        $suffix = strtolower(array_pop(explode(".", basename($a_badge_image_path))));
        if ($suffix == "png") {
            // using chamilo baker lib
            include_once "Services/Badge/lib/baker.lib.php";
            $png = new PNGImageBaker(file_get_contents($a_badge_image_path));
            
            // add payload
            if ($png->checkChunks("tEXt", "openbadges")) {
                $baked = $png->addChunk("tEXt", "openbadges", $a_assertion_url);
            }
            
            // create baked file
            if (!file_exists($a_baked_image_path)) {
                file_put_contents($a_baked_image_path, $baked);
            }
            
            // verify file
            $verify = $png->extractBadgeInfo(file_get_contents($a_baked_image_path));
            if (is_array($verify)) {
                return true;
            }
        } elseif ($suffix == "svg") {
            // :TODO: not really sure if this is correct
            $svg = simplexml_load_file($a_badge_image_path);
            $ass = $svg->addChild("openbadges:assertion", "", "http://openbadges.org");
            $ass->addAttribute("verify", $a_assertion_url);
            $baked = $svg->asXML();
            
            // create baked file
            if (!file_exists($a_baked_image_path)) {
                file_put_contents($a_baked_image_path, $baked);
            }
            
            return true;
        }
        
        return false;
    }

Here is the caller graph for this function:

clearBadgeCache()

static ilBadgeAssignment::clearBadgeCache (   $a_user_id )

static

Definition at line 507 of file class.ilBadgeAssignment.php.

Referenced by ilBadgeProfileGUI\saveSettings().

    {
        foreach (self::getInstancesByUserId($a_user_id) as $ass) {
            $ass->deleteStaticFiles();
        }
    }

Here is the caller graph for this function:

delete()

ilBadgeAssignment::delete

(

)

Definition at line 295 of file class.ilBadgeAssignment.php.

References $db, $ilDB, deleteStaticFiles(), getBadgeId(), and getUserId().

    {
        $ilDB = $this->db;
        
        if (!$this->getBadgeId() ||
            !$this->getUserId()) {
            return;
        }
        
        $this->deleteStaticFiles();
        
        $ilDB->manipulate("DELETE FROM badge_user_badge" .
            " WHERE badge_id = " . $ilDB->quote($this->getBadgeId(), "integer") .
            " AND user_id = " . $ilDB->quote($this->getUserId(), "integer"));
    }

Here is the call graph for this function:

deleteByBadgeId()

static ilBadgeAssignment::deleteByBadgeId (   $a_badge_id )

static

Definition at line 318 of file class.ilBadgeAssignment.php.

Referenced by ilBadge\delete().

    {
        foreach (self::getInstancesByBadgeId($a_badge_id) as $ass) {
            $ass->delete();
        }
    }

Here is the caller graph for this function:

deleteByParentId()

static ilBadgeAssignment::deleteByParentId (   $a_parent_obj_id )

static

Definition at line 325 of file class.ilBadgeAssignment.php.

    {
        foreach (self::getInstancesByParentId($a_parent_obj_id) as $ass) {
            $ass->delete();
        }
    }

deleteByUserId()

static ilBadgeAssignment::deleteByUserId (   $a_user_id )

static

Definition at line 311 of file class.ilBadgeAssignment.php.

Referenced by ilObjUser\delete().

    {
        foreach (self::getInstancesByUserId($a_user_id) as $ass) {
            $ass->delete();
        }
    }

Here is the caller graph for this function:

deleteStaticFiles()

ilBadgeAssignment::deleteStaticFiles

(

)

Definition at line 499 of file class.ilBadgeAssignment.php.

References ilBadgeHandler\getInstance().

Referenced by delete().

    {
        // remove instance files
        $path = ilBadgeHandler::getInstance()->getInstancePath($this);
        $path = str_replace(".json", ".*", $path);
        array_map("unlink", glob($path));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

exists()

static ilBadgeAssignment::exists (   $a_badge_id,   $a_user_id  )

static

Definition at line 172 of file class.ilBadgeAssignment.php.

Referenced by ilBadgeManagementGUI\assignBadge(), ilBadgeHandler\sendNotification(), and ilBadgeHandler\triggerEvaluation().

    {
        $obj = new self($a_badge_id, $a_user_id);
        return $obj->stored;
    }

Here is the caller graph for this function:

getAssignedUsers()

static ilBadgeAssignment::getAssignedUsers (   $a_badge_id )

static

Definition at line 161 of file class.ilBadgeAssignment.php.

References $res.

Referenced by ilBadgeManagementGUI\confirmDeassignBadge().

    {
        $res = array();
        
        foreach (self::getInstancesByBadgeId($a_badge_id) as $ass) {
            $res[] = $ass->getUserId();
        }
        
        return $res;
    }

Here is the caller graph for this function:

getAwardedBy()

ilBadgeAssignment::getAwardedBy

(

)

Definition at line 218 of file class.ilBadgeAssignment.php.

References $awarded_by.

Referenced by getPropertiesForStorage().

    {
        return $this->awarded_by;
    }

Here is the caller graph for this function:

getBadgeId()

ilBadgeAssignment::getBadgeId

(

)

Definition at line 188 of file class.ilBadgeAssignment.php.

References $badge_id.

Referenced by delete(), ilBadgeHandler\getInstancePath(), prepareJson(), and store().

    {
        return $this->badge_id;
    }

Here is the caller graph for this function:

getBadgesForUser()

static ilBadgeAssignment::getBadgesForUser (   $a_user_id,   $a_ts_from,   $a_ts_to  )

static

Get badges for user.

Parameters

int	$a_user_id
int	$a_ts_from
int	$a_ts_to

Returns

array

Definition at line 359 of file class.ilBadgeAssignment.php.

References $db, $DIC, and $res.

Referenced by ilBadgeLearningHistoryProvider\getEntries().

    {
        global $DIC;
        
        $db = $DIC->database();
        
        $set = $db->queryF(
            "SELECT bdg.parent_id, ub.tstamp, bdg.title FROM badge_user_badge ub JOIN badge_badge bdg" .
            " ON (ub.badge_id = bdg.id) " .
            " WHERE ub.user_id = %s AND ub.tstamp >= %s AND ub.tstamp <= %s",
            array("integer","integer","integer"),
            array($a_user_id, $a_ts_from, $a_ts_to)
        );
        $res = [];
        while ($rec = $db->fetchAssoc($set)) {
            $res[] = $rec;
        }
        return $res;
    }

Here is the caller graph for this function:

getImagePath()

ilBadgeAssignment::getImagePath

(

ilBadge

$a_badge

)

Definition at line 433 of file class.ilBadgeAssignment.php.

References ilBadge\getImagePath(), and ilBadgeHandler\getInstance().

Referenced by prepareJson().

    {
        $json_path = ilBadgeHandler::getInstance()->getInstancePath($this);
        $baked_path = dirname($json_path);
        $baked_file = array_shift(explode(".", basename($json_path)));
        
        // get correct suffix from badge image
        $suffix = strtolower(array_pop(explode(".", basename($a_badge->getImagePath()))));
        return $baked_path . "/" . $baked_file . "." . $suffix;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getInstancesByBadgeId()

static ilBadgeAssignment::getInstancesByBadgeId (   $a_badge_id )

static

Definition at line 117 of file class.ilBadgeAssignment.php.

References $DIC, $ilDB, and $res.

Referenced by ilBadgeManagementGUI\confirmDeleteBadges(), ilObjBadgeAdministrationGUI\confirmDeleteObjectBadges(), and ilBadgeWAC\isAssignedBadgeOfPublishedUserProfile().

    {
        global $DIC;

        $ilDB = $DIC->database();
        
        $res = array();
        
        $set = $ilDB->query("SELECT * FROM badge_user_badge" .
            " WHERE badge_id = " . $ilDB->quote($a_badge_id, "integer"));
        while ($row = $ilDB->fetchAssoc($set)) {
            $obj = new self();
            $obj->importDBRow($row);
            $res[] = $obj;
        }
        
        return $res;
    }

Here is the caller graph for this function:

getInstancesByParentId()

static ilBadgeAssignment::getInstancesByParentId (   $a_parent_obj_id )

static

Definition at line 136 of file class.ilBadgeAssignment.php.

References $DIC, $ilDB, $res, and ilBadge\getInstancesByParentId().

Referenced by ilBadgeUserTableGUI\getItems().

    {
        global $DIC;

        $ilDB = $DIC->database();
        
        $res = array();
        
        $badge_ids = array();
        foreach (ilBadge::getInstancesByParentId($a_parent_obj_id) as $badge) {
            $badge_ids[] = $badge->getId();
        }
        if (sizeof($badge_ids)) {
            $set = $ilDB->query("SELECT * FROM badge_user_badge" .
            " WHERE " . $ilDB->in("badge_id", $badge_ids, "", "integer"));
            while ($row = $ilDB->fetchAssoc($set)) {
                $obj = new self();
                $obj->importDBRow($row);
                $res[] = $obj;
            }
        }
        
        return $res;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getInstancesByUserId()

static ilBadgeAssignment::getInstancesByUserId (   $a_user_id )

static

Definition at line 96 of file class.ilBadgeAssignment.php.

References $DIC, $ilDB, and $res.

Referenced by ilPublicUserProfileGUI\getEmbeddable(), ilBadgePersonalTableGUI\getItems(), ilBadgeWAC\isAssignedBadge(), ilBadgeProfileGUI\listBadges(), and ilPersonalProfileGUI\showPublicProfileFields().

    {
        global $DIC;

        $ilDB = $DIC->database();
        
        $res = array();

        $set = $ilDB->query("SELECT * FROM badge_user_badge" .
            " WHERE user_id = " . $ilDB->quote($a_user_id, "integer") .
            " ORDER BY pos");
        while ($row = $ilDB->fetchAssoc($set)) {
            $obj = new self();
            $obj->importDBRow($row);
            $res[] = $obj;
        }
        
        return $res;
    }

Here is the caller graph for this function:

getLatestTimestamp()

static ilBadgeAssignment::getLatestTimestamp ( int  $a_user_id )

static

Get latest badge.

Parameters

int

$a_user_id

Returns

int

Definition at line 80 of file class.ilBadgeAssignment.php.

References $db, and $DIC.

Referenced by ILIAS\Badge\GlobalScreen\BadgeNotificationProvider\getNotifications().

                                                              : int
    {
        global $DIC;

        $db = $DIC->database();

        $set = $db->queryF(
            "SELECT max(tstamp) maxts FROM badge_user_badge " .
            " WHERE user_id = %s",
            ["integer"],
            [$a_user_id]
        );
        $rec = $db->fetchAssoc($set);
        return (int) $rec["maxts"];
    }

Here is the caller graph for this function:

getNewCounter()

static ilBadgeAssignment::getNewCounter ( int  $a_user_id )

static

Get new counter.

Parameters

int

$a_user_id

Returns

int

Definition at line 44 of file class.ilBadgeAssignment.php.

References $db, and $DIC.

Referenced by ILIAS\Badge\GlobalScreen\BadgeNotificationProvider\getNotifications().

                                                         : int
    {
        global $DIC;

        $db = $DIC->database();

        $user = new ilObjUser($a_user_id);
        $noti_repo = new \ILIAS\Badge\Notification\BadgeNotificationPrefRepository($user);

        $last = $noti_repo->getLastCheckedTimestamp();


        // if no last check exists, we use last 24 hours
        if ($last == 0) {
            $last = time() - (24 * 60 * 60);
        }

        if ($last > 0) {
            $set = $db->queryF(
                "SELECT count(*) cnt FROM badge_user_badge " .
                " WHERE user_id = %s AND tstamp >= %s",
                ["integer", "integer"],
                [$a_user_id, $last]
            );
            $rec = $db->fetchAssoc($set);
            return (int) $rec["cnt"];
        }
        return 0;
    }

Here is the caller graph for this function:

getPosition()

ilBadgeAssignment::getPosition

(

)

Definition at line 231 of file class.ilBadgeAssignment.php.

References $pos.

Referenced by getPropertiesForStorage().

    {
        return $this->pos;
    }

Here is the caller graph for this function:

getPropertiesForStorage()

ilBadgeAssignment::getPropertiesForStorage ( )

protected

Definition at line 264 of file class.ilBadgeAssignment.php.

References getAwardedBy(), getPosition(), and getTimestamp().

Referenced by store().

    {
        return array(
            "tstamp" => array("integer", (bool) $this->stored ? $this->getTimestamp() : time()),
            "awarded_by" => array("integer", $this->getAwardedBy()),
            "pos" => array("integer", $this->getPosition())
        );
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getStaticUrl()

ilBadgeAssignment::getStaticUrl

(

)

Definition at line 485 of file class.ilBadgeAssignment.php.

References $url, ilBadgeHandler\getInstance(), and prepareJson().

    {
        $path = ilBadgeHandler::getInstance()->getInstancePath($this);
        
        $url = ILIAS_HTTP_PATH . substr($path, 1);
        
        if (!file_exists($path)) {
            $json = json_encode($this->prepareJson($url));
            file_put_contents($path, $json);
        }
        
        return $url;
    }

Here is the call graph for this function:

getTimestamp()

ilBadgeAssignment::getTimestamp

(

)

Definition at line 208 of file class.ilBadgeAssignment.php.

References $tstamp.

Referenced by getPropertiesForStorage(), and prepareJson().

    {
        return $this->tstamp;
    }

Here is the caller graph for this function:

getUserId()

ilBadgeAssignment::getUserId

(

)

Definition at line 198 of file class.ilBadgeAssignment.php.

References $user_id.

Referenced by delete(), ilBadgeHandler\getInstancePath(), prepareJson(), and store().

    {
        return $this->user_id;
    }

Here is the caller graph for this function:

importDBRow()

ilBadgeAssignment::importDBRow ( array  $a_row )

protected

Definition at line 241 of file class.ilBadgeAssignment.php.

References setAwardedBy(), setBadgeId(), setPosition(), setTimestamp(), and setUserId().

Referenced by read().

    {
        $this->stored = true;
        $this->setBadgeId($a_row["badge_id"]);
        $this->setUserId($a_row["user_id"]);
        $this->setTimestamp($a_row["tstamp"]);
        $this->setAwardedBy($a_row["awarded_by"]);
        $this->setPosition($a_row["pos"]);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

prepareJson()

ilBadgeAssignment::prepareJson (   $a_url )

protected

Definition at line 384 of file class.ilBadgeAssignment.php.

References ilBadgeProfileGUI\BACKPACK_EMAIL, bakeImage(), getBadgeId(), getImagePath(), ilBadgeHandler\getInstance(), getTimestamp(), and getUserId().

Referenced by getStaticUrl().

    {
        $verify = new stdClass();
        $verify->type = "hosted";
        $verify->url = $a_url;
        
        $recipient = new stdClass();
        $recipient->type = "email";
        $recipient->hashed = true;
        $recipient->salt = ilBadgeHandler::getInstance()->getObiSalt();
                        
        // https://github.com/mozilla/openbadges-backpack/wiki/How-to-hash-&-salt-in-various-languages.
        $user = new ilObjUser($this->getUserId());
        $mail = $user->getPref(ilBadgeProfileGUI::BACKPACK_EMAIL);
        if (!$mail) {
            $mail = $user->getEmail();
        }
        $recipient->identity = 'sha256$' . hash('sha256', $mail . $recipient->salt);
        
        // spec: should be locally unique
        $unique_id = md5($this->getBadgeId() . "-" . $this->getUserId());
        
        $json = new stdClass();
        $json->{"@context"} = "https://w3id.org/openbadges/v1";
        $json->type = "Assertion";
        $json->id = $a_url;
        $json->uid = $unique_id;
        $json->recipient = $recipient;

        $badge = new ilBadge($this->getBadgeId());
        $badge_url = $badge->getStaticUrl();
                                    
        // created baked image
        $baked_image = $this->getImagePath($badge);
        if ($this->bakeImage($baked_image, $badge->getImagePath(), $a_url)) {
            // path to url
            $parts = explode("/", $a_url);
            array_pop($parts);
            $parts[] = basename($baked_image);
            $json->image = implode("/", $parts);
        }
        
        $json->issuedOn = $this->getTimestamp();
        $json->badge = $badge_url;
        $json->verify = $verify;
        
        return $json;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

read()

ilBadgeAssignment::read (   $a_badge_id,   $a_user_id  )

protected

Definition at line 251 of file class.ilBadgeAssignment.php.

References $db, $ilDB, and importDBRow().

Referenced by __construct().

    {
        $ilDB = $this->db;
        
        $set = $ilDB->query("SELECT * FROM badge_user_badge" .
            " WHERE badge_id = " . $ilDB->quote($a_badge_id, "integer") .
            " AND user_id = " . $ilDB->quote($a_user_id, "integer"));
        $row = $ilDB->fetchAssoc($set);
        if ($row["user_id"]) {
            $this->importDBRow($row);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setAwardedBy()

ilBadgeAssignment::setAwardedBy

(

$a_id

)

Definition at line 213 of file class.ilBadgeAssignment.php.

Referenced by importDBRow().

    {
        $this->awarded_by = (int) $a_id;
    }

Here is the caller graph for this function:

setBadgeId()

ilBadgeAssignment::setBadgeId (   $a_value )

protected

Definition at line 183 of file class.ilBadgeAssignment.php.

Referenced by __construct(), and importDBRow().

    {
        $this->badge_id = (int) $a_value;
    }

Here is the caller graph for this function:

setPosition()

ilBadgeAssignment::setPosition

(

$a_value

)

Definition at line 223 of file class.ilBadgeAssignment.php.

Referenced by importDBRow().

    {
        if ($a_value !== null) {
            $a_value = (int) $a_value;
        }
        $this->pos = $a_value;
    }

Here is the caller graph for this function:

setTimestamp()

ilBadgeAssignment::setTimestamp (   $a_value )

protected

Definition at line 203 of file class.ilBadgeAssignment.php.

Referenced by importDBRow().

    {
        $this->tstamp = (int) $a_value;
    }

Here is the caller graph for this function:

setUserId()

ilBadgeAssignment::setUserId (   $a_value )

protected

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

Referenced by __construct(), and importDBRow().

    {
        $this->user_id = (int) $a_value;
    }

Here is the caller graph for this function:

store()

ilBadgeAssignment::store

(

)

Definition at line 273 of file class.ilBadgeAssignment.php.

References $db, $ilDB, $keys, getBadgeId(), getPropertiesForStorage(), and getUserId().

Referenced by ilBadgeHandler\triggerEvaluation().

    {
        $ilDB = $this->db;
        
        if (!$this->getBadgeId() ||
            !$this->getUserId()) {
            return;
        }
        
        $keys = array(
            "badge_id" => array("integer", $this->getBadgeId()),
            "user_id" => array("integer", $this->getUserId())
        );
        $fields = $this->getPropertiesForStorage();
        
        if (!(bool) $this->stored) {
            $ilDB->insert("badge_user_badge", $fields + $keys);
        } else {
            $ilDB->update("badge_user_badge", $fields, $keys);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

updatePositions()

static ilBadgeAssignment::updatePositions (   $a_user_id, array  $a_positions  )

static

Definition at line 332 of file class.ilBadgeAssignment.php.

Referenced by ilPersonalProfileGUI\savePublicProfile().

    {
        $existing = array();
        foreach (self::getInstancesByUserId($a_user_id) as $ass) {
            $badge = new ilBadge($ass->getBadgeId());
            $existing[$badge->getId()] = array($badge->getTitle(), $ass);
        }
        
        $new_pos = 0;
        foreach ($a_positions as $title) {
            foreach ($existing as $id => $item) {
                if ($title == $item[0]) {
                    $item[1]->setPosition(++$new_pos);
                    $item[1]->store();
                    unset($existing[$id]);
                }
            }
        }
    }

Here is the caller graph for this function:

Field Documentation

$awarded_by

ilBadgeAssignment::$awarded_by

protected

Definition at line 20 of file class.ilBadgeAssignment.php.

Referenced by getAwardedBy().

$badge_id

ilBadgeAssignment::$badge_id

protected

Definition at line 17 of file class.ilBadgeAssignment.php.

Referenced by getBadgeId().

$db

ilBadgeAssignment::$db

protected

Definition at line 15 of file class.ilBadgeAssignment.php.

Referenced by delete(), getBadgesForUser(), getLatestTimestamp(), getNewCounter(), read(), and store().

$pos

ilBadgeAssignment::$pos

protected

Definition at line 21 of file class.ilBadgeAssignment.php.

Referenced by getPosition().

$stored

ilBadgeAssignment::$stored

protected

Definition at line 22 of file class.ilBadgeAssignment.php.

$tstamp

ilBadgeAssignment::$tstamp

protected

Definition at line 19 of file class.ilBadgeAssignment.php.

Referenced by getTimestamp().

$user_id

ilBadgeAssignment::$user_id

protected

Definition at line 18 of file class.ilBadgeAssignment.php.

Referenced by getUserId().

---

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

• Services/Badge/classes/class.ilBadgeAssignment.php