March 19, 2013

The WP-Recent-phpBB plugin defines a sidebar widget and a shortcode to show the most recent posts of phpBB 2.x or phpBB 3.x forums on your WordPress blog.

The plugin submits only one SQL query to gather all the required information from phpBB. Your phpBB tables can be located on the same database of your WordPress tables, another database or even another host.

This plugin allows you to choose the phpBB forums and users that you would like their posts to be included in or excluded from the listing.

The look of the phpBB posts are fully customizable within the plugin. This plugin uses two templates, one for new topics and another for replies. So that, you have complete freedom to define your own display format for phpBB posts on the sidebar widget or on your posts (or pages).

Here is the list of template variables that you can use to format each post:

  • {POST_URL}
    Absolute URL of the post
    Excerpt of the post (maximum first 20 words)
    Date of the post (date format is determined according to your WordPress settings)
    Time of the post (time format is determined according to your WordPress settings)
    Time elapsed since publishing the post (e.g. 5 minuets ago, 2 weeks ago, …)
    Absolute URL of the post’s topic
    Title of the post’s topic
    Absolute URL of the post’s forum
    Title of the post’s forum
  • {USER_URL}
    Absolute URL of the poster’s profile
    The poster’s user name

To embed recent phpBB posts in a post (or page), type [phpbb] in the content area, and then save/publish the post (or page).

The [phpbb] shortcode accepts the following parameters:

  • db_host
    Host name of the phpBB database server.
    Defaults to WordPress database server.
  • db_name
    Name of the phpBB database.
    Defaults to WordPress database name.
  • db_user
    User name of the phpBB database.
    Defaults to WordPress database user name.
  • db_pass
    Password of the phpBB database.
    Defaults to WordPress database password.
  • table_prefix
    Prefix name of the phpBB tables.
    Defaults to ‘phpbb_’
  • link
    URL to the phpBB bulletin board.
    Defaults to none
  • limit
    Maximum number of phpBB posts to display.
    Defaults to ‘5’
  • template_new
    The template for showing the new phpBB posts.
  • template_reply
    The template for showing the reply phpBB posts.
  • forum_include
    Comma separated list of phpBB forum IDs to include in the output.
    Defaults to all forums
  • forum_exclude
    Comma separated list of phpBB forum IDs to exclude from the output.
    Defaults to none
  • user_include
    Comma separated list of phpBB user names to follow their posts only.
    Defaults to all users
  • user_exclude
    Comma separated list of phpBB user names to ignore their posts.
    Defaults to none
  • show_link
    Whether the link to the phpBB bulletin board should be displayed (‘1’) or not (‘0’).
    Defaults to ‘1’ (show link)
  • link_title
    Title of the link to the phpBB bulletin board if show_link is on.

By the way, if you have more than one phpBB bulletin board, you can use more than one instance of the phpBB Recent Posts widget on your sidebar.


WP-Recent-phpBB (15.8 KiB, Last updated on March 19, 2013)Defines a fully customizable sidebar widget and shortcode to show the most recent phpBB posts on your WordPress blog.

