jQueryFacebookWall Documentation

jQueryFacebookWall Documentation

These Instructions are a bit dated.

I’m leaving them up so you can get an idea of what it takes to get the plugin working. New instruction are included in the download .zip with the source files. If you want to see a list of all of the plugin options checkout out the WordPress documentation – there’s a table that describes them all.

A. GETTTING STARTED

B. SETUP

 

GETTTING STARTED

Thanks for downloading your very own copy of jQueryFacebookWall.

Before we get started you should know a couple things. To get the Facebook data required to build your wall, you need or need to know the following:

  1. A Facebook account, and from that you’ll need to get the name of the account (Section 2)
  2. A Facebook App associated with that account (Section 3)
  3. A Facebook App access token (Section 4)
  4. Facebook accounts can have pages; pages have far ‘looser’ authentication requirements than normal Facebook accounts. Consequently, you can retrieve more data from them. (Section 5)

 

SETUP

Section 1 – Creating a Facebook wall

Adding a Facebook wall or timeline to your website requires a few steps (see index.html from the .zip download for a working version):

    1. Generate a Facebook access token via the steps in Section 3.
    2. Make an html element to hold the Facebook wall
    3. Call the jQueryFacebookWall plugin via the following code:
        $('.facebook-wall').jQueryFacebookWall({
            appId: 'yourAppId',
            FacebookUser: 'YourFacebookAccountName',
            domain: 'yourDomain.com'
        });

 

Section 2 – Getting your Facebook account name

Your Facebook username appears after the www.facebook.com/ in your browser url. Usually it looks something like this: www.facebook.com/*yourUserName*

In other words, if you are Rick James, your Facebook url looks something like: www.facebook.com/RickJames

facebookAccountNameFigure 1 – Facebook account name

 

Copy the value of the username, delineated by *yourUserName* above, and add it to your plugin call

$('.Facebook-wall').jQueryFacebookWall({ 
    appId: 'yourAppId', 
    FacebookUser: 'RickJames', 
    domain: 'RickJames.com'
});

 

Section 3 – Creating a Facebook app

  1. Log into your Facebook account.
  2. Go to https://developers.Facebook.com/apps
  3. Click the ‘Create New App’ button in the upper right hand corner.
  4. Fill out your app info, name, etc.

facebookAppInfoFigure 2 – Facebook App ID and App Secret

User your App Id/API Key highlighted in red above for ‘yourAppId’ in the plugin call

$('.Facebook-wall').jQueryFacebookWall({
    appId: 'yourAppId',
    FacebookUser: 'yourUserName',
    domain: 'yourDomain.com' 
});

 

Section 4 – Generating a Facebook access token

    1. Open fb_get_app_token.php and enter your Facebook app id and secret (see Figure 2) on lines 19&20.
19         $app_id = '----------------'; 
20         $app_secret = '----------------';
  1. Save and exit the file.
  2. Generate a Facebook access token for your Facebook app by running  fb_get_app_token.php in your browser. If you have unzipped the plugin and put it in, say, youDomainWebRoot/jQueryFacebooWall/, then in your browser open www.yourdomain.com/fb_get_app_token.php
  3. fb_get_app_token.php will retrieve an access token from Facebook and write it to the fb_app_token.php file. Make sure that fb_app_token.php has full write permissions.
  4. Open fb_app_token.php it should contain something that looks like this:
    {"appToken":"24506blahblahblahblahblah2722|fkLcyxj6C-_blahblahblahblahblah"}
  5. If it doesn’t, you didn’t get an access token from Facebook. An alternative method of retrieving an app access token is running www.yourdomain.com/fb_get_app_token.php?debug=true This will show debugging information for the script. If it returns an access token, copy and paste it into fb_app_token.php

facebookAccessTokenFigure 3 – Facebook Access Token

* To generate an app access token via the fb_get_app_token.php script, php must have https wrapper enabled. In your php.ini ;extension=php_openssl.dll must be uncommented, if you can’t do this you may have to contact your hosting provider or system administrator.

 

Section 5 – Facebook pages vs. regular user accounts

jQueryFacebookWall plugin makes use of Facebook’s open graph api, which has various levels of authentication requirements. Facebook pages have looser restrictions than user accounts; therefore, the plugin can retrieve more info (posts and album data) for pages than normal accounts. jQueryFacebookWall will work with normal accounts, but you will not be able to retrieve album data and you will have to edit the permissions of your posts, and photos in your Facebook account. If you don’t have a Facebook page you should consider creating one. You can do so by logging into face book and going here. https://www.Facebook.com/pages/create/

Here are the caveats imposed by Facebook’s authentication requirements:

  • Pages can have albums.
  • Pages can show all posts.
  • User accounts can’t have albums.
  • User accounts don’t include all posts.