phpBB Forum in Typo3 integrieren

Ich gehe hier davon aus, dass euer phpBB-Forum in einem extra Ordner namens “forum” liegt. Soll heißen in eurem Root-Ordner von Typo3 liegt der Ordner “forum”. Dieser ist Root-Ordner des phpBB-Forums.
Nun soll das Forum, sprich Login und Menü in die Homepage (Typo3) integriert werden. Wie macht man das nun? Eigentlich ist es gar nicht schwer, wenn man die folgenden Schritte durchführt. Ihr werdet sehen, ihr könnt so beides parallel laufen lassen und z.B. als eingeloggter User im phpBB-Forum das Menü vom Forum in Typo3 nutzen. So kann man dann eine Seite aus dem Typo3-Menü ansehen, bleibt aber dennoch im Forum eingeloggt. Kehrt man also wieder über das Menü zum Forum zurück, muss man sich nicht neu anmelden.
Und wie funktionert das? Über die Session! Im folgenden zeige ich euch, wie ihr dies realisieren könnt. Zunächst möchte ich aber noch die Frage klären “Wozu der ganze Aufwand?”… Na ja, in erster Linie bietet es sich dann an, wenn das phpBB-Forum und die Typo3-Homepage identisch aussehen und so quasi als eine gemeinsame Internetseite dargestellt werden sollen. Dem User fällt dann quasi gar nicht auf, dass hier im Hintergrund eigentlich zwei ganz verschiedene Systeme arbeiten.

Nun aber zur Integration von phpBB in Typo3

Zuerst legen wir im fileadmin von Typo3 ein neues php-Script an. In meinem Beispiel liegt dieses in einem extra im fileadmin angelegten Ordner phpscripts, also der Pdaf zum php-Script lautet somit “/fileadmin/phpscripts/forum_login.php”. Zusätzlich zum Script forum_login.php benötigen wir noch das Script forum_menu.php. Wie die Namen schon schließen lassen, ist hier ein Script für das Integrieren des phpBB Menüs und ein Script zum Integrieren des phpBB Logins.
Werfen wir nun einen Blick in die beiden Scripts. Zunächst die Datei forum_menu.php, die  im weiteren Verlauf genauer erklärt wird:

<?php
global $board_config;
global $HTTP_COOKIE_VARS, $HTTP_GET_VARS, $SID;
global $db, $user, $cache, $phpEx, $method, $config, $phpbb_root_path;
$active_group = "forum";

define('IN_PHPBB', true);
define('PHPBB_ROOT_PATH', $_SERVER['DOCUMENT_ROOT']."/forum/");
$phpbb_root_path = (defined('PHPBB_ROOT_PATH')) ? PHPBB_ROOT_PATH : './';
$phpEx = substr(strrchr(__FILE__, '.'), 1);

include($phpbb_root_path . 'common.' . $phpEx);

// Start session management
$user->session_begin();
$auth->acl($user->data);

if ($user->data['user_id'] != ANONYMOUS) {
?>
        <ul class="navmenu_forum">
          <li>
          <div class="menutop menutop-closed">
              <a href="./forum">Forum</a>
              <div class="toggle toggle-closed">+</div>
            </div>
            <ul class="submenu">          
              <li><a href="./forum/faq.php" title="Häufig gestellte Fragen">FAQ</a></li>
              <li><a href="./forum/memberlist.php" title="Zeigt eine vollständige Liste aller Mitglieder an">Mitglieder</a></li>
              <li><a href="./forum/search.php?search_id=unanswered">Unbeantwortete Themen</a></li>
              <li><a href="./forum/search.php?search_id=unreadposts">Ungelesene Beiträge</a></li>
              <li><a href="./forum/search.php?search_id=newposts">Neue Beiträge</a></li>
              <li><a href="./forum/search.php?search_id=active_topics">Aktive Themen</a></li>
            </ul>
          </li>  
        </ul>
<?php
} else {
?>
        <ul class="navmenu_forum">
          <li>
          <div class="menutop menutop-closed">
              <a href="./forum">Forum</a>
              <div class="toggle toggle-closed">+</div>
            </div>
            <ul class="submenu">          
              <li><a href="./forum/faq.php" title="Häufig gestellte Fragen">FAQ</a></li>
            </ul>
          </li>  
        </ul>
<?php } ?>

