collective.simplesocial 1.4

Prerequisites

To use the Like Box portlet, you must complete the steps in the section on Creating a Facebook Application. You also need a Facebook Page. Take note of the numeric ID of the Page (it appears in the URL when viewing the page in Facebook), and enter in when you create the portlet.

Adding a Like Box

1. Go to Site Setup.

2. Click Add/Remove Products.

3. Check ‘Facebook Like Box portlet’ and click Install.

4. Return to Site Setup.

5. Click Facebook Settings.

6. Paste in the Application ID that you recorded when creating your Facebook application. Click Save.

7. Navigate to the location in the site where you want to add the portlet.

8. Click ‘Manage portlets’.

9. Click on the dropdown to add a portlet to the column where you want the like box to appear, and select ‘Facebook Like Box’.

10. Paste in the numeric ID of the Facebook Page you want to promote.

11. You may configure whether or not an activity stream appears, the number of fan connections to display, and the width of the like box.

12. Click save and return to the location where you assigned the portlet to view the like box.

Prerequisites

To use the Feed Form portlet, you must first complete the steps in the section on Creating a Facebook Application.

Adding a Feed Form

1. Go to Site Setup.

2. Click Add/Remove Products.

3. Check ‘Facebook Feed Form portlet’ and click Install.

4. Return to Site Setup.

5. Click Facebook Settings.

6. Paste in the Application ID that you recorded when creating your Facebook application. Click Save.

7. Navigate to the location in the site where you want to add the portlet.

8. Click ‘Manage portlets’.

9. Click on the dropdown to add a portlet to the column where you want the feed form to appear, and select ‘Facebook Feed Form’.

10. Edit the settings as prompted. When finished, click Save.

11. Return to the location where you assigned the portlet to view the feed form.

If a visitor to a page with a feed form is not logged into Facebook, then the feed form will not appear automatically. Instead, a message will be shown along with a Facebook login button. Clicking this button will allow the visitor to log into Facebook, after which the feed form will be displayed.

Customizing the Feed Attachment

When a user submits a feed form, collective.simplesocial sends along an attachment to Facebook with information about the content item where the feed form was displayed. By default, this attachment contains the following information:

• The title of the content item

• The URL of the content item

• The content item’s description, if it provides one

• The content item’s tile image, if it provides one, or the site logo

These defaults are provided by the DefaultFeedFormDataProvider adapter. It is possible to override the defaults globally or for a particular content type by registering an adapter that provides the IFeedFormDataProvider interface. This interface provides methods for getting the attachment for the current context and for overriding the settings specified in the portlet assignment. For more information, see collective.simplesocial.feedform.facebookfeedform.IFeedFormDataProvider and the documentation for the stream.publish method and stream attachment object.

Prerequisites

To use the Post to Facebook Fan Page feature, you must first complete the steps in the section on Creating a Facebook Application.

Configuring the ‘Post to Fan Page’ feature

1. Go to Site Setup.

2. Click Add/Remove Products.

3. Check ‘Post to Facebook Fan Page’ and click Install.

4. Return to Site Setup.

5. Click Facebook Settings.

6. Paste in the Application ID that you recorded when creating your Facebook application.

7. If prompted, log into Faceboook to see a list of Facebook pages for which you are an administrator.

8. Select the Facebook fan page you want to post to. Click Save.

Now the ‘Post to Fan Page’ link should show up when you are logged in. To post to Facebook, click on the link. You will be prompted to confirm the message that will be posted.

Miscellaneous tips

• The TAL parser likes to complain about mismatched tags when using tags with the ‘fb’ XML namespace. You may need to escape such tags and include them with a tal:replace or put them in a separate file and include them via a browser view method that reads that file.

• The Facebook javascript library is loaded asynchronously, which means that Facebook API calls cannot be made immediately when the page is loaded. To address this issue, the SimpleSocial javascript library implements a queue that stores functions that depend on the Facebook API until the API is fully loaded. It then executes all of the functions in the queue in the order that they were inserted. Functions passed to the queue after the Facebook API has loaded are executed immediately.

  SimpleSocial.queue behaves like a javascript array. To add a function to the queue, use the push method:

  SimpleSocial.queue.push(function () {
    // Do something using the Facebook API.
  });

• Use logic like the following to do something different depending on whether or not the user is already logged into Facebook and connected to your application:

  SimpleSocial.queue.push(function () {
    FB.getLoginStatus(function (response) {
      if (response.session) {
        // The user is logged in and connected.
      } else {
        // The user is not logged in or is not connected
        // to your application.
      }
    });
  });

  For more information, see the documentation for FB.getLoginStatus.

Additional Facebook API Resources

• Facebook Developer Documentation

• Facebook JavaScript SDK

• Social Plugins

• XFBML

1.4 (2010-09-21)

• Removed user message option from feed form because Facebook no longer supports it. [yomatters]

• Dropped support for Internet Explorer 6 because Facebook no longer supports it. [yomatters]

• Fixed escaping bug in the feed form portlet’s action title. [yomatters]

• Replaced fan box with a like box. The like box portlet is rendered using XFBML, so the basic Facebook support profile is now a dependency. [yomatters]

• Took advantage of the Facebook’s new Javascript SDK. [yomatters]

• Provided defaults for fanbox portlet thus make it possible to assign it using portlets.xml GS file. [piv]

1.3 (2010-06-02)

• Also catch NotFound when trying to look up ‘image_tile’. [davisagli]

• Added a feed form tracking plugin for collective.googleanalytics. [yomatters]

• Added the option to only show the feed form after a save. [yomatters]

• Changed Facebook fanbox portlet HTML to meet Plone standards, fixes #1. [jaroel]

1.2 (2010-04-06)

• Fixed a unicode decode bug in the JSON serializer. [yomatters]

1.1 (2010-03-26)

• Added the ‘Post to Fan Page’ feature. [davisagli]

• Stripped line breaks from the description in the default feed form adapter to avoid breaking the javascript. [yomatters]

• Added a view to resize the site logo to the size that Facebook requires. [yomatters]

• Added an adapter interface so that we can override the feed form portlet and attachment settings on a per-site or per-content-type basis. [yomatters]

1.0 (2009-12-22)

• Add z3c.autoinclude Plone plugin entry point. [davisagli]

• Fix control panel authenticator to work in Plone 4. [davisagli]

• Added a jq() wrapper to the feature loader initialization call so that it doesn’t happen until the DOM is fully loaded. [yomatters]

• Removed bogus dependency of the Fan Box profile on the Basic Facebook Connect integration profile. [davisagli]

1.0b1 (2009-08-13)

• Initial release. [davisagli]