9. For programmers and developers

DieserThis Abschnittsection richtetis sichaimed anat Programmierer,programmers diewho want to influence this extension in eigenentheir Modulenown Einflussmodules. aufIn diesethe Erweiterungprogram nehmenflow, wollen.you Imcan Programmablauflink kannin manat sichvarious anpoints ver­schie­denenusing Stellena mittelsHOOK einerregistration. HOOK-RegistrierungThe einkoppeln. Die Erweiterungextension contao-pdfforms-bundle ruftcalls diethe registriertenregistered Hookshooks, auf,if sofernany welcheare vor­handen sind.available.

FolgendeThe Hooksfollowing sindhooks verfügbar:are available:

pdf_formsBeforePdf

WirdIs nachcalled derafter Datenaufbereitungdata aufgerufen,preparation bevorbefore dasthe PDF erstelltis wird.created. HierHere, könnenfurther inentries demcan übergebenenbe Arrayadded to the $arrPDF weiterearray Einträgeor hinzugefügtexisting oderentries vorhandenecan modifiziertbe werden.modified. DerThe Hookhook mussmust dasreturn the $arrPDF alsas Rückgabewertthe zurückgeben.return value.

Beispiel:Example:

// src/EventListener/Pdf_formsBeforePdfListener.php
<?php

namespace App\EventListener;

use Contao\CoreBundle\DependencyInjection\Attribute\AsHook;

#[AsHook('pdf_formsBeforePdf')]
class Pdf_formsBeforePdfListener
{
    public function __invoke(array $arrPDF)
    {
        // beliebigerany Codecode

        return $arrPDF;
    }
}

pdf_formsPositions

WirdIs beicalled derup PDF-Erstellung fürfor jedeeach Positionitem imin Formularthe aufgerufen.form Hierduring bestehtPDF diecreation. Möglichkeit,It nochis Datenstill zupossible manipulieren.to Diemani­pulate Seitennummerdata kannhere. nichtThe verändertpage werden,number dacannot andernfallsbe diechanged, Ausgabeotherwise nichtthe korrektoutput funktioniert.will Alsnot Rückgabewertwork wirdcorrectly. dasThe übergebenepassed undand ggf.possibly modifiziertemodified Arrayarray $arrItem erwartet.is expected as the return value.

Beispiel:Example:

// src/EventListener/Pdf_formsPositionsListener.php
<?php

namespace App\EventListener;

use Contao\CoreBundle\DependencyInjection\Attribute\AsHook;

#[AsHook('pdf_formsPositions')]
class Pdf_formsPositionsListener
{
    public function __invoke(array $arrItem)
    {
        // beliebigerany Codecode
 
        return $arrItem;
    }
}

pdf_formsAfterPdf

WirdIs nachcalled derup Erzeugung,after Speicherungcreation, undsaving derand Übergabetransfer anto dieform Formular­ver­arbeitungprocessing. aufgerufen.Further Hierfinal könnenactivities weiterecan abschließendebe Aktivitäteninserted perhere Hookusing eingefügta werden.hook. DerThe Hookhook hathas keinenno Rückgabewert.return value.

Beispiel:Example:

// src/EventListener/Pdf_formsAfterPdfListener.php
<?php

namespace App\EventListener;

use Contao\CoreBundle\DependencyInjection\Attribute\AsHook;

#[AsHook('pdf_formsAfterPdf')]
class Pdf_formsAfterPdfListener
{
    public function __invoke(string $pdfdatei, array $arrPDF): void
    {
        // beliebigerany Codecode
    }
}