pingpong/twitter

Twitter OAuth for Laravel

Twitter OAuth for Laravel

, _(*1)

Server Requirements

Require PHP 5.4+ or higher.

Installation

For Laravel 4.* please use version 1.*., _(*2)

Open your composer.json file, and add the new required package., _(*3)

  "pingpong/twitter": "~2" 

Next, open a terminal and run., _(*4)

  composer update 

After the composer updated. Add new service provider in app/config/app.php., _(*5)

    'Pingpong\Twitter\TwitterServiceProvider'

Next, Add new alias., _(*6)

    'Twitter'           => 'Pingpong\Twitter\Facades\Twitter',

Next, open a terminal and run., _(*7)

  php artisan vendor:publish --provider="Pingpong\Twitter\TwitterServiceProvider" 

Done., _(*8)

Configuration File

return array(
    'consumer_key'      =>  '',
    'consumer_secret'   =>  '',

    'oauth_token'       =>  null,
    'oauth_token_secret'=>  null,

    'bearer_token'      =>  null,

    'callback_url'      =>  url('twitter/callback'),
    'fallback_url'      =>  url('/')
);

Usage

Authorize the user., _(*9)

Twitter::authorize();

Authenticate the user., _(*10)

Twitter::authenticate();

You can also override the callback url when authorize or authenticate the user., _(*11)

$callbackUrl = url('twitter/getcallback');

Twitter::authorize($callbackUrl);

Twitter::authenticate($callbackUrl);

Get callback after authorize or authenticate the user., _(*12)

Twitter::getCallback();

// or using `callback` method

Twitter::callback();

Get account verify credentials., _(*13)

Twitter::getAccountVerifyCredentials();

// you can also specify what parameters want you use

$parameters = array();

Twitter::getAccountVerifyCredentials($parameters);

// or using `getCredentials` method

Twitter::getCredentials($parameters);

Global API call., _(*14)

Twitter::api($method, $path, $parameters, $multipart, $appOnlyAuth);

Twitter::api('GET', '/path');

Twitter::api('POST', '/path', $parameters);

Twitter::api('PUT', '/path', $parameters);

Twitter::api('PATCH', '/path', $parameters);

Twitter::api('DELETE', '/path/to', $parameters);

Helper method for call Twitter API., _(*15)

GET Request, _(*16)

Twitter::get('/path', $parameters);

POST Request, _(*17)

Twitter::post('/path', $parameters);

PUT Request, _(*18)

Twitter::put('/path', $parameters);

PATCH Request, _(*19)

Twitter::patch('/me', $parameters);

DELETE Request, _(*20)

Twitter::delete('/me', $parameters);

Set return format., _(*21)

Twitter::format('json');

Twitter::format('array');

Twitter::format('object');

Enable and disable curl., _(*22)

Twitter::enableCurl();

Twitter::disableCurl();

Set connection and request timeout., _(*23)

Twitter::setConnectionTimeout(2000);

Twitter::setTimeout(500);

Allows a Consumer application to exchange the OAuth Request Token for an OAuth Access Token with xAuth., _(*24)

Twitter::xAuth($username, $password);

Set token., _(*25)

Twitter::setToken($oauthToken, $oauthTokenSecret);

Get bearer token., _(*26)

$token = Twitter::getBearerToken();

Set bearer token., _(*27)

Twitter::setBearerToken($token);

Example

Authenticate the user., _(*28)

Route::get('twitter/authenticate', function()
{
    return Twitter::authenticate();
});

Authorize the user., _(*29)

Route::get('twitter/authorize', function()
{
    return Twitter::authorize();
});

Get twitter callback., _(*30)

Route::get('twitter/callback', function()
{
    try
    {
        $callback = Twitter::getCallback();

        dd($callback);
    }
    catch(Pingpong\Twitter\Exceptions\TwitterApiException $e)
    {
        var_dump($e->getMessage());
        var_dump($e->getResponse());
    }
});

Logout the user., _(*31)

Route::get('twitter/logout', function()
{
    Twitter::logout();

    return Redirect::home();
});

Post tweet., _(*32)

Route::get('twitter/tweet', function()
{
    try
    {
        $status = 'Hello world!';

        $response = Twitter::tweet($status);

        dd($response);
    }
    catch(Pingpong\Twitter\Exceptions\TwitterApiException $e)
    {
        var_dump($e->getMessage());
        var_dump($e->getResponse());
    }
});

Upload media., _(*33)

Route::get('twitter/upload', function()
{
    try
    {
        $status = 'Hello world!';
        $media  = '/path/to/your-media.ext';

        $response = Twitter::upload($status, $media);

        dd($response);
    }
    catch(Pingpong\Twitter\Exceptions\TwitterApiException $e)
    {
        var_dump($e->getMessage());
        var_dump($e->getResponse());
    }
});

REST API v1.1 Resources

Timelines

