ADVANCED PLAN + 


NOTE: As of MARCH 29, 2017, the Facebook PHP client library requires a minimum PHP version of 5.4.


The MemberMouse Facebook login extension will allow your customers to create a new membership using their Facebook login credentials.


Creating A Facebook App

The first step to enabling the Facebook login extension on your site is to create a Facebook App. To create your app, follow these steps:

  1. To access the developers page of Facebook visit http://developers.facebook.com/apps. This is the page where Facebook lists down a list of applications that you have already created with them. On the top right corner, hover over Apps and click on the Create a New App:





  2. Facebook would prompt a dialog to request you to give your application a name:




  3. Your app has now been created, but it is not live just yet:




  4. Next, click Settings on the left hand menu.  You will see the basic information about your newly created app. You will need to create a platform by clicking the +Add Platform button:




  5. Select Website:





  6. Add your website URL, and save your settings.

  7. To make your app live, click App Review in the left menu:





  8. Look for the grey slider next to your app name:





    Slide it to Yes. You will be asked to confirm the app:





  9. Your app has now been created. You will need to access the App ID and App Secret to configure the extension on your site:




  10. Open up a new tab on your web browser, and move to configuring the Facebook Login Extension:


Configuring The Facebook Login Extension


To enable the Facebook login extension, follow the steps below:

  1. In the MemberMouse menu, click on General Settings.

  2. Next, click on the Extensions tab and from the following page, click on the Facebook logo.

  3. You will need to provide some information from your Facebook app, as well as make a few selections:





    App ID - From your Facebook app dashboard.
    App Secret
    - From your Facebook app dashboard.
    Allow Signups?
    - If you want to allow new customers to sign up using their Facebook login credentials, then click this box. Otherwise, members will only be able to login using their Facebook credentials, but not sign up for a new membership.
    Membership Level - Customers can only signup for a free membership level when they are using their Facebook login credentials. Once they are members, they can purchase a paid membership. You need to select the default free membership you would like customers to join when using Facebook.
    Callback URL:
    - This is the URL that is used in the Facebook App.

  4. Click Save Configuration.


Adding Facebook Signup And Login To Your Site





Once you have configured your site to accept Facebook login, you need to add the following SmartTags to allow for signup and login:

Signup Button SmartTag


The following SmartTag generates a button that customers can use to sign up for a new account:

[MM_Social_Signup_Button provider='Facebook']

Attributes:

provider - Set the provider attribute to all to generate signup buttons for all active social login providers, or you can use an individual tag for each provider Twitter, Facebook and Google. For example:

[MM_Social_Signup_Button provider='all']


Optional Attributes:
 
membershipLevel - You can optionally use this attribute to override the default signup membership level
defined above. It takes a membership level ID for free membership levels only. For example:

[MM_Social_Signup_Button provider='Facebook' membershipLevel='2']

Read this article to learn how to find your membership level IDs.



Login Button SmartTag


The following SmartTag generates a button that customers can use to log into an existing account:


[MM_Social_Login_Button provider='Facebook']


Attributes:

provider - Set the provider attribute to all to generate signup buttons for all active social login providers, or you can use an individual tag for each provider Twitter, Facebook and Google. For example:

[MM_Social_Login_Button provider='all']


MM_Form Section Update


If you installed MemberMouse prior to version 2.2.0, and you want to use the SSO extension, you will also need to add the code below to your login core page (read this article to learn more about the login core page)

[MM_Form_Section type='socialLogin']
<div id="mm-social-login-section" class="mm-myaccount-module">
    <div id="mm-social-login-header" class="mm-myaccount-module-header">
        Social Networks
    </div>
    <div class="mm-myaccount-content-wrapper">
    <div id="mm-social-login-body">
        [MM_Form_Data name='socialLogin']
    </div>
       </div>
</div>
[/MM_Form_Section]

This is only for customers who have a version of MemberMouse prior to version 2.2.0.