PHPackages                             uisits/blackboardintegration - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. uisits/blackboardintegration

ActiveLibrary

uisits/blackboardintegration
============================

Allows interaction with the Blackboard API

v2.0.x-dev(7y ago)01.2kMITPHP

Since Mar 26Pushed 6y ago1 watchersCompare

[ Source](https://github.com/uisits/blackboardintegration)[ Packagist](https://packagist.org/packages/uisits/blackboardintegration)[ RSS](/packages/uisits-blackboardintegration/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (2)Versions (3)Used By (0)

Installation:

- Step 1 `composer require uisits/blackboardintegration`
- Step 2 `php artisan vendor:publish --tag=bbconfig`
- Step 3 Add Service Provider to your config/app.php ```
    uisits\blackboardintegration\BlackboardintegrationServiceProvider::class,

    ```
- Step 4 Add Facades to your config/app.php ```
    'Blackboard' => uisits\blackboardintegration\Facades\Blackboard::class,

    ```
- Step 5 Configure your config/bbconfig.php file Add the following env variables to this file
    BB\_HOSTNAME = ''
    BB\_KEY = 'xxxxxxxx' BB\_SECRET = 'yyyyyyyy'
    BB\_AUTH\_PATH = '/learn/api/public/v1/oauth2/token'
    BB\_DSK\_PATH = '/learn/api/public/v1/dataSources'
    BB\_TERM\_PATH = '/learn/api/public/v1/terms'
    BB\_COURSE\_PATH = '/learn/api/public/v1/courses'
    BB\_USER\_PATH = '/learn/api/public/v1/users'

**Usage:**In your controller

- `use BlackBoard;`
- ```
      $token = Blackboard::token_authorize();
      dd($token);

    ```

**Example:**

```
    $classid = "123456";
    $token = (BlackBoard::token_authorize())->access_token;
    $courseid = (BlackBoard::getCourseIdbyCourseId($token, $classid))->id;
    $course = BlackBoard::readCourse($token, $courseid);

```

Available Methods:

- token\_authorize(): creates and returns the token object
- createDatasource($access\_token): Creates and returns a new datasource
- readDatasource($access\_token, $dsk\_id): Gets and returns a datasource with id of $dsk\_id
- updateDatasource($access\_token, $dsk\_id): Updates and returns a datasource with id of $dsk\_id
- deleteDatasource($access\_token, $dsk\_id): Deletes datasource with id of $dsk\_id and returns True or False depending on success
- createTerm($access\_token, $dsk\_id): Creates and returns a new Blackboard Term on datasource with id of $dsk\_id
- readTerm($access\_token, $term\_id): Gets and returns a Term with an id of $term\_id
- updateTerm($access\_token, $dsk\_id, $term\_id): Updates Term with a disk id of $dsk\_id and term id of $term\_id
- deleteTerm($access\_token, $term\_id): Deletes Term with an id of $term\_id
- createCourse($access\_token, $dsk\_id, $term\_id): Creates and returns a new course
- readCourse($access\_token, $course\_id): Gets and returns a course with id of $course\_id
- getCourseIdbyCourseId($access\_token, $course\_id): Gets and returns the course that has the external id of $course\_id
- getCourseGradebookColumnIdbyExternalId($access\_token, $course\_id, $external\_id): Gets and returns a gradebook column with the external id of $external\_id from the course of $course\_id
- getCourseGradebookColumns($access\_token, $course\_id): Gets and returns a collection of all of the gradebook columns for a course with course id of $course\_id
- createCourseGradebookColumn($access\_token, $name, $course\_id): Creates and returns a gradebook column called $name for the course with an id of $course\_id
- getCourseGradebookColumnGrade($access\_token, $course\_id, $column\_id, $user\_id): Gets and returns the grade object for the student of $user\_id in the gradebook column with id of $column\_id in the course with $course\_id
- updateCourseGradebookColumnGrade($access\_token, $course\_id, $user\_id, $column\_id, $score): Updates and returns a grade with a value of $score for the student of $user\_id in the gradebook column with id of $column\_id in the course with $course\_id
- updateCourse($access\_token, $dsk\_id, $course\_id, $course\_uuid, $course\_created, $termId): Updates Course values of $dsk\_id, $course\_uuid, $course\_created, and $termId where the course id is $course\_id
- deleteCourse($access\_token, $course\_id): Deletes Course with an id of $course\_id and returns True or False depending on success
- createUser($access\_token, $dsk\_id): Creates and returns a user created on the datasource with id of $dsk\_id
- readUser($access\_token, $user\_id): Gets and returns a user with an id of $user\_id
- readUserCourses($access\_token, $user\_id): Gets and returns a collection of courses associated with the user with an id of $user\_id
- getUserIdbyNetid($access\_token, $user\_id): Gets and returns the user object that has a netid of $user\_id
- updateUser($access\_token, $dsk\_id, $user\_id, $user\_uuid, $user\_created): Updates and returns a user with the values of $dsk\_id, $user\_uuid, and $user\_created for a user with an id of $user\_id
- deleteUser($access\_token, $user\_id): Deletes a user with an id of $user\_id and returns True or False depending on success
- createMembership($access\_token, $dsk\_id, $course\_id, $user\_id): Creates and returns a membership for a user with id of $user\_id in course with an id of $course\_id
- readMembership($access\_token, $course\_id, $user\_id): Gets and returns a membership for a user with id of $user\_id for the course with $course\_id
- updateMembership($access\_token, $dsk\_id, $course\_id, $user\_id, $membership\_created): Updates and returns a membership with values of $membership\_created and $dsk\_id for user with $user\_id in course with $course\_id
- deleteMembership($access\_token, $course\_id, $user\_id): Deletes a membership for a user with $user\_id and course with $course\_id and returns True or False depending on success

Resources: Blackboard API:

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~15 days

Total

2

Last Release

2590d ago

Major Versions

v1.0.x-dev → v2.0.x-dev2019-04-11

### Community

Maintainers

![](https://www.gravatar.com/avatar/740bacd4c073191efba56c0256c7db4e2f3c1dac40f7ff44c1c904e7571860a0?d=identicon)[uisits](/maintainers/uisits)

---

Top Contributors

[![bneale35](https://avatars.githubusercontent.com/u/37228444?v=4)](https://github.com/bneale35 "bneale35 (21 commits)")[![ChinwalPrasad](https://avatars.githubusercontent.com/u/40767861?v=4)](https://github.com/ChinwalPrasad "ChinwalPrasad (4 commits)")[![tllos1](https://avatars.githubusercontent.com/u/40802058?v=4)](https://github.com/tllos1 "tllos1 (3 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/uisits-blackboardintegration/health.svg)

```
[![Health](https://phpackages.com/badges/uisits-blackboardintegration/health.svg)](https://phpackages.com/packages/uisits-blackboardintegration)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)