docs: add documentation about Facebook OAuth (#148)

* docs: add documentation about Facebook OAuth

* Update 11-oauth.md

* docs: add installation instruction for Facebook OAuth adapter

---------

Co-authored-by: Ivan Borshchov <[email protected]>

Author: NoOne7135

adminforth/documentation/docs/tutorial/05-Plugins/11-oauth.md

@@ -9,6 +9,7 @@ To install the plugin:
 ```bash
 npm install @adminforth/oauth --save
 npm install @adminforth/google-oauth-adapter --save  # for Google OAuth
+npm install @adminforth/facebook-oauth-adapter --save  # for Facebook OAuth
 ```
 
 ## Configuration
@@ -17,8 +18,8 @@ npm install @adminforth/google-oauth-adapter --save  # for Google OAuth
 
 You need to get the client ID and client secret from your OAuth2 provider.
 
-For Google:
-1. Go to the [Google Cloud Console](https://console.cloud.google.com)
+#### For Google:
+1. Go to the [Google Cloud Console](https://console.cloud.google.com) and log in.
 2. Create a new project or select an existing one
 3. Go to `APIs & Services` → `Credentials`
 4. Create credentials for OAuth 2.0 client IDs
@@ -32,6 +33,20 @@ GOOGLE_OAUTH_CLIENT_ID=your_google_client_id
 GOOGLE_OAUTH_CLIENT_SECRET=your_google_client_secret
 ```
 
+#### For Facebook:
+1. Go to the [Facebook Developers](https://developers.facebook.com/)
+2. Go to `My apps`
+3. Create a new project or select an existing one (choose Authenticate and request data from users with Facebook Login)
+4. Go to `Use Cases` - `Authenticate and request data from users with Facebook Login` -> `Customize` and add email permissions 
+5. Go to `App Settings` -> `Basic`
+6. Get App ID and App secret
+7. Add the credentials to your `.env` file:
+
+```bash
+FACEBOOK_OAUTH_CLIENT_ID=your_facebook_client_id
+FACEBOOK_OAUTH_CLIENT_SECRET=your_facebook_client_secret
+```
+
 ### 2. Plugin Configuration
 
 Configure the plugin in your user resource file:

dev-demo/resources/users.ts

@@ -16,6 +16,8 @@ import OAuthPlugin  from "../../plugins/adminforth-oauth";
 import AdminForthAdapterGoogleOauth2 from "../../adapters/adminforth-google-oauth-adapter";
 import AdminForthAdapterGithubOauth2 from  "../../adapters/adminforth-github-oauth-adapter";
 
+import AdminForthAdapterFacebookOauth2 from "../../adapters/adminforth-facebook-oauth-adapter";
+
 export default {
   dataSource: "maindb",
   table: "users",
@@ -98,7 +100,11 @@ export default {
           clientID: process.env.GOOGLE_CLIENT_ID,
           clientSecret: process.env.GOOGLE_CLIENT_SECRET,
           redirectUri: 'http://localhost:3000/oauth/callback',
-        })
+        }),
+        new AdminForthAdapterFacebookOauth2({
+          clientID: process.env.FACEBOOK_CLIENT_ID,
+          clientSecret: process.env.FACEBOOK_CLIENT_SECRET,
+        }),
       ],
       emailField: 'email',
       emailConfirmedField: 'email_confirmed'