mirror of
https://github.com/BookStackApp/BookStack.git
synced 2024-08-27 04:32:14 +00:00
130 lines
5.3 KiB
PHP
130 lines
5.3 KiB
PHP
<?php
|
|
|
|
namespace BookStack\Theming;
|
|
|
|
use BookStack\Entities\Models\Page;
|
|
|
|
/**
|
|
* The ThemeEvents used within BookStack.
|
|
*
|
|
* This file details the events that BookStack may fire via the custom
|
|
* theme system, including event names, parameters and expected return types.
|
|
*
|
|
* This system is regarded as semi-stable.
|
|
* We'll look to fix issues with it or migrate old event types but
|
|
* events and their signatures may change in new versions of BookStack.
|
|
* We'd advise testing any usage of these events upon upgrade.
|
|
*/
|
|
class ThemeEvents
|
|
{
|
|
/**
|
|
* Activity logged event.
|
|
* Runs right after an activity is logged by bookstack.
|
|
* These are the activities that can be seen in the audit log area of BookStack.
|
|
* Activity types can be seen listed in the \BookStack\Actions\ActivityType class.
|
|
* 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|\BookStack\Interfaces\Loggable $detail
|
|
*/
|
|
const ACTIVITY_LOGGED = 'activity_logged';
|
|
|
|
/**
|
|
* Application boot-up.
|
|
* After main services are registered.
|
|
*
|
|
* @param \BookStack\Application $app
|
|
*/
|
|
const APP_BOOT = 'app_boot';
|
|
|
|
/**
|
|
* Auth login event.
|
|
* Runs right after a user is logged-in to the application by any authentication
|
|
* 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 \BookStack\Auth\User $user
|
|
*/
|
|
const AUTH_LOGIN = 'auth_login';
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param string $authSystem
|
|
* @param \BookStack\Auth\User $user
|
|
*/
|
|
const AUTH_REGISTER = 'auth_register';
|
|
|
|
/**
|
|
* Commonmark environment configure.
|
|
* Provides the commonmark library environment for customization before it's used to render markdown content.
|
|
* If the listener returns a non-null value, that will be used as an environment instead.
|
|
*
|
|
* @param \League\CommonMark\ConfigurableEnvironmentInterface $environment
|
|
* @returns \League\CommonMark\ConfigurableEnvironmentInterface|null
|
|
*/
|
|
const COMMONMARK_ENVIRONMENT_CONFIGURE = 'commonmark_environment_configure';
|
|
|
|
/**
|
|
* Page include parse event.
|
|
* Runs when a page include tag is being parsed, typically when page content is being processed for viewing.
|
|
* Provides the "include tag" reference string, the default BookStack replacement content for the tag,
|
|
* the current page being processed, and the page that's being referenced by the include tag.
|
|
* The referenced page may be null where the page does not exist or where permissions prevent visibility.
|
|
* If the listener returns a non-null value, that will be used as the replacement HTML content instead.
|
|
*
|
|
* @param string $tagReference
|
|
* @param string $replacementHTML
|
|
* @param Page $currentPage
|
|
* @param ?Page $referencedPage
|
|
*/
|
|
const PAGE_INCLUDE_PARSE = 'page_include_parse';
|
|
|
|
/**
|
|
* Web before middleware action.
|
|
* Runs before the request is handled but after all other middleware apart from those
|
|
* that depend on the current session user (Localization for example).
|
|
* Provides the original request to use.
|
|
* Return values, if provided, will be used as a new response to use.
|
|
*
|
|
* @param \Illuminate\Http\Request $request
|
|
* @returns \Illuminate\Http\Response|null
|
|
*/
|
|
const WEB_MIDDLEWARE_BEFORE = 'web_middleware_before';
|
|
|
|
/**
|
|
* Web after middleware action.
|
|
* Runs after the request is handled but before the response is sent.
|
|
* 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\Response|\Symfony\Component\HttpFoundation\BinaryFileResponse $response
|
|
* @returns \Illuminate\Http\Response|null
|
|
*/
|
|
const WEB_MIDDLEWARE_AFTER = 'web_middleware_after';
|
|
|
|
/**
|
|
* Webhook call before event.
|
|
* Runs before a webhook endpoint is called. Allows for customization
|
|
* of the data format & content within the webhook POST request.
|
|
* Provides the original event name as a string (see \BookStack\Actions\ActivityType)
|
|
* along with the webhook instance along with the event detail which may be a
|
|
* "Loggable" model type or a string.
|
|
* 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\Actions\Webhook $webhook
|
|
* @param string|\BookStack\Interfaces\Loggable $detail
|
|
* @param \BookStack\Auth\User $initiator
|
|
* @param int $initiatedTime
|
|
*/
|
|
const WEBHOOK_CALL_BEFORE = 'webhook_call_before';
|
|
}
|