====== AuthFacebook Plugin ======

---- plugin ----
description: Authentication with Facebook accounts
author     : Leo Zachl
email      : leo.zachl@gmail.com
type       : auth, action
lastupdate : 2017-06-15
compatible : Hrun
depends    : 
conflicts  : 
similar    : authgoogle
tags       : authentication, oauth, facebook

downloadurl: https://github.com/leozachl/dokuwiki-authfacebook/zipball/master
bugtracker : https://github.com/leozachl/dokuwiki-authfacebook/issues
sourcerepo : https://github.com/leozachl/dokuwiki-authfacebook/
donationurl: 

screenshot_img : 
----

===== Description =====

Facebook Authentication Plugin allows to sign in to DokuWiki using Facebook accounts.

==== Features ====

  * Allows to specify a default group for Facebook users.
  * Allows to map facebookgroups to dokuwiki groups.
  * Allows to map a list of facebook users to the admin group.

===== Installation =====

First create a Facebook App for authentication.\\
Take a look at [[https://developers.facebook.com/docs/]] section [[https://developers.facebook.com/docs/facebook-login|Login]] and [[https://developers.facebook.com/docs/reference/php|PHP - SDK]]

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Configuration and Settings =====
  - Change ''authtype'' to ''authfacebook''
  - Enter your Facebook ApplicationID and the ApplicationSecret
  - Create a maybe empty JSON list of superusers ''[fbUID1,fbUID2]''
  - Create a JSON map of Facebook group IDs to DW-groups ''{"fbGID1":"DWGroup1","fbGID2":"DWGroup2"}''
  - Change the Facebook default group if needed

all FB-IDs are numerical!

===== Development =====


=== Change Log ===

https://github.com/leozachl/dokuwiki-authfacebook/commits/master

  * **2015-02-25**
    * Initial release

=== Known Bugs and Issues ===
[[https://github.com/leozachl/dokuwiki-authfacebook/issues]]