Jetzt schauen wir uns noch die Datei forum_login.php an, auch diese wird im weiteren Verlauf des Beitrags erklärt:

<?php
// Start session management
$user->session_begin();
$auth->acl($user->data);

if ($user->data['user_id'] == ANONYMOUS) {
?>
  <form method="post" action="./forum/ucp.php?mode=login" class="loginform">
    <p><strong>Login</strong></p>
    <div>
      <label for="username">Benutzername</label>
      <input type="text" name="username" id="email" class="loginfield" />
      <label for="password">Passwort</label>
      <input type="password" name="password" id="password" class="loginfield" />
      <input type="submit" name="login" value="Login" class="loginbutton" />
    </div>
  </form>
<?php
} else {
  echo '<a href="./forum/ucp.php?mode=logout&amp;amp;sid='.$user->data["session_id"].'" title="Abmelden [ '.$user->data["username"].' ]" accesskey="x">Abmelden [ '.$user->data["username"].' ]</a>';
?>                
  <br /><hr class="toolbox_seperator_loggedin">

  <form action="./forum/search.php" method="post" id="search" class="searchform">
    <div>
      <input name="keywords" id="keywords" type="text" maxlength="128" title="Suche nach Wörtern" class="inputbox search" value="Foren-Suche…" onclick="if(this.value=='Suche…')this.value='';" onblur="if(this.value=='')this.value='Suche…';" />
      <input class="button2" value="Suche" type="submit" /><br />
    </div>
  </form>
  <a href="./forum/search.php" title="Zeigt die erweiterten Suchoptionen an">Erweiterte Suche</a> 

  <br /><hr class="toolbox_seperator_loggedin">

  <a href="./forum/ucp.php" title="Persönlicher Bereich" accesskey="e">Persönlicher Bereich</a>          
  <a href="./forum/search.php?search_id=egosearch">Eigene Beiträge</a>    
<?php } ?>

Die Datei forum_menu.php im Detail

Schauen wir uns die Datei forum_menu.php einmal im Detail an. Hierzu nehme ich immer einen gewissen Abschnitt aus dem Script und erkläre euch diesen dann detailliert, damit ihr auch wisst, was genau hier geschieht.

<?php
global $board_config;
global $HTTP_COOKIE_VARS, $HTTP_GET_VARS, $SID;
global $db, $user, $cache, $phpEx, $method, $config, $phpbb_root_path;
$active_group = "forum";

define('IN_PHPBB', true);
define('PHPBB_ROOT_PATH', $_SERVER['DOCUMENT_ROOT']."/forum/");
$phpbb_root_path = (defined('PHPBB_ROOT_PATH')) ? PHPBB_ROOT_PATH : './';
$phpEx = substr(strrchr(__FILE__, '.'), 1);

include($phpbb_root_path . 'common.' . $phpEx);

Dies ist wohl der wichtigste Teil der Datei. Hierzu muss zunächst angemerkt werden, dass dieser Abschnitt des Scripts entweder in der forum_menu.php oder der forum_login.php eingebunden werden kann. Wichtig ist, dass dieser Abschnitt in der Datei eingebunden wird, die zuerst geladen wird. In meinem Beispiel ist dies nun einmal das Menü, also die forum_menu.php.
Nun aber zur Erklärung. Wie man sieht werden zunächst alle benötigten globalen Variablen des phpBB-Forums gesetzt. Diese sind unabdingbar, damit im nächsten Schritt die benötigte Datei common.php und deren inkludierte Scripts inkludiert werden können. Zuvor wird natürlich noch der ROOT_PATH des Forums gesetzt. Wie man sieht befindet sich das Forum in einem extra Ordner namens “forum”, der auf der gleichen Ebene des Ordners “fileadmin” liegt. Und genau hier kommt es darauf an, dass der Pfad korrekt gesetzt ist, sonst scheitert das gesamte Projekt bereits an dieser Stelle.
Habt ihr also die gleiche Ordnerstruktur wie ich, könnt ihr den obigen Code eins zu eins kopieren und in euer Script einfügen.

