Giter VIP home page Giter VIP logo

contao-facebook-login's Introduction

Contao Facebook Login

Contao 4 bundle for a Facebook login.

Installation

Require the bundle via composer:

composer require inspiredminds/contao-facebook-login

If you use the Contao Standard Edition, you will have to add

new FacebookLoginBundle\FacebookLoginBundle()

to your AppKernel.php. You will also need to add the bundle's routes to your app/config/routing.yml:

FacebookLoginBundle:
    resource: "@FacebookLoginBundle/Resources/config/routing.yml"

Then execute the Contao Install Tool (regardless of which edition you use).

Usage instructions

Facebook App

Before being able to use the Facebook login, you have to create a Facebook App for your website under developers.facebook.com/apps. Make sure to fill out at least the following fields:

  • Settings » Basic » Add Platform » Website: enter the basic URL of your site, e.g. http://example.org.
  • Settings » Basic » App Domains: fill in the domain of your site, e.g. example.org.

Then you need to configure the Facebook Login on the left side under PRODUCTS. If said product is not there, you need to add it manually via + Add Product first. Make sure to fill out Valid OAuth URIs with the the following URL of your site: http://example.org/fblogincallback. If you are using https, use that instead (or both). Set the rest of the settings as seen in the screenshot below:

Facebook Login settings

Use Strict Mode for Redirect URIs can be enabled (new Facebook apps will have this enabled by default). Then make your App public under App Review.

Contao configuration

After creating the Facebook App, you need to set the Facebook App ID and Facebook App Secret. You can define these either in the website root or in the system settings. Use the former if you are using a multidomain setup.

Facebook Login module

Simply create a Facebook Login module in your theme and include it anywhere. It works and behaves the same way as the regular login module of Contao and also offers the same settings, plus the ability to define the member groups newly registered users will belong to and the ability to decide what personal data should be stored from Facebook.

You can also define additional Facebook Login Permissions. These will be added to the default permissions. The module will also save a user access token in the session under the variable facebook_login_access_token for later use.

Attributions

This bundle uses code provided and originally used by Kamil Kuzminski.

contao-facebook-login's People

Contributors

fritzmg avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.