WordPress plugin to get latest latest posts from Facebook profile or page.

Basically this plugin fetches posts from profile or page, saves those to transient and next requests will be served from there. After transient has expired and deleted, new fetch from Facebook will be made and saved to transient. This implements very simple cache.

Handcrafted with love at Digitoimisto Dude Oy, a Finnish boutique digital agency in the center of Jyväskylä.

1. Please note before using
2. License
3. Usage
4. Usage example for displaying a Facebook page feed
5. Limiting feed items
6. Add support for likes field
7. Hooks
8. Default call parameters
9. Composer
10. Contributing

This plugin is not meant to be "plugin for everyone", it needs at least some basic knowledge about php and css to add it to your site and making it look beautiful.

This is a plugin in development for now, so it may update very often.

Dude Facebook feed is released under the GNU GPL 2 or later.

This plugin does not have settings page or provide anything visible on front-end. So it's basically dumb plugin if you don't use any filters listed below.

Only mandatory filter to use is dude-facebook-feed/parameters/access_token.

Get posts by calling function dude_facebook_feed()->get_posts(), pass Facebook id as a only argument. It id can be obtained with this tool.

1. Go to developers.facebook.com and create app for your WordPress site
2. Generate access token by going Facebook Graph API Explorer.

Here comes a tricky part. Facebook let's apps access any pages if the app was made before May 1st, 2018.

My app was created before May 1st, 2018:

Select your app in Application: dropdown, select Get Token and Get App Token. Your access_token will look like appid|appsecret.

My app was created after May 1st, 2018:

You need to be administrator in the page that you want to access. You can no longer get access token to any page but if you are the administrator, you don't need to send your app to review. Only if you need to access to any public page will you need to go through the app review process.

Select your app in Application: dropdown, select Get Token and Get User Token. Grant pretty much all privileges.

Select Get Token again and select correct page from Page Access Token. After that, copy the long "Access token" shown (can be over 200 characters). This is your access_token.

Notice that this access_token will only grant you permission to that page. For every page, you must create separate access_token.

3. Copy Access Token and create filter that returns access token to your functions.php (remember to change prefix yourtexdomain to your app/site name):

<?php
/**
 * Facebook feed
 */
 add_filter('dude-facebook-feed/parameters/access_token', 'yourtexdomain_fb_access_token' );
 function yourtexdomain_fb_access_token() {
    return 'very_long_access_token_from_fb'; // legacy access_token: 'appid|appsecret'
 }

4. Get your Facebook page numeric ID from findmyfbid.com. Go to the page you want your Facebook feed to be displayed, for example front-page.php and loop the feed and do stuff (it's always good idea to var_dump the data to see what's there to use:

$feed = dude_facebook_feed()->get_posts( '569702083062696' );

foreach ( $feed['data'] as $item ) :

  if ( $item['story'] ) :
    $message = $item['story'];
  else :
    $message = $item['message'];
  endif;

  echo $message;
endforeach;

// Limit feed to 6 items
add_filter('dude-facebook-feed/api_call_parameters', 'yourtexdomain_fb_limit' );
function yourtexdomain_fb_limit( $parameters ) {
  $parameters['limit'] = 6;
  return $parameters;
}

// Add likes support
add_filter('dude-facebook-feed/parameters/fields', 'yourtexdomain_fb_likes' );
function yourtexdomain_fb_likes( $parameters ) {
  $parameters[] = 'likes';

  return $parameters;
}

All the settings are set with filters, and there is also few filters to change basic functionality and manipulate data before caching.

You need most likely global access token to get posts from page, it's App ID and secret separated with |. If you are fetching posts from profile, please provide user access token generated with Graph API Explorer.

Defaults to empty string.

Change name of the transient for posts. Passed arguments are default name and facebook id.

Defaults to dude-facebook-user-$fbid.

Modify api call parameters just before sending those. Only passed argument is array of default parameters.

Defaults to access_token, locale, since, limit and fields wth values described later on this document.

Manipulate or use data before it's cached to transient. Only passed argument is array of posts.

Change posts cache lifetime. Only passed argument is default lifetime in seconds.

Defaults to 600 (= ten minutes).

Default parameters are below, those can be changed with filters named dude-facebook-feed/parameters/<PARAMETER>.

array(
  ["access_token"]  => ""
  ["locale"]        => "fi_FI"
  ["since"]         => "2015-12-09"
  ["limit"]         => "10"
  ["fields"]        => array(
    "id",
    "created_time",
    "type,message",
    "story",
    "full_picture",
    "link"
  )
)

To use with composer, run composer require digitoimistodude/dude-facebook-feed dev-master in your project directory or add "digitoimistodude/dude-facebook-feed":"dev-master" to your composer.json require.

If you have ideas about the theme or spot an issue, please let us know. Before contributing ideas or reporting an issue about "missing" features or things regarding to the nature of that matter, please read Please note section. Thank you very much.