phpBB.de

##############################################################
## MOD Title: ChatBox
## MOD Author: Wooly Spud <WoolySpud@xgmag.com> (Richard McConnell) http://www.xgmag.com
## Smartor < smartor_xp@hotmail.com > (Hoang Ngoc Tu) http://smartor.is-root.com
## MOD Description: This will add a LIVE chatbox on your phpBB2
## Only registered users can chat. Admin can take
## control chatroom by some commands(/KICK username, /CLEAR). Smilies enabled.
## Only tested with phpBB 2.0.x/MySQL
## MOD Version: 3.0.2
##
## Installation Level: easy
## Installation Time: 20 Minutes
## Files To Edit: 3
## index.php
## templates/subSilver/index_body.tpl
## language/lang_english/lang_main.php
## chatbox_mod/chatbox_config.php
##
## Included Files: 10
## chatbox_db_install.php (only required for DB install)
## chatbox_front.php
## chatbox_mod/chatbox.css
## chatbox_mod/chatbox.php
## chatbox_mod/chatbox_config.php
## chatbox_mod/chatbox_drop.php
## chatbox_mod/chatbox_function.php
## chatbox_mod/chatbox_title.php - NEW
## chatbox_mod/chatbox_faq.php - NEW
## chatbox_mod/chatbox_about.php - NEW
## chatbox_mod/messenger_list.php
## chatbox_mod/messenger_send.php
## chatbox_mod/messenger_view.php
##
##############################################################
## Author Notes:
##
##############################################################
## Before Adding This MOD To Your Forum, You Should Back Up All Files Related To This MOD
##############################################################



#
#-----[ COPY ]--------------------------------------------
#
# Do this only if you are not going to do the SQL sttements Manually
#
copy support_files/chatbox_db_install.php to phpbb/chatbox_db_install.php

#
#-----[ SQL ]---------------------------------------------
# Run these folloing queries manually or run chatbox_db_install.php found in the support files folder once
# Afterthat please remove your chatbox_db_install.php immediately
#
# NOTE: if the prefix of your boards is not "phpbb_" please change
# the below SQL statement so that the right prefix is used

DROP TABLE IF EXISTS `phpbb_chatbox`;
CREATE TABLE `phpbb_chatbox` (
`id` int(11) NOT NULL auto_increment,
`name` varchar(99) NOT NULL default '',
`msg` varchar(255) NOT NULL default '',
`timestamp` int(10) unsigned NOT NULL default '0',
PRIMARY KEY (`id`)
) TYPE=MyISAM AUTO_INCREMENT=1528 ;


DROP TABLE IF EXISTS `phpbb_chatbox_session`;
CREATE TABLE `phpbb_chatbox_session` (
`username` varchar(99) NOT NULL default '',
`user_id` mediumint(8) unsigned NOT NULL default '0',
`lastactive` int(10) NOT NULL default '0',
`laststatus` varchar(8) NOT NULL default '',
UNIQUE KEY `username` (`username`)
) TYPE=MyISAM;

#
#-----[ COPY ]--------------------------------------------
#
copy chatbox_front.php to phpbb/chatbox_front.php
copy chatbox_mod/*.* to phpbb/chatbox_mod/

#
#-----[ OPEN ]---------------------------------------------
#
index.php


#
#-----[ FIND ]---------------------------------------------
#
$template->assign_vars(array(
'TOTAL_POSTS' => sprintf($l_total_post_s, $total_posts),
'TOTAL_USERS' => sprintf($l_total_user_s, $total_users),
'NEWEST_USER' => sprintf($lang['Newest_user'], '<a href="' . append_sid("profile.$phpEx?mode=viewprofile&" . POST_USERS_URL . "=$newest_uid") . '">', $newest_user, '</a>'),

#
#-----[ BEFORE, ADD ]--------------------------------------
#
// ChatBox Mod
require_once($phpbb_root_path . 'chatbox_front.php');

#
#-----[ FIND ]---------------------------------------------
#
'L_MARK_FORUMS_READ' => $lang['Mark_all_forums'],

#
#-----[ AFTER, ADD ]--------------------------------------
#
// ChatBox Mod
'TOTAL_CHATTERS_ONLINE' => sprintf($lang['How_Many_Chatters'], $howmanychat),
'CHATTERS_LIST' => sprintf($lang['Who_Are_Chatting' ],$chatters),
'L_CLICK_TO_JOIN_CHAT' => $lang['Click_to_join_chat'],
'S_JOIN_CHAT' => append_sid("chatbox_mod/chatbox.$phpEx"),
'CHATBOX_NAME' => $userdata['user_id'] . '_ChatBox', // To make easier to test on my PC
'L_LOGIN_TO_JOIN_CHAT' => $lang['Login_to_join_chat'],

#
#-----[ OPEN ]---------------------------------------------
#
language/lang_english/lang_main.php

#
#-----[ FIND ]---------------------------------------------
#
//
// That's all Folks!

#
#-----[ BEFORE, ADD ]--------------------------------------
#
// ChatBox Mod
$lang['How_Many_Chatters'] = 'There are <B>%d</B> user(s) on chat now';
$lang['Who_Are_Chatting' ] = '<B>%s</B>';
$lang['Click_to_join_chat'] = 'Click to join chat';
$lang['ChatBox'] = 'ChatBox';
$lang['log_out_chat'] = 'You have successfully logged out from chat on ';
$lang['Send'] = 'Send';
$lang['Login_to_join_chat'] = 'Login to join chat';


#
#-----[ OPEN ]--------------------------------------------
#
templates/subSilver/index_body.tpl

#
#-----[ FIND ]--------------------------------------------
#
<td class="row1" align="center" valign="middle" rowspan="2"><img src="templates/subSilver/images/whosonline.gif" alt="{L_WHO_IS_ONLINE}" /></td>

#
#-----[ REPLACE WITH ]------------------------------------
#
<td class="row1" align="center" valign="middle" rowspan="3"><img src="templates/subSilver/images/whosonline.gif" alt="{L_WHO_IS_ONLINE}" /></td>

#
#-----[ FIND ]---------------------------------------------
#
<tr>
<td class="row1" align="left"><span class="gensmall">{TOTAL_USERS_ONLINE} &nbsp; [ {L_WHOSONLINE_ADMIN} ] &nbsp; [ {L_WHOSONLINE_MOD} ]<br />{RECORD_USERS}<br />{LOGGED_IN_USER_LIST}</span></td>
</tr>

#
#-----[ AFTER, ADD ]--------------------------------------
#
<tr>
<td class="row1" align="left"><span class="gensmall">{TOTAL_CHATTERS_ONLINE}&nbsp;&nbsp;&nbsp;
<!-- BEGIN switch_user_logged_out -->
[ {L_LOGIN_TO_JOIN_CHAT} ]
<!-- END switch_user_logged_out -->
<!-- BEGIN switch_user_logged_in -->
[ <a href="javascript:void(0);" onClick="window.open('{S_JOIN_CHAT}','{CHATBOX_NAME}','scrollbars=no,width=540,height=450')">{L_CLICK_TO_JOIN_CHAT}</a> ]
<!-- END switch_user_logged_in -->
<br />{CHATTERS_LIST}
</span>
</td>
</tr>

#
#-----[ OPEN and EDIT ]---------------------------------------------
#
# chatbox_mod/chatbox_config.php,
# Set the Settings in this file to suite your needs. everything is labeled.
# Also you can edit the chatbox css file to change the look if you wish.



#
#-----[ SAVE/CLOSE ALL FILES ]------------------------------------------
#
# EoM