JSL3 Facebook Wall Feed
Displays your Facebook wall as a widget or through shortcode on a post or page.
Menu
- Description
- Installation
- Configuration
- Widget Usage
- Shortcode Usage
- Frequently Asked Questions
- Change Log
- Upgrade Notice
- Comments
- Add a Comment
Description
Displays your Facebook wall as a widget or through shortcode on a post or page. Makes use of Fedil Grogan’s Facebook Wall Feed for WordPress code and changes suggested by Daniel Westergren and Neil Pie. German translation provided by Remo Fleckinger. Facebook Graph API v2.0 bug fix provided by Andrew Bloom.
Back to the top
Installation
- Download the JSL3 Facebook Wall Feed v1.7.4 widget plugin.
- Extract the zip file to the ‘/wp-content/plugins/’ directory.
- Activate the plugin through the ‘Plugins’ menu in WordPress.
Configuration
- Create your Facebook App. NOTE: You cannot use a Facebook Page to create a Facebook App. You must use your personal Facebook profile. However, once you create your Facebook App, you can use its App ID and App Secret along with the Facebook ID of the Facebook Page you want to get the feed from on the settings page for the plugin.
- If this is your first time creating a Facebook App, you will need to register. Otherwise, skip to step e.
- Toggle the button to Yes to agree to the Facebook Policies and then click Next.
- After you enter the confirmation code that Facebook sent to your phone, click Register.
- Click Done to complete the registration.
- When you Add a New App, select the Website option.
- Click Create New Facebook App ID.
- Select a category that best fits your WordPress site and then click Create App ID.
- Enter your Site URL and Mobile Site URL in the Tell us about your website section at the bottom of the page. Do not enter www. Then click Next.
- Click the Skip to Developer Dashboard link in the Next Steps section at the bottom of the page.
- Select the Settings menu option. Enter your App Domain and Contact Email. Then click Save Changes.
- Click the Show button to reveal your App Secret.
- Make note of your App ID and App Secret. You will need them in step 2.
- Select the Status & Review menu option. Change the toggle button to Yes to make you Facebook App available to the public.
- Click Confirm to complete the creation of your Facebook App.
- Go to JSL3 Facebook Wall Feed under Settings on your WordPress Administration menu. Enter the App ID and App Secret you recorded earlier. Also, enter your Facebook ID. If you do not know your Facebook ID, you can find it at http://findmyfacebookid.com.
- Click the Save Changes button at the bottom of the page. You will be redirected to Facebook. You may be prompted to login a couple of times.
- Click Okay to give your Facebook App permission to access your public profile, News Feed, status updates and groups.
- Click Okay to give your Facebook App permission to manage your Pages.
- You will be returned to the JSL3 Facebook Wall Feed settings page with your Access Token and its expiration date.
- NOTE: Facebook has changed how the Facebook ID is used with new Facebook Apps. If, after adding your widget to your WordPress site, you see that the feed is blank, go back to the settings page for the plugin and check the box below your Facebook ID and then click the Save Changes button. This will tell the plugin to request the App Scoped User ID instead of your Facebook ID.
Widget Usage
- Go to Widgets under Appearance on your WordPress Administration menu. Drag the JSL3 Facebook Wall Feed widget to the sidebar of your choice.
- Give the widget a title (or leave it blank) and enter how many posts you want to get from your wall. You may also enter the Facebook ID of the Facebook page you want to display in the widget. If you leave the Facebook ID blank, the widget will use the Facebook ID entered on the settings page for the plugin. Click Save.
- Go check out your Facebook Wall Feed on your WordPress site.
Shortcode Usage
- Add the shortcode [jsl3_fwf] or [jsl3_fwf limit=”1″] or even [jsl3_fwf limit=”1″ fb_id=”1405307559″] to the Text view of a post or page. If you do not enter a Facebook ID, the plugin will use the Facebook ID entered on the settings page for the plugin. If your feed is blank, try setting the fb_id property to your App Scoped User ID. If you do not know your App Scoped User ID, set the app_scoped_user_id property to true like this: [jsl3_fwf limit=”1″ fb_id=”1405307559″ app_scoped_user_id=”true”]
- View your Facebook Wall Feed on your WordPress post or page.
Frequently Asked Questions
- Where can I find support for this plugin?
- How do I use shortcode to add the Facebook Wall Feed to a post or page?
- Can I translate the plugin?
- How do I get rid of the ‘Facebook Status’ box?
- How can I adjust the width of the Facebook Wall Feed?
- How do I adjust the height of the Facebook Wall Feed?
- Why is my token set to expire in less than 24 hours?
- What does the error “OAuthException: Error validating access token: Session has expired at unix time [UNIX TIME]. The current unix time is [UNIX TIME]” mean?
- What does the error “OAuthException: Error validating access token: The session has been invalidated because the user has changed the password” mean?
- What does the error “OAuthException: An access token is required to request this resource” mean?
- What does the error “Exception: No node specified” mean?
- What does the error “Exception: SETTINGS: Unrecognized pref_type 0 for NullProfileSettings pref name default_non_connection_tab” mean?
- What does “An error occurred with [Your App Name]. Please try again later” mean?
- Why is my feed blank?
- Where can I find support for this plugin?Just add a comment and I will do my best to help you.
Back to the FAQ menu - How do I use shortcode to add the Facebook Wall Feed to a post or page?Switch to HTML view and add the following:
[jsl3_fwf]
To limit the number of posts displayed add the ‘limit’ attribute:[jsl3_fwf limit="1"]
To specify a specific feed to display add the ‘fb_id’ attribute and enter the feed’s Facebook ID:[jsl3_fwf limit="1" fb_id="1405307559"]
If you do not enter a Facebook ID in the shortcode, the plugin will use the Facebook ID entered on the settings page for the plugin.
Back to the FAQ menu - Can I translate the plugin?I would be happy if you translated the plugin. You can use the ‘default.po’ file found in the ‘wp-content/plugins/jsl3-facebook-wall-feed/languages’ directory. Use Poedit to translate the plugin into your language and then save the PO file using the text domain (‘jsl3-fwf’), language code and country code as the name. For example, if you translate the plugin into German, you should save the file as ‘jsl3-fwf-de_DE.po’. Finally, place the translated PO file and its corresponding MO file in the ‘wp-content/plugins/jsl3-facebook-wall-feed/languages’ directory.Let me know the URL of the site with the translated plugin by posting a comment on the this page.
Back to the FAQ menu - How do I get rid of the ‘Facebook Status’ box?To remove the ‘Facebook Status’ box add the following to the bottom of the style sheet on the settings page for the plugin:
/* Remove Facebook Status */
#facebook_status_box h2
{
display: none;
}
Back to the FAQ menu - How can I adjust the width of the Facebook Wall Feed?To adjust the width of the Facebook Wall Feed add the following to the bottom of the style sheet on the settings page for the plugin:
/* Adjust width */
#facebook_status_box
{
width: 225px;
}
Change the number in front of “px” to one that fits for you.
Back to the FAQ menu - How do I adjust the height of the Facebook Wall Feed?To adjust the height of the Facebook Wall Feed add the following to the bottom of the style sheet on the settings page for the plugin:
#facebook_status_box #facebook_canvas
/* Adjust height */
#facebook_status_box
{
height: 500px;
}
{
height: 460px;
}
Change the numbers in front of “px” to ones that fits for you. Try to keep the height in #facebook_status_box about 40px greater than the height in #facebook_canvas if you are keeping the ‘Facebook Status’ box at the top of the feed.
Back to the FAQ menu - Why is my token set to expire in less than 24 hours?I am not sure why Facebook will give some users a short-lived token. Facebook will only allow you to attempt to renew your token once per 24 hours. Try waiting 24 hours from the last time you clicked “Save Changes” on the settings page for the plugin, then try again. If you do not get a token that lasts about 60 days, then you may want to try creating a new Facebook App for the plugin.
Back to the FAQ menu - What does the error “OAuthException: Error validating access token: Session has expired at unix time [UNIX TIME]. The current unix time is [UNIX TIME]” mean?It means your access token has expired. Go to the settings page for the plugin and click “Save Changes” to renew your token.
Back to the FAQ menu - What does the error “OAuthException: Error validating access token: The session has been invalidated because the user has changed the password” mean?It usually means you changed your Facebook password recently. Go to the settings page for the plugin and click “Save Changes” to validate your session.
Back to the FAQ menu - What does the error “OAuthException: An access token is required to request this resource” mean?It usually means you do not have an access token. Check that your App ID and App Secret are correct. Then click “Save Changes” on the settings page for the plugin.
Back to the FAQ menu - What does the error “Exception: No node specified” mean?It usually means you have not set your Facebook ID. Check that you have entered your Facebook ID on the settings page for the plugin. Then click “Save Changes” on the settings page for the plugin.
Back to the FAQ menu - What does the error “Exception: SETTINGS: Unrecognized pref_type 0 for NullProfileSettings pref name default_non_connection_tab” mean?It usually means are using an incorrect Facebook ID. Check that your Facebook ID is correct. Then click “Save Changes” on the settings page for the plugin.
Back to the FAQ menu - What does “An error occurred with [Your App Name]. Please try again later” mean?This is a Facebook error and may also include the following message:
API Error Code: 191
API Error Description: The specified URL is not owned by the application
Error Message: Invalid redirect_uri: Given URL is not allowed by the Application configuration.This error means that the App Domain and Site URL for your Facebook App do not match the domain of the website where you are using the plugin. Go to https://developers.facebook.com/apps and click “Edit Settings”. Under “Basic”, change your “App Domain” to match the domain of the website where the plugin is located. In the “Select how your app integrates with Facebook” section, under “Website with Facebook Login”, change your “Site URL” to match the URL of the website where the plugin is located. Do not use “www.” in your App Domain or Site URL.
Back to the FAQ menu - Why is my feed blank?First, a blank feed usually indicates an invalid Facebook ID. If you do not know your Facebook ID, then go to https://developers.facebook.com/tools/explorer. Click “Get Access Token”. You may be prompted to log in. If you are prompted to “Select permissions”, click “Get Access Token”. In the text box next to the “Submit” button, enter the “Facebook Username” used in your Facebook URL (for example, my Facebook URL is https://www.facebook.com/takanudo so my Facebook Username is takanudo) followed by “?fields=id”. Click Submit. Your Facebook ID will be in the results.Second, The limit property tells Facebook how many posts to return. Some of those posts could be filtered out depending on how you have configured the plugin. For example, if you set the limit to one, the post returned may be filtered out if you have “Only show posts made by this Facebook ID” checked or “Show all status messages” unchecked or “Privacy” set to “Show only wall posts labeled public”. The thoroughness option forces the plugin to keep making requests to Facebook until the limit number has been reached, but it will slow down the plugin dramatically.
Back to the FAQ menu
Change Log
1.7.4
- Added a feature to request your App Scoped User ID if your Facebook ID returns a blank feed.
- Updated the Facebook App configuration guide.
1.7.3
- Added the ability to only show posts that were posted to the Facebook ID listed in the plugin’s settings page.
- Fixed a bug introduced in Facebook Graph v2.0..
1.7.2
- Fixed a bug with how the access token renew check was scheduled.
1.7.1
- Added group permissions to the feed.
1.7
- Added the ability to display multiple feeds.
- Added a German translation to the plugin.
1.6
- This update displays the likes count for each post and comment.
1.5.5
- Updated the help section.
1.5.4
- This update should send fewer notification emails.
- Changes all URLs to use https.
1.5.3
- Fixed a minor bug introduced in v1.5.2
1.5.2
- Fixed privacy setting to work with the change Facebook made to how they display privacy settings in the feed.
- Minor change to how the style sheet is enqueued into the header.
1.5.1
- Fixed a bug in the shortcode introduced in v1.5
1.5
- Added an option to disable the make_clickable() WordPress function added in v1.4.2
- The plugin will now notify the WordPress admin that their Facebook access token is about to expire a week from the expiration date.
1.4.2
- Added an option to disable the make_clickable() WordPress function added in v1.4.2
- The plugin will now notify the WordPress admin that their Facebook access token is about to expire a week from the expiration date.
- Added make_clickable() WordPress function to convert plain text URI to HTML links.
1.4.1
- Added CRON schedule to refresh expired tokens because Facebook no longer allows non-expiring tokens.
- Fixed 1 pixel images filtered through Facebook’s safe_image.php file.
- Added ability to turn off displaying Facebook icons.
- Added additional security features.
1.3.1
- Made the feed validate XHTML 1.0 Strict.
- Made a cURL and allow_url_fopen check.
- Feed will now use the same locale as WordPress.
- Added ability to turn of SSL certificate verification.
- Added ability to display profile picture from Facebook pages with demographic restrictions.
1.2
- Added default.po file to support localization.
- Added thoroughness check.
- Added ability to show status messages.
- Added ability to show post comments.
- Added ability to open links in a new window or tab.
- Feed will now display a greater variety of wall posts.
- Accounted for newline character
1.1
- Fixed a PHP Notice error when displaying video posts.
- Added shortcode capability.
- Added a property to limit posts to only the user (posts by other users are not displayed).
- Added a privacy setting to limit the feed to only public posts.
- Added contextual help.
- Added better error handling.
1.0
- This is the initial version.
Upgrade Notice
1.7.4
Added a feature to request your App Scoped User ID if your Facebook ID returns a blank feed. Also, I finally updated the Facebook App configuration guide.
1.7.3
Added a feature to limit the posts displayed in the feed to only posts that were directly posted to the timeline associated with the Facebook ID you assign to the plugin. Also, fixed a incompatibility bug introduced with the latest Facebook Graph API.
1.7.2
Fixed a timing bug where the access token renew check would be scheduled to run before the expiration date was stored in the database.
1.7.1
A minor update to add group permissions to the feed.
1.7
The plugin now has the ability to display feeds from different Facebook pages. Also, a German translation of the plugin has been provided.
1.6
Facebook removed the likes count from the feed. This update uses a different method to get the likes count for each post. The plugin also displays the likes count for each comment.
1.5.5
The help section has been updated.
1.5.4
Hopefully this update will send fewer email notifications when your token is about to expire. Also, changed all URLs to use https.
1.5.3
Fixed a minor bug introduced in v1.5.2.
1.5.2
Facebook changed public privacy setting to be a blank entry, so I have adjusted the plugin to account for that. Also, for some users, the style sheet would be embedded more than once. This update should fix that.
1.5.1
This is a minor shortcode bug fix.
1.5
This update adds an option to disable the make_clickable() WordPress function added in v1.4.2. Also, the automatic Facebook access token renewal added in v1.4.1 never worked properly. So now the plugin will now notify the WordPress admin that their Facebook access token is about to expire a week from the expiration date. Renewing the token should simply be a matter of clicking “Save Changes” on the settings page for the plugin.
1.4.2
This is a minor update that adds the make_clickable() WordPress function to convert plain text URI to HTML links.
1.4.1
This update adds additional security features. It also adds a CRON schedule to refresh expired tokens because Facebook no longer allows non-expiring tokens.
1.3.1
This update should validate under XHTML 1.0 Strict. It also checks to see if cURL is loaded or allow_url_fopen is on. The feed will now use the same locale setting that WordPress is using.
1.2
This upgrade provides support for localization. Feel free to use the ‘default.po’ file in the ‘languages’ directory to create a translation of the plugin.
1.1
This upgrade provides added security measures and better error handling.
1.0
This is the initial version.
Back to the top
10000049968155
Your Facebook ID is 100000499681558
Thank you, problem solved.
Earl
What is “OAuthException: Error validating access token: Session has expired at unix time?”
No wall feed.
For better or worse, Facebook no longer allows non-expiring tokens. Make sure you have the latest version of the plugin. Then, on the settings page for the plugin, set “Renew Token” to a more frequent time, like “Once Hourly”. Then click “Save Changes”. Your token should be renewed after an hour.
I am assuming this is under “Additional Setting” but under what tab is this “Renew token”? I went through each tab and did not see it. Thanks for quick response.
Never mind, FIXED IT, initially I was looking at a different app to change settings. Thanks.
Can the plugin add the Facebook Like button?
Adding a like button would be difficult with the current version of the plugin. If I get enough requests for it, I may add that functionality in the future.
Is it possible to have two page feeds at once? Or have two widgets with different page feeds?
Unfortunately, the plugin is designed to work with only one feed.
How about 1 feed to appear twice. Once in a sidebar widget (which is narrow), and a second time on a page/post but widened for easy readability? Thanks!
The way the plugin is currently designed, each instance of the plugin uses the same stylesheet. Unfortunately, there is no easy way to do what you are asking.
[…] […]
It seems like there should be a way to get the images to not size to 90px wide by 90px high. Can you help?
I’m not sure what else I can do. I’m constrained by what Facebook sends in its feed. I guess I could try to detect the size of the image and then scale it accordingly, but then then question is what scale should I use. I have no way of knowing what size a person has decided to set there widget to. I’m sorry I can’t be of more help.
I get this messge, how can I solve it?
OAuthException: Unknown path components: /dartlirepro/feed
Hi, I think i’ve tried everything, but my facebook status on my website, remains empty.
Myj facebook address is facebook.com/dartlirepro
What am I doing wrong?
Use the following Facebook ID: 232798823444160
I’ve had your plug-in on several different sites and it’s worked just fine, but now I keep getting this message: Server Configuration Error: allow_url_fopen is off and cURL is not loaded. What I’m a doing wrong?
Check with your web server administrator to see if they have turned off allow_url_fopen in the php configuration. If they have then ask them to turn it back on, or to install cURL.
Ok, thank you!
I put my Q in two places here, so this is the same I got a replay from you.
Thank you!
I have 5 pages under 1 Facebook account. How can I just have a feed from one of them?
I have 5 pages under one FB account. How can I limit the feed to only one fo those pages?
I’ve never come across this scenario before. Does each page have its own Facebook ID? If not, then I don’t think you’ll be able to limit the feed to only one.
Thank you for your reply. Facebook allows you to have a personal page and then create “business” or “special/hobby interest” pages under that. This allows you to keep your personal life seperated from your business and hobbies etc. If you go to the bottom of your FB page you will see a link that says Create Page
Can you give me a link to your pages?
http://www.facebook.com/?ref=tn_tnmn#!/twinfallsbridalexpo
http://www.facebook.com/?ref=tn_tnmn#!/pages/Southern-Idaho-Bride/217063198421864
http://www.facebook.com/?ref=tn_tnmn#!/musicmagicevents
http://www.facebook.com/?ref=tn_tnmn#!/DJzoneMagazine
The Facebook ID for twinfallsbridalexpo is 143910298993447.
The Facebook ID for Southern-Idaho-Bride is 217063198421864.
The Facebook ID for musicmagicevents is 135077616550245.
The Facebook ID for DJzoneMagazine is 332520056834972.
Just use the Facebook ID of the page you want to display and you will only get its feed.
Is there a way to use multiple facebook page feeds? I have 4 feeds for a client, and they want to have a random feed pop up on refresh. I was thinking maybe make 4 sidebar widgets, then do dynamic_sidebar(rand(1,4)) or something similar, but you have to specify the ID in the main settings page, not the widget page.
Or can I just update the database on page refresh to change the ID that’s stored by JSL3 wall feed?
Kind of figured it out. In class-jsl3-fwf-widget.php, changed
$dev_options['fb_id']
to$fbIds[rand(0,3)]
and added$fbIds = array ( '123', '456', '789', '012' )
to randomly grab an ID. I hate hacking the original code though.At some point, when I can find the time, I’ll have to add the ability to display more than one feed. Until then, if you are fine with the hack, then so am I.
For some reason I cannot get the plugin to work after I customized my facebook URL. I have changed the facebook id to 312621165494342 but it still doent work – can you help?
Try using the following Facebook ID: 159899417433185
My facebook page is : https://www.facebook.com/Genanvendt.dk
Hello,
Is there another possibillity to get my profile photo in de commentbox.
I’ve tried to check and uncheck the checkbox of the Profile Picture. In both ways my Profile Picture won’t be showed in de commentbox
I can see your profile picture just fine. I’ve used Firefox 15, Internet Explorer 9, and Chrome 21.0.1180.89. What browser and version are you using?
Thank you soooo much!!!!! It worked ;o)
i seem get Error : OAuthException: Error validating client secret. Please help me fix this error.
I seem to have this error:OAuthException: Error validating client secret. Please help me fix this error
1. Please go to https://developers.facebook.com/apps and select the app you created for this plugin.
2. Copy what is under “App Secret”.
3. Paste it into the “App Secret” text box on the settings page for the plugin.
4. Click “Save Changes” on the settings page for the plugin.
Thnak you for the response.. i have done it already and its working like a charm.. 🙂
Thanks for a fresh look on facebook feeds.
I have a problem. I don’t get any feed? I have tried switching on the heavy grab option but it still don’t work… any suggestions?
Thanks
Do you have “Show all status messages” checked? Also, what are you using for a Facebook ID?
Yes I do have “Show all status messages” checked. My facebook ID is KIJKDesignStudio and not a number… The reason being is that facebook, as far as I know, have switched from using number ID’s to actual real numbers.
Thanks again for your help.
Try using the following Facebook ID: 245615568797491
Hi Takanudo
I already has that in place and it still doesn’t work. Do you have an email address that I can send some screenshots?
Thanks for trying to help.
Stefanus, I sent you an email.