[DOCS] Updated documentation

Refs #1409

Author: derhansen

Documentation/ForDevelopers/CurrencyUtility/Index.rst

@@ -28,7 +28,7 @@ API
 
 .. php:class:: \DERHANSEN\SfEventMgt\Utility\CurrencyUtility
 
-   .. php:method:: getByIsoCode(string $isoCode): ?array
+   .. php:method:: getByIsoCode(string $isoCode)
 
       Returns the currency data array for the given ISO 4217 alphabetic code (case-insensitive),
       or :php:`null` if the code is not found.
@@ -40,11 +40,11 @@ API
       * :php:`name` — Human-readable currency name (e.g. :php:`'Euro'`)
       * :php:`symbol` — Currency symbol (e.g. :php:`'€'`)
 
-   .. php:method:: getBySymbol(string $symbol): ?array
+   .. php:method:: getBySymbol(string $symbol)
 
       Returns the first currency data array matching the given symbol, or :php:`null` if not found.
 
-   .. php:method:: getAllIsoCodes(): array
+   .. php:method:: getAllIsoCodes()
 
       Returns an array of all available ISO 4217 alphabetic codes.
 

Documentation/ForDevelopers/Index.rst

@@ -20,3 +20,4 @@ For Developers
    Extending/Index
    Events/Index
    Payment/Index
+   CurrencyUtility/Index

Documentation/ForDevelopers/Payment/Index.rst

@@ -101,44 +101,29 @@ to enable the actions in sf_event_mgt
 
 Please also refer to the :php:`PaymentController` in sf_event_mgt to see all available PSR-14 Events.
 
-In this example I create the class :php:`DERHANSEN\SfEventMgtMypaymentmethod\Payment\Mypaymentmethod` and add
-the following method.::
-
- /**
-  * Adds required HTML (for redirection) to the given values-array
-  *
-  * @param array $values
-  * @param bool $updateRegistration
-  * @param \DERHANSEN\SfEventMgt\Domain\Model\Registration $registration
-  * @param ActionController $pObj
-  * @return void
-  */
- public function renderRedirectView(&$values, &$updateRegistration, $registration, $pObj)
+In this example I create the class :php:`DERHANSEN\SfEventMgtMypaymentmethod\EventListener\MyPaymentRedirectResponse`
+and as following::
+
+ class MyPaymentRedirectResponse
  {
-     $pluginSettings = $this->getPluginSettings();
-
-     $view = GeneralUtility::makeInstance(StandaloneView::class);
-     $view->setFormat('html');
-     $view->setLayoutRootPaths($pluginSettings['view']['layoutRootPaths']);
-     $view->setPartialRootPaths($pluginSettings['view']['partialRootPaths']);
-     $view->setTemplateRootPaths($pluginSettings['view']['templateRootPaths']);
-
-     // @todo - e.g. call payment providers API to initialize payment
-     //
-     // Make sure to multiply the price with the given amount of depending registrations
-     //
-     // Depending on the payment provider you may receive a redirection URL or a token
-     // which can be passed to the standalone view.
-
-     $view->assignMultiple([
-         'settings' => $pluginSettings['settings'],
-     ]);
-     $values['html'] = $view->render();
+     #[AsEventListener('sf-event-mgt-mypaymentmethod/payment-redirect-response')]
+     public function __invoke(ModifyPaymentRedirectResponseEvent $processPaymentInitializeEvent): void
+     {
+         if ($processPaymentInitializeEvent->getRegistration()->getPaymentmethod() !== 'mypaymentmethod') {
+             return;
+         }
+
+         // @todo Initial payment provider and determine redirect URL
+         $redirectUrl = 'https://paymentprovider.tld/foo/bar'
+
+         $redirectResponse = new RedirectResponse($redirectUrl, 303);
+         $processPaymentInitializeEvent->setResponse($redirectResponse);
+     }
  }
 
-Replace the @todo section with your own code. The returned view should include some text
-and at least the link for the redirection. In order process automatic redirection, the
-view could include a JavaScript redirect to the payment providers payment page.
+The event listener shows how to use the PSR-14 event :php:`ModifyPaymentRedirectResponseEvent` to
+set a redirect response, which is handled by the extensions internal redirect process and redirects
+the user to the given redirect URL.
 
 5. Implement methods
 --------------------
@@ -165,10 +150,10 @@ using a HMAC, the cHash can manually be removed from generated URLs by implement
 the :php:`ProcessPaymentInitializeEvent` PSR-14 event.
 
 
-7. Security conciderations
+7. Security considerations
 --------------------------
 
-Make sure that your rendered Fluid standlone views do not contain sensitive data or possibilities
+Make sure that rendered Fluid views do not contain sensitive data or possibilities
 for Cross Site Scripting (XSS) (:php:`values['html']` is rendered with :php:`f:format.raw`).