Timelines are collections of Tweets, ordered with the most recent first., _(*34)

GET statuses/mentions_timeline

Returns the 20 most recent mentions (tweets containing a users's @screen_name) for the authenticating user., _(*35)

Twitter::getStatusesMentionsTimeline($parameters, $multipart, $appOnlyAuth);

GET statuses/user_timeline

Returns a collection of the most recent Tweets posted by the user indicated by the screen_name or user_id parameters., _(*36)

Twitter::getStatusesUserTimeline($parameters, $multipart, $appOnlyAuth);

GET statuses/home_timeline

Returns a collection of the most recent Tweets and retweets posted by the authenticating user and the users they follow., _(*37)

Twitter::getStatusesHomeTimeline($parameters, $multipart, $appOnlyAuth);

GET statuses/retweet_of_me

Returns the most recent tweets authored by the authenticating user that have been retweeted by others., _(*38)

Twitter::getStatusesRetweetsOfMe($parameters, $multipart, $appOnlyAuth);

Tweets

Tweets are the atomic building blocks of Twitter, 140-character status updates with additional associated metadata., _(*39)

GET statuses/retweets/:id

Returns a collection of the 100 most recent retweets of the tweet specified by the id parameter., _(*40)

Twitter::getStatusesRetweets($id, $parameters, $multipart, $appOnlyAuth);

GET statuses/show/:id

Returns a single Tweet, specified by the id parameter., _(*41)

Twitter::getStatusesShow($id, $parameters, $multipart, $appOnlyAuth);

POST statuses/destroy/:id

Destroys the status specified by the required ID parameter., _(*42)

Twitter::postStatusesDestroy($id, $parameters, $multipart, $appOnlyAuth);

POST statuses/update

Updates the authenticating user's current status, also known as tweeting., _(*43)

Twitter::postStatusesUpdate($parameters, $multipart, $appOnlyAuth);

POST statuses/retweet/:id

Retweets a tweet., _(*44)

Twitter::postStatusesRetweet($id, $parameters, $multipart, $appOnlyAuth);

POST statuses/update_with_media

Updates the authenticating user's current status and attaches media for upload., _(*45)

Twitter::postStatusesUpdateWithMedia($parameters, $appOnlyAuth);

GET statuses/oembed

Returns information allowing the creation of an embedded representation of a Tweet on third party sites., _(*46)

Twitter::getStatusesOembed($parameters, $multipart, $appOnlyAuth);

GET statuses/retweeters/ids

Returns a collection of up to 100 user IDs belonging to users who have retweeted the tweet specified by the id parameter., _(*47)

Twitter::getStatusesRetweetersIds($parameters, $multipart, $appOnlyAuth);

Search

Find relevant Tweets based on queries performed by your users., _(*48)

GET search/tweets

Returns a collection of relevant Tweets matching a specified query., _(*49)

Twitter::getSearchTweets($parameters, $multipart, $appOnlyAuth);

Direct Messages

Direct Messages are short, non-public messages sent between two users., _(*50)

Twitter::getSearchTweets($parameters, $multipart, $appOnlyAuth);

GET direct_messages

Returns the 20 most recent direct messages sent to the authenticating user., _(*51)

Twitter::getDirectMessages($parameters, $multipart, $appOnlyAuth);

GET direct_messages/sent

Returns the 20 most recent direct messages sent by the authenticating user., _(*52)

Twitter::getDirectMessagesSent($parameters, $multipart, $appOnlyAuth);

GET direct_messages/show

Returns a single direct message, specified by an id parameter., _(*53)

Twitter::getDirectMessagesShow($parameters, $multipart, $appOnlyAuth);

POST direct_messages/destroy

Destroys the direct message specified in the required ID parameter., _(*54)

Twitter::postDirectMessagesDestroy($parameters, $multipart, $appOnlyAuth);

POST direct_messages/new

Sends a new direct message to the specified user from the authenticating user., _(*55)

Twitter::postDirectMessagesNew($parameters, $multipart, $appOnlyAuth);

Favorites

Users favorite tweets to give recognition to awesome tweets, to curate the best of Twitter, to save for reading later, and a variety of other reasons. Likewise, developers make use of "favs" in many different ways., _(*56)

GET favorites/list

Returns the 20 most recent Tweets favorited by the authenticating or specified user., _(*57)

Twitter::getFavoritesList($parameters, $multipart, $appOnlyAuth);

POST favorites/destroy

Un-favorites the status specified in the ID parameter as the authenticating user., _(*58)

Twitter::postFavoritesDestroy($parameters, $multipart, $appOnlyAuth);

POST favorites/create

Favorites the status specified in the ID parameter as the authenticating user., _(*59)

Twitter::postFavoritesCreate($parameters, $multipart, $appOnlyAuth);

NOTE: Not all functions and Facade APIs documented, _(*60)

License

This package is open-sourced software licensed under The BSD 3-Clause License, _(*61)