webtrees Facebook Module

Facebook integration for webtrees genealogy software.

All of the authentication is done on the server-side so no external JavaScript files are needed.

• webtrees 1.7.9 is required for beta 7. webtrees 1.5.0 or higher is required up to beta 5. webtrees 1.6.1 or higher is required for beta 6+.
• 'Allow visitors to request account registration' must be enabled in Site Configuration if you want to allow new users via Facebook.

Installation

1. Install the module by extracting/cloning the directory with the name facebook inside /modules_v3/.
2. In the 'administration' section of your webtrees site, visit the 'Modules' page and check the box to enable the 'Facebook' module and then click 'Save'.
3. If you don't have a Facebook Developer account, create one at https://developers.facebook.com/
4. If you don't already have a Facebook application setup for the site, visit https://developers.facebook.com/apps/ and set one up by clicking 'Create a New App' from the Apps menu and specify a 'Display Name' and 'Category'.
   • Once the App is created, click the 'Settings' menu and put your domain name (e.g. example.com) in the 'App Domains' field.
   • Click 'Add platform', choose 'Website' and enter your 'Site URL' (e.g. http://example.com).
   • Click 'Save Changes'.
5. Specify the Facebook API App ID and Secret at {WEBTREES_ROOT}/module.php?mod=facebook&mod_action=admin which is accessible as a 'Facebook' link from the bottom of the administration menu.

Known Issues

• If a user logs in with a Facebook account which uses a different email address than their existing webtrees email address, a second account will be created for the same individual. If administrator approval is required for new accounts, the administrator can delete the new account and link the existing account to the user's Facebook account. The administrator can also link existing users to their Facebook accounts in advance (where possible) to avoid this situation.
• Pre-approval of users won't work for Facebook Apps created after 2014-04-30. See #16.
• There is no comment field during registration with a Facebook account.
• The login button will not appear if all trees have "Require visitor authentication".

Development

Clone this repo into a facebook subdirectory of modules_v3/ in a webtrees installation.

Automated Tests

Tests are located in the tests/ directory. They use steward and php-webdriver.

Setup

brew install geckodriver
composer install
./vendor/bin/steward install
java -jar ./vendor/bin/selenium-server-standalone-3.1*.jar
./vendor/bin/steward run -vvv dev firefox