Jump to content

Guides

Facebook

You can allow your members to sign in to your community using their Facebook account.

In order to use facebook, your site must be on a secure https domain. You can see more information on how to switch to https after obtaining an SSL certicate from your hosting company in the following guide

https://invisioncommunity.com/4guides/advanced-options/configuration-options/using-ssl-https-r273/

Basic Facebook Login

To start the process, go to AdminCP -> System -> Login & Registration, click Create New to setup a new login method and choose Facebook. You will now be prompted to fill in some details which you'll need to acquire by creating an "app" with Facebook.

Creating a Facebook App

1. Go to the Facebook for Developers site and sign in with your Facebook account.

2. If you have not already registered with Facebook for Developers, click Register Now and follow the instructions to register

3. when prompted, enter your community name as the name for your first app. If you have previously registered, click Add a New App 

2.png

Click to create a new app

4. Enter your community name when prompted


3_add_name.png

Enter your community name here

 

5. You will be taken to the dashboard for the app you have just created. Under the Add a Product section, select Integrate Facebook Login section and click Confirm.

2019-02-12_12-27-42.png

 

Facebook App Dashboard

6. You will then be taken to the basic settings page for the new application. Here you need to add your privacy policy, and your terms of service, and logo, then save.

1.png

Basic Settings

 

7. Go to the Products > Facebook Login > Settings tab from the left sidebar. In the Valid OAuth redirect URIs field enter the value shown in your AdminCP, which will be your community's URL ending with "/oauth/callback/" on the end. You must click Save Changes at the bottom to save this.

7_callback.png

Callback URL

8. If you are setting up login only, then you can at this stage set your application live. If you need to enable statuses or promotion ability, then continue through the next stages before going live with the application.

2019-02-12_14-53-21.png

Switch to live

 

Set Up Invision Community

Go to Settings > Basic from the left sidebar. You will see your App ID and a button to reveal the App SecretBack in your ACP, fill in the form, using these details

2018-09-26_12-24-26.png

App ID and Secret

Now go to the front-end of your community, log out, and log in with the Sign in with Facebook button. At this point, only your own Facebook account, which you used to create the client, will work. If it works, you can continue to the next step.

2019-02-12_15-01-32.png

Entering details in Invision Community

Once you have done the above, you will be able to use facebook to login to your community. Note if you wish to enable status imports, you will need to add more permissions and get your application permissions reviewed by facebook.

Enabling Status Imports

When setting up Facebook Login in your AdminCP you will have seen a Allow Status Imports? setting which mentions requiring additional setup. Using this feature means gaining access to restricted Facebook APIs, which, before you can do, you need to get approval from Facebook.

1. To get started, enable the Allow Status Imports? setting from AdminCP -> System -> Login & Registration -> Facebook. 

2. On the Facebook for Developers site, go to App Review -> Permissions and Features  from the left-side menu. Use the search box at the top to search for user_posts

3. select the "Request" option then select continue

4. You will now see the review, for each of the items you have chosen, there is an Add Details link.

 

2019-02-12_15-14-13.png

Request a review

Click Add Details and fill in the form. Details for what to provide are below. In addition to these information, you will need to provide a screencast of you demonstrating that process of signing in with Facebook and doing the thing you are asking Facebook for permission for (importing a status or automatically sharing to Facebook). Make sure your video shows you doing exactly the steps in the instructions you provided otherwise your review will likely be rejected. This video needs to show your community, so we cannot provide a video for you to send to Facebook - you must record and submit it yourself.

  • For Tell us how you're using this permission or feature enter something like the following:
    Quote

    Allows users to import their timeline posts into their profile on the website.

  • For Demontrate how your selected platforms will use this permission or feature? choose Web. 
  • Under this option, you will need to stated how this is used by the user. Enter the following information to show how a user logs in (please modify if your options are in different places due to theming or 3rd party items)
    Quote

    1. On the home page, click "Existing User? Sign In" in the top-right and then click "Sign in with Facebook" from the dropdown.
    2. Click on your name on the top-right and then click "Profile".
    3. Click "Edit Profile" and then enable the "Enable status updates?" setting to enable the site's status update feature.
    4. Click on your name on the top-right and then click "Account Settings".
    5. Click the "Facebook" tab.
    6. Enable the "Copy my Facebook status updates to my profile" setting and save the form.
    7. Click on your name on the top-right and then click "Profile".
    8. Observe how your latest timeline post has been imported and shows alongside other content from the site.

You will then additionally need to do a screencast to show on video how the system is used. This can be uploaded to the same form. Click on save once complete

6. Click Submit For Review to submit the review and confirm the submission. You will be advised how long it will take you for Facebook to approve the submission, and should receive an email once it is complete

Enabling Promotion

Important
Please note that due to changes on the
facebook platform, the below process may not be the entire process required, and you may have to get your application business verified. We are working on a solution to this issue at present.

Within the Invision Community product, you can enable the ablility for yourself, and other selected staff, to promote items directly to your facebook pages and groups. This is set up from following location in your AdminCP 

Settings -> Site promotion -> Social Media Promotion

In order to enable this however, you first need to ensure you have the correct facebook permissions. 

1. On the Facebook for Developers site, go to App Review -> Permissions and Features  from the left-side menu. 


8_addperms.png

3. Use search to locate the following 3 items and select request on each of those items

  • manage_pages
  • publish_pages
  • publish_to_groups

2019-02-12_15-48-14.png

Select for Review

5. Select "Continue the Request" in the top right 

You will now see the review, for each of the items you have chosen, there is a Small arrow on the right. Each of these must be completed in order to complete the review

2019-02-12_15-51-00.png

Incomplete Facebook Review

Details for what to provide are below. In this scenario each would contain the same information. In addition to these information, you will need to provide a screencast of you demonstrating that process of signing in with Facebook and doing the thing you are asking Facebook for permission for (importing a status or automatically sharing to Facebook). Make sure your video shows you doing exactly the steps in the instructions you provided otherwise your review will likely be rejected. This video needs to show your community, so we cannot provide a video for you to send to Facebook - you must record and submit it yourself.

Important:- Ensure you edit text below as appropriate to group or page, and with the links for your site where noted in brackets

  • For Tell us how you're using this permission or feature? enter something similar to the following:
    Quote

    Allows users with the appropriate permissions to promote content to our facebook page/group

  • For Demonstrate how your selected platforms will use this permission or feature? choose Web, then enter the details below in the box provided
    Quote

    1. On the home page, click "Existing User? Sign In" in the top-right, and then click "sign in with facebook" from the dropdown.
    2. Click on an item of content (include a link here so facebook can test)
    3. Click "Promote" in the top right of the topic
    4. Enter details in the box next to the facebook icon (click x next to all others)
    5. Click promote
    5. Await 5 mins as it runs on a task
    6. Observe how the content entered, along with link to the topic, is posted to the facebook page/group (add your facebook page here)

6. Do this for each item, then select Submit For Review to submit the review and confirm the submission. You will be advised how long it will take you for Facebook to approve the submission, and should receive an email once it is complete.

 

Go Live

IMPORTANT: - Do not go live with your product, until you have completed any application permission reviews required by facebook for Statuses, and/or social media promotion.

In the top-right you will see an On/Off switch next to Status: In Development. Click the on/off switch and confirm. The switch should now indicate On and you should see Status: Live.

 

2019-02-12_14-53-21.png

Live Facebook App

 

 

 


  Report Guide


×
×
  • Create New...