====== Facebook Login Plugin ======

---- plugin ----
description: Plugin to get authentication from Facebook
author     : Václav Voborník
email      : nomail@vobornik.eu 
type       : Action,Admin
lastupdate : 2013-01-12
compatible : 2010-11-07 2011-05-25 2012-01-25 2012-10-13
depends    : 
conflicts  : 
similar    : authfacebook
tags       : !obsolete, facebook, authentication

downloadurl: https://github.com/vobornik/Dokuwiki-FBlogin-Plugin/zipball/master
bugtracker : https://github.com/vobornik/Dokuwiki-FBlogin-Plugin/issues
sourcerepo : https://github.com/vobornik/Dokuwiki-FBlogin-Plugin/
donationurl: http://flattr.com/thing/606924/Dokuwiki-Plugins
----
Probably this is replaceable by [[plugin:authfacebook]]

===== Download and Installation =====

Note: Your webserver must have the php5-curl installed for this plugin to work.

Note: Facebook rejects this plugin authentication if $conf['baseurl'] is not set (https://github.com/vobornik/Dokuwiki-FBlogin-Plugin/issues/3) and auto-detection is not enough.

Note: You have to have an application ID and Secret string to connect your dokuwiki with Facebook. You can [[http://developers.facebook.com/setup/|Create your Facebook application here]]

  - Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
  - Click to **Admin** button, then **Authentication using Facebook** and then click on **Install** button. This will copy the authentication backend file //lib/plugins/fblogin/file/facebook.class.php// //into inc/auth/// directory. FIXME WeatherWax release will not support backends in inc/auth, it needs [[devel:Auth plugins]]
  - Go to **Admin** -> **Configuration Settings** and fill out the Fblogin Plugin Settings:
    * ''applicationID'' -- Application ID obtained from Facebook
    * ''applicationSecret'' -- Application Secret ID obtained from Facebook
    * ''superuser'' -- Facebook user ID whom to grant global Superuser rights on your DokuWiki site - **IMPORTANT** -- only the user with this Facebook user id will be able to administer your Dokuwiki after step 4. (TODO: get the list of superusers from your Facebook application managers)
  - Switch the Authentication backend to "facebook" (**Admin** -> **Configuration Settings**)
  * You might want to change also the //showuseras// configuration option (What to display when showing the user that last edited a page) to //User's full name//


===== Discussion =====


does not work with weatherwax.. plz update this. thanks!  --- [[user>goldseed|S.C. Yoo]] //2013/04/05 16:29//