upgrade

plugin/oauth2/README.md

@@ -0,0 +1,22 @@
+# The OAuth2 Plugin
+Allows authentication with a generic OAuth2 provider.
+
+This plugin adds an extra field to users :
+- `oauth2_id`, to store each users' OAuth2 identifier.
+
+> This plugin uses the [`league/oauth2-client`](https://oauth2-client.thephpleague.com/) package.
+
+### To configure the OAuth2 server
+The OAuth2 server administrator must give you an OAuth2 client identifier and secret and enter this callback URL :
+`https://{CHAMILO_URL}/plugin/oauth2/src/callback.php`.
+
+### To configure this plugin
+* Enable it
+* Fill in the setting parameters (read the help messages)
+* assign a region. Preferably `login_bottom`.
+
+Also, you can configure the external login to work with the classic Chamilo form login.
+Adding this line in `configuration.php` file.
+```php
+$extAuthSource["oauth2"]["login"] = $_configuration['root_sys']."main/auth/external_login/login.oauth2.php";
+```