ilBadgeHandler Class Reference

Collaboration diagram for ilBadgeHandler:

Public Member Functions
	isActive ()
	setActive ($a_value)
	isObiActive ()
	setObiActive ($a_value)
	getObiOrganistation ()
	setObiOrganisation ($a_value)
	getObiContact ()
	setObiContact ($a_value)
	getObiSalt ()
	setObiSalt ($a_value)
	getComponents ()
	setComponents (array $a_components=null)
	getProviderInstance ($a_component_id)
	Get provider instance. More...
	getComponentCaption ($a_component_id)
	getUniqueTypeId ($a_component_id, ilBadgeType $a_badge)
	getTypeInstanceByUniqueId ($a_id)
	Get type instance by unique id (component, type) More...
	getInactiveTypes ()
	setInactiveTypes (array $a_types=null)
	getAvailableTypes ()
	Get badges types. More...
	getAvailableTypesForObjType ($a_object_type)
	Get valid badges types for object type. More...
	getAvailableManualBadges ($a_parent_obj_id, $a_parent_obj_type=null)
	Get available manual badges for object id. More...
	isObjectActive ($a_obj_id, $a_obj_type=null)
	triggerEvaluation ($a_type_id, $a_user_id, array $a_params=null)
	getUserIds ($a_parent_ref_id, $a_parent_obj_id=null, $a_parent_type=null)
	getInstancePath (ilBadgeAssignment $a_ass)
	countStaticBadgeInstances (ilBadge $a_badge)
	getBadgePath (ilBadge $a_badge)
	getIssuerStaticUrl ()
	rebuildIssuerStaticUrl ()
	sendNotification (array $a_user_map, $a_parent_ref_id=null)

Static Public Member Functions
static	getInstance ()
	Constructor. More...
static	updateFromXML ($a_component_id)
	Import component definition. More...
static	clearFromXML ($a_component_id)
	Remove component definition. More...

Protected Member Functions
	__construct ()
	Constructor. More...
	getComponent ($a_id)
	getBasePath ()
	countStaticBadgeInstancesHelper (&$a_cnt, $a_path)
	prepareIssuerJson ($a_url)

Protected Attributes
	$db
	$tree
	$lng
	$settings

Static Protected Attributes
static	$instance

Detailed Description

Definition at line 12 of file class.ilBadgeHandler.php.

Constructor & Destructor Documentation

__construct()

ilBadgeHandler::__construct ( )

protected

Constructor.

Returns

self

Definition at line 38 of file class.ilBadgeHandler.php.

References $DIC, and settings().

    {
        global $DIC;

        $this->db = $DIC->database();
        if (isset($DIC["tree"])) {
            $this->tree = $DIC->repositoryTree();
        }
        $this->settings = new ilSetting("bdga");
    }

Here is the call graph for this function:

Member Function Documentation

clearFromXML()

static ilBadgeHandler::clearFromXML (   $a_component_id )

static

Remove component definition.

Parameters

string

$a_component_id

Definition at line 337 of file class.ilBadgeHandler.php.

References $handler.

    {
        $handler = self::getInstance();
        $components = $handler->getComponents();
        foreach ($components as $idx => $component) {
            if ($component == $a_component_id) {
                unset($components[$idx]);
            }
        }
        $handler->setComponents($components);
    }

countStaticBadgeInstances()

ilBadgeHandler::countStaticBadgeInstances

(

ilBadge

$a_badge

)

Definition at line 474 of file class.ilBadgeHandler.php.

References $path, countStaticBadgeInstancesHelper(), getBasePath(), and ilBadge\getId().

    {
        $path = $this->getBasePath() . "instances/" . $a_badge->getId();
        $cnt = 0;
        if (is_dir($path)) {
            $this->countStaticBadgeInstancesHelper($cnt, $path);
        }
        return $cnt;
    }

Here is the call graph for this function:

countStaticBadgeInstancesHelper()

ilBadgeHandler::countStaticBadgeInstancesHelper ( &  $a_cnt,   $a_path  )

protected

Definition at line 484 of file class.ilBadgeHandler.php.

