2017 © Pedro Peláez
 

library trakt

Trakt API wrapper

image

wubs/trakt

Trakt API wrapper

  • Saturday, October 7, 2017
  • by megawubs
  • Repository
  • 8 Watchers
  • 30 Stars
  • 704 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 18 Forks
  • 5 Open issues
  • 9 Versions
  • 10 % Grown

The README.md

Trakt-api-wrapper version 2

This is the Trakt API wrapper for their new API (version 2)., (*1)

Installation

In your composer.json file add:"wubs/trakt": "~2.0" and run composer install, (*2)

The goal

The goal of this wrapper is to make communicating with the Trakt api easier. It aims to be easy, readable and usable in many cases. Designed as a composer package it can be easy installed inside a lager application., (*3)

Laravel usage

To use the wrapper inside Laravel, you only have to add Wubs\Trakt\Providers\Laravel\TraktApiServiceProvider::class to the providers array in your config/app.php file. When you've done this, use the \Wubs\Trakt\Trakt class as a type hint to inject it into routes or methods. See here an example:, (*4)

```php Route::get( '/', function (\Wubs\Trakt\Trakt $trakt) { dump($trakt->movies->popular()); } );, (*5)


### Non Laravel Usage

If you don't use Laravel, you have to do a bit more to get it working.

## Instantiating the Trakt API Wrapper

The API Wrapper needs one dependency. The `Wubs\Trakt\Auth` class, that in turn depends on 
`Wubs\Trakt\Provider\TraktProvider` The `TraktProvider` holds your client id, secret and your redirect url. To make an 
Auth object:

 ```PHP
 <?php
 $provider = new TraktProvider($clientId, $clientSecret, $redirectUrl);
 $auth = new Auth($provider);
 ```

With this, you can create the `Trakt` class.

```PHP
$trakt = new Trakt($auth);

If you want to mock http request, you can give Trakt a second argument that must implement GuzzleHttp\ClientInterface. When you don't pass one, the real implementation is used to send requests to Trakt., (*6)

Once you've created the Trakt object, you should register it inside your IoC container, so you only have to write the code that instantiates the Trakt class once., (*7)

OAuth

To get your OAuth token, do the following after creating the Trakt object., (*8)

<?php
$trakt->auth->authorize();

When you created the Auth object, you specified a redirect url. This is the url Trakt is going to redirect the user to, with an code you can use to obtain an access token., (*9)

The moment you call $trakt->auth->authorize(); the user will be directed to the authorization page of trakt.tv. After giving your application access to their account, Trakt redirects to the provided url, with a code. This code can than be used to obtain the access token. This can be done like so: $trakt->auth->token($code);, (*10)

But, when you don’t have a website running yet, you can’t specify a return url. To get the code displayed on the trakt site, you need to tell Trakt that you want to redirect to them self and display the code you need to obtain an access token. You can do this by providing the following string as redirect url: urn:ietf:wg:oauth:2.0:oob. This is only necessary when you have no local dev machine running., (*11)

So, lets say your client id is 12345678 and you client secret is secret01 and we you a local dev machine with the host nametrakt.dev. Now, you can set trakt.dev/trakt/auth as our redirect url., (*12)

With this you can create a route from witch you do the following. Lets say it's your index route., (*13)

```PHP <?php, (*14)

//... initiate Auth, (*15)

$auth = $trakt->auth->authorize();, (*16)

//route: trakt/auth $token = $trakt->auth->token($_GET['code']);, (*17)


When you now go through the OAuth flow, you'll get your token (an instance of 
`League\OAuth2\Client\Token\AccessToken`) dumped out on the screen. Store the 
values from the token somewhere so you can recreate it later when the user needs it. You can do this by 
using `$trakt->auth->createToken()` and pass the required parameters `$token`, `$type`,`$expires`, 
`$refresh` and `$scope`. This wil return an instance of `League\OAuth2\Client\Token\AccessToken` which you can pass 
to methods that (optionally )require an token.

## Using the api wrapper

Now that you have the access token, you can use it to retrieve user-specific data from trakt.tv with the `Trakt` class.

```PHP
<?php

//initialize Auth here...

$trakt = new Trakt($auth);
$token = $trakt->auth->createToken($token, $type, $expires, $refresh, $scope);

$settings = $trakt->users->settings($token);
$comment = $trakt->comments->get($commentId);
$movie = $trakt->search->byId($type, $id);
$movie = $trakt->search->byId($type, $id, $token); //can be with, or without token.

Pagination and Extended info

To utilise the extended info and pagination features, you have to set the page or extended info level before calling the endpoint. Here is an example:, (*18)

<?php
$trakt->movies->page(2)->collected(); //this will get the second page of the /movies/collected endpoint
//when you want to specify a limit
$trakt->movies->page(2)->limit(15)->collected(); //this will give you the second page, with 15 items

Extended info goes along the same way:, (*19)

<?php

$trakt->movies->withImages()->collected();//this will give you all kinds of extra images
//or
$trakt->movies->withFull()->collected(); //this will give you a lot of extra data

You can also combine all of this:, (*20)

<?php
$response = trakt->movies
    ->page(2)
    ->withImages()
    ->withFull()
    ->limit(20)
    ->collected();

The response will now be the second page of the movies/collected endpoint, with all images and all data limited to 20 items per page., (*21)

Feel free to contact me or help development :), (*22)

The Versions

07/10 2017

dev-master

9999999-dev

Trakt API wrapper

  Sources   Download

The Requires

 

The Development Requires

by Avatar megawubs

02/07 2016

2.2.0

2.2.0.0

Trakt API wrapper

  Sources   Download

The Requires

 

The Development Requires

by Avatar megawubs

02/07 2016

dev-fixes

dev-fixes

Trakt API wrapper

  Sources   Download

The Requires

 

The Development Requires

by Avatar megawubs

18/09 2015

dev-develop

dev-develop

Trakt API wrapper

  Sources   Download

The Requires

 

The Development Requires

by Avatar megawubs

18/09 2015

2.1.2

2.1.2.0

Trakt API wrapper

  Sources   Download

The Requires

 

The Development Requires

by Avatar megawubs

18/09 2015

2.1.1

2.1.1.0

Trakt API wrapper

  Sources   Download

The Requires

 

The Development Requires

by Avatar megawubs

16/09 2015

2.0

2.0.0.0

Trakt API wrapper

  Sources   Download

The Requires

 

The Development Requires

by Avatar megawubs

08/01 2015

1.0.x-dev

1.0.9999999.9999999-dev

Trakt api wrapper for php

  Sources   Download

The Development Requires

by Avatar megawubs

08/01 2015

v0.1

0.1.0.0

Trakt api wrapper for php

  Sources   Download

The Development Requires

by Avatar megawubs