Forum module

This module will add a fully functional forum to an existing Yii application.


  • Clear forum structure and forum functionality.
  • CKEditor for wysiwyg.
  • Private messaging.
  • Moderation.
  • Search functionality.
  • Language support (message files included for Dutch and German).
  • Time zone handling.
  • Post upvoting.
  • Polls.


Yii 1.1.8 or above.
PHP 5.3 or above (a work-around for PHP 5.2 exists).
The application to which BBii is added needs to have a user table.


  • Extract the zip file to the application's protected/modules directory
  • Create database tables according to bbii/data/schema.mysql.sql
  • Import sample data from bbii/data/sampledata.mysql.sql
  • Create the subdirectory ‘avatar’ in your application webroot directory to which the application must be given read/write access rights.
  • Edit your configuration to register the module (the default option values may need to be adjusted):
  • BBii requires a user database table to be present that at least contains an integer user ID field and a varchar user name field. BBii also expects Yii::app()->user->id to return the user ID, not the user name. The model for the user table and the column names for the user ID column and the user name column are part of the module options.
  • Log in to your application with the user that has the user ID equal to the value for the option ‘adminId’ to acquire administration rights in BBii.
  • Navigate to http://[ your base url ]/forum. Click the link ‘Forum settings’ and set up the forum.


The following configuration options can be used:
adminId: the user ID (integer) for the user to receive the admin authorization (default value: false). When the application uses rbac and the role ‘admin’ exists the users that get the role ‘admin’ assigned will also be admin for BBii.
avatarStorage: The directory in which uploaded avatar images are stored relative to the application webroot directory (leading ‘/’ required) (default value: '/avatar').
forumTitle: The name for the forum (default value: 'BBii Forum').
userClass: The model name of the database table that contains the user authentication information for User ID and User name (default value: 'User').
userIdColumn: The column name of the User class field that contains the User ID (default value: 'id').
userNameColumn: The column name of the User class field that contains the User name (default value: 'username').
userMailColumn: The column name of the User class field that contains the User e-mail address (default value: false).
topicsPerPage: The number of topics to display on a single page (default value: 20).
postsPerPage: The number of posts to display on a single page (default value: 20).
purifierOptions: The CHtmlPurifier options.
editorToolbar: The toolbar options for the CKEditor.
cssFile: The cascading style sheet filename to be used by BBii (default: 'bbii.css').

Embedded Extensions


  • v0.9 (Apr. 6, 2014): Moderator mail. Membergroup forums. Bugfix.
  • v0.82 (Mar. 26, 2014): Improvements to pm. Bugfixes.
  • v0.81 (Mar. 16, 2014): Security related bugfixes.
  • v0.8 (Nov. 30, 2013): More module options. A grey-themed css file. German translation.
  • v0.7 (Nov. 16, 2013): Polls. Show upvoted by.
  • v0.6 (Nov. 1, 2013): Post upvoting.
  • v0.5 (Aug. 20, 2013): Indicate unread forums and topics.
  • v0.4 (Aug. 18, 2013): Moderator assignment. Member group icons.
  • v0.3 (Aug. 4, 2013): User e-mail form added. Session count for statistics.
  • v0.2 (Aug. 1, 2013): Search functionality added.
  • v0.1 (Jul. 27, 2013): Initial release.


Total 12 comments

#16228 report it
Ronald_ at 2014/02/01 03:42am
Re: Awesome work!

Thanks, and yes, I knew about it, but it slipped my mind. I will included this in the next release. Thanks for reminding me.

#16226 report it
webego at 2014/01/31 02:56pm
Awesome work!

Thank you for taking the time to put this together. Very nice indeed!

Have noticed that whilst you can set a forum to not be public, this just hides it from the list of forums. If you know (or guess) the url of the forum or any of the associated posts, you can still see these when logged out.

#15973 report it
Peter NewbYii at 2014/01/06 06:56am
Great extension!

Thank you for your work! It's great extension.

#15507 report it
Ronald_ at 2013/11/16 10:18am
Version 0.7 is available

BBii version 0.7 has added polls to the module.

#15367 report it
Ronald_ at 2013/11/01 02:35pm
Re: Default timezone and language

The info icons in the forum settings would have "given" you the answers:

You cannot set the language of the forum separate from the application to which the module is added. The forum language will be the language set in the config/main.php "language" parameter, for example (dutch):

return array(

As for the default timezone. You cannot set it separate from the setting in your php.ini file, which is part of the PHP installation. But you can override the setting of "date.timezone" parameter either in the source code or by adding this override in a ".user.ini" file, which is supported since PHP 5.3.0.

#15366 report it
karolintxu at 2013/11/01 12:30pm
Default timezone and language

Thanks for such a great extensions. It's working perfectly in a few configuration steps. I only have a problem, I can't (I don't find out how to do this) change the default timezone and language. Could you please, post here how to achieve this?

Thanks a lot!

#15138 report it
Sankalp Singha at 2013/10/10 02:19pm

This is really a very very good extension. Thank you for the hardwork! Very good forum.

#15060 report it
adreno at 2013/10/03 04:04am
Looks really great

Nice to have a good yii based forum to build upon rather than just the typical forums scripts wrapped as extensions. Looking forward to playing around with this and seeing what I can do with it.

Thanks also for the nice pdf guide!

#14277 report it
Ronald_ at 2013/08/01 04:06am

Thanks all for the positive responses. I really appreciate it.

#14271 report it
alexzv at 2013/07/31 07:59am
Very good

Good work! Can you create a repo on github?

#14244 report it
PeRoChAk at 2013/07/30 12:51am

Nice work...

#14230 report it
dhanakumar at 2013/07/29 01:22am

It's working fine.. keep the good work going ..

Leave a comment

Please to leave your comment.

Create extension