This post is a "living post", and will be updated as necessary to ensure the latest instructions are available to FKS users. As an FYI, I hope to soon publish a release of the FKS that cuts back on these installation steps dramatically. I choose instead to release the FKS sooner to get it out to the community, but I do desire to make the installation much more streamlined in the future. So stay tuned!
FKS Details: http://philwicklund.com/freeware/fks/default.aspx
1. Setup Facebook Connect Application (if you haven't already)
Go to http://facebook.com/developers and click Setup new Application:
Type in an application name, and click submit.
The only other thing you MUST do, is specify a callback URL:
Version 1.0 of FKS only supports a web application deployment, so specify the root relative URL for your SharePoint web application. For instance, http://philwicklund.com/. Type your SharePoint Web Application URL and click Save Settings.
2. Deploy Cross-Domain Receiver Page
In the Web Application folder on each web front end in the farm, deploy the xd_receiver.htm file:
In IIS, make sure anonymous access is enabled on the file/folder and set the security permissions for "Everyone" to have read/execute permissions (alternatively, grant the IUSR account anonymous access is running as). Lastly, TEST the deployment by browsing to http://www.[your domain].com/xd_receiver.htm. Make sure to test this first! You'll get a page that is empty, but the title will show "Cross-Domain Receiver Page":
Works! You can download the xd_receiver file(s) from the latest release of FKS on codeplex:
3. Add and Deploy the Facebook SharePoint solution package
Download the latest solution package and drop it onto one of your web front ends in your farm. Execute the addsolution command, followed by the deploysolution command, and finally the execadmsvcjobs command:
4. Make 2 changes to the master page(s) that will be hosting the SharePoint web parts
Unfortunately, two lines of code need to be added into EVERY master page that is hosting SharePoint sites where you plan on deploying the Facebook Connect web parts to. Firstly, in the <html> tag at the top of the master page, add another namespace, xmlns:fb="http://www.facebook.com/2008/fbml":
Secondly, at the bottom of the master page, just before the </body> tag, add the following:
<SharePoint:DelegateControl runat="server" ControlId="AdditionalPageFoot" AllowMultipleControls="true"/>
Save and deploy your master page changes as necessary…
5. Activate the FacebookParts feature on each Site Collection you want the web parts to be available
6. Set your Facebook Connect Settings
Within Site Settings at the root site in the Site Collection, click Facebook Connect Settings:
Specify your Facebook Connect Application Key created in step 1, and click Save.
7. Add your web parts!
For more instructions and details, view the User Guide (coming soon). Also, feel free to CONTACT ME with your questions/feedback/feature suggestions.
Sincerely,
Phil Wicklund