// Start session management
$user->session_begin();
$auth->acl($user->data);

Eigentlich recht selbsterklärend… An dieser Stelle wird die Session gestartet und das für die Authentifizierung benötigte Objekt aus der Session geladen.

if ($user->data['user_id'] != ANONYMOUS) {
?>
        <ul>
          <li>
          <div>
              <a href="./forum">Forum</a>
              <div>+</div>
            </div>
            <ul>          
              <li><a href="./forum/faq.php" title="Häufig gestellte Fragen">FAQ</a></li>
              <li><a href="./forum/memberlist.php" title="Zeigt eine vollständige Liste aller Mitglieder an">Mitglieder</a></li>
              <li><a href="./forum/search.php?search_id=unanswered">Unbeantwortete Themen</a></li>
              <li><a href="./forum/search.php?search_id=unreadposts">Ungelesene Beiträge</a></li>
              <li><a href="./forum/search.php?search_id=newposts">Neue Beiträge</a></li>
              <li><a href="./forum/search.php?search_id=active_topics">Aktive Themen</a></li>
            </ul>
          </li>  
        </ul>

Nun wird festgelegt, was im Menü auftauchen soll, wenn der Benutzer noch auf der eigentlichen Typo3 Homepage, aber im Forum eingeloggt ist. Die Abfrage ob der User eingeloggt ist, erfolgt durch if ($user->data['user_id'] != ANONYMOUS). Ihr seht schon den Aufbau des Menüs via HTML. Hier handelt es sich natürlich um ein Beispiel, das bedeutet ihr müsst an dieser Stelle die entsprechenden DIVs oder Listenelemente so setzen, wie ihr diese benötigt bzw. wie diese auch im eigentlichen Menü eurer Homepage, also in Typo3 aufgebaut sind. Ihr könnt zudem natürlich frei wählen, welche Menüpunkte angezeigt werden sollen. Hierzu setzt ihr einfach die entsprechenden Links, die ihr dem Menü aus dem phpBB-Forum entnehmen könnt. Ich habe in diesem Beispiel einfach den Quelltext des phpBB-Forums in eingeloggtem Zustand anzeigen lassen und habe mir rausgeschrieben, auf welche php die einzelnen Menüpunkte verweisen bzw. welche Parameter benötigt werden. So z.B. für die Anzeige der aktiven Themen:

              <li><a href="./forum/search.php?search_id=active_topics">Aktive Themen</a></li>

Im nächsten Schritt geht es darum festzulegen, was angezeigt werden soll, wenn der User nicht eingeloggt ist. In meinem Beispiel wird einfach der Menüpunkt “Forum” und als Untermenüpunkt “FAQ” angezeigt. Auch hier könnt ihr selbstverständlich frei wählen. Beachtet aber, dass gewisse Funktionen, wie z.B. die Menüpunkte bei eingeloggtem Zustand unter Umständen hier nicht funktionieren. Dies hängt natürlich immer davon ab, wie öffentlich euer Forum ist bzw. was nicht eingeloggte User angezeigt bekommen. Das sind Einstellungen, die ich hier nicht aufgreifen werde, da dies den Rahmen des Beitrags sprengen würde. Schließlich werden diese Einstellungen alle im Administrations-Bereich des phpBB-Forums vorgenommen.
Im folgenden seht ihr also mein Menü, bei nicht eingeloggtem Zustand:

<?php
} else {
?>
        <ul>
          <li>
          <div>
              <a href="./forum">Forum</a>
              <div>+</div>
            </div>
            <ul>          
              <li><a href="./forum/faq.php" title="Häufig gestellte Fragen">FAQ</a></li>
            </ul>
          </li>  
        </ul>
<?php } ?>

