Once you have installed and activated Wp2BB, go to ‘Settings’ -> ‘Wp2BB’ in your WordPress control panel and configure the plugin.

Here’s the list of parameters and a brief explanation.

PhpBB local path:

Local path of your PhpBB installation (PhpBB needs to be in the same host as Wordpress for Wp2BB to work). It will look similar to this:

/hsphere/local/home/user/mydomain.com/phpbb

PhpBB forum URL:

Public URL of your PhpBB forum, used by Wp2BB to generate the template links. Something like this:

http://www.mydomain.com/myforum

Default forum for posts:

Numeric ID of the PhpBB forum where you want Wp2BB to create topics for your WordPress posts. You can find the ID after the “f=” bit of the PhpBB URL of your desired forum:

http://www.mydomain.com/myforum/viewforum.php?f=24

So your default forum for posts should be:

24
  • The default forum for posts can be overriden by a ‘forum’ custom field in your post (i.e. if your default forum for posts is ‘17′ but you want a post to have the corresponding topic in your forum ‘23′, simply add a ‘forum’ custom field with value ‘23′ to your WordPress post before publishing it).
  • If the default forum for posts is blank or ‘0′, no topics will be created for your posts unless you specify a ‘forum’ custom field in the post.

Default forum for pages:

Numeric ID of the PhpBB forum where you want Wp2BB to create topics for your Wordpress pages. You can find the ID after the “f=” bit of the PhpBB URL of your desired forum:

http://www.mydomain.com/myforum/viewforum.php?f=41

So your default forum for posts should be:

41
  • The default forum for pages can be overriden by a ‘forum’ custom field in your post (i.e. if your default forum for pages is ‘14′ but you want a page to have the corresponding topic in your forum ‘41′, simply add a ‘forum’ custom field with value ‘41′ to your WordPress page before publishing it).
  • If the default forum for pages is blank or ‘0′, no topics will be created for your pages unless you specify a ‘forum’ custom field in the page.

Forum user name:

The PhpBB existing user that will be used for creating new topics. For instance:

admin
  • If left blank or user does not exist, ‘guest’ will be used.

Forum user color:

Hex color in which user name will be displayed in the forum. For instance:

AA1F1F
  • Leave blank for default forum color.

Topic message text:

Message text for the topic in the forum (if none specified in the ‘msg’ custom field of the WP entry). Some text replacement keywords can be used:

  • {$post} Wordpress post text (in HTML)
  • {$title} Wordpress post title
  • {$purl} Wordpress post Permalink

For example, if your topic message text is

<b>This topic correspond to the post <{$title}> of my blog that can be found at {$purl}:</b><br>{$post}

and you publish a post called “Hello world” with the text “This is my first post”, the correspondent PhpBB topic created by Wp2BB will contain the following message:

This topic correspond to the post <Hello World> of my blog that can be found at http://www.mydomain.com/myblog/hello-world:
This is my first post

‘0 messages in the forum’ text:

Text displayed by the Wp2BB template when there are no messages in the forum for the current post. Something like this:

There are no responses in the forum yet!

‘1 message in the forum’ text:

Text displayed by the Wp2BB template when there is one message in the forum for the current post. Something like this:

There is one response in the forum

‘x messages in the forum’ text:

Text displayed by the Wp2BB template when there is more than one message in the forum for the current post. Some text replacement can be used:

  • {$x} Number of messages in the forum for the current post

Something like this:

There are {$x} responses in the forum

‘Add a message in the forum’ text:

Text displayed by the Wp2BB template in the ‘Add a reply’ link. Something like this:

Leave a message in the forum!

Add topics for old posts:

If set to ‘Yes’, old posts in your blog (published before you installed Wp2BB) will also have correspondent PhpBB topics. The topics will be created as the old posts are browsed by your readers.

Now check some usage tips…