I used this on my old forum with ezPortal. It was great and worked perfectly. It doesn't require a lot to be done but the instructions are a little tricky. This mod would show who was online by displaying a chat bubble next to their name in the Who Is Online section, would show who/how many people are using Instant Messgener, and it was fully integrated with your existing database. This way users would not have to register again. It wouldn't ask for your password/username because it was integrated. Great mod and it's free.
<script type="text/javascript">
<!--
var newwindow;
function poptastic(url)
{
newwindow=window.open(url,'name','height=500,width=240,left=20,top=20,toolbar=no,menubar=no,directories=no,location=no,scrollbars=yes,status=no,resizable=yes,fullscreen=no');
if (window.focus) {newwindow.focus()}
}
-->
</script>
Joined: January 2008
Posts: 1369
Location: Georgia
Re: Php121 Instant Messenger
KasLimon,
Great work! I've made all the changes you posted, but the Instant Messenger link still does not show at the top when I am using the Black Pearl template.
Would it be possible to put the Instant Messenger link in a block? Also, do you have your test site setup to show who is using Instant Messenger? It should show a chat bubble next to their username in the Who Is Online section in the forum.
I was also pretty confused about the SQL directions in the docs folder. It says to: Edit configuration: Copy php121config.php-PHPBB to php121config.php, replacing the existing file. Edit php121config.php and change all the variables to match your database and website configuration.
In the php121config.php-PHPBB file, you have to change a variety of variables. The file lists:
<?php
/*****************************************************************************************
** PHP121 Instant Messenger (PHP121) **
** File: php121config.php **
** Date modified: 29/06/06 **
** Copyright: (C) 2005 Paul Synnott **
** Email:
**
** Web: http://www.php121.com **
** File function: User configuration file (phpBB defaults) **
** ---- EDIT YOUR SETTINGS BELOW THE GNU GPL NOTICE!!! ---- **
*****************************************************************************************/
/*****************************************************************************************
** This file is part of PHP121. **
** **
** PHP121 is free software; you can redistribute it and/or modify **
** it under the terms of the GNU General Public License as published by **
** the Free Software Foundation; either version 2 of the License, or **
** (at your option) any later version. **
** **
** PHP121 is distributed in the hope that it will be useful, **
** but WITHOUT ANY WARRANTY; without even the implied warranty of **
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the **
** GNU General Public License for more details. **
** **
** You should have received a copy of the GNU General Public License **
** along with PHP121; if not, write to the Free Software **
** Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA **
*****************************************************************************************/
# $php121_prefix: Your Database table's php121 prefix (Don't change this unless you know what you are doing)
$php121_prefix = "php121";
# $siteurl: The URL to php121, including the trailing slash e.g. http://www.MYURL.com/php121/
$siteurl = "http://www.MYSITE.com/phpBB2/php121/";
# $customtitle: The title you want to appear at the top of every screen
$customtitle = "PHP121";
# $webmaster: The email address where your users can contact you
$webmaster = "support@MYSITE.com";
# $integration: Is PHP121 integrated into another application?
# Possible options: none, phpnuke, phpbb
# Warning! This changes the behaviour of PHP121 a lot! Be sure you know what you are doing!
# This setting affects how PHP121 looks at sessions. You also have to change the database
# options in the "Extra Database Options" section below!
$integration = "phpbb";
# $acctman: Should PHP121 handle creating new user accounts / deleting accounts etc?
# Usually you only want this if $integration is set to none!
# Warning! This changes the behaviour of PHP121 a lot! Be sure you know what you are doing!
# 0 = off; 1 = on.
$acctman = 0;
/*****************************************************************************************
** Extra Database Options **
** DO NOT CHANGE THESE unless you are wanting to use your existing user database **
** If you want to use your existing user database (with existing usernames and **
** passwords, you MUST first alter your database to include the extra PHP121 fields. **
** To do this, do the following: **
** **
** 1. EDIT sql/alter_existing_usertable.sql and change the name of the table on the **
** first line to be the name of your existing users table. **
** **
** 2. EXECUTE sql/alter_existing_usertable.sql within your existing database **
** (You can do this easily with PHPMyAdmin if your host has it, or simply 'source' **
** it on the mysql console after selecting the appropriate database ('use')) **
** **
** 3. CHANGE the options below to match your user table configuration. **
** **
******************************************************************************************/
# db_usertable: name of the existing user table (e.g. php121_users)
$db_usertable = "phpbb_users";
# dbf_uid: name of the user id field (e.g. uid)
# (must be an integer field)
$dbf_uid = "user_id";
# dbf_uname: name of the username field (e.g. uname)
$dbf_uname = "username";
# dbf_upassword: name of the password field (e.g. upassword)
$dbf_upassword = "user_password";
# dbf_passwordtype: password type, either md5 or plaintext
$dbf_passwordtype = "md5";
# dbf_uemail: name of the email field (e.g. uemail)
$dbf_uemail = "user_email";
# dbf_user_chatting: name of the php121 user_chatting field (e.g. php121_user_chatting)
$dbf_user_chatting = "php121_user_chatting";
# dbf_smilies: name of the php121 smilies field (e.g. php121_smilies)
$dbf_smilies = "php121_smilies";
# dbf_level: name of the php121 level field (e.g. php121_level)
$dbf_level = "user_level";
# dbf_showrequest: name of the php121 showrequest field (e.g. php121_showrequest)
$dbf_showrequest = "php121_showrequest";
# dbf_uname_len: the length of the username field
$dbf_uname_len = 25;
# dbf_upassword_len: the length of the password field
$dbf_upassword_len = 32;
# dbf_uemail_len: the length of the email field
$dbf_uemail_len = 255;
# dbf_upassword_input_min_length: the minimum password length allowed
$dbf_upassword_input_min_length = 6;
# dbf_upassword_input_max_length: the maximum password length allowed
$dbf_upassword_input_max_length = 10;
# dbf_beep_newmsg: name of the php121 beep on new msg field (e.g. php121_beep_newmsg)
$dbf_beep_newmsg = "php121_beep_newmsg";
# dbf_focus_newmsg: name of the php121 focus on new msg field (e.g. php121_focus_newmsg)
$dbf_focus_newmsg = "php121_focus_newmsg";
# dbf_banned: name of the php121 user banned field (e.g. php121_banned)
$dbf_banned = "php121_banned";
# dbf_timezone: name of the php121 user timezone field (e.g. php121_timezone)
$dbf_timezone = "user_timezone";
# dbf_timestamp: name of the php121 user timestamp field (e.g. php121_timestamp)
$dbf_timestamp = "php121_timestamp";
# dbf_language: name of the php121 user language field (e.g. php121_language)
$dbf_language = "user_lang";
# dbf_auto_email_transcript: name of the php121 auto_email_transcript field (e.g. php121_auto_email_transcript)
$dbf_auto_email_transcript = "php121_auto_email_transcript";
?>
Should anything be changed in the Extra Database Options section?
<?php
/*****************************************************************************************
** PHP121 Instant Messenger (PHP121) **
** File: php121config.php **
** Date modified: 29/06/06 **
** Copyright: (C) 2005 Paul Synnott **
** Email: support@php121.com **
** Web: http://www.php121.com **
** File function: User configuration file (phpBB defaults) **
** ---- EDIT YOUR SETTINGS BELOW THE GNU GPL NOTICE!!! ---- **
*****************************************************************************************/
/*****************************************************************************************
** This file is part of PHP121. **
** **
** PHP121 is free software; you can redistribute it and/or modify **
** it under the terms of the GNU General Public License as published by **
** the Free Software Foundation; either version 2 of the License, or **
** (at your option) any later version. **
** **
** PHP121 is distributed in the hope that it will be useful, **
** but WITHOUT ANY WARRANTY; without even the implied warranty of **
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the **
** GNU General Public License for more details. **
** **
** You should have received a copy of the GNU General Public License **
** along with PHP121; if not, write to the Free Software **
** Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA **
*****************************************************************************************/
# $php121_prefix: Your Database table's php121 prefix (Don't change this unless you know what you are doing)
$php121_prefix = "php121";
# $siteurl: The URL to php121, including the trailing slash e.g. http://www.MYURL.com/php121/
$siteurl = "http://www.MYSITE.com/phpBB2/php121/";
# $customtitle: The title you want to appear at the top of every screen
$customtitle = "PHP121";
# $webmaster: The email address where your users can contact you
$webmaster = "support@MYSITE.com";
# $integration: Is PHP121 integrated into another application?
# Possible options: none, phpnuke, phpbb
# Warning! This changes the behaviour of PHP121 a lot! Be sure you know what you are doing!
# This setting affects how PHP121 looks at sessions. You also have to change the database
# options in the "Extra Database Options" section below!
$integration = "phpbb";
# $acctman: Should PHP121 handle creating new user accounts / deleting accounts etc?
# Usually you only want this if $integration is set to none!
# Warning! This changes the behaviour of PHP121 a lot! Be sure you know what you are doing!
# 0 = off; 1 = on.
$acctman = 0;
/*****************************************************************************************
** Extra Database Options **
** DO NOT CHANGE THESE unless you are wanting to use your existing user database **
** If you want to use your existing user database (with existing usernames and **
** passwords, you MUST first alter your database to include the extra PHP121 fields. **
** To do this, do the following: **
** **
** 1. EDIT sql/alter_existing_usertable.sql and change the name of the table on the **
** first line to be the name of your existing users table. **
** **
** 2. EXECUTE sql/alter_existing_usertable.sql within your existing database **
** (You can do this easily with PHPMyAdmin if your host has it, or simply 'source' **
** it on the mysql console after selecting the appropriate database ('use')) **
** **
** 3. CHANGE the options below to match your user table configuration. **
** **
******************************************************************************************/
# db_usertable: name of the existing user table (e.g. php121_users)
$db_usertable = "phpbb_users";
# dbf_uid: name of the user id field (e.g. uid)
# (must be an integer field)
$dbf_uid = "user_id";
# dbf_uname: name of the username field (e.g. uname)
$dbf_uname = "username";
# dbf_upassword: name of the password field (e.g. upassword)
$dbf_upassword = "user_password";
# dbf_passwordtype: password type, either md5 or plaintext
$dbf_passwordtype = "md5";
# dbf_uemail: name of the email field (e.g. uemail)
$dbf_uemail = "user_email";
# dbf_user_chatting: name of the php121 user_chatting field (e.g. php121_user_chatting)
$dbf_user_chatting = "php121_user_chatting";
# dbf_smilies: name of the php121 smilies field (e.g. php121_smilies)
$dbf_smilies = "php121_smilies";
# dbf_level: name of the php121 level field (e.g. php121_level)
$dbf_level = "user_level";
# dbf_showrequest: name of the php121 showrequest field (e.g. php121_showrequest)
$dbf_showrequest = "php121_showrequest";
# dbf_uname_len: the length of the username field
$dbf_uname_len = 25;
# dbf_upassword_len: the length of the password field
$dbf_upassword_len = 32;
# dbf_uemail_len: the length of the email field
$dbf_uemail_len = 255;
# dbf_upassword_input_min_length: the minimum password length allowed
$dbf_upassword_input_min_length = 6;
# dbf_upassword_input_max_length: the maximum password length allowed
$dbf_upassword_input_max_length = 10;
# dbf_beep_newmsg: name of the php121 beep on new msg field (e.g. php121_beep_newmsg)
$dbf_beep_newmsg = "php121_beep_newmsg";
# dbf_focus_newmsg: name of the php121 focus on new msg field (e.g. php121_focus_newmsg)
$dbf_focus_newmsg = "php121_focus_newmsg";
# dbf_banned: name of the php121 user banned field (e.g. php121_banned)
$dbf_banned = "php121_banned";
# dbf_timezone: name of the php121 user timezone field (e.g. php121_timezone)
$dbf_timezone = "user_timezone";
# dbf_timestamp: name of the php121 user timestamp field (e.g. php121_timestamp)
$dbf_timestamp = "php121_timestamp";
# dbf_language: name of the php121 user language field (e.g. php121_language)
$dbf_language = "user_lang";
# dbf_auto_email_transcript: name of the php121 auto_email_transcript field (e.g. php121_auto_email_transcript)
$dbf_auto_email_transcript = "php121_auto_email_transcript";
Joined: January 2008
Posts: 1369
Location: Georgia
Re: Php121 Instant Messenger
After some trouble, I finally got it up and running. I'm now going to make those extra code changes to see if the bubble will show up in the WIO section.
Joined: January 2008
Posts: 1369
Location: Georgia
Re: Php121 Instant Messenger
Ok, Instead of having the link in the navigation bar at the top, I think it would best suit me in a block that I could move anywhere. Let me know if you found a way for this to work.
Thanks Kas.
Also, the Chat Bubble is showing in the wrong place. It should be showing next to the users that are currently online, not in the who has been online line.
Joined: January 2008
Posts: 1369
Location: Georgia
Re: Php121 Instant Messenger
Kas, it works!
The chat bubbles appear in the WIO block, which is great! A user can click the chat box to initiate a chat with another user. I also like the way you made this into a block. Users are signed into Instant Messenger as soon as they log in. You made this into a block, with a height dimension field...could you also make a width dimension field? This would allow me to put this block on the left or right side instead of just in the middle.
Joined: November 2006
Posts: 494
Location: Madrid (Spain)
Re: Php121 Instant Messenger
Of course you can add it to any place
I've added to the block some abilities so now you can:
Set block height
Set block width
Set block alignment (so if you don't set width to 100% you can align it)
Upload the files included in this new package.
After uploading, delete the php121 block and add it again.
Also, I'd like you to test this php121config file I've attached.
It should work without editing it, just upload it to php121 folder.
Remember to make a backup first.
I'm adding this to Customizations forum in a while.
The time now is Wed 22 Oct, 2025 17:52 • All times are UTC + 1 Hour [DST enabled]
Permissions List
Permissions List
You cannot post new topics You cannot reply to topics You cannot edit your posts You cannot delete your posts You cannot vote in polls You cannot attach files You can download files You cannot post calendar events