Automatically add links to published posts or pages to your Facebook wall, pages or groups and more
If you have more than one Facebook account, either logout completely or login to the correct account before you start.
If you want to add links to a fan/community/business page, authorize the plugin with a personal account that owns to the page.
If you have a multi-site installation, create a separate Facebook application for each site.
Never delete an existing Facebook application, because you could delete the links added through it too.
Please note that you can add links to Facebook pages you administer (own) only. You can add links to other pages after submitting the permission manage_pages for review and getting approval from Facebook.
Facebook is not very clear about this, but you might need to submit the Facebook application for review if your want to add links to groups:
Some people need to verify their account before they can create an application. If you want to use your mobile phone number, take care that the phone number is correct. When it was wrong, you have to wait more than a week before you can try again. If the standard procedure doesn't work, you can try this page.
If you are having a problem, you can probably find the solution in the FAQ.
If you need to setup the plugin again for some reason, just remove the Facebook App ID & Secret from the Easy setup section of the plugin settings page.
Everybody has to start here. Just follow the short instruction on the setup page or the setup guide above. The first goal is the acquire the following two values from Facebook:
After entering these values you should authorize the plugin. The plugin will use the App ID and Secret to obtain an access token, which is required to access your Facebook wall.
For administrators (capability manage_options) there is one option in this section:
The default is that each user of your weblog has to setup/authorize the plugin. If you check this option all users will use your access token. After checking this option the setup page of the plugin will be accessible only to the administrator that enabled this option. Note that all users will use your name. You may want to choose Avatar of author as link picture (see below).
Links on Facebook can have a link picture, which is displayed between your Facebook profile picture and the link text(s). The plugin offers several options to automatically select a picture:
Most users probably want to use First image in the post. This is also the best option for users that use remote publishing.
Note that the default picture is used if no link picture could be found, for example if there was no featured post image selected or when there was no picture in the post.
No picture at all is not officially supported by Facebook, but you can try to use an invalid custom picture.
Pages and groups
The plugin can add a link to a page or group wall of your choice. Just check what you want, page or group, press Save and select the page or group you want to add links to. For pages it is possible to add links as page owner, instead of with your personal account. For groups this is not possible, since Facebook doesn't support it.
Some visual aspects of added links can be controlled, but most of the layout is entirely determined by Facebook. The plugin will strip all markup, since Facebook doesn't allow it.
To better understand some of the options take a look at the screen shot to see what is what.
If you use a text trailer, you should know it is just a text and it is not clickable. The text including the trailer will not be longer than 256 characters, this is what Facebook will display at maximum without truncating the text. Note that the text could be shorter, because the plugin will truncate the text after periods only (sentences). You can change the default maximum text length with trailer of 256 characters using a plugin option. If you don't use a text trailer, the complete post/page text up to 10,000 characters will be sent to Facebook and Facebook will truncate the text at 256 characters and display Read more, which when clicked will reveal the complete text. You can change the default maximum text length of 10,000 characters using a plugin option, but you shouldn't set it above 10,000 characters, since Facebook will report an error above this hard limit.
Comments and likes
Please be aware that comment integration could harm the privacy of other Facebook users!
Comments copied from Facebook to WordPress are subject to moderation and notification, depending on the WordPress discussion settings.
Link Facebook comment to:
The Facebook author name is always shown.
The plugin only mirrors comments on links it added. In summary it works like this:
You can disable comment integration for individual posts/pages by selecting Do not integrate comments on the post page.
Standard Facebook buttons
The plugin can as an extra add a standard Facebook like button/box and/or send button to your post. The layout is mostly determined by Facebook. You can only control the general layout, if there will be faces, the width, the action (like or recommend), the font and color scheme. See for details the Facebook documentation.
By default the buttons will be shown below your post/page text, but you can change that by checking Show at the top of the post. If you want more control over the location of the buttons, you can use a shortcode or template tag. See question U23 of the FAQ for details.
There are options to suppress showing the like and send button on your home page, on individual posts or pages, in archives and in categories. It is also possible to check Do not add like button on the post page to suppress showing the like/send button for individual posts.
By default the like button will link to the post or page where it is shown (recommended). It is possible to change this to a static URL with the Link to option. Use with care.
If you use a Facebook like button, you should enable the Open Graph protocol (unless you use another plugin for this purpose). Most problems with the like button do find its cause in not using the Open Graph protocol.
If you explicitly want to select when to add, check the option Do not add link by default. Alternatively you can select Do not add link to Facebook on the post page to prevent the plugin from adding a link.
If your post overview is already full of extra columns, you could check the option Don't show a summary in the post list.
I have never had a report about it, but if you have problems displaying the correct characters on Facebook, you could use the Facebook character encoding option to override the default character encoding (UTF-8).
When you don't want to use the plugin anymore, you can check Clean on deactivate before deactivating the plugin to erase all options. This doesn't erase the administrator option, however.
Checking the option I have donated to this plugin will remove all the donate buttons and links. Developing this plugin took many hours. A small donation as a token of your appreciation is always welcome.
Please let me know if you think this plugin is good or bad by rating it. Checking I have rated this plugin will remove the rating reminder message. If you don't like the plugin, please let me know why. If the plugin isn't working for you, help is just one question away.
The administrator options can only be changed by an administrator (obviously) and apply to all users.
The plugin needs to communicate with Facebook. The default timeout time is 30 seconds. If your server has a slow connection, you may have to increase the timeout time to for example 60 seconds.
When you are running a multi-user weblog, you probably want to check Do not display notices to restrict the plugin notices, mostly error messages, to the plugin setting page only. And maybe you don't want to allow usage of the plugin to all users. This is what the option Required capability to use plugin is for.
When comment integration is turned on, Facebook comments are fetched every 10 minutes by default. You can use the option Refresh Facebook comments every to do this more or less often, maybe depending on the number of visitors of your weblog.
See link appearance section above for a description of the text length options.
The plugin supports custom post types if the custom post type support custom values. Sometimes you don't want to add links for certain custom post types. That is where the option Exclude these custom post types is for. Enter the names, separated by comma's for which you don't want the plugin add links.
Speaking about excluding things, maybe you don't want to add links for certain categories. You are in luck, because you can use the option Exclude these categories for this. You should use catergory id's, not names.
If your server isn't setup completely right, there could be problems making a secure link to Facebook. In case you get cURL error 60, you can try the option Do not verify the peer's certificate as a workaround. Of course this is less secure ...
Please be aware that showing Facebook comments and status messages in the widget could harm the privacy of other Facebook users!
You can read here in the WordPress codex how widgets work.
The Add Link to Facebook widget can display:
The widget is only shown on single posts or pages (not on the home page or elsewhere). Facebook comments, status updates and the profile link are only shown if the post author has authorized the plugin (or when the option Share with all users on this site is enabled). The link to the author follow the comment integration settings (None, Profile author or Added link). The styling (layout, colors, etc) of the widget depends on the styling of your theme. You can add additional styling rules using a plugin option.
This plugin uses:
Requires: 3.2 or higher
Compatible up to: 3.9.1
Last Updated: 2014-7-19
2 of 2 support threads in the last two months have been resolved.
Got something to say? Need help?