Inherits from INKHandler : NSObject
Declared in INKTwitterHandler.h

Overview

An instance of INKTwitterHandler performs Twitter-related tasks in third-party Twitter apps.

Tasks

Other Methods

  •   callbackURL

    A URL to be opened by the third-party app when the action has been completed. Not all third-party apps support callbacks.

    property
  •   activeUser

    For Twitter clients that support multiple accounts, specifies the screen name of the account that should be used.

    property
  • – showTweetWithId:

    Shows a specific single tweet

Standard Twitter actions

Properties

activeUser

@property (strong, nonatomic) NSString *activeUser
Discussion

For Twitter clients that support multiple accounts, specifies the screen name of the account that should be used.

Declared In

INKTwitterHandler.h

callbackURL

@property (strong, nonatomic) NSURL *callbackURL
Discussion

A URL to be opened by the third-party app when the action has been completed. Not all third-party apps support callbacks.

Declared In

INKTwitterHandler.h

Instance Methods

favoriteTweetWithId:

- (INKActivityPresenter *)favoriteTweetWithId:(NSString *)tweetId
Discussion

Favorites a tweet.

Parameters

tweetId

The ID of a tweet to favorite.

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

followUser:

- (INKActivityPresenter *)followUser:(NSString *)user
Discussion

Follows a given user.

Parameters

user

A screen name or user ID

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

retweetTweetWithId:

- (INKActivityPresenter *)retweetTweetWithId:(NSString *)tweetId
Discussion

Retweets a tweet.

Parameters

tweetId

The ID of a tweet to retweet.

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

searchFor:

- (INKActivityPresenter *)searchFor:(NSString *)query
Discussion

Searches for tweets or users

Parameters

query

A string to search for

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

sendDirectMessageToScreenName:

- (INKActivityPresenter *)sendDirectMessageToScreenName:(NSString *)screenName
Discussion

Opens a window to compose a new DM / view DMs for a given user.

Parameters

screenName

A screen name to search for

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

showDirectMessages

- (INKActivityPresenter *)showDirectMessages
Discussion

Shows DMs for the active user

Warning: The first-party Twitter app does not have a “Messages” screen any more. If this results in opening Twitter.app, the “Connect” page will be displayed, which aggregates @mentions, DMs, and favorites/retweets/etc.

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

showFavorites

- (INKActivityPresenter *)showFavorites
Discussion

Shows the tweets the current user has favorited

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

showListWithId:

- (INKActivityPresenter *)showListWithId:(NSString *)listId
Discussion

Shows a specific list.

Parameters

listId

The id of a list

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

showLists

- (INKActivityPresenter *)showLists
Discussion

Shows the current user’s lists.

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

showMentions

- (INKActivityPresenter *)showMentions
Discussion

Shows @mentions for the active user

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

showRetweets

- (INKActivityPresenter *)showRetweets
Discussion

Show retweets.

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

showTimeline

- (INKActivityPresenter *)showTimeline
Discussion

Shows the timeline of the active user

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

showTweetWithId:

- (INKActivityPresenter *)showTweetWithId:(NSString *)tweetId
Discussion

Shows a specific single tweet

Parameters

tweetId

The id of a status update

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

showUserWithId:

- (INKActivityPresenter *)showUserWithId:(NSString *)userId
Discussion

Shows the timeline of a given user

Parameters

userId

The user id of a Twitter user

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

showUserWithScreenName:

- (INKActivityPresenter *)showUserWithScreenName:(NSString *)screenName
Discussion

Shows the timeline of a given user

Parameters

screenName

The screen name/handle of a Twitter user

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

tweetMessage:

- (INKActivityPresenter *)tweetMessage:(NSString *)message
Discussion

Opens a window to compose a new tweet

Parameters

message

The content to pre-populate the input box with

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

tweetMessage:inReplyTo:

- (INKActivityPresenter *)tweetMessage:(NSString *)message inReplyTo:(NSString *)replyId
Discussion

Opens a window to compose a new relpy

Parameters

message

The content to pre-populate the input box with

replyId

The id of a tweet that the new tweet is a reply to.

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

tweetSearchPage

- (INKActivityPresenter *)tweetSearchPage
Discussion

Shows the search screen.

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

unfavoriteTweetWithId:

- (INKActivityPresenter *)unfavoriteTweetWithId:(NSString *)tweetId
Discussion

Unfavorites a tweet.

Parameters

tweetId

The ID of a tweet to unfavorite.

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h

unfollowUser:

- (INKActivityPresenter *)unfollowUser:(NSString *)user
Discussion

Unfollows a given user.

Parameters

user

A screen name or user ID

Return Value

A INKActivityPresenter object to present.

Declared In

INKTwitterHandler.h