.. This file is generated by nextcloud-ocp-events. .. Always change the source file. ``OCP\Accounts\UserUpdatedEvent`` ********************************* .. versionadded:: 28 This event is triggered when the account data of a user was updated. ``OCP\App\Events\AppDisableEvent`` ********************************** .. versionadded:: 27 This event is triggered when an app is disabled. ``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\ManagerEvent`` ************************ .. versionadded:: 9 Class ManagerEvent ``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\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\TwoFactorProviderChallengeFailed`` ********************************************************************* .. versionadded:: 28 ``OCP\Authentication\TwoFactorAuth\TwoFactorProviderChallengePassed`` ********************************************************************* .. versionadded:: 28 ``OCP\Authentication\TwoFactorAuth\TwoFactorProviderDisabled`` ************************************************************** .. versionadded:: 20 ``OCP\Authentication\TwoFactorAuth\TwoFactorProviderForUserDisabled`` ********************************************************************* .. versionadded:: 22 ``OCP\Authentication\TwoFactorAuth\TwoFactorProviderForUserEnabled`` ******************************************************************** .. versionadded:: 22 ``OCP\Authentication\TwoFactorAuth\TwoFactorProviderForUserRegistered`` *********************************************************************** .. versionadded:: 28 ``OCP\Authentication\TwoFactorAuth\TwoFactorProviderForUserUnregistered`` ************************************************************************* .. versionadded:: 28 ``OCP\Authentication\TwoFactorAuth\TwoFactorProviderUserDeleted`` ***************************************************************** .. versionadded:: 28 ``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\Calendar\Events\CalendarObjectCreatedEvent`` ************************************************** .. versionadded:: 32 ``OCP\Calendar\Events\CalendarObjectDeletedEvent`` ************************************************** .. versionadded:: 32 ``OCP\Calendar\Events\CalendarObjectMovedEvent`` ************************************************ .. versionadded:: 32 ``OCP\Calendar\Events\CalendarObjectMovedToTrashEvent`` ******************************************************* .. versionadded:: 32 ``OCP\Calendar\Events\CalendarObjectRestoredEvent`` *************************************************** .. versionadded:: 32 ``OCP\Calendar\Events\CalendarObjectUpdatedEvent`` ************************************************** .. versionadded:: 32 ``OCP\Collaboration\AutoComplete\AutoCompleteEvent`` **************************************************** .. versionadded:: 16 ``OCP\Collaboration\AutoComplete\AutoCompleteFilterEvent`` ********************************************************** .. versionadded:: 28 ``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\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\Comments\CommentsEntityEvent`` ************************************ .. versionadded:: 9.1 .. versionchanged:: 28.0.0 Dispatched as a typed event Class CommentsEntityEvent ``OCP\Comments\CommentsEvent`` ****************************** .. versionadded:: 9 Class CommentsEvent ``OCP\Config\BeforePreferenceDeletedEvent`` ******************************************* .. versionadded:: 25 ``OCP\Config\BeforePreferenceSetEvent`` *************************************** .. versionadded:: 25 ``OCP\Console\ConsoleEvent`` **************************** .. versionadded:: 9 Class ConsoleEvent ``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\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\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\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\DirectEditing\RegisterDirectEditorEvent`` *********************************************** .. versionadded:: 18 Event to allow to register the direct editor. ``OCP\EventDispatcher\GenericEvent`` ************************************ .. versionadded:: 18 Class GenericEvent convenience re-implementation of \Symfony\Component\GenericEvent against \OCP\EventDispatcher\Event ``OCP\Federation\Events\TrustedServerRemovedEvent`` *************************************************** .. versionadded:: 25 ``OCP\Files\Cache\AbstractCacheEvent`` ************************************** .. versionadded:: 22 ``OCP\Files\Cache\CacheEntryInsertedEvent`` ******************************************* .. versionadded:: 21 Event for when an existing entry in the cache gets inserted ``OCP\Files\Cache\CacheEntryRemovedEvent`` ****************************************** .. versionadded:: 21 Event for when an existing entry in the cache gets removed ``OCP\Files\Cache\CacheEntryUpdatedEvent`` ****************************************** .. versionadded:: 21 Event for when an existing entry in the cache gets updated ``OCP\Files\Cache\CacheInsertEvent`` ************************************ .. versionadded:: 16 Event for when a new entry gets added to the cache ``OCP\Files\Cache\CacheUpdateEvent`` ************************************ .. versionadded:: 16 Event for when an existing entry in the cache gets updated ``OCP\Files\Config\Event\UserMountAddedEvent`` ********************************************** .. versionadded:: 31 Event emitted when a user mount was added. ``OCP\Files\Config\Event\UserMountRemovedEvent`` ************************************************ .. versionadded:: 31 Event emitted when a user mount was removed. ``OCP\Files\Config\Event\UserMountUpdatedEvent`` ************************************************ .. versionadded:: 31 Event emitted when a user mount was moved. ``OCP\Files\Events\BeforeDirectFileDownloadEvent`` ************************************************** .. versionadded:: 25 This event is triggered when a user tries to download a file directly. ``OCP\Files\Events\BeforeFileScannedEvent`` ******************************************* .. versionadded:: 18 ``OCP\Files\Events\BeforeFileSystemSetupEvent`` *********************************************** .. versionadded:: 31 Event triggered before the file system is setup ``OCP\Files\Events\BeforeFolderScannedEvent`` ********************************************* .. versionadded:: 18 ``OCP\Files\Events\BeforeZipCreatedEvent`` ****************************************** .. versionadded:: 25 This event is triggered before a archive is created when a user requested downloading a folder or multiple files. By setting `successful` to false the tar creation can be aborted and the download denied. ``OCP\Files\Events\FileCacheUpdated`` ************************************* .. versionadded:: 18 ``OCP\Files\Events\FileScannedEvent`` ************************************* .. versionadded:: 18 ``OCP\Files\Events\FolderScannedEvent`` *************************************** .. 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\Node\BeforeNodeCopiedEvent`` *********************************************** .. versionadded:: 20 ``OCP\Files\Events\Node\BeforeNodeCreatedEvent`` ************************************************ .. versionadded:: 20 ``OCP\Files\Events\Node\BeforeNodeDeletedEvent`` ************************************************ .. versionadded:: 20 ``OCP\Files\Events\Node\BeforeNodeReadEvent`` ********************************************* .. versionadded:: 20 ``OCP\Files\Events\Node\BeforeNodeRenamedEvent`` ************************************************ .. versionadded:: 20 ``OCP\Files\Events\Node\BeforeNodeTouchedEvent`` ************************************************ .. versionadded:: 20 ``OCP\Files\Events\Node\BeforeNodeWrittenEvent`` ************************************************ .. versionadded:: 20 ``OCP\Files\Events\Node\FilesystemTornDownEvent`` ************************************************* .. versionadded:: 24 Event fired after the filesystem has been torn down ``OCP\Files\Events\Node\NodeCopiedEvent`` ***************************************** .. versionadded:: 20 ``OCP\Files\Events\Node\NodeCreatedEvent`` ****************************************** .. versionadded:: 20 ``OCP\Files\Events\Node\NodeDeletedEvent`` ****************************************** .. versionadded:: 20 ``OCP\Files\Events\Node\NodeRenamedEvent`` ****************************************** .. versionadded:: 20 ``OCP\Files\Events\Node\NodeTouchedEvent`` ****************************************** .. versionadded:: 20 ``OCP\Files\Events\Node\NodeWrittenEvent`` ****************************************** .. versionadded:: 20 ``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\Files\Template\BeforeGetTemplatesEvent`` ********************************************** .. versionadded:: 30 ``OCP\Files\Template\FileCreatedFromTemplateEvent`` *************************************************** .. versionadded:: 21 ``OCP\Files\Template\RegisterTemplateCreatorEvent`` *************************************************** .. versionadded:: 30 ``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\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\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\Group\Events\BeforeGroupChangedEvent`` ******************************************** .. versionadded:: 26 ``OCP\Group\Events\BeforeGroupCreatedEvent`` ******************************************** .. versionadded:: 18 ``OCP\Group\Events\BeforeGroupDeletedEvent`` ******************************************** .. versionadded:: 18 ``OCP\Group\Events\BeforeUserAddedEvent`` ***************************************** .. versionadded:: 18 ``OCP\Group\Events\BeforeUserRemovedEvent`` ******************************************* .. versionadded:: 18 ``OCP\Group\Events\GroupChangedEvent`` ************************************** .. versionadded:: 26 ``OCP\Group\Events\GroupCreatedEvent`` ************************************** .. 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\Log\Audit\CriticalActionPerformedEvent`` ********************************************** .. versionadded:: 22 Emitted when the admin_audit app should log an entry ``OCP\Log\BeforeMessageLoggedEvent`` ************************************ .. versionadded:: 28 Even for when a log item is being logged ``OCP\Mail\Events\BeforeMessageSent`` ************************************* .. versionadded:: 19 Emitted before a system mail is sent. It can be used to alter the message. ``OCP\Navigation\Events\LoadAdditionalEntriesEvent`` **************************************************** .. versionadded:: 31 ``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\Preview\BeforePreviewFetchedEvent`` ***************************************** .. versionadded:: 25.0.1 .. versionchanged:: 28.0.0 the constructor arguments ``$width``, ``$height``, ``$crop`` and ``$mode`` are no longer nullable. .. versionchanged:: 31.0.0 the constructor arguments ``$mimeType`` was added Emitted before a file preview is being fetched. It can be used to block preview rendering by throwing a ``OCP\Files\NotFoundException`` ``OCP\Profile\BeforeTemplateRenderedEvent`` ******************************************* .. versionadded:: 25 Emitted before the rendering step of the public profile page happens. ``OCP\SabrePluginEvent`` ************************ .. versionadded:: 8.2 ``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 Event to request a secure password to be generated. Since Nextcloud 31 this event also provides a ``getContext`` method allowing to apply different rules for different password context like account passwords or share passwords. ``OCP\Security\Events\ValidatePasswordPolicyEvent`` *************************************************** .. versionadded:: 18 This event can be emitted to request a validation of a password. If a password policy app is installed and the password is invalid, an `\OCP\HintException` will be thrown. Since Nextcloud 31 this event also provides a ``getContext`` method allowing to apply different rules for different password context like account passwords or share passwords. ``OCP\Security\FeaturePolicy\AddFeaturePolicyEvent`` **************************************************** .. versionadded:: 17 Event that allows to register a feature policy header to a request. ``OCP\Settings\Events\DeclarativeSettingsGetValueEvent`` ******************************************************** .. versionadded:: 29 ``OCP\Settings\Events\DeclarativeSettingsRegisterFormEvent`` ************************************************************ .. versionadded:: 29 ``OCP\Settings\Events\DeclarativeSettingsSetValueEvent`` ******************************************************** .. versionadded:: 29 ``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\SpeechToText\Events\TranscriptionFailedEvent`` **************************************************** .. versionadded:: 27 This Event is emitted if a transcription of a media file using a Speech-To-Text provider failed ``OCP\SpeechToText\Events\TranscriptionSuccessfulEvent`` ******************************************************** .. versionadded:: 27 This Event is emitted when a transcription of a media file happened successfully ``OCP\SystemTag\ManagerEvent`` ****************************** .. versionadded:: 9 Class ManagerEvent ``OCP\SystemTag\MapperEvent`` ***************************** .. versionadded:: 9 Class MapperEvent ``OCP\SystemTag\SystemTagsEntityEvent`` *************************************** .. versionadded:: 9.1 .. versionchanged:: 28.0.0 Dispatched as a typed event Class SystemTagsEntityEvent ``OCP\TaskProcessing\Events\GetTaskProcessingProvidersEvent`` ************************************************************* .. versionadded:: 32 Event dispatched by the server to collect Task Processing Providers and custom Task Types from listeners (like AppAPI). Listeners should add their providers and task types using the addProvider() and addTaskType() methods. ``OCP\TaskProcessing\Events\TaskFailedEvent`` ********************************************* .. versionadded:: 30 ``OCP\TaskProcessing\Events\TaskSuccessfulEvent`` ************************************************* .. versionadded:: 30 ``OCP\TextProcessing\Events\TaskFailedEvent`` ********************************************* .. versionadded:: 27.1 ``OCP\TextProcessing\Events\TaskSuccessfulEvent`` ************************************************* .. versionadded:: 27.1 ``OCP\TextToImage\Events\TaskFailedEvent`` ****************************************** .. versionadded:: 28 ``OCP\TextToImage\Events\TaskSuccessfulEvent`` ********************************************** .. versionadded:: 28 ``OCP\User\Events\BeforePasswordUpdatedEvent`` ********************************************** .. versionadded:: 18 Emitted before the user password is updated. ``OCP\User\Events\BeforeUserCreatedEvent`` ****************************************** .. versionadded:: 18 Emitted before a new user is created on the back-end. ``OCP\User\Events\BeforeUserDeletedEvent`` ****************************************** .. versionadded:: 18 ``OCP\User\Events\BeforeUserIdUnassignedEvent`` *********************************************** .. versionadded:: 31 Emitted before removing the mapping between an external user and an internal userid ``OCP\User\Events\BeforeUserLoggedInEvent`` ******************************************* .. versionadded:: 18 ``OCP\User\Events\BeforeUserLoggedInWithCookieEvent`` ***************************************************** .. versionadded:: 18 Emitted before a user is logged in via remember-me cookies. ``OCP\User\Events\BeforeUserLoggedOutEvent`` ******************************************** .. versionadded:: 18 Emitted before a user is logged out. ``OCP\User\Events\OutOfOfficeChangedEvent`` ******************************************* .. versionadded:: 28 Emitted when a user's out-of-office period has changed ``OCP\User\Events\OutOfOfficeClearedEvent`` ******************************************* .. versionadded:: 28 Emitted when a user's out-of-office period is cleared ``OCP\User\Events\OutOfOfficeEndedEvent`` ***************************************** .. versionadded:: 28 Emitted when a user's out-of-office period ended ``OCP\User\Events\OutOfOfficeScheduledEvent`` ********************************************* .. versionadded:: 28 Emitted when a user's out-of-office period is scheduled ``OCP\User\Events\OutOfOfficeStartedEvent`` ******************************************* .. versionadded:: 28 Emitted when a user's out-of-office period started ``OCP\User\Events\PasswordUpdatedEvent`` **************************************** .. versionadded:: 18 Emitted when the user password has been updated. ``OCP\User\Events\PostLoginEvent`` ********************************** .. versionadded:: 18 ``OCP\User\Events\UserChangedEvent`` ************************************ .. versionadded:: 18 ``OCP\User\Events\UserCreatedEvent`` ************************************ .. versionadded:: 18 Emitted when a new user has been created on the back-end. ``OCP\User\Events\UserDeletedEvent`` ************************************ .. versionadded:: 18 ``OCP\User\Events\UserFirstTimeLoggedInEvent`` ********************************************** .. versionadded:: 28 ``OCP\User\Events\UserIdAssignedEvent`` *************************************** .. versionadded:: 31 Emitted by backends (like user_ldap) when a user created externally is mapped for the first time and assigned a userid ``OCP\User\Events\UserIdUnassignedEvent`` ***************************************** .. versionadded:: 31 Emitted after removing the mapping between an external user and an internal userid ``OCP\User\Events\UserLiveStatusEvent`` *************************************** .. versionadded:: 20 ``OCP\User\Events\UserLoggedInEvent`` ************************************* .. versionadded:: 18 ``OCP\User\Events\UserLoggedInWithCookieEvent`` *********************************************** .. versionadded:: 18 Emitted when a user has been successfully logged in via remember-me cookies. ``OCP\User\Events\UserLoggedOutEvent`` ************************************** .. versionadded:: 18 Emitted when a user has been logged out successfully. ``OCP\User\GetQuotaEvent`` ************************** .. versionadded:: 20 Event to allow apps to ``OCP\WorkflowEngine\Events\LoadSettingsScriptsEvent`` ****************************************************** .. versionadded:: 20 Emitted when the workflow engine settings page is loaded. ``OCP\WorkflowEngine\Events\RegisterChecksEvent`` ************************************************* .. versionadded:: 18 ``OCP\WorkflowEngine\Events\RegisterEntitiesEvent`` *************************************************** .. versionadded:: 18 ``OCP\WorkflowEngine\Events\RegisterOperationsEvent`` ***************************************************** .. versionadded:: 18