The MemberMouse X (previously Twitter) login extension will allow your users to create a new free membership using their X login credentials.
Please note that these instructions can require a different order for some or look different than shown. The developer interface changes regularly, and each account may have verification requirements that may not be covered in this article.
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:
- To access the developers page of Twitter visit https://dev.twitter.com/apps. Once you are on this page, login and click on the Create New App button.
- 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: - Once you have set the above settings and accepted the terms and conditions, click on the next button and proceed with the next step.
- 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:
- 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:
- In the MemberMouse menu, click on General Settings.
- Next, click on the Extensions tab and from the following page, click on the Twitter logo.
- 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. - 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_Login_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']