NAME

Mojo::Facebook - Talk with Facebook

VERSION

0.0401

DESCRIPTION

This module implements basic actions to the Facebook graph protocol.

SYNOPSIS

    use Mojo::Facebook;
    my $fb = Mojo::Facebook->new(access_token => $some_secret);

    # fetch facebook name
    Mojo::IOLoop->delay(
        sub {
            my($delay) = @_;
            $fb->fetch({
                from => '1234567890',
                fields => 'name',
            }, $delay->begin);
        },
        sub {
            my($delay, $res) = @_;
            warn $res->{error} || $res->{name};
        },
    )

    # fetch cover photo url
    $fb->fetch({
        from => '1234567890',
        fields => ['cover']
    }, sub {
        my($fb, $res) = @_;
        return $res->{errors} if $res->{error};
        warn $res->{cover}{source}; # URL
    });

ERROR HANDLING

Facebook JSON errors will be set in the $res hash returned to the callback:

Error messages

• Could not decode JSON from Facebook

• $fb_json->{error}{message}

• HTTP status message

• Unknown error from JSON structure

ATTRIBUTES

access_token

This attribute need to be set when doing "fetch" on private objects or when issuing "post". This is not "code" query param from the Facebook authentication process, something which need to be fetched from Facebook later on. See the source code forMojolicious::Plugin::OAuth2 for details.

    $oauth2->get_token(facebook => sub {
        my($oauth2, $access_token) = @_;
        $fb = Mojo::Facebook->new(access_token => $access_token);
        $fb->post({
            to => $fb_uid,
            message => "Mojo::Facebook works!",
        }, sub {
            # ...
        });
    });

app_namespace

This attribute is used by "publish" as prefix to the publish URL:

    https://graph.facebook.com/$id/$app_namespace:$action

scheme

Used to either run requests over "http" or "https". Default to "https".

METHODS

fetch

    $self->fetch({
        from => $id,
        fields => [...]
        ids => [...],
        limit => $Int,
        offset => $Int,
    }, $callback);

Will fetch information from Facebook about a user.

$id can be ommitted and will then default to "me". $callback will be called like this:

    $callback->($self, $res);

$res will be a hash-ref containing the result. Look for the "error" key to check for errors.

comment

    $self->comment({ on => $id, message => $str }, $callback);

Will add a comment to a graph element with the given $id.

$callback will be called like this:

    $callback->($self, $res);

$res will be a hash-ref containing the result. Look for the "error" key to check for errors.

publish

    $self->publish({
        to => $id,
        action => $str,
        $object_name => $object_url,

        # optional
        start_time => $DateTime,
        end_time => $DateTime,
        expires_in => $int,
        message => $str,
        place => $facebook_id,
        ref => String,
        tags => "$facebook_id,...",

        # any other key/value is considered to be custom
        $custom_attribute => $any,
    });

Publish a story at $who's wall, looking like this:

    .--------------------------------------.
    | $who $action a $object_name ... $app |
    |                                      |
    | .----------.                         |
    | |  $image  |  [$url]($title)         |
    | |          |  $descripton ...        |
    | '----------'                         |
    '--------------------------------------'

Required HTML:

    <meta property="fb:app_id" content="$app_id" />
    <meta property="og:image" content="$url" />
    <meta property="og:title" content="$str" />
    <meta property="og:url" content="$url_to_self" />
    <meta property="og:description" content="$str">
    <meta property="og:type" content="$app_namespace:$action" />

$callback will be called like this:

    $callback->($self, $res);

$res will be a hash-ref containing the result. Look for the "error" key to check for errors.

delete_object

    $self->delete_object($id, $callback);

Will try to remove an object from Facebook.

&callback will be called like this:

    $callback->($self, $res);

$res will be a hash-ref containing the result. Look for the "error" key to check for errors.

picture

    $url = $self->picture;
    $url = $self->picture($who, $type);

Returns a Mojo::URL object with the URL to a Facebook image.

$who defaults to "me". $type can be "square", "small" or "large". Default to "square".

COPYRIGHT & LICENSE

This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Jan Henning Thorsen - jhthorsen@cpan.org

cpanm Mojo::Facebook

perl -MCPAN -e shell
install Mojo::Facebook