Merge pull request #12060 from nextcloud/update-events

feat: update list of ocp events
2026-01-03 02:09:45 +07:00 · 2024-07-25 21:20:59 +02:00
parent 105ae3e859 df5c9443e7
commit a606e449ec
2 changed files with 966 additions and 444 deletions
--- a/developer_manual/basics/_available_events_ocp.rst
+++ b/developer_manual/basics/_available_events_ocp.rst
@@ -0,0 +1,965 @@
+.. This file is generated by nextcloud-ocp-events.
+.. Always change the source file.
+
+``OCP\Authentication\Events\AnyLoginFailedEvent``
+*************************************************
+
+.. versionadded:: 26
+
+Emitted when the authentication fails
+
+``OCP\Authentication\Events\LoginFailedEvent``
+**********************************************
+
+.. versionadded:: 19
+
+Emitted when the authentication fails, but only if the login name can be associated with an existing user.
+
+``OCP\Authentication\TwoFactorAuth\RegistryEvent``
+**************************************************
+
+.. versionadded:: 15
+
+
+``OCP\Authentication\TwoFactorAuth\TwoFactorProviderDisabled``
+**************************************************************
+
+.. versionadded:: 20
+
+
+``OCP\Authentication\TwoFactorAuth\TwoFactorProviderChallengePassed``
+*********************************************************************
+
+.. versionadded:: 28
+
+
+``OCP\Authentication\TwoFactorAuth\TwoFactorProviderForUserEnabled``
+********************************************************************
+
+.. versionadded:: 22
+
+
+``OCP\Authentication\TwoFactorAuth\TwoFactorProviderForUserDisabled``
+*********************************************************************
+
+.. versionadded:: 22
+
+
+``OCP\Authentication\TwoFactorAuth\TwoFactorProviderForUserRegistered``
+***********************************************************************
+
+.. versionadded:: 28
+
+
+``OCP\Authentication\TwoFactorAuth\TwoFactorProviderUserDeleted``
+*****************************************************************
+
+.. versionadded:: 28
+
+
+``OCP\Authentication\TwoFactorAuth\TwoFactorProviderChallengeFailed``
+*********************************************************************
+
+.. versionadded:: 28
+
+
+``OCP\Authentication\TwoFactorAuth\TwoFactorProviderForUserUnregistered``
+*************************************************************************
+
+.. versionadded:: 28
+
+
+``OCP\Profile\BeforeTemplateRenderedEvent``
+*******************************************
+
+.. versionadded:: 25
+
+Emitted before the rendering step of the public profile page happens.
+
+``OCP\Share\Events\ShareDeletedEvent``
+**************************************
+
+.. versionadded:: 21
+
+
+``OCP\Share\Events\ShareDeletedFromSelfEvent``
+**********************************************
+
+.. versionadded:: 28
+
+
+``OCP\Share\Events\BeforeShareCreatedEvent``
+********************************************
+
+.. versionadded:: 28
+
+
+``OCP\Share\Events\BeforeShareDeletedEvent``
+********************************************
+
+.. versionadded:: 28
+
+
+``OCP\Share\Events\ShareCreatedEvent``
+**************************************
+
+.. versionadded:: 18
+
+
+``OCP\Share\Events\VerifyMountPointEvent``
+******************************************
+
+.. versionadded:: 19
+
+
+``OCP\Share\Events\ShareAcceptedEvent``
+***************************************
+
+.. versionadded:: 28
+
+
+``OCP\AppFramework\Http\Events\BeforeLoginTemplateRenderedEvent``
+*****************************************************************
+
+.. versionadded:: 28
+
+Emitted before the rendering step of the login TemplateResponse.
+
+``OCP\AppFramework\Http\Events\BeforeTemplateRenderedEvent``
+************************************************************
+
+.. versionadded:: 20
+
+Emitted before the rendering step of each TemplateResponse. The event holds a
+flag that specifies if an user is logged in.
+
+``OCP\FilesMetadata\Event\MetadataBackgroundEvent``
+***************************************************
+
+.. versionadded:: 28
+
+MetadataBackgroundEvent is an event similar to MetadataLiveEvent but dispatched
+on a background thread instead of live thread. Meaning there is no limit to
+the time required for the generation of your metadata.
+
+``OCP\FilesMetadata\Event\MetadataNamedEvent``
+**********************************************
+
+.. versionadded:: 28
+
+MetadataNamedEvent is an event similar to MetadataBackgroundEvent completed with a target name,
+used to limit the refresh of metadata only listeners capable of filtering themselves out.
+Meaning that when using this event, your app must implement a filter on the event's registered
+name returned by getName()
+
+This event is mostly triggered when a registered name is added to the files scan
+   i.e. ./occ files:scan --generate-metadata [name]
+
+``OCP\FilesMetadata\Event\MetadataLiveEvent``
+*********************************************
+
+.. versionadded:: 28
+
+MetadataLiveEvent is an event initiated when a file is created or updated.
+The app contains the Node related to the created/updated file, and a FilesMetadata that already
+contains the currently known metadata.
+
+Setting new metadata, or modifying already existing metadata with different value, will trigger
+the save of the metadata in the database.
+
+``OCP\App\Events\AppUpdateEvent``
+*********************************
+
+.. versionadded:: 27
+
+This event is triggered when an app is updated.
+
+``OCP\App\Events\AppEnableEvent``
+*********************************
+
+.. versionadded:: 27
+
+This event is triggered when an app is enabled.
+
+``OCP\App\Events\AppDisableEvent``
+**********************************
+
+.. versionadded:: 27
+
+This event is triggered when an app is disabled.
+
+``OCP\App\ManagerEvent``
+************************
+
+.. versionadded:: 9
+
+Class ManagerEvent
+
+``OCP\TextToImage\Events\TaskFailedEvent``
+******************************************
+
+.. versionadded:: 28
+
+
+``OCP\TextToImage\Events\TaskSuccessfulEvent``
+**********************************************
+
+.. versionadded:: 28
+
+
+``OCP\Contacts\Events\ContactInteractedWithEvent``
+**************************************************
+
+.. versionadded:: 19
+
+An event that allows apps to notify other components about an interaction
+between two users. This can be used to build better recommendations and
+suggestions in user interfaces.
+Emitters should add at least one identifier (uid, email, federated cloud ID)
+of the recipient of the interaction.
+
+``OCP\WorkflowEngine\Events\RegisterOperationsEvent``
+*****************************************************
+
+.. versionadded:: 18
+
+
+``OCP\WorkflowEngine\Events\RegisterChecksEvent``
+*************************************************
+
+.. versionadded:: 18
+
+
+``OCP\WorkflowEngine\Events\LoadSettingsScriptsEvent``
+******************************************************
+
+.. versionadded:: 20
+
+Emitted when the workflow engine settings page is loaded.
+
+``OCP\WorkflowEngine\Events\RegisterEntitiesEvent``
+***************************************************
+
+.. versionadded:: 18
+
+
+``OCP\Federation\Events\TrustedServerRemovedEvent``
+***************************************************
+
+.. versionadded:: 25
+
+
+``OCP\SabrePluginEvent``
+************************
+
+.. versionadded:: 8.2
+
+
+``OCP\Mail\Events\BeforeMessageSent``
+*************************************
+
+.. versionadded:: 19
+
+Emitted before a system mail is sent. It can be used to alter the message.
+
+``OCP\Settings\Events\DeclarativeSettingsRegisterFormEvent``
+************************************************************
+
+.. versionadded:: 29
+
+
+``OCP\Settings\Events\DeclarativeSettingsSetValueEvent``
+********************************************************
+
+.. versionadded:: 29
+
+
+``OCP\Settings\Events\DeclarativeSettingsGetValueEvent``
+********************************************************
+
+.. versionadded:: 29
+
+
+``OCP\Collaboration\AutoComplete\AutoCompleteFilterEvent``
+**********************************************************
+
+.. versionadded:: 28
+
+
+``OCP\Collaboration\AutoComplete\AutoCompleteEvent``
+****************************************************
+
+.. versionadded:: 16
+
+
+``OCP\Collaboration\Resources\LoadAdditionalScriptsEvent``
+**********************************************************
+
+.. versionadded:: 25
+
+This event is used by apps to register their own frontend scripts for integrating
+projects in their app. Apps also need to dispatch the event in order to load
+scripts during page load
+
+``OCP\Collaboration\Reference\RenderReferenceEvent``
+****************************************************
+
+.. versionadded:: 25
+
+Event emitted when apps might render references like link previews or smart picker widgets.
+This can be used to inject scripts for extending that.
+Further details can be found in the :ref:`Reference providers` deep dive.
+
+``OCP\Comments\CommentsEntityEvent``
+************************************
+
+.. versionadded:: 9.1
+
+.. versionchanged:: 28.0.0
+   Dispatched as a typed event
+
+Class CommentsEntityEvent
+
+``OCP\Comments\CommentsEvent``
+******************************
+
+.. versionadded:: 9
+
+Class CommentsEvent
+
+``OCP\Accounts\UserUpdatedEvent``
+*********************************
+
+.. versionadded:: 28
+
+This event is triggered when the account data of a user was updated.
+
+``OCP\Files\Cache\CacheEntryRemovedEvent``
+******************************************
+
+.. versionadded:: 21
+
+Event for when an existing entry in the cache gets removed
+
+``OCP\Files\Cache\CacheUpdateEvent``
+************************************
+
+.. versionadded:: 16
+
+Event for when an existing entry in the cache gets updated
+
+``OCP\Files\Cache\CacheEntryInsertedEvent``
+*******************************************
+
+.. versionadded:: 21
+
+Event for when an existing entry in the cache gets inserted
+
+``OCP\Files\Cache\CacheEntryUpdatedEvent``
+******************************************
+
+.. versionadded:: 21
+
+Event for when an existing entry in the cache gets updated
+
+``OCP\Files\Cache\AbstractCacheEvent``
+**************************************
+
+.. versionadded:: 22
+
+
+``OCP\Files\Cache\CacheInsertEvent``
+************************************
+
+.. versionadded:: 16
+
+Event for when a new entry gets added to the cache
+
+``OCP\Files\Events\NodeRemovedFromFavorite``
+********************************************
+
+.. versionadded:: 28
+
+
+``OCP\Files\Events\FileScannedEvent``
+*************************************
+
+.. versionadded:: 18
+
+
+``OCP\Files\Events\FolderScannedEvent``
+***************************************
+
+.. versionadded:: 18
+
+
+``OCP\Files\Events\NodeAddedToFavorite``
+****************************************
+
+.. versionadded:: 28
+
+
+``OCP\Files\Events\BeforeFileScannedEvent``
+*******************************************
+
+.. versionadded:: 18
+
+
+``OCP\Files\Events\Node\BeforeNodeCopiedEvent``
+***********************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\BeforeNodeTouchedEvent``
+************************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\BeforeNodeRenamedEvent``
+************************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\NodeDeletedEvent``
+******************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\BeforeNodeCreatedEvent``
+************************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\BeforeNodeReadEvent``
+*********************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\NodeRenamedEvent``
+******************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\BeforeNodeDeletedEvent``
+************************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\NodeCopiedEvent``
+*****************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\NodeCreatedEvent``
+******************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\FilesystemTornDownEvent``
+*************************************************
+
+.. versionadded:: 24
+
+Event fired after the filesystem has been torn down
+
+``OCP\Files\Events\Node\NodeTouchedEvent``
+******************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\BeforeNodeWrittenEvent``
+************************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\Node\NodeWrittenEvent``
+******************************************
+
+.. versionadded:: 20
+
+
+``OCP\Files\Events\FileCacheUpdated``
+*************************************
+
+.. versionadded:: 18
+
+
+``OCP\Files\Events\BeforeZipCreatedEvent``
+******************************************
+
+.. versionadded:: 25
+
+
+``OCP\Files\Events\NodeRemovedFromCache``
+*****************************************
+
+.. versionadded:: 18
+
+
+``OCP\Files\Events\BeforeDirectFileDownloadEvent``
+**************************************************
+
+.. versionadded:: 25
+
+This event is triggered when a user tries to download a file
+directly.
+
+``OCP\Files\Events\BeforeFolderScannedEvent``
+*********************************************
+
+.. versionadded:: 18
+
+
+``OCP\Files\Events\InvalidateMountCacheEvent``
+**********************************************
+
+.. versionadded:: 24
+
+Used to notify the filesystem setup manager that the available mounts for a user have changed
+
+``OCP\Files\Events\NodeAddedToCache``
+*************************************
+
+.. versionadded:: 18
+
+
+``OCP\Files\Template\FileCreatedFromTemplateEvent``
+***************************************************
+
+.. versionadded:: 21
+
+
+``OCP\Files\Template\RegisterTemplateCreatorEvent``
+***************************************************
+
+.. versionadded:: 30
+
+
+``OCP\Config\BeforePreferenceDeletedEvent``
+*******************************************
+
+.. versionadded:: 25
+
+
+``OCP\Config\BeforePreferenceSetEvent``
+***************************************
+
+.. versionadded:: 25
+
+
+``OCP\DirectEditing\RegisterDirectEditorEvent``
+***********************************************
+
+.. versionadded:: 18
+
+Event to allow to register the direct editor.
+
+``OCP\Preview\BeforePreviewFetchedEvent``
+*****************************************
+
+.. versionadded:: 25.0.1
+
+.. versionchanged:: 28.0.0
+   the constructor arguments ``$width``, ``$height``, ``$crop`` and ``$mode`` are no longer nullable.
+
+Emitted before a file preview is being fetched.
+It can be used to block preview rendering by throwing a ``OCP\Files\NotFoundException``
+
+``OCP\SpeechToText\Events\TranscriptionSuccessfulEvent``
+********************************************************
+
+.. versionadded:: 27
+
+This Event is emitted when a transcription of a media file happened successfully
+
+``OCP\SpeechToText\Events\TranscriptionFailedEvent``
+****************************************************
+
+.. versionadded:: 27
+
+This Event is emitted if a transcription of a media file using a Speech-To-Text provider failed
+
+``OCP\Security\CSP\AddContentSecurityPolicyEvent``
+**************************************************
+
+.. versionadded:: 17
+
+Allows to inject something into the default content policy. This is for
+example useful when you're injecting Javascript code into a view belonging
+to another controller and cannot modify its Content-Security-Policy itself.
+Note that the adjustment is only applied to applications that use AppFramework
+controllers.
+
+WARNING: Using this API incorrectly may make the instance more insecure.
+Do think twice before adding whitelisting resources. Please do also note
+that it is not possible to use the `disallowXYZ` functions.
+
+``OCP\Security\Events\GenerateSecurePasswordEvent``
+***************************************************
+
+.. versionadded:: 18
+
+
+``OCP\Security\Events\ValidatePasswordPolicyEvent``
+***************************************************
+
+.. versionadded:: 18
+
+
+``OCP\Security\FeaturePolicy\AddFeaturePolicyEvent``
+****************************************************
+
+.. versionadded:: 17
+
+Event that allows to register a feature policy header to a request.
+
+``OCP\User\GetQuotaEvent``
+**************************
+
+.. versionadded:: 20
+
+Event to allow apps to
+
+``OCP\User\Events\UserChangedEvent``
+************************************
+
+.. versionadded:: 18
+
+
+``OCP\User\Events\UserLiveStatusEvent``
+***************************************
+
+.. versionadded:: 20
+
+
+``OCP\User\Events\BeforePasswordUpdatedEvent``
+**********************************************
+
+.. versionadded:: 18
+
+Emitted before the user password is updated.
+
+``OCP\User\Events\UserDeletedEvent``
+************************************
+
+.. versionadded:: 18
+
+
+``OCP\User\Events\BeforeUserDeletedEvent``
+******************************************
+
+.. versionadded:: 18
+
+
+``OCP\User\Events\BeforeUserCreatedEvent``
+******************************************
+
+.. versionadded:: 18
+
+Emitted before a new user is created on the back-end.
+
+``OCP\User\Events\OutOfOfficeClearedEvent``
+*******************************************
+
+.. versionadded:: 28
+
+Emitted when a user's out-of-office period is cleared
+
+``OCP\User\Events\BeforeUserLoggedInEvent``
+*******************************************
+
+.. versionadded:: 18
+
+
+``OCP\User\Events\UserFirstTimeLoggedInEvent``
+**********************************************
+
+.. versionadded:: 28
+
+
+``OCP\User\Events\UserCreatedEvent``
+************************************
+
+.. versionadded:: 18
+
+Emitted when a new user has been created on the back-end.
+
+``OCP\User\Events\UserLoggedInWithCookieEvent``
+***********************************************
+
+.. versionadded:: 18
+
+Emitted when a user has been successfully logged in via remember-me cookies.
+
+``OCP\User\Events\PasswordUpdatedEvent``
+****************************************
+
+.. versionadded:: 18
+
+Emitted when the user password has been updated.
+
+``OCP\User\Events\OutOfOfficeScheduledEvent``
+*********************************************
+
+.. versionadded:: 28
+
+Emitted when a user's out-of-office period is scheduled
+
+``OCP\User\Events\PostLoginEvent``
+**********************************
+
+.. versionadded:: 18
+
+
+``OCP\User\Events\OutOfOfficeChangedEvent``
+*******************************************
+
+.. versionadded:: 28
+
+Emitted when a user's out-of-office period has changed
+
+``OCP\User\Events\OutOfOfficeStartedEvent``
+*******************************************
+
+.. versionadded:: 28
+
+Emitted when a user's out-of-office period started
+
+``OCP\User\Events\BeforeUserLoggedOutEvent``
+********************************************
+
+.. versionadded:: 18
+
+Emitted before a user is logged out.
+
+``OCP\User\Events\OutOfOfficeEndedEvent``
+*****************************************
+
+.. versionadded:: 28
+
+Emitted when a user's out-of-office period ended
+
+``OCP\User\Events\UserLoggedOutEvent``
+**************************************
+
+.. versionadded:: 18
+
+Emitted when a user has been logged out successfully.
+
+``OCP\User\Events\UserLoggedInEvent``
+*************************************
+
+.. versionadded:: 18
+
+
+``OCP\User\Events\BeforeUserLoggedInWithCookieEvent``
+*****************************************************
+
+.. versionadded:: 18
+
+Emitted before a user is logged in via remember-me cookies.
+
+``OCP\SystemTag\MapperEvent``
+*****************************
+
+.. versionadded:: 9
+
+Class MapperEvent
+
+``OCP\SystemTag\ManagerEvent``
+******************************
+
+.. versionadded:: 9
+
+Class ManagerEvent
+
+``OCP\SystemTag\SystemTagsEntityEvent``
+***************************************
+
+.. versionadded:: 9.1
+
+.. versionchanged:: 28.0.0
+   Dispatched as a typed event
+
+Class SystemTagsEntityEvent
+
+``OCP\TaskProcessing\Events\TaskFailedEvent``
+*********************************************
+
+.. versionadded:: 30
+
+
+``OCP\TaskProcessing\Events\TaskSuccessfulEvent``
+*************************************************
+
+.. versionadded:: 30
+
+
+``OCP\EventDispatcher\GenericEvent``
+************************************
+
+.. versionadded:: 18
+
+Class GenericEvent
+convenience reimplementation of \Symfony\Component\GenericEvent against
+\OCP\EventDispatcher\Event
+
+``OCP\BeforeSabrePubliclyLoadedEvent``
+**************************************
+
+.. versionadded:: 26
+
+Dispatched before Sabre is loaded when accessing public webdav endpoints
+This can be used to inject a Sabre plugin for example
+
+``OCP\Console\ConsoleEvent``
+****************************
+
+.. versionadded:: 9
+
+Class ConsoleEvent
+
+``OCP\Log\BeforeMessageLoggedEvent``
+************************************
+
+.. versionadded:: 28
+
+Even for when a log item is being logged
+
+``OCP\Log\Audit\CriticalActionPerformedEvent``
+**********************************************
+
+.. versionadded:: 22
+
+Emitted when the admin_audit app should log an entry
+
+``OCP\DB\Events\AddMissingIndicesEvent``
+****************************************
+
+.. versionadded:: 28
+
+Event to allow apps to register information about missing database indices
+This event will be dispatched for checking on the admin settings and when running
+occ db:add-missing-indices which will then create those indices
+
+``OCP\DB\Events\AddMissingColumnsEvent``
+****************************************
+
+.. versionadded:: 28
+
+Event to allow apps to register information about missing database columns
+This event will be dispatched for checking on the admin settings and when running
+occ db:add-missing-columns which will then create those columns
+
+``OCP\DB\Events\AddMissingPrimaryKeyEvent``
+*******************************************
+
+.. versionadded:: 28
+
+Event to allow apps to register information about missing database primary keys
+This event will be dispatched for checking on the admin settings and when running
+occ db:add-missing-primary-keys which will then create those keys
+
+``OCP\Group\Events\GroupCreatedEvent``
+**************************************
+
+.. versionadded:: 18
+
+
+``OCP\Group\Events\UserRemovedEvent``
+*************************************
+
+.. versionadded:: 18
+
+
+``OCP\Group\Events\SubAdminRemovedEvent``
+*****************************************
+
+.. versionadded:: 21
+
+
+``OCP\Group\Events\BeforeGroupCreatedEvent``
+********************************************
+
+.. versionadded:: 18
+
+
+``OCP\Group\Events\UserAddedEvent``
+***********************************
+
+.. versionadded:: 18
+
+
+``OCP\Group\Events\GroupDeletedEvent``
+**************************************
+
+.. versionadded:: 18
+
+
+``OCP\Group\Events\GroupChangedEvent``
+**************************************
+
+.. versionadded:: 26
+
+
+``OCP\Group\Events\BeforeUserAddedEvent``
+*****************************************
+
+.. versionadded:: 18
+
+
+``OCP\Group\Events\BeforeUserRemovedEvent``
+*******************************************
+
+.. versionadded:: 18
+
+
+``OCP\Group\Events\BeforeGroupChangedEvent``
+********************************************
+
+.. versionadded:: 26
+
+
+``OCP\Group\Events\SubAdminAddedEvent``
+***************************************
+
+.. versionadded:: 21
+
+
+``OCP\Group\Events\BeforeGroupDeletedEvent``
+********************************************
+
+.. versionadded:: 18
+
+
+``OCP\OCM\Events\ResourceTypeRegisterEvent``
+********************************************
+
+.. versionadded:: 28
+
+Use this event to register additional OCM resources before the API returns
+them in the OCM provider list and capability
+
+``OCP\TextProcessing\Events\TaskFailedEvent``
+*********************************************
+
+.. versionadded:: 27.1
+
+
+``OCP\TextProcessing\Events\TaskSuccessfulEvent``
+*************************************************
+
+.. versionadded:: 27.1
+
--- a/developer_manual/basics/events.rst
+++ b/developer_manual/basics/events.rst
@@ -314,13 +314,6 @@ This event is triggered during the setup of the SabreDAV server to allow the reg

 This event is triggered during the setup of the SabreDAV server to allow the registration of additional authentication backends.

