<docbook><section><title>OdsFacebookIntegrationSetupAdminGuide</title><title> ODS Administrators Guide to Facebook Integration</title> ODS Administrators Guide to Facebook Integration
<para>To enable Facebook integration on a given ODS Instance, the ODS Administrator must perform the following steps.</para>
<orderedlist spacing="compact"><listitem><ulink url="http://www.facebook.com">Register (or login) as a Facebook user</ulink>.
</listitem>
<listitem><ulink url="http://www.facebook.com/developers/createapp.php">Set up a new Facebook App</ulink>.
 If not already done, this will add the Facebook Developers app to that Facebook user account and/or verify the Facebook account with credit card or mobile phone information.
 Then, do the following: <orderedlist spacing="compact"><listitem>Set the &quot;Application Name&quot; and agree to the <ulink url="http://www.facebook.com/terms.php">Facebook Terms</ulink> </listitem>
<listitem>Set the &quot;Callback URL&quot; using the following convention -- <programlisting>http://cname:port/ods
</programlisting>-- e.g., -- <programlisting>http://ods-server.example.com:8890/ods
</programlisting></listitem>
<listitem>Set a &quot;Canvas Page URL&quot; value.
 This is the Facebook URL where the application will be made available to ODS users, e.g., . </listitem>
<listitem>Click Create </listitem>
<listitem>As result the application should be created </listitem>
<listitem>Copy the generated API key and Secret values that are shown below the Facebook application.
 The Key and the Secret values can also be found <ulink url="http://www.facebook.com/developers/apps.php">here</ulink>.
</listitem>
</orderedlist></listitem>
<listitem>Install the ods_framework_dav.vad and the rdf_mappers_dav.vad packages on a running Virtuoso database, using either the Conductor UI or the iSQL tool.
</listitem>
<listitem>Go to <ulink url="http://cname:port/ods">http://cname:port/ods</ulink> </listitem>
<listitem>Log in as the dav user.
</listitem>
<listitem>Go to &quot;Profile -&gt;Edit&quot;-&gt; &quot;Associations &amp; Web Services&quot; tab.
<figure><graphic fileref="OdsFacebookIntegrationSetupAdminGuide/f15.png" /></figure> </listitem>
<listitem>In the form shown there: <orderedlist spacing="compact"><listitem>Select Service &quot;<ulink url="FaceBook">FaceBook</ulink>&quot;.
</listitem>
<listitem>Enter your Virtuoso instance URL </listitem>
<listitem>In the Keys text-area, enter the values copied from above: <itemizedlist mark="bullet" spacing="compact"><listitem><emphasis>key</emphasis> -- this is the API key from the Facebook site </listitem>
<listitem><emphasis>secret</emphasis> -- this is the secret from the Facebook site </listitem>
</itemizedlist></listitem>
<listitem><emphasis><emphasis>Note:</emphasis> The session parameter is not obligatory.
 When set, it is used by the Virtuoso Sponger.
 Use the &quot;<emphasis>Get Facebook session</emphasis>&quot; button to obtain the session key value.</emphasis> <figure><graphic fileref="OdsFacebookIntegrationSetupAdminGuide/f16.png" /></figure> </listitem>
</orderedlist></listitem>
<listitem>Press &quot;<emphasis>Add</emphasis>&quot;.
<figure><graphic fileref="OdsFacebookIntegrationSetupAdminGuide/f17.png" /></figure> </listitem>
<listitem>The Administrator&#39;s Facebook Setup Process is complete.</listitem>
</orderedlist><para> </para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">Related</bridgehead>
<itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="OdsFacebookIntegration">ODS Facebook Guide</ulink> </listitem>
<listitem><ulink url="OdsFacebookIntegrationLinkODSFacebook">Link existing ODS user with Facebook account</ulink> </listitem>
<listitem><ulink url="OdsFacebookIntegrationLinkODSFacebookSignUp">Link ODS user with Facebook account using the Sign Up Facebook feature</ulink>.
</listitem>
<listitem><ulink url="OdsFacebookIntegrationLinkODSFacebookProfile">Link existing ODS user with Facebook account using the Profile Setup Feature</ulink>.
</listitem>
<listitem><ulink url="OdsFacebookIntegrationAuthentcFacebook">Authenticate in ODS using your Facebook account</ulink> </listitem>
</itemizedlist></section></docbook>