-------Step One

Import product-chatbox.xml using the Product Manager.

You can review and change the Chatbox default options under vBulletin Options > Chatbox Options in the Admin Control Panel now.


-------Step Two

Upload chatbox.php to your main forum folder.

Upload chatbox_admin.php to your admincp folder.

Upload cpnav_chatbox.xml to your includes/xml folder.


-------Step Three (template edits)

This is the javascript to open the Chatbox in a new window.

At the top of the navbar template, add

+++++++++++++++++++++++++++++++++++++++++
<script type="text/javascript">
<!--
function openChatbox () {
	chatbox = window.open('chatbox.php','chatbox','height=330,width=650,directories=no,location=no,menubar=no,resizable=yes,status=no,toolbar=no,scrollbars=yes');
}
//-->
</script>
+++++++++++++++++++++++++++++++++++++++++

Still in the navbar template, only if you want to add a link to the Chatbox in your navbar, find

+++++++++++++++++++++++++++++++++++++++++
		<td class="vbmenu_control"><a href="calendar.php$session[sessionurl_q]">$vbphrase[calendar]</a></td>
+++++++++++++++++++++++++++++++++++++++++

after that, add

+++++++++++++++++++++++++++++++++++++++++
		<td class="vbmenu_control"><a href="#" onclick="return openChatbox()">$vbphrase[chatbox_chatbox]</a></td>
+++++++++++++++++++++++++++++++++++++++++

This is the template edit to show the Chatbox in your forum home page.

If you want to show it after the forum listing, edit the FORUMHOME template and find

+++++++++++++++++++++++++++++++++++++++++
<!-- /main -->

<br />
$ad_location[ad_forumhome_afterforums]
<br />
+++++++++++++++++++++++++++++++++++++++++

replace that for

+++++++++++++++++++++++++++++++++++++++++
<!-- /main -->

<br />
$ad_location[ad_forumhome_afterforums]

<!-- Chatbox -->
<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
	<thead>
	<tr>
		<td class="tcat"><a style="float:right" href="#top" onclick="return toggle_collapse('forumhome_chatbox')"><img id="collapseimg_forumhome_chatbox" src="$stylevar[imgdir_button]/collapse_tcat$vbcollapse[collapseimg_forumhome_chatbox].gif" alt="" border="0" /></a><a href="javascript:openChatbox()">$vbphrase[chatbox_chatbox]</a></td>
	</tr>
	</thead>
	<tbody id="collapseobj_forumhome_chatbox" style="$vbcollapse[collapseobj_forumhome_chatbox]">
	<tr>
		<td class="alt1" width="100%" colspan="2"><div class="smallfont" align="center"><iframe src="chatbox.php?nofocus=1" width="100%"$chatboxheight style="border: 0px" frameborder="0"></iframe></div></td>
	</tr>
	</tbody>
</table>
<br />
<!-- / Chatbox -->
+++++++++++++++++++++++++++++++++++++++++

Note we removed one <br /> (newline) for it to look better, but you can use it with two <br />s if you want.

If you want the Chatbox to appear below the navbar on the forum home page, instead of using the above code use this one:

edit the FORUMHOME template and after "$navbar" add

+++++++++++++++++++++++++++++++++++++++++
<!-- Chatbox -->
<table class="tborder" cellpadding="$stylevar[cellpadding]" cellspacing="$stylevar[cellspacing]" border="0" width="100%" align="center">
	<thead>
	<tr>
		<td class="tcat"><a style="float:right" href="#top" onclick="return toggle_collapse('forumhome_chatbox')"><img id="collapseimg_forumhome_chatbox" src="$stylevar[imgdir_button]/collapse_tcat$vbcollapse[collapseimg_forumhome_chatbox].gif" alt="" border="0" /></a><a href="javascript:openChatbox()">$vbphrase[chatbox_chatbox]</a></td>
	</tr>
	</thead>
	<tbody id="collapseobj_forumhome_chatbox" style="$vbcollapse[collapseobj_forumhome_chatbox]">
	<tr>
		<td class="alt1" width="100%" colspan="2"><div class="smallfont" align="center"><iframe src="chatbox.php?nofocus=1" width="100%"$chatboxheight style="border: 0px" frameborder="0"></iframe></div></td>
	</tr>
	</tbody>
</table>
<br />
<!-- / Chatbox -->
+++++++++++++++++++++++++++++++++++++++++



You can change the Chatbox options under vBulletin Options > Chatbox Options in the Admin Control Panel.

You can prune messages in your Admin Control Panel under the Chatbox menu.

You can modify or translate phrases with the "chatbox_" prefix.

In the cron/ folder, there are files to use for auto prunning the Chatbox regularly, or to post system messages every other time, just follow the instructions of the text file inside.

That's it, enjoy :)