How you integrate phpBB with drupal, share users but use phpBB as forums.

First, I had to do some more than just 5 lines of code in phpBB to get it to work the way I wanted...

Here is what I did.

• Download XML-RPC for PHP from http://phpxmlrpc.sourceforge.net/
• Place this library in phpBB's path includes/lib
• Open up phpBB's phpBB's template.php file....
• Place the following function in the template.php file.
  

  <?php
     /**  
      * Drupal Template hack by Travis Tidwell : www.travistidwell.com
  	 *    Tap into the template system to allow for Drupal to load its template first, and then place the forum in the content of the theme.
  	 *    This is assuming that you have your phpBB instalation within a directory that is one level higher than the Drupal Root.  For example,
  	 *    drupal_root/phpBB/index.php is valid, while drupal_root/forum/phpBB/index.php is not.
  	 */
  
     function showDrupal($content) {
  		require_once('lib/xmlrpc.inc');
  		$client = new xmlrpc_client('http://'.$this->sitename.'/services/xmlrpc');
  		$client->return_type = 'phpvals';
  		$content_var = new xmlrpcval($content, "string");
  		$sessid = new xmlrpcval($this->sid, "string");
  	
  		$message = new xmlrpcmsg("phpbb.getpage", array($sessid, $content_var));
  		$resp = $client->send($message);
  		if ($resp->faultCode())
    	   	echo 'KO. Error: '.$resp->faultString();
  		else
  			echo $resp->value();
     }
  ?>
  

• Now change the pparse routine to the following...
  

  <?php
  	/**
  	 * Load the file for the handle, compile the file,
  	 * and run the compiled code. This will print out
  	 * the results of executing the template.
  	 */
  	function pparse($handle)
  	{
  		if (!$this->loadfile($handle))
  		{
  			die("Template->pparse(): Couldn't load template file for handle $handle");
  		}
  
        $content = "";
  
  		// actually compile the template now.
  		if (!isset($this->compiled_code[$handle]) || empty($this->compiled_code[$handle]))
  		{
  			// Actually compile the code now.
  			if(defined('IN_ADMIN') && IN_ADMIN) {
  				$this->compiled_code[$handle] = $this->compile($this->uncompiled_code[$handle]);
  			}
  			else {
  				$this->compiled_code[$handle] = $this->compile($this->uncompiled_code[$handle], true, 'content');
  			}
  		}
  
  		// Run the compiled code.
  		eval($this->compiled_code[$handle]);
  		
  		if(defined('IN_ADMIN') && IN_ADMIN) {
  			return true;
  		}
  		else {
  			if(strpos($handle, 'header') !== FALSE) {
  				$_SESSION['page_header'] = $content;
  			}
  			else if(strpos($handle, 'body') !== FALSE) {
  				$_SESSION['page_body'] = $content;
  			}
  			else if(strpos($handle, 'footer') !== FALSE) {
  				$content = $_SESSION['page_header'] . $_SESSION['page_body'] . $content;
  				$this->showDrupal($content);		
  			}
  		}
  		
  		return true;
  	}
  ?>
  

• Now download the Services Module and enable it...
• Now you just need to edit the phpbb.module file and add the following lines of code...
  

  <?php
  /**
   * phpBB Drupal Hack by Travis Tidwell, www.travistidwell.com
   *
   * phpbb_get_page :  This function is called with the XML-RPC from the phpBB template engine.  It passes the 
   * content of the forum page to this routine, and then waits to get a response to print to the screen.  This function
   * takes that content, and then merges the two templates together before it sends it back to the phpBB template engine.
   */
  
  function phpbb_get_page($content) {
    $body_start = '<table width="100%" cellspacing="0" cellpadding="10" border="0" align="center"><tr><td class="bodyline" '.$background_color.'>';
    $body_end = '</td></tr></table>';
    $tolower = strtolower($content);
    $template = variable_get('phpbb_template', 'subSilver');
    $phpBBPath = variable_get('phpbb_dir', 'phpBB2/');
    $content = str_replace('templates/', $phpBBPath . 'templates/', $content);
     
    drupal_add_css("{$phpBBPath}templates/{$template}/{$template}.css", 'theme');
    drupal_set_title(variable_get('phpbb_forum_title', 'Forum'));
     
  /*
   * Doesn't quite work yet...
   *
   * drupal_set_html_head(_extract_tag_info($content, $tolower, '<style', '</style>'));     // Copy all links to the drupal header.
   * drupal_set_html_head(_extract_tag_info($content, $tolower, '<link', '>'));             // Copy all links to the drupal header.
   * drupal_set_html_head(_extract_tag_info($content, $tolower, '<script', '</script>'));   // Copy all scripts to the drupal header.
   */
    $startpos = strpos($tolower, '<body');
    $startpos = strpos($tolower, '>', $startpos) + 1;
    $endpos = strpos($tolower, '</body>');
    return theme('page', substr($content, $startpos, ($endpos - $startpos)));
  }
  
  /*
  * Implementation of hook_service()
  * Required by all server modules
  * Returns array defining all the methods available in the service
  */
  function phpbb_service() {
    return array(
      array(
        '#method' => 'phpbb.getpage',
        '#callback' => 'phpbb_get_page',
        '#args' => array(
          array(
            '#name' => 'content',
            '#type' => 'string',
            '#optional' => false,
            '#description' => 'A string of the content of the bulletin board.'       
          ),
        ),
  
        '#return' => 'string',
        '#help' => 'Returns a drupal page with the content provided.'
      )
    );
  }
  ?>
  

And that's how I did it!!!

Enjoy,

Travis.