added routes for zip export

[bookstack] / app / Theming / ThemeEvents.php

diff --git a/app/Theming/ThemeEvents.php b/app/Theming/ThemeEvents.php
index 3d8cd416789b48b039b6e63b85a6e3c1e794a013..2d4900c962cb1cf690bad1d12bc6899cbda799d7 100644 (file)
--- a/app/Theming/ThemeEvents.php
+++ b/app/Theming/ThemeEvents.php
@@ -23,7 +23,7 @@ class ThemeEvents
      * The provided $detail can be a string or a loggable type of model. You should check
      * the type before making use of this parameter.
      *
      * The provided $detail can be a string or a loggable type of model. You should check
      * the type before making use of this parameter.
      *

-     * @param string                                $type
+     * @param string $type

      * @param string|\BookStack\Activity\Models\Loggable $detail
      */
     const ACTIVITY_LOGGED = 'activity_logged';
      * @param string|\BookStack\Activity\Models\Loggable $detail
      */
     const ACTIVITY_LOGGED = 'activity_logged';


@@ -42,18 +42,37 @@ class ThemeEvents
      * system as a standard app user. This includes a user becoming logged in
      * after registration. This is not emitted upon API usage.
      *
      * system as a standard app user. This includes a user becoming logged in
      * after registration. This is not emitted upon API usage.
      *

-     * @param string               $authSystem
+     * @param string $authSystem

      * @param \BookStack\Users\Models\User $user
      */
     const AUTH_LOGIN = 'auth_login';
 
      * @param \BookStack\Users\Models\User $user
      */
     const AUTH_LOGIN = 'auth_login';
 

+    /**
+     * Auth pre-register event.
+     * Runs right before a new user account is registered in the system by any authentication
+     * system as a standard app user including auto-registration systems used by LDAP,
+     * SAML, OIDC and social systems. It only includes self-registrations,
+     * not accounts created by others in the UI or via the REST API.
+     * It runs after any other normal validation steps.
+     * Any account/email confirmation occurs post-registration.
+     * The provided $userData contains the main details that would be used to create
+     * the account, and may depend on authentication method.
+     * If false is returned from the event, registration will be prevented and the user
+     * will be returned to the login page.
+     *
+     * @param string $authSystem
+     * @param array $userData
+     * @returns bool|null
+     */
+    const AUTH_PRE_REGISTER = 'auth_pre_register';
+

     /**
      * Auth register event.
      * Runs right after a user is newly registered to the application by any authentication
      * system as a standard app user. This includes auto-registration systems used
     /**
      * Auth register event.
      * Runs right after a user is newly registered to the application by any authentication
      * system as a standard app user. This includes auto-registration systems used

-     * by LDAP, SAML and social systems. It only includes self-registrations.
+     * by LDAP, SAML, OIDC and social systems. It only includes self-registrations.

      *
      *

-     * @param string               $authSystem
+     * @param string $authSystem

      * @param \BookStack\Users\Models\User $user
      */
     const AUTH_REGISTER = 'auth_register';
      * @param \BookStack\Users\Models\User $user
      */
     const AUTH_REGISTER = 'auth_register';


@@ -91,8 +110,8 @@ class ThemeEvents
      *
      * @param string $tagReference
      * @param string $replacementHTML
      *
      * @param string $tagReference
      * @param string $replacementHTML

-     * @param \BookStack\Entities\Models\Page   $currentPage
-     * @param ?\BookStack\Entities\Models\Page  $referencedPage
+     * @param \BookStack\Entities\Models\Page $currentPage
+     * @param ?\BookStack\Entities\Models\Page $referencedPage

      */
     const PAGE_INCLUDE_PARSE = 'page_include_parse';
 
      */
     const PAGE_INCLUDE_PARSE = 'page_include_parse';
 


@@ -101,7 +120,7 @@ class ThemeEvents
      * Called when standard web (browser/non-api) app routes are registered.
      * Provides an app router, so you can register your own web routes.
      *
      * Called when standard web (browser/non-api) app routes are registered.
      * Provides an app router, so you can register your own web routes.
      *

-     * @param \Illuminate\Routing\Router
+     * @param \Illuminate\Routing\Router $router

      */
     const ROUTES_REGISTER_WEB = 'routes_register_web';
 
      */
     const ROUTES_REGISTER_WEB = 'routes_register_web';
 


@@ -111,7 +130,7 @@ class ThemeEvents
      * These are routes that typically require login to access (unless the instance is made public).
      * Provides an app router, so you can register your own web routes.
      *
      * These are routes that typically require login to access (unless the instance is made public).
      * Provides an app router, so you can register your own web routes.
      *

-     * @param \Illuminate\Routing\Router
+     * @param \Illuminate\Routing\Router $router

      */
     const ROUTES_REGISTER_WEB_AUTH = 'routes_register_web_auth';
 
      */
     const ROUTES_REGISTER_WEB_AUTH = 'routes_register_web_auth';
 


@@ -133,7 +152,7 @@ class ThemeEvents
      * Provides both the original request and the currently resolved response.
      * Return values, if provided, will be used as a new response to use.
      *
      * Provides both the original request and the currently resolved response.
      * Return values, if provided, will be used as a new response to use.
      *

-     * @param \Illuminate\Http\Request                                                       $request
+     * @param \Illuminate\Http\Request $request

      * @param \Illuminate\Http\Response|\Symfony\Component\HttpFoundation\BinaryFileResponse $response
      * @returns \Illuminate\Http\Response|null
      */
      * @param \Illuminate\Http\Response|\Symfony\Component\HttpFoundation\BinaryFileResponse $response
      * @returns \Illuminate\Http\Response|null
      */


@@ -149,11 +168,11 @@ class ThemeEvents
      * If the listener returns a non-null value, that will be used as the POST data instead
      * of the system default.
      *
      * If the listener returns a non-null value, that will be used as the POST data instead
      * of the system default.
      *

-     * @param string                                     $event
-     * @param \BookStack\Activity\Models\Webhook         $webhook
+     * @param string $event
+     * @param \BookStack\Activity\Models\Webhook $webhook

      * @param string|\BookStack\Activity\Models\Loggable $detail
      * @param string|\BookStack\Activity\Models\Loggable $detail

-     * @param \BookStack\Users\Models\User               $initiator
-     * @param int                                        $initiatedTime
+     * @param \BookStack\Users\Models\User $initiator
+     * @param int $initiatedTime

      * @returns array|null
      */
     const WEBHOOK_CALL_BEFORE = 'webhook_call_before';
      * @returns array|null
      */
     const WEBHOOK_CALL_BEFORE = 'webhook_call_before';