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
	$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 23 of file class.ilBadgeHandler.php.

References settings().

        {
                $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 340 of file class.ilBadgeHandler.php.

        {       
                $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 493 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 504 of file class.ilBadgeHandler.php.

Referenced by countStaticBadgeInstances().

        {
                foreach(glob($a_path."/*") as $item)
                {                               
                        if(is_dir($item))
                        {
                                $this->countStaticBadgeInstancesHelper($a_cnt, $item);
                        }
                        else if(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 286 of file class.ilBadgeHandler.php.

References $res, ilObject\_lookupType(), array, 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 234 of file class.ilBadgeHandler.php.

References League\OAuth2\Client\Provider\$provider, $res, array, 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 264 of file class.ilBadgeHandler.php.

References $res, array, 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 519 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 473 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 127 of file class.ilBadgeHandler.php.

References $ilDB.

Referenced by getComponentCaption(), and getProviderInstance().

        {
                global $ilDB;
                
                // 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 166 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 100 of file class.ilBadgeHandler.php.

References array, and 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 207 of file class.ilBadgeHandler.php.

References array, and 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 33 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(), ilObjectBadgeTableGUI\initFilter(), ilBadgeTableGUI\initFilter(), ilObjBadgeAdministrationGUI\initFormSettings(), ilObjBadgeAdministrationGUI\initImageTemplateForm(), ilObjectServiceSettingsGUI\initServiceSettingsForm(), ilBadgeProfileGUI\listBackpackGroups(), ilBadgeManagementGUI\listBadges(), ilBadgeManagementGUI\listUsers(), ilBadgeAssignment\prepareJson(), ilBadge\prepareJson(), ilMainMenuGUI\renderEntry(), 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 478 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 545 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 80 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 70 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 90 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 147 of file class.ilBadgeHandler.php.

References $file, and 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 189 of file class.ilBadgeHandler.php.

References League\OAuth2\Client\Provider\$provider, 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 179 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 426 of file class.ilBadgeHandler.php.

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

        {
                global $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 47 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 57 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 359 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 532 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 562 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 577 of file class.ilBadgeHandler.php.

References $lng, $url, ilLink\_getLink(), ilObjUser\_lookupEmail(), array, ilNotificationConfig\DEFAULT_TTS, ilBadgeAssignment\exists(), and ilNotificationConfig\TTL_SHORT.

Referenced by triggerEvaluation().

        {
                global $lng;
                
                $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
                                
                                $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("templates/default/images/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 52 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 110 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 217 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 65 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 85 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 75 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 95 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 387 of file class.ilBadgeHandler.php.

References array, 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 327 of file class.ilBadgeHandler.php.

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

$instance

ilBadgeHandler::$instance

staticprotected

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

$settings

ilBadgeHandler::$settings

protected

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

---

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

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