Genius PHP

Genius PHP is a open source library that allows you to access Genius API from your PHP application. It supports oAuth 2 from version 1.0.

Getting started

Genius PHP is avialable via Composer. Version 1.0 does not implement HTTP Client on it's own anymore and uses HTTPlug abstraction so you are free to choose any HTTP Client you want that depends on php-http/client-implementation virutal package.

composer require simivar/genius-php php-http/message php-http/guzzle6-adapter

Usage

Note: This version of Genius PHP requires PHP version of 5.6 or higher.

You can use every resource available with classes from Resources namespace. You can create main Genius object and use getters or create every object on your own.

require_once('vendor/autoload.php');

$authentication = new \Genius\Authentication\OAuth2(
  'YOUR_CLIENT_ID',
  'YOUR_CLIENT_SECRET',
  'YOUR_REDIRECT_URL',
  new \Genius\Authentication\Scope([
      \Genius\Authentication\Scope::SCOPE_ME,
      \Genius\Authentication\Scope::SCOPE_CREATE_ANNOTATION,
      \Genius\Authentication\Scope::SCOPE_MANAGE_ANNOTATION,
      \Genius\Authentication\Scope::SCOPE_VOTE,
  ]),
  null
);

if (isset($_GET[ 'code' ])) {
    $authentication->refreshToken($_GET[ 'code' ]);
} else {
    // read access token you got for user from your database or redirect him
    if (!$accessTokenFromDatabase) {
        header('Location: ' . $oauth->getAuthUrl());
    } else {
        $oauth->setAccessToken($accessTokenFromDatabase);
    }
}

$genius = new \Genius\Genius($authentication);
$upvoteAnnotation = $genius->getAnnotationsResource()->upvote(11852248);

Complete documentation, installation instructions, and examples are available at: http://simivar.github.io/Genius-PHP/.

Versioning

Genius PHP is created using Semver. All minor and patch updates are backwards compatibile. 0.1 branch is no longer maintained.

License

Please see the license file for more information.