Note on Features: Some features documented here require an addon, refer to the Feature List for details.

Note about 'Listings': The use of the term "listings" in the user manual can refer to classifieds, classified ads, standard auctions, dutch auctions, reverse auctions, and buy now only.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

addons:social_connect:setting_up_facebook [2018/04/15 12:36]
geojames
addons:social_connect:setting_up_facebook [2018/04/15 12:38] (current)
geojames
Line 9: Line 9:
   - Install and enable the **Social Connect** addon in the admin at **Addons > Manage Addons**, as instructed in [[addons/install/start]]. Within the details for the settings page for the Social Connect app (Addons > Social Connect > Settings) you'll see a redirect url that will be used later in your Facebook App Setup Steps. <   - Install and enable the **Social Connect** addon in the admin at **Addons > Manage Addons**, as instructed in [[addons/install/start]]. Within the details for the settings page for the Social Connect app (Addons > Social Connect > Settings) you'll see a redirect url that will be used later in your Facebook App Setup Steps. <
   - If you do not already have a Facebook App for your website, go to [[https://developers.facebook.com/]] to sign up for a facebook developers account or to verify you have one.  Note that you will need to have a personal Facebook account to create a Facebook App.  Once setup go to [[https://developers.facebook.com/apps/]].  That is the link where you'll manage all the apps attached to your Facebook account.  Within that page you'll see link to "Add a New App".  Click any one of them <   - If you do not already have a Facebook App for your website, go to [[https://developers.facebook.com/]] to sign up for a facebook developers account or to verify you have one.  Note that you will need to have a personal Facebook account to create a Facebook App.  Once setup go to [[https://developers.facebook.com/apps/]].  That is the link where you'll manage all the apps attached to your Facebook account.  Within that page you'll see link to "Add a New App".  Click any one of them <
-  - You will then see a screen like the one below: {{ :addons:social_connect:facebook_app_2.png?800 }}\\ For the **Display Name** enter what you want the app name to be.  This will show when visitors click to login with facebook, it will be used at the top of the window to log in.  We recommend using your site's name or something similar. Insert the contact email you will use for this specific app.  Once done with those fields click the **Create App ID** button at the bottom right.< +  - You will then see a screen like the one below: {{ :addons:social_connect:facebook_app_2.png?700 }}\\ For the **Display Name** enter what you want the app name to be.  This will show when visitors click to login with facebook, it will be used at the top of the window to log in.  We recommend using your site's name or something similar. Insert the contact email you will use for this specific app.  Once done with those fields click the **Create App ID** button at the bottom right.< 
-  - You will now see a screenshot like the one below.  Click the **Set Up** button within the **Facebook Login** box on that page : \\ {{ :addons:social_connect:facebook_app_3.png?800 }}\\+  - You will now see a screenshot like the one below.  Click the **Set Up** button within the **Facebook Login** box on that page : \\ {{ :addons:social_connect:facebook_app_3.png?700 }}\\< 
-  - You will now see a page like the one below:\\ {{ :addons:social_connect:facebook_app_3.png?800 }}\\ From here click the **Settings** link in the left menu+  - You will now see a page like the one below:\\ {{ :addons:social_connect:facebook_app_4.png?700 }}\\ Click the **Web** link or **www** icon.< 
-  - You will now see a page like the one below:\\ {{ :addons:social_connect:facebook_app_4.png?800 }}\\ Click the **Web** link or **www** icon.< +  - Next you will a page like you see here:\\ {{ :addons:social_connect:facebook_app_5.png?700 }}\\ Within that page fill in the url where your Geo software is installed.  Once done click the **Save** button to commit your changes.  You should see a **Continue** button appear.  Click it.  <
-  - Next you will a page like you see here:\\ {{ :addons:social_connect:facebook_app_5.png?800 }}\\ Within that page fill in the url where your Geo software is installed.  Once done click the **Save** button to commit your changes.  You should see a **Continue** button appear.  Click it.  <+
   - Next you'll go through a series of instructions on setting up the Facebook SDK for Javascript, Check Login Status, Add the Facebook Login Button,  and Next Steps.  You will not need to go through or do any of the suggestions you see there.  All of that is already within your Geo software.   - Next you'll go through a series of instructions on setting up the Facebook SDK for Javascript, Check Login Status, Add the Facebook Login Button,  and Next Steps.  You will not need to go through or do any of the suggestions you see there.  All of that is already within your Geo software.
-  - Next click the **Settings** link you see just below **Facebook Login** in the left column.  That link is shown in the screenshot below.  You will now see a page like the one below.  \\ {{ :addons:social_connect:facebook_app_6.png?800 }}\\ Within the **Valid OAuth Redirect URIs** setting pointed out in the above screenshot you will paste in the url mentioned in the first step above from within the settings page of the Social Connect Addon in your Geo admin tool.  Pasting the url should be all you need do.  To save click **Save Changes** button at the bottom right of the page. < +  - Next click the **Settings** link you see just below **Facebook Login** in the left column.  That link is shown in the screenshot below.  You will now see a page like the one below.  \\ {{ :addons:social_connect:facebook_app_6.png?700 }}\\ Within the **Valid OAuth Redirect URIs** setting pointed out in the above screenshot you will paste in the url mentioned in the first step above from within the settings page of the Social Connect Addon in your Geo admin tool.  Pasting the url should be all you need do.  To save click **Save Changes** button at the bottom right of the page. < 
-  - Now you will need to get the **APP ID** and **App Secret** from you App Dashboard.  Click the **Settings** link in the left column and then the **Basic** link below that.  You will then see a page like the following:\\ {{ :addons:social_connect:facebook_app_7.png?800 }}\\ Within that page you'll be able to get the **App ID** and the **App Secret**. +  - Now you will need to get the **APP ID** and **App Secret** from you App Dashboard.  Click the **Settings** link in the left column and then the **Basic** link below that.  You will then see a page like the following:\\ {{ :addons:social_connect:facebook_app_7.png?700 }}\\ Within that page you'll be able to get the **App ID** and the **App Secret**. 
  You will need to click on the **show** button next to **App Secret** to expose that value for cutting and pasting within those same fields in your ADDONS > SOCIAL CONNECT > SETTINGS section of your Geo admin tool.  After entering those values within your Geo admin tool click the save button in that admin tool page.<  You will need to click on the **show** button next to **App Secret** to expose that value for cutting and pasting within those same fields in your ADDONS > SOCIAL CONNECT > SETTINGS section of your Geo admin tool.  After entering those values within your Geo admin tool click the save button in that admin tool page.<
-  - Once you are sure you have everything correct you will need to change that status of your app from **development** to **live** within Facebook page at top right of the setup pages for your Facebook developers page as shown in the screenshot below:\\ {{ :addons:social_connect:facebook_app_8.png?800 }}\\ Click the sliding button.  You will be prompted to fill in the url for your **Privacy Policy URL** and **Terms of Service URL** fields before you go live.  The Geo software default designs provide links to both of those within the footer of the default designs.  You can insert those URLs into those fields.  The privacy policy and terms of service we provide are boilerplate and so must be edited to reflect the policies and terms of service for your site. <+  - Once you are sure you have everything correct you will need to change that status of your app from **development** to **live** within Facebook page at top right of the setup pages for your Facebook developers page as shown in the screenshot below:\\ {{ :addons:social_connect:facebook_app_8.png?700 }}\\ Click the sliding button.  You will be prompted to fill in the url for your **Privacy Policy URL** and **Terms of Service URL** fields before you go live.  The Geo software default designs provide links to both of those within the footer of the default designs.  You can insert those URLs into those fields.  The privacy policy and terms of service we provide are boilerplate and so must be edited to reflect the policies and terms of service for your site. <
   - Now try the feature on the client side of your website.  But DO NOT test this with an facebook account whose email matches the Geo admin users account.<   - Now try the feature on the client side of your website.  But DO NOT test this with an facebook account whose email matches the Geo admin users account.<
  
  
  
/home/geodesic/apps/dokuwiki/data/pages/addons/social_connect/setting_up_facebook.txt · Last modified: 2018/04/15 12:38 by geojames
CC Attribution-Noncommercial-Share Alike 3.0 Unported
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0