Integrate PunBB forum into WordPress

1 Flares Twitter 0 Facebook 1 Google+ 0 1 Flares ×

As I promised previously after installed Forum, here I describe how to integrate PunBB forum into WordPress. The softwares used are WordPress 1.2.2 and PunBB 1.2.4. The same method probably works for later version, too.

Rip the header and footer code of your WordPress template. Remember to remove any WordPress template tags from the code, also the CSS stylesheet links of your template. Here I use _HEADER_ as template header code, _FOOTER_ as template footer code and _CSS_ as template css stylesheet links.


  1. Edit main.tpl (remember to make a backup first) that sit in http://www.YOUR_PATH/forum/include/template directory.
  2. Plug in your template header(_HEADER_) and footer(_FOOTER_) code into main.tpl. It will looks something like this:
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "">
    <html dir="<pun_content_direction>">
    <meta http-equiv="Content-Type" content="text/html; charset=<pun_char_encoding>" />
    <!-- WordPress Template CSS Stylesheet -->
    <!-- WordPress Template CSS Stylesheet -->
    <!-- WordPress template design header -->
    <!-- WordPress template design header -->
    <div id="punwrap">
    <div id="pun<pun_page>" class="pun">
    <div id="brdheader" class="block">
    	<div class="box">
    		<div id="brdtitle" class="inbox">
    <!-- WordPress template design footer -->
    <!-- WordPress template design footer -->
  3. You are almost done now. Now we need to tweak the PunBB forum CSS code to make the forum looks better in WordPress. Goto http://www.YOUR_PATH/forum/style/ and edit the CSS code of the PunBB template you are using. I use PunBB Oxygen template, so I edit Oxygen.css.
    In fact, the PunBB forum looks fine after done Step #2 but the font size is very small in Internet Explorer. That’s why I tweak the forum’s CSS code for IE.
  4. That’s it. You are done! :)

Additional: PunBB Plug-ins
Beside default PunBB installation, I install RSS mod and Active Topics mod from Alex King PunBB Mods collection.

Hope this small instruction to integrate PunBB forum into WordPress is helpful to some bloggers. Initially, I was planning to use miniBB for my blog but its simple (read: limited) admin control scared me off.

1 Flares Twitter 0 Facebook 1 Google+ 0 1 Flares ×

