53 lines
No EOL
2 KiB
PHP
53 lines
No EOL
2 KiB
PHP
<?php namespace BookStack\Theming;
|
|
|
|
/**
|
|
* 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
|
|
{
|
|
/**
|
|
* Application boot-up.
|
|
* After main services are registered.
|
|
* @param \BookStack\Application $app
|
|
*/
|
|
const APP_BOOT = 'app_boot';
|
|
|
|
/**
|
|
* 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
|
|
* @returns \Illuminate\Http\Response|null
|
|
*/
|
|
const WEB_MIDDLEWARE_AFTER = 'web_middleware_after';
|
|
|
|
/**
|
|
* Commonmark environment configure.
|
|
* Provides the commonmark library environment for customization
|
|
* before its 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';
|
|
} |