Differences

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

--- addons:social_connect:start [2014/01/23 22:59]
geojames [Setting Up Facebook Connect]
+++ addons:social_connect:start [2018/04/15 16:39] (current)
geojames [Setting Up Facebook Connect]
@@ Line 2: / Line 2: @@
 The **Social Connect Addon** is meant primarily to allow your users to both register, and log in, using popular social websites such as Facebook and Google+.  Currently only Facebook connect is implemented but we have plans to add more sites in future versions.
+<tip c w>**__Do not use or test this feature using the admin account or with any facebook account where the email on that account matches the email of the admin user in your Geo software__**</tip>
 The secondary function is to add various integration options, such as showing a seller's Facebook profile pic on the seller's listings.
@@ Line 33: / Line 35: @@
   * **Profile ID**:  In order to allow future "login with facebook" to work, and to allow displaying the profile picture for the user, it stores the Facebook profile ID. <
   * **That's all!((Technically the software //could// ask for permission to see more of the user's information, however the more things that are asked for, the less likely the user is to allow access.  If it asked for all the user's information the user is more likely to just leave the site, so instead the software only asks for the minimal information.))**  Even if you have other required fields set in your registration settings, the above are the only fields that will be populated for a user registered using **Login with Facebook**.  If however, the user ever tries to edit the profile information within "my account" area, it will require that all required fields are entered at that time before they can save any other changes. <
-====== Setting Up Facebook Connect ======
-These instructions will walk you through steps necessary to set your site up to start using Facebook Connect.
-  - Install and enable the addon as instructed in [[addons/install/start]].
-  - If you do not already have a Facebook App for your website, go to [[http://developers.facebook.com/setup]] to sign up.  Note that you will need to have a personal Facebook account to create a Facebook App.  The link above goes to a page that looks like the following:\\ {{ :addons:social_connect:facebook_app_1.png }}\\ The above page would list any apps if you already had one.  The above shows an account with none of them.  In the above page you would click the "Create a New App" link.
-  - You will then see a screen like the one below: {{ :addons:social_connect:facebook_app_2.png }}\\ 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 to use your site's name or something similar. Be sure to read the info provided when you hover over the ? next to the display name to see restrictions. The **category** field is now a requirement but doesn't really mean anything in this instance as you are not offering this app to other facebook users. You can set any category you like but **Apps for Pages** if you non-committal on your choice.  **Namespace** field is optional and not needed in this app instance.
-  - If you see one, Do NOT check the box for "web hosting"((Note that this option is not in the screenshot, for some reason the option only shows for some people.  If it gives you the option though, don't check it.)), since you already have your own hosting. Click the **Create App** button in that screen to continue.
-  - You will now see a page like the one below:\\ {{ :addons:social_connect:facebook_app_3.png }}\\ 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 }}\\ For **App Domains** enter the main domain name where the app will be used, without the www if you use it.  As an example, if your site was installed at www.example.com you would enter **example.com**  When you enter the main domain there, it should allow all sub-domains as well so that www.example.com will work, as well as any sub-domains for geographic navigation if you happen to use that feature.
-  - Next click on the **+ Add Platform** link in that same page as shown in the above screen shot.  You will see a section that appears like this:\\ {{ :addons:social_connect:facebook_app_5.png }}\\ Click the **Website** link/icon.
-  - You will now see the following within that page\\ {{ :addons:social_connect:facebook_app_6.png }}\\ Enter the website URL.  If the software was installed in http://example.com/index.php you would enter **http://example.com/**.  In other words when you view the software homepage on your website, it should be the entire URL minus the file index.php.
-  - Now you will need to get the **APP ID** and **App Secret** from you App Dashboard (click the Dashboard link in the left hand menu).  You will find those values there as seen in the following screenshot:\\ {{ :addons:social_connect:facebook_app_7.png }}\\ 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 admin tool like appears in the screenshot below:\\ {{ :addons:social_connect:facebook_app_8.png }}\\ After entering those values click the save button in that admin tool.
-  - Once you are sure you have everything correct you will need to change that status of your app from **development** to **live" within the **Status & Review** admin tool at facebook as it appears in the screenshot below:\\ {{ :addons:social_connect:facebook_app_9.png }}\\ Click the sliding button to allow the general public access to that feature.
-  - Now try the feature on the client side.  But DO NOT test this with an facebook account whose email matches the Geo admin users account.
 ====== Addon Tags ======

Geodesic Solutions Community Wiki

User Tools

Site Tools

Differences

Page Tools