[TASK] Adds custom log processor example (#6248)

* [TASK] Adds custom log processor example

* Add example for extending AbstractProcessor class

Added an example section for extending the abstract processor class.

---------

Co-authored-by: Christian Reifenscheid <reifenscheid@clickstorm.de>
Co-authored-by: Lina Wolf <48202465+linawolf@users.noreply.github.com>

Author: 3 people

Documentation/ApiOverview/Logging/Processors/Index.rst

@@ -157,6 +157,11 @@ It is suggested to extend the abstract class
 :t3src:`core/Classes/Log/Processor/AbstractProcessor.php` which allows you use
 configuration options by adding the corresponding properties and setter methods.
 
+..  rubric:: Example
+
+..  literalinclude:: _MyProcessorWithOptions.php
+    :caption: EXT:my_extension/Classes/Log/Processor/MyProcessor.php
+
 Please keep in mind that TYPO3 will silently continue operating,
 in case a log processor is throwing an exception while executing
 the :php:`processLogRecord()` method.

Documentation/ApiOverview/Logging/Processors/_MyProcessorWithOptions.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace MyVendor\MyExtension\Log\Processor;
+
+use TYPO3\CMS\Core\Log\LogRecord;
+
+class MyProcessor extends \TYPO3\CMS\Core\Log\Processor\AbstractProcessor
+{
+    protected bool $option = true;
+
+    public function setOption(bool $option): void
+    {
+        $this->option = $option;
+    }
+
+    public function processLogRecord(LogRecord $logRecord): LogRecord
+    {
+        // add magic
+
+        return $logRecord;
+    }
+}