[FEATURE] Dispatch event after BE user's password reset (#5108)

* [FEATURE] Dispatch event after BE user's password reset

Resolves: TYPO3-Documentation/Changelog-To-Doc#1166
Releases: main

* Apply suggestions from code review

Co-authored-by: Stefan Frömken <froemken@gmail.com>

---------

Co-authored-by: Stefan Frömken <froemken@gmail.com>

Documentation/ApiOverview/Events/Events/Backend/PasswordHasBeenResetEvent.rst

@@ -0,0 +1,34 @@
+..  include:: /Includes.rst.txt
+..  index:: Events; PasswordHasBeenResetEvent
+..  _PasswordHasBeenResetEvent:
+
+=========================
+PasswordHasBeenResetEvent
+=========================
+
+..  versionadded:: 14.0
+    It is possible to add custom business logic after a Backend user resets their
+    password using the new PSR-14 event.
+
+The event :php-short:`\TYPO3\CMS\Backend\Authentication\Event\PasswordHasBeenResetEvent`
+is raised right after a backend user resets their password
+and it has been hashed and persisted to the database.
+
+The event contains the corresponding backend user UID.
+
+..  _PasswordHasBeenResetEvent-example:
+
+Example
+=======
+
+The corresponding event listener class:
+
+..  literalinclude:: _PasswordHasBeenResetEvent/_MyEventListener.php
+    :caption: EXT:my_extension/Classes/Backend/EventListener/MyEventListener.php
+
+..  _PasswordHasBeenResetEvent-api:
+
+API
+===
+
+..  include:: /CodeSnippets/Events/Backend/PasswordHasBeenResetEvent.rst.txt

Documentation/ApiOverview/Events/Events/Backend/_PasswordHasBeenResetEvent/_MyEventListener.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Vendor\MyPackage\Backend\EventListener;
+
+use TYPO3\CMS\Backend\Authentication\Event\PasswordHasBeenResetEvent;
+use TYPO3\CMS\Core\Attribute\AsEventListener;
+
+final class PasswordHasBeenResetEventListener
+{
+    #[AsEventListener('my-package/backend/password-has-been-reset')]
+    public function __invoke(PasswordHasBeenResetEvent $event): void
+    {
+        $userUid = $event->userId;
+        // Do something with the be_user UID
+    }
+}

Documentation/CodeSnippets/Config/Api/Events/EventsBackend.php

@@ -273,4 +273,10 @@
         'targetFileName' => 'CodeSnippets/Events/Backend/AfterRawPageRowPreparedEvent.rst.txt',
         'withCode' => false,
     ],
+    [
+        'action' => 'createPhpClassDocs',
+        'class' => \TYPO3\CMS\Backend\Authentication\Event\PasswordHasBeenResetEvent::class,
+        'targetFileName' => 'CodeSnippets/Events/Backend/PasswordHasBeenResetEvent.rst.txt',
+        'withCode' => false,
+    ],
 ];

Documentation/CodeSnippets/Events/Backend/PasswordHasBeenResetEvent.rst.txt

@@ -0,0 +1,8 @@
+..  Generated by https://github.com/TYPO3-Documentation/t3docs-codesnippets
+..  php:namespace::  TYPO3\CMS\Backend\Authentication\Event
+
+..  php:class:: PasswordHasBeenResetEvent
+
+    ..  php:attr:: userId
+        :readonly:
+        :public: