---++ODS Facebook Integration Administrators Guide

The following guide presents the steps an ODS Administrator must perform in order to setup Facebook for given ODS dataspace.
Afterwords, regular ODS users will be able to set their own Facebook accounts too.

   1. [[http://www.facebook.com][Create Facebook account]].
   1. [[http://www.facebook.com/developers/editapp.php?new][Add a Facebook developer application]] to the created from above Facebook account, by performing the following steps:
      1. Set the "Callback URL" to: 
<verbatim>
http://cname:port/ods
</verbatim>
      1. Specify "Canvas Page URL" field value; this is the Facebook URL where the application will be available.   
      1 Click Create
      1 As result the application should be created
      1. Copy the generated API key and Secret values that are shown bellow the Facebook application. The Key and the Secret values can also be found [[http://www.facebook.com/developers/apps.php][here]].
   1. Install the <code><nowiki>ods_framework_dav.vad</nowiki></code> and the <code><nowiki>rdf_mappers_dav.vad</nowiki></code> packages on a running Virtuoso database, using either the Conductor UI or the iSQL tool.
   1. Go to http://cname:port/ods
   1 Enter credentials for <code>dba</code> user.
   1. Go to "Profile ->Edit"-> "Associations & Web Services" tab.
%BR%%BR%<img src="%ATTACHURLPATH%/f15.png" style="wikiautogen"/>%BR%%BR%
   1 In the shown form:
      1 Select Service "FaceBook".
      1 Enter your Virtuoso instance URL
      1. Enter the copied values from above in the Keys text-area respectively for:
<verbatim>
key={this is the API key from the Facebook site}
secret={this is the secret from the Facebook site}
</verbatim>
      * Note: The session parameter is not obligatory. When is set, it is used by the Virtuoso Sponger. Use the button <nowiki>"Get Facebook session"</nowiki> to obtain the session key value.
%BR%%BR%<img src="%ATTACHURLPATH%/f16.png" style="wikiautogen"/>%BR%%BR%
   1. Press "Add". 
%BR%%BR%<img src="%ATTACHURLPATH%/f17.png" style="wikiautogen"/>%BR%%BR%
   1 The Administrator's Facebook Setup Process is complete.


---++Related

   * [[OdsFacebookIntegration][ODS Facebook Guide]]
   * [[OdsFacebookIntegrationLinkODSFacebook][Link existing ODS user with Facebook account]]
   * [[OdsFacebookIntegrationLinkODSFacebookSignUp][Link ODS user with Facebook account using the Sign Up Facebook feature]].
   * [[OdsFacebookIntegrationLinkODSFacebookProfile][Link existing ODS user with Facebook account using the Profile Setup Feature]].
   * [[OdsFacebookIntegrationAuthentcFacebook][Authenticate in ODS using your Facebook account]]