Referenced by countStaticBadgeInstances().

    {
        foreach (glob($a_path . "/*") as $item) {
            if (is_dir($item)) {
                $this->countStaticBadgeInstancesHelper($a_cnt, $item);
            } elseif (substr($item, -5) == ".json") {
                $a_cnt++;
            }
        }
    }

Here is the caller graph for this function:

getAvailableManualBadges()

ilBadgeHandler::getAvailableManualBadges	(		$a_parent_obj_id,
			$a_parent_obj_type = null
	)

Get available manual badges for object id.

Parameters

int	$a_parent_obj_id
string	$a_parent_obj_type

Returns

array id,title

Definition at line 288 of file class.ilBadgeHandler.php.

References $res, $type, ilObject\_lookupType(), getAvailableTypesForObjType(), getInstance(), and ilBadge\getInstancesByParentId().

    {
        $res = array();
        
        if (!$a_parent_obj_type) {
            $a_parent_obj_type = ilObject::_lookupType($a_parent_obj_id);
        }
        
        include_once "./Services/Badge/classes/class.ilBadge.php";
        $badges = ilBadge::getInstancesByParentId($a_parent_obj_id);
        foreach (ilBadgeHandler::getInstance()->getAvailableTypesForObjType($a_parent_obj_type) as $type_id => $type) {
            if (!$type instanceof ilBadgeAuto) {
                foreach ($badges as $badge) {
                    if ($badge->getTypeId() == $type_id &&
                        $badge->isActive()) {
                        $res[$badge->getId()] = $badge->getTitle();
                    }
                }
            }
        }
        
        asort($res);
        return $res;
    }

Here is the call graph for this function:

getAvailableTypes()

ilBadgeHandler::getAvailableTypes

(

)

Get badges types.

Returns

ilBadgeType[]

Definition at line 242 of file class.ilBadgeHandler.php.

References $id, PHPMailer\PHPMailer\$provider, $res, $type, getComponents(), getInactiveTypes(), getProviderInstance(), and getUniqueTypeId().

