Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mnoorenberghe/webtrees-facebook
Facebook integration for webtrees genealogy software
https://github.com/mnoorenberghe/webtrees-facebook
authentication connect facebook login php webtrees
Last synced: 3 months ago
JSON representation
Facebook integration for webtrees genealogy software
- Host: GitHub
- URL: https://github.com/mnoorenberghe/webtrees-facebook
- Owner: mnoorenberghe
- License: gpl-2.0
- Created: 2013-12-26T23:15:19.000Z (about 11 years ago)
- Default Branch: main
- Last Pushed: 2022-04-30T04:12:12.000Z (almost 3 years ago)
- Last Synced: 2023-03-11T19:03:26.027Z (almost 2 years ago)
- Topics: authentication, connect, facebook, login, php, webtrees
- Language: PHP
- Homepage: https://mnoorenberghe.github.io/webtrees-facebook/
- Size: 945 KB
- Stars: 12
- Watchers: 11
- Forks: 5
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
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](https://developers.facebook.com/docs/create-developer-account/)
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](https://github.com/mnoorenberghe/webtrees-facebook/issues/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](https://github.com/lmc-eu/steward) and
[php-webdriver](https://github.com/facebook/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