Merge pull request #670 from devforth/next

Next

Author: SerVitasik

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

@@ -535,6 +535,21 @@ Links to adapters:
 [Keycloak](https://github.com/devforth/adminforth-oauth-adapter-keycloak)
 
 
+## Starting OAuth flow from an external page
+
+If you have an external website with a "Sign in" button that should open the AdminForth OAuth flow directly — without showing the login form first — use the `start_oauth` query parameter:
+
+```
+https://your-admin.example.com/login?start_oauth=google
+https://your-admin.example.com/login?start_oauth=clerk
+```
+
+The value must match the provider name (case-insensitive). AdminForth will immediately redirect the user to the OAuth provider, skipping the login page entirely.
+
+The provider name is derived from the adapter class name — for example `AdminForthAdapterOauth2Google` → `google`, `AdminForthAdapterOauth2Clerk` → `clerk`.
+
+If the specified provider is not found, an error toast is shown on the login page. If `start_oauth` is provided without a value (`?start_oauth`), nothing happens and the regular login form is displayed.
+
 ## Fill user full name
 
 If you have a fullName field in your users resource, you can add it to the plugin setup:

adminforth/spa/src/utils/utils.ts

@@ -21,6 +21,7 @@ const LS_LANG_KEY = `afLanguage`;
 const MAX_CONSECUTIVE_EMPTY_RESULTS = 2;
 const ITEMS_PER_PAGE_LIMIT = 100;
 const AUTOLOGIN_QUERY_PARAM = 'autologin';
+const START_OAUTH_QUERY_PARAM = 'start_oauth';
 
 export function getAutologinCredentials(autologin: unknown): { username: string, password: string } | null {
   if (typeof autologin !== 'string') {
@@ -117,6 +118,12 @@ export async function redirectToLogin() {
   if (currentPath !== '/login' && currentPath !== homePagePath) {
     query.next = next;
   }
+  
+  const currentQuery = router.currentRoute.value.query;
+
+  if (START_OAUTH_QUERY_PARAM in currentQuery) {
+    query[START_OAUTH_QUERY_PARAM] = (currentQuery[START_OAUTH_QUERY_PARAM] as string) ?? '';
+  }
 
   await router.push({ name: 'login', query });
 }