Documentation

Installation | Configuration | Like Button | Comments | Like Box | Plugins’ Position | Widgets

Installation

WordPress Connect can be installed on your blog in two ways, both of which are very simple:

The first way is through the WordPress Dashboard. Simple click on Plugins -> Add New and search (Fig. 1) for WordPress Connect and click on Install Now (Fig. 2).

Fig. 1 - Installation: Searching for WordPress Connect

Fig. 2 - Installation: Install WordPress Connect

Finalize the installation by activating the plugin – click on Activate Plugin (Fig. 3).

Fig. 3 - Installation: Activate WordPress Connect

The second way is recommended to users who are comfortable working with FTP and have a basic understanding of the WordPress file structure.

  1. Upload the plugin files to your /wp-content/plugins/ directory
  2. Activate the plugin through the Plugins menu in WordPress
  3. Go to the WP Connect settings (via you administration dashboard) and set the value for Application ID (there is a link to a Facebook page where you can create those).

Configuration

Fig. 4 - Configuration: Configure WordPress Connect

After the installation is complete, before the plugin can function correctly a few configuration values must be set. These settings can be done through the WordPress Connect Options pages – go to WP Connect (via you administration dashboard).

Fig. 5 - WordPress Connect: General Settings

  • Language – The default language for all Facebook Social Plugins. Facebook is currently available in over 70 languages. WordPress Connect offers 106 (as of v2.0) different language and locale options. Read more about Facebook internalization here.
  • Application ID - Specify the Facebook Application ID. To use Facebook plugins, your blog must have an application ID. A link where you can get an application ID by registering your blog is provided. You can create a new Facebook Application/register your blog here.
  • Application Admins - Enter a comma separated list of Facebook ids for administrators/moderators.  Application administrators/moderators will be able to moderate comments and review the Like Button and Share statistics.
  • Image URL – URL to a thumbnail which will be displayed with Facebook Stream posts. The image must be at least 50px by 50px and have a maximum aspect ratio of 3:1. The image can be set for individual posts and pages by settings a Featured Image.
  • Description – The description of the blog for Facebook Like and Stream posts. This description will be used for the homepage and for all other pages (categories, tags, etc.) in the case that no other description is provided. For individual posts the text specified in the post’s excerpt (if given) will be used. Otherwise, the content itself will be used. Note: the description will always be cut-off at the first full-stop after the first 200 characters.
  • Theme – The colorscheme for Facebook Social plugins (select light or dark)

Like Button

The Like button lets a user share your blog content with friends on Facebook. When the user clicks the Like button on your blog, a story appears in the user’s friends’ News Feed with a link back to your blog (post/page). When you first install the WordPress Connect plugin, the default configuration enables adding the Like Button automatically to the top of every post (and every page) – that is, unless the currently selected theme on your blog does not change these settings (see API for more informations).

Fig. 6 - WordPress Connect: Like Button Settings

  • Send Button – Enable/Disable the Send Button.
  • Layout Style – The layout style determines the size and amount of social context next to the button.
  • Width – The width of the Like Button plugin in pixels.
  • Show Faces – Enable/Disable the display of profile pictures below the button.
  • Verb to display - The verb to display in the button. Currently only ‘like’ and ‘recommend’ are supported.
  • Font – The font of the plugin.
  • Ref - a label for tracking referrals; must be less than 50 characters and can contain alphanumeric characters and some punctuation (currently +/=-.:_)
  • Default Position – The default position of the like button plugin within a post/page. This value can be changed for every post/page individually.

You can read more about Plugins’ Position settings.

Fig. 7 - WordPress Connect: Like Button Settings (pt. 2)

Comments

Fig. 8 - WordPress Connect: Comments Settings

Fig. 9 - WordPress Connect: Comments Settings (pt. 2)

Like Box

Fig. 10 - WordPress Connect: Like Box Settings

Plugins’ Position

Some default settings for Like Button and Comments can be changed individually for every post and page. The plugins can be enabled/disabled and their position within the post/page can be modified through the settings panel displayed above.

Fig. 11 - Individual Post/Page Settings

There are three options provided for the position settings of a plugin:

  • Top – The plugin will be displayed at the top, just beneath the title and before the content of the post/page.
  • Bottom – The plugin will be displayed at the bottom right after the content of the post/page.
  • Custom – The plugin can be placed anywhere within the content using the Like or the Comments buttons from the WordPress Connect Toolbar (see the screenshot below).

Fig. 12 - WordPress Connect Toolbar

The WordPress Connect Toolbar provides an easy user interface to create WordPress shortcodes (similar to placing images and captions on a post/page) – see Fig. 13, Fig. 14. These shortcodes, which are replaced with the mark-up for the appropriate Facebook Plugin at runtime, can be used to position the plugin at any location within the post/page. Furthermore, using the shortcodes, it is possible to display multiple Like Buttons and Comments in a single post/page, e.g. when it is desirable to have a Like Button linking to other posts/pages.

