phpBB Template Events

Mit Template Events lässt sich eigener HTML Code in das Template von phpBB einfügen. So ist es möglich das eine Extension das Template erweitert ohne das dazu Änderungen an der original Template Datei gemacht werden müssen. In phpBB gibt es mehrere Stellen für die man ein Event erstellen kann, eine vollständige Liste aller Stellen gibt es im phpBB Wiki.

Template Event erstellen

Um ein Template Event für seine Extension zu erstellen sucht man sich aus der Liste der Template Events zu erst das passende Event für die Stelle an der man seinen HTML Code ausgeben möchte. Nun legt man im Ordner seiner Extension einen Ordner mit dem Namen styles an, darin legt man einen weiteren Ordner mit dem Namen des Templates das man erweitern möchte (z.B. prosilver) an. Wenn man HTML Code in allen installierten Templates ausgeben möchte kann man den Ordner auch all nennen. Allerdings sollte man dort nur Code ausgeben der auch wirklich in allen Templates funktioniert, also z.B. JavaScripts. In diesen Ordner legt man nun einen weiteren Ordner mit dem Namen template und dort rein nochmal einen Ordner mit dem Name event. In diesen Ordner legt man nun HTML Dateien die den Namen des jeweiligen Events das man verwenden möchte haben. Wenn man z.B. im Header und im Footer des Style prosilver etwas ausgeben möchte würde die Ordner und Dateistruktur folgendermaßen aussehen:

- ROOT PFAD DEINER EXTENSION
  - styles
    - prosilver
      - template
       - event
        - overall_header_content_before.html
        - overall_footer_content_after.html

Hier werden also die Events overall_header_content_before und overall_footer_content_after verwendet. Die HTML Dateien kann man jetzt mit seinem HTML Code befüllen der an den entsprechenden Stelen ausgegeben werden soll. In den Template Dateien kann man wie im normalen Template auch Template-Variablen oder Sprach-Variablen verwenden.