Feature video validate event (#38)

* Set default limit for video validation to 0.

* Add ModifyVideoValidateEvent for custom validation actions

Introduced a new `ModifyVideoValidateEvent` to enable custom actions during video validation. Updated `VideoService` to dispatch this event and added documentation to guide developers on registering and handling the event.

* Remove change from other pull request

* Rename event class in README.md

---------

Co-authored-by: Kevin Meckl <kevin.meckl@zdrei.com>

Author: kevinmeckl

Classes/Event/ModifyVideoValidateEvent.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Ayacoo\VideoValidator\Event;
+
+use TYPO3\CMS\Core\Resource\FileInterface;
+
+final class ModifyVideoValidateEvent
+{
+    public function __construct(
+        private readonly ?FileInterface $file,
+        private readonly array $properties = [],
+    ) {
+    }
+
+    public function getFile(): ?FileInterface
+    {
+        return $this->file;
+    }
+
+    public function getProperties(): array
+    {
+        return $this->properties;
+    }
+}

Classes/Service/VideoService.php

@@ -7,6 +7,7 @@
 use Ayacoo\VideoValidator\Domain\Dto\ValidatorDemand;
 use Ayacoo\VideoValidator\Domain\Repository\FileRepository;
 use Ayacoo\VideoValidator\Event\ModifyValidatorEvent;
+use Ayacoo\VideoValidator\Event\ModifyVideoValidateEvent;
 use Ayacoo\VideoValidator\Service\Validator\AbstractVideoValidatorInterface;
 use Ayacoo\VideoValidator\Service\Validator\VimeoValidator;
 use Ayacoo\VideoValidator\Service\Validator\YoutubeValidator;
@@ -130,6 +131,11 @@ public function validate(ValidatorDemand $validatorDemand): void
                 );
 
                 $this->fileRepository->updatePropertiesByFile($video['uid'], $properties);
+
+                // You want a special action after validation? Have a look at the documentation!
+                $event = new ModifyVideoValidateEvent($file, $properties);
+                $this->eventDispatcher->dispatch($event);
+
                 $this->io->progressAdvance(1);
             }
             $this->io->progressFinish();

README.md

@@ -400,7 +400,46 @@ class YourReportService implements AbstractReportServiceInterface
 
 ```
 
-### 5.4 Email settings
+### 5.4 Register your custom validate action
+
+It is also possible to register your own actions during validation. For example,
+You can disable referenced content items.
+
+### EventListener registration
+
+```
+services:
+  Extension\Namespace\Listener\VideoValidateListener:
+    tags:
+      - name: event.listener
+        identifier: 'extensionkey/videovalidator'
+        event: Ayacoo\VideoValidator\Event\ModifyVideoValidateEvent
+```
+
+### EventListener
+
+```
+<?php
+declare(strict_types=1);
+
+namespace Extension\Namespace\Listener;
+
+use Ayacoo\VideoValidator\Event\ModifyVideoValidateEvent;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+
+class VideoValidateListener
+{
+    public function dispatch(ModifyVideoValidateEvent $event): void
+    {
+        $file = $event->getFile();
+        $properties = $event->getProperties();
+        // Do your custom stuff e.g. custom action
+    }
+}
+
+```
+
+### 5.5 Email settings
 
 To define a sender for the email, the
 configuration ```$GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromAddress']```