Reader's Comments »

  1. 1. By pakkun on December 16, 2008 at 17:19

    hi, I can’t seem to edit the New Topics/Reply template in the widget. No matter how many times I click “change” it’s still reverts back to the original.

    Also, I was wondering if you can also include the Contents of the Post (POST_TEXT, mabbe?) as one of the variables?


  2. 2. By pakkun on December 16, 2008 at 17:28

    Oops my bad.. Pls delete my previous comment…

    It’s a great plugin! Thanks!

  3. 3. By Kambiz on December 17, 2008 at 17:06

    Good idea, thanks. I will consider adding POST_CONTENT and POST_EXCERPT template variables for the next release.

  4. 4. By ExEducation on April 1, 2009 at 00:06

    Great plug-in! Thanks!

  5. 6. By Kambiz on June 19, 2009 at 12:35

    Thank you Grib.

  6. 7. By wp on August 3, 2009 at 17:14

    Hi,it is great plugin, but how to use this plugin in theme without widgets??

  7. 8. By Kambiz on August 4, 2009 at 00:15

    Sorry, but I didn’t consider that while writing the plugin.

  8. 9. By Pete on August 29, 2009 at 20:12


    how i can use the plugin a second time in the same Blog, i like to show recent topice from a second forum

    thanks for your help


  9. 10. By Kambiz on August 30, 2009 at 17:10

    Simply drag the widget from “Available Widget” section and drop it on “Sidebar” as many times as you want.

  10. 11. By kandiaheart on September 23, 2009 at 04:03


    I tried to add image but I don’t know how to do this
    Can anyone be kind to tell me how?

    thanks a lot

  11. 12. By Kambiz on September 23, 2009 at 04:15

    Where you want to put the image?

  12. 13. By Yakub on February 11, 2010 at 16:01

    Hi guys! What kind of access to remote forum’s SQL database needed for this plugin (if I want to receive posts from not my forum)?

  13. 14. By Kambiz on February 11, 2010 at 16:24

    Hi! You need the SELECT permission only.

  14. 15. By Yakub on February 18, 2010 at 15:21

    Hi 2 all! Have you ever done or seen the sql-script that uses push-method for delivering last messages from wp forum? I have problems with access to remote SQL-database because of security considerations and I want to receive messages without contacting with sql-server at all.

  15. 16. By Kambiz on February 18, 2010 at 15:55

    The latest release of phpBB has RSS feed. You can consider using it.

  16. 17. By Uwe on February 20, 2010 at 22:45

    Hi, I would like to show the recent phpBB-posts in a static WP-Page.
    How can I do this with WP-Recent-phpBB ?

  17. 18. By Kambiz on February 24, 2010 at 22:09

    The current version of WP-Recent-phpBB can be used only as a sidebar widget. In its future release, I’ll add a shortcode, so that you can add it to any post/page.

  18. 19. By razvan on March 20, 2010 at 05:13

    Hey, i have a small problem.
    Instead of showing me new reply by “user” on “topic” in “forum” (i left the default tags for display) it shows them to me in some weird order: “posted by on in ” and then the urls’s for user/topic/forum .etc
    How can i solve this? 🙂

  19. 20. By Kambiz on March 20, 2010 at 09:06

    @razvan: To have the default templates, drop a new instance of the widget on the sidebar.

  20. 21. By Andriy Moraru on March 22, 2010 at 21:30

    Is it possible to use this plugin with the WP theme that isn’t “widget-ready” (sidebars are static)?

  21. 22. By Kambiz on March 22, 2010 at 23:49

    No, it’s not. It’s only for widget-ready themes.

  22. 23. By shane on March 28, 2010 at 23:35

    Is there a way to filter the posts it displays so it will only show a thread once regardless of how many recent posts it has received? ie. March 26 …. March 26…. Skiing …. March 26
    Just show it once? Or is that not possible with the way the widget was coded?

  23. 24. By Kambiz on March 29, 2010 at 00:18

    It is possible. Leave the reply template as empty if you want to show only the new topics.

  24. 25. By Hajmer on May 7, 2010 at 17:25

    Please , do u have WP-Recent vbulletin ?!

  25. 26. By Kambiz on May 8, 2010 at 19:51

    No, sorry! It’s only for phpbb.

  26. 27. By Gravity on August 11, 2010 at 07:19

    This is great, works perfectly thank you.

  27. 28. By Kambiz on August 11, 2010 at 07:48

    Good to know that, thanks!

  28. 29. By Oskar on August 25, 2010 at 13:32

    Hey, is there any progress with the shortcode 🙂

  29. 30. By Kambiz on August 26, 2010 at 11:56

    Sorry, not yet!

  30. 31. By xFanat on January 7, 2011 at 17:51

    Kambiz, thanks! Really good plugin.
    Grib, thanks for translation 🙂

  31. 32. By Kambiz on June 12, 2012 at 19:55

    Version 1.3 covers all the requested features!

  32. […] Добрый день! Делала я недавно сайт на WordPress, на нем организовала форум, использующий движок phpBB3. Между собой эти два движка у меня никак не связаны, т.к. сайт – это простая визитка, а все общение идет на форуме. Возник вопрос: “А как же вывести на сайте список последних сообщений на форуме?” Долго бродила по интернету в поисках решения и нашла! Это замечательный плагин WP-Recent-phpBB, скачать который можно здесь. […]