ADVANCED PLAN + 


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


Creating A Twitter App

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

  1. To access the developers page of Twitter visit https://dev.twitter.com/apps. Once you are on this page, login you will see the button below to get started:





    unless you have already created an app already, in which case click on the Create New App button.




  2. You will need to provide some details to Twitter to ensure that Twitter recognizes your site. Please note, these settings will be seen by your customers when they are signing in, so be sure to keep that in mind when naming your app:




    Name - Give your application with a meaningful name.
    Description
    - Give your application some description like what is the application all about.
    WebSite
    - Enter the full URL to your site. (E.g: http://yoursite.com).
    Callback URL:
    - This is the URL that you can see on the Twitter Extension admin page in your site:


  3. Once you have set the above settings and accepted the terms and conditions, click on the next button and proceed with the next step.

  4. Your app has now been created. You will need to access the API Key and API secret to configure the extension on your site. To find those, click the API Keys menu item:




  5. Once you have this screen open, you will see the API Key and API Secret. You will need to enter those in your MemberMouse configuration for Twitter. To do so, open up a new tab on your web browser, and move to Configuring The Twitter Login Extension:




Configuring The Twitter Login Extension


To enable the Twitter 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 Twitter logo.

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




    API Key - From your Twitter app API Keys screen.
    API Secret
    - From your Twitter app API Keys screen.
    Allow Signups?
    - If you want to allow new customers to sign up using their Twitter login credentials, then click this box. Otherwise, members will only be able to login using their Twitter credentials, but not sign up for a new membership. If you check the Allow Signup box, you will see that Twitter does not allow access to the user's email address. You will have to select to either ask the customer for their email address via a popup dialog:





    or have MemberMouse generate a fake email address.





    Membership Level - Customers can only signup for a free membership level when they are using their Twitter 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 Twitter.
    Callback URL:
    - This is the URL that is used in the Twitter App.

  4. Click Save Configuration.


Adding Twitter Signup And Login To Your Site





Once you have configured your site to accept Twitter 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='Twitter']

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='Twitter' 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='Twitter']


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 customer who have a version of MemberMouse prior to version 2.2.0