Geodesic Solutions Community Wiki

User Tools

Site Tools

You are here: Auction and Classified Software Support Home » Addons » Social Connect Addon (AKA Facebook Connect)
addons:social_connect:start

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
addons:social_connect:start [2011/12/09 19:43]
jonyo [Minimal User Registration] 		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. 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. The secondary function is to add various integration options, such as showing a seller's Facebook profile pic on the seller's listings.
 ===== What It Does ===== ===== What It Does =====
  
-This addon currently allows users to click a link **Login with Facebook**.  This will pop up a window that will let them log into their Facebook account, and "approve" your website's Facebook app to access minimal information.  The user is then taken back to the site.  Below are the different scenarios for what will happen:+This addon currently allows users to click a link **Login with Facebook**.  This will direct them to a page that will let them log into their Facebook account, and "approve" your website's Facebook app to access minimal information.  The user is then taken back to the site.  Below are the different scenarios for what will happen:
  
   * If the Facebook profile ID is already attached to an account in the software, the user is logged in under that account. <   * If the Facebook profile ID is already attached to an account in the software, the user is logged in under that account. <
-  * If the user's e-mail matches a user already in the system, then the user is logged in as that user, and the Facebook profile is attached to that user. <+  * If the user's **e-mail matches** a user already in the system, then it knows the user is the same as the one already in the system.  In that case, it links the Facebook account to that existing user, and logs the user in. <
   * //Rare Scenario//: If trying to link up a FB account to one account, when it is already linked to another account, it will merge both user accounts together using the "older" of the two user accounts in the system.  Typically this will happen if someone that already has a user account attempts to use "login with Facebook" when the e-mail does not match, so that it creates a brand new user account.  If that user later tries to link the FB account to the older account within the software, it will merge the newer account created using Facebook connect into the pre-existing older user account. <   * //Rare Scenario//: If trying to link up a FB account to one account, when it is already linked to another account, it will merge both user accounts together using the "older" of the two user accounts in the system.  Typically this will happen if someone that already has a user account attempts to use "login with Facebook" when the e-mail does not match, so that it creates a brand new user account.  If that user later tries to link the FB account to the older account within the software, it will merge the newer account created using Facebook connect into the pre-existing older user account. <
   * If there are no matching accounts on the site yet, it will **register a new "minimal" user** with the info mentioned in [[#Minimal User Registration]] <   * If there are no matching accounts on the site yet, it will **register a new "minimal" user** with the info mentioned in [[#Minimal User Registration]] <
Line 22: Line 24:
     - First name and last initial - example: **First L**((Note that a username can have spaces in it.)) <     - First name and last initial - example: **First L**((Note that a username can have spaces in it.)) <
     - Full name - example: **First Last**((Note that a username can have spaces in it.)) (Only if first/last name could not be determined) <     - Full name - example: **First Last**((Note that a username can have spaces in it.)) (Only if first/last name could not be determined) <
 +    - First part of e-mail before @
 +    - Username is filtered to remove any characters not allowed for a username.
     - If the username generated matches one in the system, it adds a number - example: **First L 1** or **First L 5**((Note that a username can have spaces in it.)) if happen to already have 4 other users with same first name and last initial. <     - If the username generated matches one in the system, it adds a number - example: **First L 1** or **First L 5**((Note that a username can have spaces in it.)) if happen to already have 4 other users with same first name and last initial. <
 < <
-  * **Password**:  //NOT used!// ((The user must always use the "login with Facebook" button to log in on an account originally created using the login with Facebook button.)) <+  * **Password**:  //NOT used!// ((The user must always use the "login with Facebook" button to log into an account originally created using the login with Facebook button.)) <
   * **First Name**: Set to first name in Facebook profile. <   * **First Name**: Set to first name in Facebook profile. <
   * **Last Name**: Set to last name in Facebook profile. <   * **Last Name**: Set to last name in Facebook profile. <
Line 31: 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. <   * **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. <   * **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. 
-{{ :addons:social_connect:facebook-app-register.png?200 |}} 
-    - For the **Site name** enter your website's name. < 
-    - For the **Site URL** enter the URL to the website, like **http://example.com** < 
-    - Continue with the registration process.  Note that to create a Facebook App, you will need to have a **verified Facebook account**.  When you try to create a new Facebook app, if your Facebook account is not already verified, it will tell you how to verify your account at that point. < 
-    - You can further customize your Facebook App if desired, however for the purposes of the Facebook Connect, only a minimal Facebook App is required that is tied to your domain name. < 
-< 
-  - In the admin, go to **Addons > Social Connect > Settings**.  On this page, you need to enter the **Facebook App ID**, and **Facebook App Secret** as displayed on Facebook.com.  As long as you have signed up for the app correctly, you can view the app at [[https://developers.facebook.com/apps]].  < 
- 
  
 ====== Addon Tags ====== ====== Addon Tags ======
Line 115: Line 105:
  {addon author='geo_addons' addon='social_connect' tag='facebook_session_profile_picture' assign='fb_pic'}  {addon author='geo_addons' addon='social_connect' tag='facebook_session_profile_picture' assign='fb_pic'}
  {if $fb_pic}  {if $fb_pic}
- <div style="float: left; border: 1px solid black; margin: 0px 8px 8px 5px;">{$fb_pic}</div>+ <div style="float: left; border: 1px solid black; margin: 0px 8px 8px 5px; line-height: 0px;">{$fb_pic}</div>
  {/if}  {/if}
  Welcome, {module tag='display_username'}  Welcome, {module tag='display_username'}
addons/social_connect/start.1323459836.txt.gz · Last modified: 2014/09/25 16:55 (external edit)

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
CC Attribution-Noncommercial-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki