Social Sign In

  1. External Database

    Within IPS 4 you can use an external database as a login handler. You would do this from the following location in your admin CP System>Settings>Login Handlers From here you can then set up the relevant details needed for connection Database connection Details In the first section you will need to enter all the details to connect to your mysql data. Ensure these details are 100% connect and can be connected to from the server where your IPS installation is located.   Database Schema Details This is where you will set up the information related to where your users are located. You will need to provide the Table and at minimum either an email address or username column. You can of course use both if you are using both methods of login. You will need to add in the password column and tell the system how this password is stored. If this is encrypted you will need to ensure you provide the correct Encryption type. There is also an additional clause which will allow you to add to the end of the query which returns users. So for example, you may have users who you do not want to have access and have a column named 'active'. This will allow you to add active=1 and it will add to the end of the sql statement 'WHERE active=1"   Login Settings Finally you will need to set up which authentication type is being used, and whether or not to allow Admin CP login with this method.
  2. Linked In

    You can allow your members to log in to the site using their linkedin account. In order to do this, you will need to set up the linked in login method within your admin CP. You will first of all however need an API key in order to do this. First of all, you will need to visit the following location in your browser and log in with your own linkedin account. https://www.linkedin.com/secure/developer Once logged in, you will need to create a new application   You will first of all need to fill out your company/website information. Note that at present the application logo must be 80px x 80px and square. Once done, select submit.  On the next page, you will need to select the r_emailaddress checkbox which is not selected by default. You will also need to enter the authorised Redirect URL as shown in the image below. You need to point this to the auth.php file for linkedin, which you can see the location to below. In this example our site is located in example.com/community/ . You would need to amend as appropriate. Ensure that you select the "Add" button after entering this. http://www.example.com/community/applications/core/interface/linkedin/auth.php On the previous page you will see Client ID and Client Secret. These are then needed within the following location in your admin CP. System > Settings > Login Handlers > Linked In 
  3. Google+

    You can allow your members to sign in to your website using their google+ account. In order to do this however, you first need to create an API key.  First you need to go to the following URL and sign in using your google account.  https://console.developers.google.com/project Once signed in you will need to create a new project using the button provided under the project dropdown, in the top left   You will then be asked to enter a project name. This is not something that is important to the code, it simply gives it a recognisable name and ID. I would suggest simply using your site name here. You will also need to select whether or not youwish to receive emails with special offers etc, and agree to the terms and conditions. Then click create   You will then be presented with a large list of APIs. You need to select the Google+ API as shown in the screen below.   To finish adding this, you need to ensure you then select enable as shown below   We then need to set up the credentials for your site to use. Select create credentials on the top right   You will then be presented with the following screen, where you need to select 'client ID' as shown You will be informed at this point, you need to configure the consent screen. Select the 'configure consent screen' button shown here On this screen, you need to fill in your product name (this can be anything you like), and your privacy policy URL     Now select "Web Application" . You will also need to then enter a name (leave as default). The examples for the next 2 items are based on the website being installed at our dummy location of http://www.example.com/community/ Authorised Javascript Origins (Note this is just the domain, not the full path to your site) http://www.example.com Authorised Redirect URIs http://www.example.com/community/applications/core/interface/google/auth.php Warning You may see these are not selectable and you need to set up your website name. If that is shown, simply click on the link and enter your website name as instructed. Once clicking on create you will then be shown the key and secret that you need to enter within your admin cp   You can enter these details within System>Settings>Login Handlers>Google
  4. Twitter

    You can allow your members to sign in to your website using their twitter account. In order to do this however, you first need to create an API key.  Creating the twitter application First you need to go to the following URL and sign in using your twitter account.  https://apps.twitter.com/ From here you will then need to select the "Create New App" button    Once selected, you will be prompted to fill in the details for your site. Fill these in similar to the below, replacing the details I have entered with the details relevant for your site. Once done, agree to the disclaimer and click "Create your twitter application" Warning The URL below used is http://localhost/419 because the example location I used is this. You should be entering your own site URL. For example, if your site is located at http://www.someurlhere.com then that is what you would enter. Similarly if you installed at http://www.someurlhere.com/forums this is what you would enter.  Once you are done, you will see something similar the following screen   there are now 2 things you need to check. First of all take a look in the settings tab and ensure that "Allow this application to be used to Sign in with Twitter" is checked. Then select the permissions tab and ensure it is set to "Read and Write"   Once you have done both of these, you can get your application key and secret from the "Kets and Access Tokens" tab, which you will need to enter into your admin cp.   Setting up the connection Within your admin CP, go to System>Settings>Login Handlers and select the pencil icon at the side of the twitter login method. You can then enter the details you generated above, choose which name to use for the account, and save. Tip You can also state if you would like Admin CP logins to be allowed using twitter authorisation from this page, and allow users to share their content immediately. This will give the user a checkbox they can select when creating new content    
  5. Microsoft

    You can allows users to sign in on your community with their Microsoft account. This is a great way to make it easier for users to get started on your community and increase the number of signups, especially if the subject of your community means your users are likely to have Microsoft accounts. This guide covers everything you need to know to set up this integration. Warning Using Microsoft login requires your community to use a https URL. For assistance setting this up, contact your hosting provider or system administrator.   Step One: Create a Microsoft App Go to https://apps.dev.microsoft.com/ and sign in with your Microsoft account if you are not already signed in.
      Click the button to add an app in the top-right.


      Enter the name of your community and click on "Create Application".


      Under the "Platforms" section, click "Add Platform"



    And then choose "Web".


      In the "Redirect URIs" section, enter the URL to your community, followed by: /applications/core/interface/microsoft/auth.php For example, if the URL to your community was https://www.example.com/community you would enter http://www.example.com/community/applications/core/interface/microsoft/auth.php



    Microsoft requires that your URL start with https. At the bottom of the page, click Save

      Step Two: Link your Microsoft App with your Community To link your Microsoft App with your community, you need the Application Id and Password. The Application Id is shown at the top of the dashboard for your Microsoft App:


      To obtain a password, click the "Generate New Password" button.




      Copy and paste these into the Admin CP on your community. Go to Admin CP -> System -> Login Handlers and click the "Edit" icon for Microsoft and enter those details on that screen.


      After saving, you need to enable the login handler. Make sure the badge next to Microsoft says "Enabled", and click it to toggle if it doesn't.

      Users will now be able to sign in with Microsoft on your community.    
  6. Facebook

    You can allows users to sign in on your community with their Facebook account. This is a great way to make it easier for users to get started on your community and increase the number of signups. In addition, users who sign in with Facebook can have their profile photo automatically synced with Facebook and can even import their status updates and allow them to automatically share content they post on your community to Facebook. This guide covers everything you need to know to set up this integration. Tip If you enable either the "Allow Status Imports?" or "Users can share immediately when posting?" settings for Facebook login, make sure you read and follow the instructions in Step Five below.   Step One: Create a Facebook App In order to use Facebook to log in on your community, you need to create an "application" through the Facebook Developer site. This gives Facebook some information about your community and a special key that is needed to complete the set up. Go to https://developers.facebook.com/apps and sign in with your Facebook account if you are not already signed in. 
      Click the button to add an app in the top-right.

      Add in a display name (probably the same as you added above) and a contact email, along with a category appropriate to your community.

      On the product setup screen, select 'Get Started' next to 'Facebook Login'

      Select 'web' from the new app screen

      Add your site URL in the space provided


      Click continue through all the next screens, until you reach the following page

      Step Two: Update App Settings There's a few more pieces of information you need to give Facebook about your community before continuing. On the dashboard for your app on Facebook's site, click the "Settings" link the sidebar.
    Fill in a Contact Email and select save changes in the bottom right of the page.

    It is also a good idea to upload an App Icon so that when users sign in with Facebook they see your logo rather than a generic icon on the login screen. You can also set a Privacy Policy URL so users see a link to that on the sign in screen. These are normally optional, but if you intend to enable the "Allow Status Imports?" or "Users can share immediately when posting?" settings (discussed in Step Five), it is required.

      Step Three: Link your Facebook App with your Community Back on the dashboard for your Facebook App you will see a box like this at the top of the page:   You need to copy and paste the App ID and App Secret into the Admin CP on your community. Go to Admin CP -> System -> Login Handlers and click the "Edit" icon for Facebook and enter those details on that screen.
      Tip If you enable either the "Allow Status Imports?" or "Users can share immediately when posting?" settings for Facebook login, make sure you read and follow the instructions in Step Five below. After saving, you need to enable the login handler. Make sure the badge next to Facebook says "Enabled", and click it to toggle if it doesn't.   Step Four: Enable your App Now you need to set your Facebook App to be ready for use. Back on the dashboard for your app on Facebook's site, click the "App review" link the sidebar.

    Click the toggle to make your application live and confirm the popup.



      Users will now be able to sign in with Facebook on your community.   Optional Step Five: App Review for Status Integration When setting up Facebook login, there are two settings which, if enabled, you need to perform additional steps to set up: "Allow Status Imports?" or "Users can share immediately when posting?". Because these settings allow your community to read from and write to the user's timeline on Facebook, Facebook requires that before you can use these features you must submit an application to them to review this functionality. If you want to enable either of these settings, you need to do the following: If you have not already uploaded an App Icon and set a Privacy Policy URL as discussed in Step Two, do that now.
      Enable the settings as desired and then sign in with Facebook on your site. You will see a message that some permissions have not been submitted for approval, you can ignore that warning for now and press "OK" to continue logging in.

      If you are enabling the "Users can share immediately when posting?" setting, you need to perform this action so that Facebook knows it works correctly. Submit a topic or other content on your community and when you do so, check the "Share on Facebook" checkbox.

      Back on the dashboard for your app on Facebook's site, click the "App review" link the sidebar.


      Click "Start a Submission".

      If you are enabling the "Allow Status Imports?" setting, check the "user_posts" checkbox.

      If you are enabling the "Users can share immediately when posting?" setting, check the "publish_actions" checkbox.

      Click the "Add X Items" button.

      If you are enabling the "Allow Status Imports?" setting, click the "Add Notes" button for the "user_posts" permission and fill in the form explaining how your community will allow users to import posts from the user's timeline into the statuses feature on your community. You will need to select the "Web" platform and provide both instructions and a screencast of how Facebook can test the feature. Suggested instructions are:
     
      If you are enabling the "Users can share immediately when posting?" setting, click the "Add Notes" button for the "publish_actions" permission and fill in the form explaining how your community will allow users to share content they create on your community to their Facebook timeline. You will need to select the "Web" platform and provide both instructions and a screencast of how Facebook can test the feature. Suggested instructions are:
      Upload at least 4 screenshots showing the Facebook integration on your site. For example, you might show the "Sign in with Facebook" button, the homepage after the user has signed in, the Facebook screen in Account Settings, and the "Share on Facebook" button on the topic submission screen.

      Submit the review.

    You should be advised how long the review will take. Once Facebook have approved your review, the additional features will be available on your community.