Die Datei forum_login.php im Detail

Jetzt wird es Zeit die Datei für das Einbinden des Logins / Logouts des phpBB-Forums in Typo3 genauer unter die Lupe zu nehmen. Wie bereits erwähnt müssen an dieser Stelle keine Variablen, Klassen, etc. mehr eingebunden werden um die Session zu starten und auszulesen, da die Session bereits durch die forum_menu.php zur Verfügung.

<?php
// Start session management
$user->session_begin();
$auth->acl($user->data);

if ($user->data['user_id'] == ANONYMOUS) {
?>
  <form method="post" action="./forum/ucp.php?mode=login">
    <p><strong>Login</strong></p>
    <div>
      <label for="username">Benutzername</label>
      <input type="text" name="username" id="email" />
      <label for="password">Passwort</label>
      <input type="password" name="password" id="password" />
      <input type="submit" name="login" value="Login" />
    </div>
  </form>

Wir können also nun ganz einfach, wie man im Code sieht die Session starten und wieder unser benötigtes Objekt auslesen. Im folgenden wird dann abgefragt ob der User eingeloggt ist bzw. wenn er nicht eingeloggt ist, dann soll das Login-Formular angezeigt werden. Hier ist es selbstverständlich wichtig, dass dieses exakt die in diesem Code enthaltenen input-Elemente und die angegebene Action enthält. Der genaue Aufbau bzw. die Labels sind natürlich euch selbst überlassen und sollten an eure Typo3-Homepage angepasst werden. Bei der Action ist es natürlich, genau wie bei allen Links, die ihr im Menü eingefügt habt wichtig, dass der Pfad korrekt angegeben wird. Ich weise an dieser Stelle nochmals darauf hin, dass bei mir das Forum bzw. dessen ROOT_PATH im Ordner “forum” (auf der gleichen Ebene wie der Ordner “fileadmin”) liegt.

Im nächsten Abschnitt wird dann bestimmt, was angezeigt werden soll, wenn der Benutzer eingeloggt ist. Bei mir ist dies der Benutzername mit dem Link zum Abmelden, das Suchfeld für das Forum, der Link zum persönlichen Bereich, sowie der Link zur erweiterten Suche. Der Aufbau ist auch wieder euch überlassen, simples HTML halt.

<?php
} else {
  echo '<a href="./forum/ucp.php?mode=logout&amp;amp;sid='.$user->data["session_id"].'" title="Abmelden [ '.$user->data["username"].' ]" accesskey="x">Abmelden [ '.$user->data["username"].' ]</a>';
?>                
  <br /><hr>

  <form action="./forum/search.php" method="post" id="search">
    <div>
      <input name="keywords" id="keywords" type="text" maxlength="128" title="Suche nach Wörtern" value="Foren-Suche…" onclick="if(this.value=='Suche…')this.value='';" onblur="if(this.value=='')this.value='Suche…';" />
      <input value="Suche" type="submit" /><br />
    </div>
  </form>
  <a href="./forum/search.php" title="Zeigt die erweiterten Suchoptionen an">Erweiterte Suche</a> 

  <br /><hr>

  <a href="./forum/ucp.php" title="Persönlicher Bereich" accesskey="e">Persönlicher Bereich</a>          
  <a href="./forum/search.php?search_id=egosearch">Eigene Beiträge</a>    
<?php } ?>

So, ich hoffe, ich konnte euch die zwei benötigten Dateien gut erklären. Bevor wir mit der eigentlichen Einbindung in euer Typo3 weitermachen, möchte ich die Gelegenheit nutzen, euch noch einen kleinen Tipp zu geben:

