class.ilBadgeBackpack.php

Go to the documentation of this file.

<?php
/* Copyright (c) 1998-2010 ILIAS open source, Extended GPL, see docs/LICENSE */
 
class ilBadgeBackpack
{
    protected $email; // [string]
    protected $uid; // [int]
    
    const URL_DISPLAYER = "https://backpack.openbadges.org/displayer/";
    
    public function __construct($a_email)
    {
        $this->email = $a_email;
    }
    
    protected function authenticate()
    {
        $json = $this->sendRequest(
            self::URL_DISPLAYER . "convert/email",
            array("email" => $this->email),
            true
        );
        
        if (!isset($json->status) ||
            $json->status != "okay") {
            return false;
        }
        
        $this->uid = $json->userId;
        return true;
    }
    
    public function getGroups()
    {
        if ($this->authenticate()) {
            $json = $this->sendRequest(
                self::URL_DISPLAYER . $this->uid . "/groups.json"
            );
            
            $result = array();
            
            foreach ($json->groups as $group) {
                $result[$group->groupId] = array(
                    "title" => $group->name,
                    "size" => $group->badges
                );
            }
            
            return $result;
        }
    }
    
    public function getBadges($a_group_id)
    {
        if ($this->authenticate()) {
            $json = $this->sendRequest(
                self::URL_DISPLAYER . $this->uid . "/group/" . $a_group_id . ".json"
            );
            
            if ($json->status &&
                $json->status == "missing") {
                return false;
            }
            
            $result = array();
            
            foreach ($json->badges as $raw) {
                $badge = $raw->assertion->badge;
                                
                // :TODO: not sure if this works reliably
                $issued_on = is_numeric($raw->assertion->issued_on)
                    ? $raw->assertion->issued_on
                    : strtotime($raw->assertion->issued_on);
                
                $result[] = array(
                    "title" => $badge->name,
                    "description" => $badge->description,
                    "image_url" => $badge->image,
                    "criteria_url" => $badge->criteria,
                    "issuer_name" => $badge->issuer->name,
                    "issuer_url" => $badge->issuer->origin,
                    "issued_on" => new ilDate($issued_on, IL_CAL_UNIX)
                );
            }
            
            return $result;
        }
    }
    
    protected function sendRequest($a_url, array $a_param = array(), $a_is_post = false)
    {
        try {
            $curl = new ilCurlConnection();
            $curl->init(false);
                
            $curl->setOpt(CURLOPT_FRESH_CONNECT, true);
            $curl->setOpt(CURLOPT_RETURNTRANSFER, true);
            $curl->setOpt(CURLOPT_FORBID_REUSE, true);
            $curl->setOpt(CURLOPT_HEADER, 0);
            $curl->setOpt(CURLOPT_CONNECTTIMEOUT, 3);
            $curl->setOpt(CURLOPT_POSTREDIR, 3);
            
            // :TODO: SSL problems on test server
            $curl->setOpt(CURLOPT_SSL_VERIFYPEER, false);
 
            $curl->setOpt(CURLOPT_HTTPHEADER, array(
                    "Accept: application/json",
                    "Expect:"
            ));
 
            if ((bool) $a_is_post) {
                $curl->setOpt(CURLOPT_POST, 1);
                if (sizeof($a_param)) {
                    $curl->setOpt(CURLOPT_POSTFIELDS, http_build_query($a_param));
                }
            } else {
                $curl->setOpt(CURLOPT_HTTPGET, 1);
                if (sizeof($a_param)) {
                    $a_url = $a_url .
                        (strpos($a_url, "?") === false ? "?" : "") .
                        http_build_query($a_param);
                }
            }
            $curl->setOpt(CURLOPT_URL, $a_url);
 
            $answer = $curl->exec();
        } catch (Exception $ex) {
            ilUtil::sendFailure($ex->getMessage());
            return;
        }
        
        return json_decode($answer);
    }
}