77 Responses to Integrate PunBB forum into WordPress

  1. hi April 22, 2005 at 4:18 am #


  2. Ulysses Ronquillo April 28, 2005 at 3:07 am #

    Hey, I was looking around the web how to do this. Very clear and easy instructions. Thanks a million.

  3. Zeke April 30, 2005 at 8:15 am #

    Very useful and easy guide. I had integrated punbb into my previous theme, but it was not nearly as clean as this way. Thanks! :-)

  4. Rob August 7, 2005 at 2:41 pm #

    Would anyone be willing to help me transfer my current invison power board database, into punBB, and then add it to my word press site? I’d be willing to pay if anyone wouldn’t mind helping. I managed to get word press setup, but I really have no idea how to do the rest.

    Please email me if you could possibly help. Again, I’d be willing to compensate you for your time.


  5. Jim August 23, 2005 at 3:43 am #

    Thanks for the little tutorial Liew. Adding PunBB to my site was a snap thanks to you.


  6. dalton August 27, 2005 at 5:58 am #

    Thanks for the great info. Any chance an update for WordPress 1.5 is forthcoming? The template engine for the new WP is pretty different, I’m having trouble adapting the instructions here for the new WordPress.

  7. LcF August 27, 2005 at 9:09 am #

    The integration for WP 1.5 is similar. The PunBB is standalone from WP template engine.

  8. Ivan September 25, 2005 at 2:50 am #

    Thank’s a lot from Russia!

  9. Trevor September 26, 2005 at 12:08 am #

    I just wanted to say thanks for the nice blog entry here. It really helped me to integrate my site. I wrote up blog post, too, that details the exact steps to integrate PunBB with the new k2 theme, and it even includes some files to download.

    Thanks again!

  10. Usayd October 5, 2005 at 2:09 am #

    Thanks for that, really helped me setup my forum easily ;)

  11. Sajid October 13, 2005 at 1:56 am #

    I had another question for punBB integration.

    I want to use PunBB with wordpress, but my question is:

    1. Is it possible to have sub-forums in punBB 1.2.8?
    2. Can invision 2.0 be migrated to punBB 1.2.8 with all sub-forums intact?


  12. LcF October 13, 2005 at 2:05 am #

    Sajid: PunBB does not support sub forum natively but you can use the punbb sub forum mod

  13. Sajid October 13, 2005 at 2:08 am #

    Thanks for your reply.

    I tried that link but it sayd its is for version 1.2.6 and i am using 1.2.8

    Anyways I have been able to import invision data into punBB (except the sub forums).

    My next question was about this tutorial.

    I did all the steps as mentioned here, but then how do i add the link of PUNBB to WordPress??

    thanks again

  14. LcF October 13, 2005 at 2:35 am #

    mod that works for 1.2.6 SHOULD work for 1.2.8 as well, there is not much changes between the versions.

    You may manually edit wordpress template to add the PunBB link.

  15. dave October 22, 2005 at 6:09 am #

    Wow… very cool… I added a forum to my Star Trek site. It looks really slick in my semi-hacked Trekkie theme. Thanks for the easy tips.

  16. Heather November 10, 2005 at 7:27 am #

    Thanks :) I’m still working on my site, but got it to load with in wordpress looks beautiful

    Thanks again

  17. ryan November 16, 2005 at 5:11 am #

    Would there be a way to do this but also integrate login information?

  18. LcF November 16, 2005 at 11:23 am #

    too bad, we haven’t figure out how to integrate the members database with wordpress.

  19. Nate November 26, 2005 at 3:26 pm #

    Between this article and your help to other people in the forums, I was able to integrate beautifully. Thanks a ton.

  20. Chris Poteet January 14, 2006 at 2:27 pm #

    Thanks for the tip!

  21. Nnyan January 25, 2006 at 1:47 am #

    Between this guide and the one at Almost Efortless (which had some more specific information) I got punBB inbedded into my WP site. Looks great (still have to tweak some of the default colors).

    Only issue I have is that the Administration section spawns a new page (much bigger) and does not display with the header/footer like all the other pages (that I’ve tried so far).

    Any idea how to get the Admin page to behave like the others?

  22. quaker February 24, 2006 at 10:31 am #

    has anyone got the information for the install of punbb to intergrate the username and pass with WP?
    so, that both pull the same user/pass from the db?

  23. eldrick March 20, 2006 at 11:59 am #

    I’ve followed the instructions on this and some other sites and my forum integration looks great, except for the search page. The ‘container’ background does not extend to the extent of the search area, instead i get the page background .gif image and its really not good. Any ideas?

  24. Ajay April 4, 2006 at 3:47 am #

    Hi, Newbie question – How do you rip the header?

  25. LcF April 4, 2006 at 4:18 am #

    view page source, select and copy what you have between <head> and </head>. Remove any wordpress related code.

  26. izlesene February 11, 2007 at 5:14 am #

    view page source, select and copy what you have between and . Remove any wordpress related code.

  27. lussigagas April 1, 2007 at 3:18 am #

    300 is a great movie full of visual effects and graphics which made it different and much better.
    Acting was great, director did a wonderful job and chose great actors, full of action, and it is based on a true story.

  28. valiko March 8, 2008 at 10:30 pm #

    Oh that was really helpfull! Thanks.


  1. The Real Astos » Blog Archive » Site News, New Sections - May 16, 2005

    [...] doesn’t have to be so long. I have added forums using PunBB. I used Liew CF’s excellent tutorial to have a consistant look between my site and the foru [...]

  2. » PunBB and WordPress Integration - July 29, 2005

    [...] I’ve chosen PubBB as the script for my forums. It’s very lightweight and is valid XHTML 1.0 Strict, but the main reason I’ve decided on it is its easy integration into my sites design. I found this very helpful page and figured out that by just adding header and footer information into a single PunBB file and slightly editng my CSS styles, I could make the forums’ design identical to that of my blog. Preview the forums here, but don’t sign up yet (I still need be integrate it with a gallery script… or at least try). « bbPress   [...]

  3. Jim Mitchell Designs » Blog Archive » New (Different) Forums Added - August 23, 2005

    [...] I found PunBB last week and learned that it was easily modified to fit in with a WordPress installation thanks to a post I found over at Install was a breeze, and rethemeing was a piece of cake too. If you’re thinking about adding forums to your WP install, I highly recommend using PunBB. [...]

  4. lều rách » Blog Archive » integration punbb to wordpress - August 27, 2005

    [...] định hợp nhất punbb vào wordpress mà ngó xem chẳng thấy còn cần thiết, nếu thì nên xử dụng nupusi có lẽ được mắt hơn, bài bản gì cũng chạy lưu trữ vào một forum của punbb. lười quá, thử hai ba lần rồi lại xóa giờ thì chỉ còn wordpress nằm đây, đã vậy còn lười hơn không thiết chi update ba cái plugins, themes. chuyện đâu còn có đó, rồi sẽ tính sau. [...]

  5. PunBB on Wordpress (with K2) at - September 29, 2005

    [...] I doubt a forum here will get much use, but I’m going to see if I can integrate PunBB forum into WordPress. Of course, I will be doing this while using the K2 theme. This post here on almost effortless should help a lot. [...]

  6. Forums / Wordpress plugin to post to PunBB - March 2, 2006

    [...] Here’s a fantastic article and code for integrating WP and PunBB together … wordpress/ Offline   [...]

  7. WordPress › Forum Plugins? « WordPress Support - March 2, 2006

    [...] Style integration: (There is one more similar description somewhere) [...]

  8. PixelToast - June 19, 2006

    WordPress and PunBB

    It seems to me that every web designer/developer’s problem comes, not so much with the design, but with the actual integration of a content management system, blog, or preexisting content with another part of that website, like, let’s say, a forum. T…

  9. BeGe Web - July 19, 2006

    [...] En suivant les liens suivants documentation wordpress et article punbb , j’ai assez facilement pu faire une page d’accueil en WordPress et ensuite intègrer les headers et footers de WordPress dans la page Punbb permettant une harmonie de la présentation et de la nivigation. [...]

  10. Integrating a Forum with WordPress | blogHelper - September 19, 2006

    [...] If you just want to show your latest forum topics on your blog, follow these instructions. [...]

  11. Integra un foro en tu Wordpress - aNieto2K - September 19, 2006

    [...] punBB, más ligero que phpBB y SMF y más pesado que los demás. No lo he usado nunca aunque parece ser que hay un plugin para conseguir integrarlo facilmente.[Demo] [...]

  12. Akismet for PunBB Forum at - September 24, 2006

    [...] Ever since I integrated PunBB forum for WordPress, the forum has attracting a lot of forum spammers. Finally, an Akismet mod for PunBB is available! [...]

  13. WordPress ZH_CN » Blog Archive » 整合论坛到Wordpress - October 6, 2006

    [...] 在blog里显示最近的论坛文章,参考这篇指导。 [...]

  14. » Blog Archive » Forum Integration in Wordpress - January 29, 2007

    [...] PunBB Auch hier gibt es ein Plugin, um punBB als WordPress-Kommentarsystem einzusetzen. Um die neuesten Foreneinträge im WP-Blog anzuzeigen, solltest Du diese Anleitung lesen. Informationen für die Layout-Integration findest Du hier und hier. [...]

  15. Wordpress und Forum Plugin » Netprofit - May 22, 2007

    [...] Dafür steckt ein flexibles, sauberes Templatesystem dahinter, das einen Versuch lohnt. Eine Integrationshilfe oder Anleitung sowie ein Kommentarersatzplugin gibt es auch [...]

  16. Wordpress Forum Integration | Raven Technologies - June 10, 2007

    [...] If you just want to show your latest forum topics on your blog, follow these instructions. [...]

  17. Sam Devol :: Integrate PunBB into your WordPress site - August 29, 2007

    [...] (design/page continuity, etc.) or was too simple for my tastes… Then I came across a tutorial here (there are a few around, that’s just the one I tripped across). Following the tutorial I had [...]

  18. Integrating a Forum with WordPress at Kgarney.Com - May 15, 2008

    [...] If you just want to show your latest forum topics on your blog, follow these instructions. [...]

  19. 整合论坛到Wordpress at 第七封印 - May 21, 2008

    [...] 在blog里显示最近的论坛文章,参考这篇指导。 [...]

  20. 整合论坛到Wordpress | 窝棚-WPCMS - September 4, 2008

    [...] 在blog里显示最近的论坛文章,参考这篇指导。 [...]

  21. Deamonic Angel’s Home » Blog Archive » Integrating a Forum with WordPress - November 26, 2008

    [...] If you just want to show your latest forum topics on your blog, follow these instructions. [...]

Add a comment

1 Flares Twitter 0 Facebook 1 Google+ 0 1 Flares ×