Fig. 13 - WordPress Connect Toolbar: Generate Like Button Shortcode

Fig. 14 - WordPress Connect Toolbar: Generate Comments Shortcode

* Note: the shortcodes will work only if the Position is set to “Custom” (either globally, or for the particular post/page) – Fig. 11.

* Tip: It may be useful not to include any attributes in your shortcode, for example,

. All missing attributes, such as the width or colorscheme, will be set to the values from your setting pages automatically when the shortcode is replaced with the actual HTML markup. This way, if you change the theme and the like buttons in your posts (the ones for which you use shortcodes) are too wide or have the light colorscheme but the new theme works better with dark, you will need to go and change the appropriate values in all your posts. Whereas, if you leave the attributes empty, you can simply set the right values on the Like Button Settings pages and all Like Buttons (rendered from shortcodes) will update automatically.

Widgets

WordPress widgets provide simple way to arrange the various elements of your sidebar content. One of the most useful feature of WordPress Connect is the set of WordPress widgets that are provided. There is one widget for every available Facebook Social Plugin. Furthermore, because of the way WordPress widgets are designed, it is very easy to use the multiple instances of the same widget on your blog. If, for example, you wish to have a Like Button for every one of your categories, simple create that many Like Button Widgets and specify the appropriate URL value in the widget’s options. The only restriction placed on some widgets is the width of the sidebar columns. Some widgets, such as Comments and Send Button require a minimum width (of 400px) to correctly display their content. It is recommended to place these widgets into one of the footer widget areas.

WPC Activity Feed Widget

The Activity Feed Widget is a WordPress (Sidebar) widget that displays the the most interesting recent activity taking place on your site. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into your site. The activity feed displays stories when users like content on your site, when users share content from your site in Facebook or if they comment on a page on your site in the Comments box. If a user is logged into Facebook, the plugin will be personalized to highlight content from their friends. If the user is logged out, the activity feed will show recommendations from across your site, and give the user the option to log in to Facebook.

Widget - Activity Feed

Widget - Activity Feed

Back to Widgets

WPC Comments Widget

The Comments Widget is a WordPress (Sidebar) widget enables user commenting on your site. The minimum recommended width is 400px, if the columns in your sidebar have less that 400px of available space you should consider placing the widget into one of the Footer areas (which should have enough space).

Widget - Comments

Widget - Comments

Back to Widgets

WPC Facepile Widget

The Facepile Widget is a WordPress (Sidebar) Widget that displays the Facebook profile pictures of users who have liked your page or have signed up for your site.

Widget - Facepile

Widget - Facepile

Back to Widgets

WPC Like Box Widget

The Like Box Widget is a WordPress (Sidebar) Widget that enables Facebook Page owners to attract and gain Likes from their own website. The Like Box enables users to:

  • See how many users already like this Page, and which of their friends like it too
  • Read recent posts from the Page
  • Like the Page with one click, without needing to visit the Page
Widget - Like Box

Widget - Like Box

Back to Widgets

WPC Like Button Widget

The Like Widget is a WordPress (Sidebar) Widget that lets a user share your content with friends on Facebook. When the user clicks the Like button on your site, a story appears in the user’s friends’ News Feed with a link back to your website.

Widget - Like Button

Widget - Like Button

Back to Widgets

WPC Live Stream Widget

The Live Stream Widget is a WordPress (Sidebar) Widget that lets users visiting your site or application share activity and comments in real time. Live Stream works best when you are running a real-time event, like live streaming video for concerts, speeches, or webcasts, live Web chats, webinars, massively multiplayer games.

Widget - Live Stream

Widget - Live Stream

Back to Widgets

WPC Login Button Widget

The Login Button Widget is a WordPress (Sidebar) Widget that shows profile pictures of the user’s friends who have already signed up for your site in addition to a Facebook login button.

Widget - Login Button

Widget - Login Button

Back to Widgets

WPC Recommendations Widget

The Recommendations Widget is a WordPress (Sidebar) Widget that shows personalized recommendations to your users. Since the content is hosted by Facebook, the plugin can display personalized recommendations whether or not the user has logged into your site. To generate the recommendations, the plugin considers all the social interactions with URLs from your site. For a logged in Facebook user, the plugin will give preference to and highlight objects her friends have interacted with.

You must specify a domain for which to show recommendations. The domain is matched exactly, so a plugin with site=facebook.com would not include activity from developers.facebook.com or www.facebook.com. You cannot currently aggregate across multiple domains.

Widget - Recommendations

Widget - Recommendations

Back to Widgets

WPC Send Buton Widget

The Send Button Widget is a WordPress (Sidebar) Widget allows your users to easily send your content to their friends. People will have the option to send your URL in an inbox message to their Facebook friends, to the group wall of any Facebook group they are a member of, and as an email to any email address. While the Like Button allows users to share your content with all of their friends, the Send Button allows them to send a private message to just a few friends.

Widget - Send Button

Widget - Send Button

Back to Widgets