Skip to content
No description, website, or topics provided.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Brightcenter icon overlays
demo
README.md
auth.php
bcconnect.php
group.php
result.php
student.php

README.md

#Brightcenter-PHP-SDK V1.0 In this repo you'll find the PHP-SDK for Brightcenter. In this file I'll describe how you can use the SDK.

###Download the project First of all you need to download the project. You can either check it out with git or download the zip. Once you've done this you'll have all the files needed.

###Put the files in place Then you can move the files to any folder you want. Just remember that all the downloaded files need to be in the same folder. The demo folder can be removed anytime, it just contains a little demo that show how to get the groups of a teacher.

###How to use the SDK The SDK provides three functions you can use. First you'll need to include the bcconnect.php file in your file like this:

include('../bcconnect.php');

From then you can use all the files you've downloaded, but I would recommend that you stick to bcconnector.php and result.php only!

###How to login and get the groups First we need to make a new connector object like this:

$connector = new BCConnect();

To get the groups of a teacher simply call the following method:

$groups = $connector->getGroupsOfTeacher(username, password);

where username is the teachers username and password his password. $groups now contains an array with Group objects as specified in group.php. To get a student you can call something like:

$students = $groups[0]->students;

if an error has occured an error message(String) will be returned.

###Get results of a student To get the results of a student for an assessment you can use the following function:

$results = $connector->getResultsOfStudentForAssessment(assessmentId, studentId);

where assessmentId is the id of the assessment as string and studentId is the id of the student as string. $results now contains an array with all the results of a student for an assessment as specified in result.php

###Post results of a student To post a result of an student you can call the following method:

$connector->postResultOfStudentForAssessment(assessmentId, questionId, studentId, score, duration, CompletionStatus, date);

this method will return true if the result is accepted and gives back an error message if rejected.

assessmentId is the id of the assessment as string

questionId is the id of the question as string

studentId is the id of the student as string

score is the score of the student for the question as float. This can be 0.1, 0.00001, 1.3, 100.0, 847, etc.

duration is the time in seconds as float.

CompletionStatus is the completion of the question. the completionstatus can be retrieved as constant from the CompletionStatus object. You can use:

CompletionStatus::COMPLETED;
//and
CompletionStatus::INCOMPLETE;

Please use these constants to prevent errors!

date is the date in milliseconds(Unix timestamp). for example: 18 dec 2013 = 1387321200000

You can’t perform that action at this time.