From Showit Desktop Manual
The Facebook Comment widget allows your site visitors to leave a comment on a page for your Showit website. This widget requires that you have a Facebook account and that you create a Facebook Application to associate the comments with so that you can moderate the comments. The process for creating an application is only a few clicks and available for anyone and is described in the section below. When you add the button to a page the following are the advanced settings for the Facebook Comment widget:
- Application ID: You MUST specify an application ID or the widget will not work. It is very easy to get an ID, follow the directions below for more info.
- Comments Made: Determine if you want the comments that are posted through the widget to be posted to the specific page, or if they are for the whole site. If you choose Per Site, this links the comments to the home page so when someone clicks on the link back in Facebook, it takes them to the home page of the site.
- Button Appearance: You can either use the default button or make it transparent and place the button over your own text or button.
- Show Like Button: Choose whether to show the section above the comments that allows you to just like the page.
- Like Action: The default like action will link to the current page and like the current Showit page. However, you can have it like or recommend your Facebook Page instead, if you choose either of those options be sure to enter the full URL to the Facebook Page URL below.
- Facebook Page URL: Used only by the second or third option in the Like Action and allows you to show a Like Button for your Facebook Page. This should be the full URL that looks like: http://www.facebook.com/pages/YOURPAGENAME
- Show Faces of Friends Who Like: Allows you to hide the row of images of the current user's friends who like the page.
- Horizontal Position: The horizontal position of the popup: center, left or right. Note: Due to the nature of the HTML popup, if you use the center option it will disable the ability to click on anything on your page to the right and left of the popup when the popup is open.
- Vertical Position: The vertical position of the popup: bottom, center or top.
- Automatically Show Comments: This will open the comments when the widget is loaded onto a page.
- Animation Speed: This is the speed with which the popup will slide into view and can be set to a number of seconds. Use 0 if you want to have it just appear right away.
- Window Height: The height in pixels that the popup will occupy. The width is fixed based on the Facebook constraints of the widget.
- Vertical Offset: The number of pixels to offset the popup from the Position chosen. This value does not affect the Center option.
- Horizontal Offset: The number of pixels to offset the popup from the Location chosen. This value does not affect the Center option.
- Shadow Opacity: The amount of transparency in the rounded gray shadow around the box, use 0 to hide the shadow completely. Note: Due to HTML limitations of the IE browser, the shadow does not currently work in Internet Explorer.
Tips: If you place this widget on a Style Group, it will load and comment on the specific page that you are on. When you switch pages, the comments automatically load for the appropriate page.
This widget is based on the Facebook Social plugin and as such has certain constraints that are dictated by the Facebook platform. Facebook continues to change and we will work to keep things working with their platform but this functionality is based upon what Facebook provides.
This widget requires the use of a Facebook Application ID (explained below) to facilitate the administration of comments. Once you create the application you will see a link below the post button to Administer Comments:
Once you click this link you will get the additional settings to add additional administrators, moderators, receive notifications, and enable permissions like allowing anonymous comments.
Once you are an admin for the app, you will get additional links below each post that allow you to directly message a user, delete the comment, or block a user from commenting:
Known Issue: Even though there is a check box to request notification of comments, it seems Facebook has removed notifications of comments for this Facebook widget. Unfortunately we have no way of changing this at this point but hopefully Facebook will bring this or some form of notification back.
Creating a Facebook Application
To create your Facebook Application, just go to the Facebook Developers page. If this is your first time, the application will request permissions to your account:
You will need a verified Facebook account to be able to create an application so that you can use their commenting functionality and Facebook's policy is that you must verify either with a mobile phone number or a credit card according to their FAQ which they have done to help reduce spam and abuse. If you have issues verifying your phone number, you will need to work that out through Facebook.
Once you open the developer page and click Allow, you will be on the developer page and click the Set Up New Application in the top right:
On the setup screen, enter a name for your application and then click Create Application and you are done creating your first application!
The application name that you enter will show up at the bottom of the posts to the Facebook news stream that say about an hour ago via your application name like in the comment posted below:
You now have a Facebook Application ID, simply copy that ID as circled and paste it into the Showit widget. Also enter the App Domains and Website with Facebook Login as shown below.
Save your changes then click on App Details in the sidebar. Scroll down to Primary Icons, it's important that you add 16x16 and 75x75 icons as this will also show up in the news feed of a post.
Once you have setup the app settings, you can click the Back to My Applications at the top and optionally make some customizations to the app page. If a user clicks on the name of your app in a comment post in the Facebook news feed it will go to the application page which is similar to a typical fan page. We recommend you treat this as a landing page to redirect a user to a fan page if you have a fan page. Click on the Application Profile Page button to go to this page and see how it looks:
You now have other settings you can adjust just like your fan page, and can disable most of the features such as commenting and just direct people to your actual fan page:
There is currently a known issue when you open the Facebook comment box and are not logged in. Launching the login window will log you in but is not refreshing the comment area to show that you are logged in. Hiding the comment window and then opening it again will refresh it and allow you to comment. We are continuing to look into ways to work around this but as the login/authentication and refresh code is done by Facebook, we are getting a little stuck resolving this issue. Be sure to include a "Site URL" in your Facebook application or after login an error message on Facebook will appear.
Also, it looks like on some Safari versions 5.0.2 on a Snow Leopard Mac the comment window won't scroll and flickers, still looking into why this would be and why all other versions of Safari seem to work fine.