Yesod.Facebook

Running FacebookT actions inside HandlerT

class Yesod site => YesodFacebook site where

The YesodFacebook class for foundation datatypes that support running FacebookT actions.

Minimal complete definition

fbCredentials, fbHttpManager

Methods

fbCredentials :: site -> Credentials

The credentials of your app.

fbHttpManager :: site -> Manager

HTTP manager used for contacting Facebook (may be the same as the one used for yesod-auth).

fbUseBetaTier :: site -> Bool

Use Facebook's beta tier if True. The default is False.

runYesodFbT :: (MonadHandler m, HandlerSite m ~ site, YesodFacebook site) => FacebookT Auth m a -> m a

Run a FacebookT action inside a GHandler using your credentials.

runNoAuthYesodFbT :: (MonadHandler m, HandlerSite m ~ site, YesodFacebook site) => FacebookT NoAuth m a -> m a

Run a FacebookT action inside a GHandler without using your credentials. Usually you won't need to use this function but it's provided for completeness' sake.

getFbCredentials :: (MonadHandler m, HandlerSite m ~ site, YesodFacebook site) => m Credentials

Returns Facebook's Credentials from inside a HandlerT. Just a convenience wrapper around fbCredentials.

Real-time update notifications

parseRealTimeUpdateNotifications :: (MonadHandler m, HandlerSite m ~ site, YesodFacebook site, FromJSON a) => m (RealTimeUpdateNotification a)

Same as getRealTimeUpdateNotifications but does the heavy-lifting for you. Throws an exception whenever any step fails (signature header not found, invalid signature, invalid JSON).

answerRealTimeUpdateChallenge :: MonadHandler m => RealTimeUpdateToken -> m RepPlain

Answer Facebook's challenge if the RealTimeUpdateToken matches.

Whenever you modify your subscriptions, Facebook will try to contact your server with the RealTimeUpdateToken that you gave on your call to modifySubscription. This function will correctly answer Facebook's challenge if the RealTimeUpdateToken matches, otherwise it will return notFound.

Requests

lookupRequestIds :: MonadHandler m => m (Maybe [Id])

Lookup and parse the request_ids GET parameter http://developers.facebook.com/docs/requests/.