Referenced by getAvailableTypesForObjType().

    {
        $res = array();
        
        $inactive = $this->getInactiveTypes();
        foreach ($this->getComponents() as $component_id) {
            $provider = $this->getProviderInstance($component_id);
            if ($provider) {
                foreach ($provider->getBadgeTypes() as $type) {
                    $id = $this->getUniqueTypeId($component_id, $type);
                    if (!in_array($id, $inactive)) {
                        $res[$id] = $type;
                    }
                }
            }
        }

        return $res;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getAvailableTypesForObjType()

ilBadgeHandler::getAvailableTypesForObjType

(

$a_object_type

)

Get valid badges types for object type.

Parameters

string

$a_object_type

Returns

ilBadgeType[]

Definition at line 268 of file class.ilBadgeHandler.php.

References $id, $res, $type, and getAvailableTypes().

Referenced by getAvailableManualBadges().

    {
        $res = array();
        
        foreach ($this->getAvailableTypes() as $id => $type) {
            if (in_array($a_object_type, $type->getValidObjectTypes())) {
                $res[$id] = $type;
            }
        }
        
        return $res;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getBadgePath()

ilBadgeHandler::getBadgePath

(

ilBadge

$a_badge

)

Definition at line 495 of file class.ilBadgeHandler.php.

References $path, getBasePath(), ilBadge\getId(), and ilUtil\makeDirParents().

    {
        $hash = md5($a_badge->getId());
        
        $path = $this->getBasePath() . "badges/" .
            floor($a_badge->getId() / 100) . "/" .
            $hash . "/";
        
        ilUtil::makeDirParents($path);
        
        return $path;
    }

Here is the call graph for this function:

getBasePath()

ilBadgeHandler::getBasePath ( )

protected

Definition at line 454 of file class.ilBadgeHandler.php.

References ilUtil\getWebspaceDir().

Referenced by countStaticBadgeInstances(), getBadgePath(), getInstancePath(), getIssuerStaticUrl(), and rebuildIssuerStaticUrl().

    {
        return ilUtil::getWebspaceDir() . "/pub_badges/";
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getComponent()

ilBadgeHandler::getComponent (   $a_id )

protected

Definition at line 145 of file class.ilBadgeHandler.php.

References $db, and $ilDB.

Referenced by getComponentCaption(), and getProviderInstance().

    {
        $ilDB = $this->db;
        
        // see ilCtrl
        $set = $ilDB->query("SELECT * FROM il_component" .
            " WHERE id = " . $ilDB->quote($a_id, "text"));
        $rec = $ilDB->fetchAssoc($set);
        if ($rec["type"]) {
            return $rec;
        }
    }

Here is the caller graph for this function:

getComponentCaption()

ilBadgeHandler::getComponentCaption

(

$a_component_id

)

Definition at line 180 of file class.ilBadgeHandler.php.

References getComponent().

    {
        $comp = $this->getComponent($a_component_id);
        if ($comp) {
            return $comp["type"] . "/" . $comp["name"];
        }
    }

Here is the call graph for this function:

getComponents()

ilBadgeHandler::getComponents

(

)

Definition at line 120 of file class.ilBadgeHandler.php.

References settings().

Referenced by getAvailableTypes().

    {
        $components = $this->settings->get("components", null);
        if ($components) {
            return unserialize($components);
        }
        return array();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getInactiveTypes()

ilBadgeHandler::getInactiveTypes

(

)

Definition at line 217 of file class.ilBadgeHandler.php.

References settings().

Referenced by getAvailableTypes(), and triggerEvaluation().

    {
        $types = $this->settings->get("inactive_types", null);
        if ($types) {
            return unserialize($types);
        }
        return array();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getInstance()

static ilBadgeHandler::getInstance ( )

static

Constructor.

Returns

self

Definition at line 54 of file class.ilBadgeHandler.php.

Referenced by ilBadgePersonalTableGUI\__construct(), ilBadgeManagementGUI\__construct(), ilObjBadgeAdministrationGUI\activateTypes(), ilBadgeManagementGUI\addBadge(), ilBadgeProfileGUI\addToBackpack(), ilObjBadgeAdministrationGUI\assertActive(), ilBadgeManagementGUI\assignBadge(), ilBadgeManagementGUI\awardBadgeUserSelection(), ilObjBadgeAdministrationGUI\deactivateTypes(), ilBadgeAssignment\deleteStaticFiles(), ilBadge\deleteStaticFiles(), ilBadgeManagementGUI\editBadge(), ilBadgeProfileGUI\editSettings(), ilBadgeManagementGUI\executeCommand(), ilBadgePersonalTableGUI\fillRow(), ilObjBadgeAdministrationGUI\getAdminTabs(), getAvailableManualBadges(), ilBadgeAssignment\getImagePath(), ilBadgeTypesTableGUI\getItems(), ilObjectBadgeTableGUI\getItems(), ilBadgeUserTableGUI\getItems(), ilBadgeAssignment\getStaticUrl(), ilBadge\getStaticUrl(), ilBadgeProfileGUI\getSubTabs(), ilObjGroupGUI\getTabs(), ilObjCourseGUI\getTabs(), ilBadge\getTypeInstance(), ilBadgeManagementGUI\getValidBadgesFromClipboard(), ilBadgeAppEventListener\handleEvent(), ilBadgeTableGUI\initFilter(), ilObjectBadgeTableGUI\initFilter(), ilObjBadgeAdministrationGUI\initFormSettings(), ilObjBadgeAdministrationGUI\initImageTemplateForm(), ilObjectServiceSettingsGUI\initServiceSettingsForm(), ilBadgeLearningHistoryProvider\isActive(), ilAchievements\isActive(), ilBadgeProfileGUI\listBackpackGroups(), ilBadgeManagementGUI\listBadges(), ilBadgeManagementGUI\listUsers(), ilBadgeAssignment\prepareJson(), ilBadge\prepareJson(), ilBadgeManagementGUI\saveBadge(), ilPersonalProfileGUI\savePublicProfile(), ilObjBadgeAdministrationGUI\saveSettings(), ilBadgeProfileGUI\setTabs(), ilPersonalProfileGUI\showPublicProfileFields(), and ilObjectServiceSettingsGUI\updateServiceSettingsForm().

    {
        if (!self::$instance) {
            self::$instance = new self();
        }
        return self::$instance;
    }

Here is the caller graph for this function:

getInstancePath()

ilBadgeHandler::getInstancePath

(

ilBadgeAssignment

$a_ass

)

Definition at line 459 of file class.ilBadgeHandler.php.

References $path, ilBadgeAssignment\getBadgeId(), getBasePath(), ilBadgeAssignment\getUserId(), and ilUtil\makeDirParents().

    {
        $hash = md5($a_ass->getBadgeId() . "_" . $a_ass->getUserId());
        
        $path = $this->getBasePath() . "instances/" .
            $a_ass->getBadgeId() . "/" .
            floor($a_ass->getUserId() / 1000) . "/";
        
        ilUtil::makeDirParents($path);
        
        $path .= $hash . ".json";
        
        return $path;
    }

Here is the call graph for this function:

getIssuerStaticUrl()

ilBadgeHandler::getIssuerStaticUrl

(

)

Definition at line 521 of file class.ilBadgeHandler.php.

References $path, $url, getBasePath(), ilUtil\makeDirParents(), and prepareIssuerJson().

Referenced by rebuildIssuerStaticUrl().

    {
        $path = $this->getBasePath() . "issuer/";
        ilUtil::makeDirParents($path);
        $path .= "issuer.json";
        
        $url = ILIAS_HTTP_PATH . substr($path, 1);
        
        if (!file_exists($path)) {
            $json = json_encode($this->prepareIssuerJson($url));
            file_put_contents($path, $json);
        }
        
        return $url;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getObiContact()

ilBadgeHandler::getObiContact

(

)

Definition at line 100 of file class.ilBadgeHandler.php.

References settings().

Referenced by prepareIssuerJson().

    {
        return $this->settings->get("obi_contact", null);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getObiOrganistation()

ilBadgeHandler::getObiOrganistation

(

)

Definition at line 90 of file class.ilBadgeHandler.php.

References settings().

Referenced by prepareIssuerJson().

    {
        return $this->settings->get("obi_organisation", null);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getObiSalt()

ilBadgeHandler::getObiSalt

(

)

Definition at line 110 of file class.ilBadgeHandler.php.

References settings().

    {
        return $this->settings->get("obi_salt", null);
    }

Here is the call graph for this function:

getProviderInstance()

ilBadgeHandler::getProviderInstance

(

$a_component_id

)

Get provider instance.

Parameters

string

$a_component_id

Returns

ilBadgeProvider

Definition at line 164 of file class.ilBadgeHandler.php.

References getComponent().

Referenced by getAvailableTypes(), and getTypeInstanceByUniqueId().

    {
        $comp = $this->getComponent($a_component_id);
        if ($comp) {
            $class = "il" . $comp["name"] . "BadgeProvider";
            $file = $comp["type"] . "/" . $comp["name"] . "/classes/class." . $class . ".php";
            if (file_exists($file)) {
                include_once $file;
                $obj = new $class;
                if ($obj instanceof ilBadgeProvider) {
                    return $obj;
                }
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getTypeInstanceByUniqueId()

ilBadgeHandler::getTypeInstanceByUniqueId

(

$a_id

)

Get type instance by unique id (component, type)

Parameters

string

$a_id

Returns

ilBadgeType

Definition at line 202 of file class.ilBadgeHandler.php.

References PHPMailer\PHPMailer\$provider, $type, and getProviderInstance().

Referenced by triggerEvaluation().

    {
        $parts = explode("/", $a_id);
        $comp_id = $parts[0];
        $type_id = $parts[1];
        $provider = $this->getProviderInstance($comp_id);
        if ($provider) {
            foreach ($provider->getBadgeTypes() as $type) {
                if ($type->getId() == $type_id) {
                    return $type;
                }
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getUniqueTypeId()

ilBadgeHandler::getUniqueTypeId	(		$a_component_id,
		ilBadgeType	$a_badge
	)

Definition at line 192 of file class.ilBadgeHandler.php.

References ilBadgeType\getId().

Referenced by getAvailableTypes().

    {
        return $a_component_id . "/" . $a_badge->getId();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getUserIds()

ilBadgeHandler::getUserIds	(		$a_parent_ref_id,
			$a_parent_obj_id = null,
			$a_parent_type = null
	)

Definition at line 412 of file class.ilBadgeHandler.php.

References $path, $tree, $type, ilGroupParticipants\_getInstanceByObjId(), ilCourseParticipants\_getInstanceByObjId(), ilObject\_lookupObjectId(), and ilObject\_lookupType().

    {
        $tree = $this->tree;
                
        if (!$a_parent_obj_id) {
            $a_parent_obj_id = ilObject::_lookupObjectId($a_parent_ref_id);
        }
        if (!$a_parent_type) {
            $a_parent_type = ilObject::_lookupType($a_parent_obj_id);
        }
        
        // try to get participants from (parent) course/group
        switch ($a_parent_type) {
            case "crs":
                include_once "Modules/Course/classes/class.ilCourseParticipants.php";
                $member_obj = ilCourseParticipants::_getInstanceByObjId($a_parent_obj_id);
                return $member_obj->getMembers();

            case "grp":
                include_once "Modules/Group/classes/class.ilGroupParticipants.php";
                $member_obj = ilGroupParticipants::_getInstanceByObjId($a_parent_obj_id);
                return $member_obj->getMembers();
            
            default:
                // walk path to find course or group object and use members of that object
                $path = $tree->getPathId($a_parent_ref_id);
                array_pop($path);
                foreach (array_reverse($path) as $path_ref_id) {
                    $type = ilObject::_lookupType($path_ref_id, true);
                    if ($type == "crs" || $type == "grp") {
                        return $this->getParticipantsForObject($path_ref_id, null, $type);
                    }
                }
                break;
        }
    }

Here is the call graph for this function:

isActive()

ilBadgeHandler::isActive

(

)

Definition at line 67 of file class.ilBadgeHandler.php.

References settings().

Referenced by isObjectActive(), and triggerEvaluation().

    {
        return $this->settings->get("active", false);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

isObiActive()

ilBadgeHandler::isObiActive

(

)

Definition at line 77 of file class.ilBadgeHandler.php.

References settings().

    {
        // see bug #20124
        return false;

        return $this->settings->get("obi_active", false);
    }

Here is the call graph for this function:

isObjectActive()

ilBadgeHandler::isObjectActive	(		$a_obj_id,
			$a_obj_type = null
	)

Definition at line 354 of file class.ilBadgeHandler.php.

References ilContainer\_lookupContainerSetting(), ilObject\_lookupType(), ilObjectServiceSettingsGUI\BADGES, and isActive().

    {
        if (!$this->isActive()) {
            return false;
        }
        
        if (!$a_obj_type) {
            $a_obj_type = ilObject::_lookupType($a_obj_id);
        }

        if ($a_obj_type != "bdga") {
            include_once 'Services/Container/classes/class.ilContainer.php';
            include_once 'Services/Object/classes/class.ilObjectServiceSettingsGUI.php';
            if (!ilContainer::_lookupContainerSetting(
                $a_obj_id,
                ilObjectServiceSettingsGUI::BADGES,
                false
            )) {
                return false;
            }
        }
                
        return true;
    }

Here is the call graph for this function:

prepareIssuerJson()

ilBadgeHandler::prepareIssuerJson (   $a_url )

protected

Definition at line 508 of file class.ilBadgeHandler.php.

References getObiContact(), and getObiOrganistation().

Referenced by getIssuerStaticUrl().

    {
        $json = new stdClass();
        $json->{"@context"} = "https://w3id.org/openbadges/v1";
        $json->type = "Issuer";
        $json->id = $a_url;
        $json->name = $this->getObiOrganistation();
        $json->url = ILIAS_HTTP_PATH . "/";
        $json->email = $this->getObiContact();
        
        return $json;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

rebuildIssuerStaticUrl()

ilBadgeHandler::rebuildIssuerStaticUrl

(

)

Definition at line 537 of file class.ilBadgeHandler.php.

References $path, getBasePath(), and getIssuerStaticUrl().

    {
        $path = $this->getBasePath() . "issuer/issuer.json";
        if (file_exists($path)) {
            unlink($path);
        }
        $this->getIssuerStaticUrl();
    }

Here is the call graph for this function:

sendNotification()

ilBadgeHandler::sendNotification	(	array	$a_user_map,
			$a_parent_ref_id = null
	)

Definition at line 551 of file class.ilBadgeHandler.php.

References $lng, $url, ilLink\_getLink(), ilObjUser\_lookupEmail(), ilNotificationConfig\DEFAULT_TTS, ilBadgeAssignment\exists(), ilUtil\getImagePath(), ilContext\hasHTML(), and ilNotificationConfig\TTL_SHORT.

Referenced by triggerEvaluation().

    {
        $badges = array();
        
        include_once "Services/Badge/classes/class.ilBadge.php";
        include_once "Services/Badge/classes/class.ilBadgeAssignment.php";
        include_once "Services/Notification/classes/class.ilSystemNotification.php";
        include_once "Services/Link/classes/class.ilLink.php";
        
        foreach ($a_user_map as $user_id => $badge_ids) {
            $user_badges = array();
            
            foreach ($badge_ids as $badge_id) {
                // making extra sure
                if (!ilBadgeAssignment::exists($badge_id, $user_id)) {
                    continue;
                }
                
                if (!array_key_exists($badge_id, $badges)) {
                    $badges[$badge_id] = new ilBadge($badge_id);
                }
                
                $badge = $badges[$badge_id];
                
                $user_badges[] = $badge->getTitle();
            }
            
            if (sizeof($user_badges)) {
                // compose and send mail
                
                $ntf = new ilSystemNotification(false);
                $ntf->setLangModules(array("badge"));
                
                $ntf->setRefId($a_parent_ref_id);
                $ntf->setGotoLangId("badge_notification_parent_goto");
                
                // user specific language
                $lng = $ntf->getUserLanguage($user_id);
                
                $ntf->setIntroductionLangId("badge_notification_body");
                                
                $ntf->addAdditionalInfo("badge_notification_badges", implode("\n", $user_badges), true);
                
                $url = ilLink::_getLink($user_id, "usr", array(), "_bdg");
                $ntf->addAdditionalInfo("badge_notification_badges_goto", $url);
                            
                $ntf->setReasonLangId("badge_notification_reason");

                // force email
                $mail = new ilMail(ANONYMOUS_USER_ID);
                $mail->enableSOAP(false);
                $mail->sendMail(
                    ilObjUser::_lookupEmail($user_id),
                    null,
                    null,
                    $lng->txt("badge_notification_subject"),
                    $ntf->composeAndGetMessage($user_id, null, "read", true),
                    null,
                    array("system")
                );
                
                
                // osd
                // bug #24562
                if (ilContext::hasHTML()) {
                    $osd_params = array("badge_list" => "<br />" . implode("<br />", $user_badges));

                    require_once "Services/Notifications/classes/class.ilNotificationConfig.php";
                    $notification = new ilNotificationConfig("osd_main");
                    $notification->setTitleVar("badge_notification_subject", array(), "badge");
                    $notification->setShortDescriptionVar("badge_notification_osd", $osd_params, "badge");
                    $notification->setLongDescriptionVar("", $osd_params, "");
                    $notification->setAutoDisable(false);
                    $notification->setLink($url);
                    $notification->setIconPath(ilUtil::getImagePath('icon_bdga.svg'));
                    $notification->setValidForSeconds(ilNotificationConfig::TTL_SHORT);
                    $notification->setVisibleForSeconds(ilNotificationConfig::DEFAULT_TTS);
                    $notification->notifyByUsers(array($user_id));
                }
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

setActive()

ilBadgeHandler::setActive

(

$a_value

)

Definition at line 72 of file class.ilBadgeHandler.php.

References settings().

    {
        $this->settings->set("active", (bool) $a_value);
    }

Here is the call graph for this function:

setComponents()

ilBadgeHandler::setComponents

(

array

$a_components = null

)

Definition at line 129 of file class.ilBadgeHandler.php.

References settings().

    {
        if (is_array($a_components) &&
            !sizeof($a_components)) {
            $a_components = null;
        }
        $this->settings->set("components", $a_components !== null
            ? serialize(array_unique($a_components))
            : null);
    }

Here is the call graph for this function:

setInactiveTypes()

ilBadgeHandler::setInactiveTypes

(

array

$a_types = null

)

Definition at line 226 of file class.ilBadgeHandler.php.

References settings().

    {
        if (is_array($a_types) &&
            !sizeof($a_types)) {
            $a_types = null;
        }
        $this->settings->set("inactive_types", $a_types !== null
            ? serialize(array_unique($a_types))
            : null);
    }

Here is the call graph for this function:

setObiActive()

ilBadgeHandler::setObiActive

(

$a_value

)

Definition at line 85 of file class.ilBadgeHandler.php.

References settings().

    {
        $this->settings->set("obi_active", (bool) $a_value);
    }

Here is the call graph for this function:

setObiContact()

ilBadgeHandler::setObiContact

(

$a_value

)

Definition at line 105 of file class.ilBadgeHandler.php.

References settings().

    {
        $this->settings->set("obi_contact", trim($a_value));
    }

Here is the call graph for this function:

setObiOrganisation()

ilBadgeHandler::setObiOrganisation

(

$a_value

)

Definition at line 95 of file class.ilBadgeHandler.php.

References settings().

    {
        $this->settings->set("obi_organisation", trim($a_value));
    }

Here is the call graph for this function:

setObiSalt()

ilBadgeHandler::setObiSalt

(

$a_value

)

Definition at line 115 of file class.ilBadgeHandler.php.

References settings().

    {
        $this->settings->set("obi_salt", trim($a_value));
    }

Here is the call graph for this function:

triggerEvaluation()

ilBadgeHandler::triggerEvaluation	(		$a_type_id,
			$a_user_id,
		array	$a_params = null
	)

Definition at line 379 of file class.ilBadgeHandler.php.

References $type, ilBadgeAssignment\exists(), getInactiveTypes(), ilBadge\getInstancesByType(), getTypeInstanceByUniqueId(), isActive(), sendNotification(), and ilBadgeAssignment\store().

    {
        if (!$this->isActive() ||
            in_array($a_type_id, $this->getInactiveTypes())) {
            return;
        }
                        
        $type = $this->getTypeInstanceByUniqueId($a_type_id);
        if (!$type ||
            !$type instanceof ilBadgeAuto) {
            return;
        }
        
        include_once "Services/Badge/classes/class.ilBadge.php";
        include_once "Services/Badge/classes/class.ilBadgeAssignment.php";
        $new_badges = array();
        foreach (ilBadge::getInstancesByType($a_type_id) as $badge) {
            if ($badge->isActive()) {
                // already assigned?
                if (!ilBadgeAssignment::exists($badge->getId(), $a_user_id)) {
                    if ((bool) $type->evaluate($a_user_id, (array) $a_params, (array) $badge->getConfiguration())) {
                        $ass = new ilBadgeAssignment($badge->getId(), $a_user_id);
                        $ass->store();
                        
                        $new_badges[$a_user_id][] = $badge->getId();
                    }
                }
            }
        }
        
        $this->sendNotification($new_badges);
    }

Here is the call graph for this function:

updateFromXML()

static ilBadgeHandler::updateFromXML (   $a_component_id )

static

Import component definition.

Parameters

string

$a_component_id

Definition at line 324 of file class.ilBadgeHandler.php.

References $handler.

Referenced by ilObjDefReader\handlerBeginTag().

    {
        $handler = self::getInstance();
        $components = $handler->getComponents();
        $components[] = $a_component_id;
        $handler->setComponents($components);
    }

Here is the caller graph for this function:

Field Documentation

$db

ilBadgeHandler::$db

protected

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

Referenced by getComponent().

$instance

ilBadgeHandler::$instance

staticprotected

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

$lng

ilBadgeHandler::$lng

protected

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

Referenced by sendNotification().

$settings

ilBadgeHandler::$settings

protected

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

$tree

ilBadgeHandler::$tree

protected

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

Referenced by getUserIds().

---

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

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