-``\OCP\BeforeSabrePubliclyLoadedEvent``
-***************************************
-
-.. versionadded:: 26
-
-This event is triggered when accessing public webdav endpoints.
-
 ``\OCA\DAV\Events\SubscriptionCreatedEvent``
 ********************************************

@@ -398,443 +391,7 @@ This event is triggered right after the LDAP user backend is registered.

 This event is triggered whenever the viewer is loaded and extensions should be loaded.

-``\OCP\Accounts\UserUpdatedEvent``
-**********************************
-
-.. versionadded:: 28
-
-This event is triggered when the account data of a user was updated.
-
-``\OCP\App\Events\AppEnableEvent``
-**********************************
-
-.. versionadded:: 27
-
-This event is triggered when an app is enabled.
-
-``\OCP\App\Events\AppUpdateEvent``
-**********************************
-
-.. versionadded:: 27
-
-This event is triggered when an app is updated.
-
-``\OCP\App\Events\AppDisableEvent``
-***********************************
-
-.. versionadded:: 27
-
-This event is triggered when an app is disabled.
-
-``\OCP\AppFramework\Http\Events\BeforeTemplateRenderedEvent``
-*************************************************************
-
-.. versionadded:: 20
-
-Emitted before the rendering step of each TemplateResponse. The event holds a flag that specifies if a user is logged in.
-
-``\OCP\Authentication\Events\LoginFailedEvent``
-***********************************************
-
-.. versionadded:: 19
-
-Emitted when the authentication fails, but only if the login name can be associated with an existing user.
-
-``\OCP\Authentication\TwoFactorAuth\TwoFactorProviderChallengeFailed``
-**********************************************************************
-
-.. versionadded:: 28
-
-``\OCP\Authentication\TwoFactorAuth\TwoFactorProviderChallengePassed``
-**********************************************************************
-
-.. versionadded:: 28
-
-``\OCP\Authentication\TwoFactorAuth\TwoFactorProviderForUserRegistered``
-************************************************************************
-
-.. versionadded:: 28
-
-``\OCP\Authentication\TwoFactorAuth\TwoFactorProviderForUserUnregistered``
-**************************************************************************
-
-.. versionadded:: 28
-
-``\OCP\Authentication\TwoFactorAuth\TwoFactorProviderUserDeleted``
-******************************************************************
-
-.. versionadded:: 28
-
-``\OCP\Authentication\TwoFactorAuth\TwoFactorProviderDisabled``
-***************************************************************
-
-.. versionadded:: 20
-
-``\OCP\Collaboration\Reference\RenderReferenceEvent``
-*****************************************************
-
-.. versionadded:: 25
-
-Event emitted when apps might render references like link previews or smart picker widgets.
-
-This can be used to inject scripts for extending that. Further details can be found in the
-:ref:`Reference providers` deep dive.
-
-``\OCP\Comments\CommentsEntityEvent``
-*************************************
-
-.. versionadded:: 28
-
-``\OCP\Contacts\Events\ContactInteractedWithEvent``
-***************************************************
-
-.. versionadded:: 19
-
-Event emitted by apps whenever there was an interaction with another user or contact.
-
-It is an event that allows apps to notify other components about an interaction between two users. This can be used to build better recommendations and suggestions in user interfaces.
-
-Emitters should add at least one identifier (uid, email, federated cloud ID) of the recipient of the interaction.
-
-``\OCP\DB\Events\AddMissingColumnsEvent``
-*****************************************
-
-.. versionadded:: 28
-
-Event to allow apps to register information about missing database columns
-
-This event will be dispatched for checking on the admin settings and when running
-``occ db:add-missing-columns`` which will then create those columns or can be used
-to generate the SQL statements for manual execution.
-
-``\OCP\DB\Events\AddMissingIndicesEvent``
-*****************************************
-
-.. versionadded:: 28
-
-Event to allow apps to register information about missing database indices
-
-This event will be dispatched for checking on the admin settings and when running
-``occ db:add-missing-indices`` which will then create those indices or can be used
-to generate the SQL statements for manual execution.
-
-``\OCP\DB\Events\AddMissingPrimaryKeyEvent``
-********************************************
-
-.. versionadded:: 28
-
-Event to allow apps to register information about missing database primary keys
-
-This event will be dispatched for checking on the admin settings and when running
-``occ db:add-missing-primary-keys`` which will then create those indices or can be used
-to generate the SQL statements for manual execution.
-
-``\OCP\DirectEditing\RegisterDirectEditorEvent``
-************************************************
-
-.. versionadded:: 18
-
-Event to allow to register the direct editor.
-
-``\OCP\Files\Events\BeforeFileScannedEvent``
-********************************************
-
-.. versionadded:: 18
-
-``\OCP\Files\Events\BeforeFolderScannedEvent``
-**********************************************
-
-.. versionadded:: 18
-
-``\OCP\Files\Events\FileCacheUpdated``
-**************************************
-
-.. versionadded:: 18
-
-``\OCP\Files\Events\FileScannedEvent``
-**************************************
-
-.. versionadded:: 18
-
-``\OCP\Files\Events\FolderScannedEvent``
-****************************************
-
-.. versionadded:: 18
-
-``\OCP\Files\Events\NodeAddedToCache``
-**************************************
-
-.. versionadded:: 18
-
-``\OCP\Files\Events\NodeAddedToFavorite``
-*****************************************
-
-.. versionadded:: 28
-
-``\OCP\Files\Events\NodeRemovedFromCache``
-******************************************
-
-.. versionadded:: 18
-
-``\OCP\Files\Events\NodeRemovedFromFavorite``
-*********************************************
-
-.. versionadded:: 28
-
-``\OCP\Group\Events\BeforeGroupCreatedEvent``
-*********************************************
-
-.. versionadded:: 18
-
-``\OCP\Group\Events\BeforeGroupDeletedEvent``
-*********************************************
-
-.. versionadded:: 18
-
-``\OCP\Group\Events\BeforeUserAddedEvent``
-******************************************
-
-.. versionadded:: 18
-
-``\OCP\Group\Events\BeforeUserRemovedEvent``
-********************************************
-
-.. versionadded:: 18
-
-Deprecated in 20.0.0 - it can't be guaranteed that this event is triggered in all case (e.g. for LDAP users this isn't possible)
-
-``\OCP\Group\Events\GroupCreatedEvent``
-***************************************
-
-.. versionadded:: 26
-
-``\OCP\Group\Events\GroupChangedEvent``
-***************************************
-
-.. versionadded:: 18
-
-``\OCP\Group\Events\GroupDeletedEvent``
-***************************************
-
-.. versionadded:: 18
-
-``\OCP\Group\Events\SubAdminAddedEvent``
-****************************************
-
-.. versionadded:: 21
-
-``\OCP\Group\Events\SubAdminRemovedEvent``
-******************************************
-
-.. versionadded:: 21
-
-``\OCP\Group\Events\UserAddedEvent``
-************************************
-
-.. versionadded:: 18
-
-``\OCP\Group\Events\UserRemovedEvent``
-**************************************
-
-.. versionadded:: 18
-
-``\OCP\Mail\Events\BeforeMessageSent``
-**************************************
-
-.. versionadded:: 19
-
-Emitted before a system mail is sent. It can be used to alter the message.
-
-``\OCP\Preview\BeforePreviewFetchedEvent``
-******************************************
-
-.. versionadded:: 26
-
-Emitted before a file preview is being fetched. It can be used to block preview rendering by throwing a ``OCP\Files\NotFoundException``.
-
-``\OCP\Security\CSP\AddContentSecurityPolicyEvent``
-***************************************************
-
-.. versionadded:: 17
-
-Allows to inject something into the default content policy. This is for example useful when you're injecting Javascript code into a view belonging to another controller and cannot modify its Content-Security-Policy itself. Note that the adjustment is only applied to applications that use AppFramework controllers.
-
-WARNING: Using this API incorrectly may make the instance more insecure. Do think twice before adding whitelisting resources. Please do also note that it is not possible to use the `disallowXYZ` functions.
-
-``\OCP\Security\Events\GenerateSecurePasswordEvent``
-****************************************************
-
-.. versionadded:: 18
-
-``\OCP\Security\Events\ValidatePasswordPolicyEvent``
-****************************************************
-
-.. versionadded:: 18
-
-``\OCP\Security\FeaturePolicy\AddFeaturePolicyEvent``
-*****************************************************
-
-.. versionadded:: 17
-
-Event that allows to register a feature policy header to a request.
-
-``\OCP\Share\Events\BeforeShareCreatedEvent``
-*********************************************
-
-.. versionadded:: 28
-
-``\OCP\Share\Events\BeforeShareDeletedEvent``
-*********************************************
-
-.. versionadded:: 28
-
-``\OCP\Share\Events\ShareAcceptedEvent``
-****************************************
-
-.. versionadded:: 28
-
-``\OCP\Share\Events\ShareCreatedEvent``
-***************************************
-
-.. versionadded:: 18
-
-``\OCP\Share\Events\ShareDeletedEvent``
-***************************************
-
-.. versionadded:: 21
-
-``\OCP\Share\Events\ShareDeletedFromSelfEvent``
-***********************************************
-
-.. versionadded:: 28
-
-``\OCP\Share\Events\VerifyMountPointEvent``
-*******************************************
-
-.. versionadded:: 19
-
-``\OCP\SystemTag\SystemTagsEntityEvent``
-****************************************
-
-.. versionadded:: 28
-
-``\OCP\User\Events\BeforeUserLoggedInWithCookieEvent``
-******************************************************
-
-.. versionadded:: 18
-
-Emitted before a user is logged in via remember-me cookies.
-
-``\OCP\User\Events\UserLoggedInWithCookieEvent``
-************************************************
-
-.. versionadded:: 18
-
-Emitted when a user has been successfully logged in via remember-me cookies.
-
-``\OCP\User\Events\BeforePasswordUpdatedEvent``
-***********************************************
-
-.. versionadded:: 18
-
-Emitted before the user password is updated.
-
-``\OCP\User\Events\PasswordUpdatedEvent``
-*****************************************
-
-.. versionadded:: 18
-
-Emitted when the user password has been updated.
-
-``\OCP\User\Events\BeforeUserCreatedEvent``
-*******************************************
-
-.. versionadded:: 18
-
-Emitted before a new user is created on the back-end.
-
-``\OCP\User\Events\UserCreatedEvent``
-*************************************
-
-.. versionadded:: 18
-
-Emitted when a new user has been created on the back-end.
-
-``\OCP\User\Events\BeforeUserDeletedEvent``
-*******************************************
-
-.. versionadded:: 18
-
-``\OCP\User\Events\UserDeletedEvent``
-*************************************
-
-.. versionadded:: 18
-
-``\OCP\User\Events\BeforeUserLoggedInEvent``
-********************************************
-
-.. versionadded:: 18
-
-``\OCP\User\Events\BeforeUserLoggedOutEvent``
-*********************************************
-
-.. versionadded:: 18
-
-Emitted before a user is logged out.
-
-``\OCP\User\Events\PostLoginEvent``
-***********************************
-
-.. versionadded:: 18
-
-``\OCP\User\Events\UserChangedEvent``
-*************************************
-
-.. versionadded:: 18
-
-``\OCP\User\Events\UserFirstTimeLoggedInEvent``
-***********************************************
-
-.. versionadded:: 28
-
-``\OCP\User\Events\UserLiveStatusEvent``
-****************************************
-
-.. versionadded:: 20
-
-``\OCP\User\Events\UserLoggedInEvent``
-**************************************
-
-.. versionadded:: 18
-
-``\OCP\User\Events\UserLoggedOutEvent``
-***************************************
-
-.. versionadded:: 18
-
-Emitted when a user has been logged out successfully.
-
-``\OCP\WorkflowEngine\LoadSettingsScriptsEvent``
-************************************************
-
-.. versionadded:: 20
-
-Emitted when the workflow engine settings page is loaded.
-
-``\OCP\WorkflowEngine\RegisterChecksEvent``
-*******************************************
-
-.. versionadded:: 18
-
-``\OCP\WorkflowEngine\RegisterEntitiesEvent``
-*********************************************
-
-.. versionadded:: 18
-
-``\OCP\WorkflowEngine\RegisterOperationsEvent``
-***********************************************
-
-.. versionadded:: 18
+.. include:: _available_events_ocp.rst

 Hooks
 -----