Wenn Ihr die beiden Dateien erstellt und festlegt, was dem Benutzer beim eingeloggten und was beim nicht eingeloggten Zustand angezeigt werden soll, dann haltet euch an euer phpBB-Forum. Das bedeutet, dass der User möglichst die gleichen Sachen angezeigt bzw. nicht angezeigt bekommen sollte. So ensteht für die Besucher der Homepage der Eindruck, dass das Forum und die Homepage ein System sind. Der Benutzer loggt sich so z.B. über den Login, der im Typo3 integriert ist ein und wechselt dann im eingeloggten Zustand auf die Foren-Übersicht. Wir wissen, dass dies zwei Systeme sind und eigentlich auch zwei unabhängige “Seiten”. Der Benutzer bekommt jedoch immer noch das gleiche Layout und die gleichen Menüpunkte und Links angezeigt und merkt somit nicht, dass es zwei “Seiten” sind.

Wie binde ich nun die Dateien in Typo3 ein?

Zunächst begeben wir uns einmal in unser Fluid Template der Typo3-Installation. In Meinem Beispiel habe ich diese Datei ganz einfach layout.html genannt. Bei mir sind hier die folgenden Zeilen wichtig:

<f:render section="menu" />
  <div class="toolbox">
    <f:cObject typoscriptObjectPath="lib.forumlogin" />
  </div>

Bitte habt Verständnis, dass ich jetzt hier nicht auf den Aufbau eines Fluid Templates eingehe, dieser Beitrag soll schließlich nur erklären, wie ich phpBB in Typo3 einbinde.
Im obigen Code seht ihr, dass mein Menü aus einer separaten Datei geladen wird. Diese befindet sich auch im fileadmin und heißt menu.html. Ob ihr das Menü in einer extra Datei ablegt oder nicht, ist natürlich euch überlassen. Bei mir sieht die Datei wie folgt aus:

<div id="menu">
  <f:cObject typoscriptObjectPath="lib.menu" />
  <f:cObject typoscriptObjectPath="lib.forummenu" />
</div>

Vielleicht erkennt ihr schon, dass der Login mittels <f:cObject typoscriptObjectPath=”lib.forumlogin” /> und das Menü mittels <f:cObject typoscriptObjectPath=”lib.forummenu” /> eingebunden wird.
Natürlich ist das noch nicht alles, denn es reicht nicht, nur diese zwei Zeilen an der entsprechenden Stelle in eurem Template einzubinden. Dies dient nur dazu, dass Typo3 weiß, an welcher Stelle das Menü und der Login angezeigt werden sollen. Das eigentliche Einbinden der zwei Dateien forum_menu.php und forum_login.php, die in meinem Beispiel unter fileadmin/phpscripts/ abgelegt sind findet in Typoscript statt. Dazu wählt ihr einfach im Menü eures Typo3-Backends den Punkt “Web” aus und wechselt dann zu eurer Rootpage und klickt auf “Setup”.
Nun noch acht kleine Zeilen im Typoscript einbinden und schon habt ihr das Menü und den Login aus dem phpBB-Forum in Typo3 eingebunden:

lib.forumlogin = PHP_SCRIPT_EXT
lib.forumlogin {
 file = fileadmin/phpscripts/forum_login.php
}

lib.forummenu = PHP_SCRIPT_EXT
lib.forummenu {
 file = fileadmin/phpscripts/forum_menu.php
}

An dieser Stelle ist es netürlich wieder wichtig, dass ihr den genauen Pfad angebt, an dem ihr die Scripts im fileadmin abgelegt habt. Sehr wichtig ist auch, dass ihr PHP_SCRIPT_EXT angebt. Nur so werden die Scripts korrekt unterstützt!

Ich hoffe, ich konnte euch mit diesem kleinen Beitrag helfen und ihr wisst jetzt, wie ihr ein Menü und einen Login eures phpBB-Forums in eure Typo3-Homepage einbinden könnt. So können die User eurer Homepage ohne Bedenken zwischen dem Forum un der Homepage (was im idealen Fall ja aussehen soll, wie eine Seite) wechseln und bleiben dabei eingeloggt. Ein riesen Vorteil für euch und die Besucher!

Für Kommentare und Empfehlungen des Beitrags bin ich euch jederzeit dankbar, also ruhig “verschwenderisch” damit umgehen.

Grüße.