Chat Modifications - [Shout/Chatbox 0.7.06] GCBOS - Generic Chat Box Operating System

GCBOS - Generic Chat Box Operating System
by VertiCode UK

GCBOS is a command-based chat client written in PHP for vBulletin 3 & 4, the original modification was written by dinnerbone for vBulletin 3.7.

Versions:
-vBulletin 3.8

Features:
-Commands
-Topic and Reply notifications
-Simple to use commands
-Chat permissions
-Hide chatbox from usergroups
-Allow guests to view
-The ability to use similes and BB code
-Show who is using GCBOS on who's online
-Edit and delete messages
-Ability to prune the chat

Demo:
Otaku Studios

Commands:
- Impersonate: Makes <user> say <message ...>
- Usage: /say <user> <message ...>
- Example: /say "Basfreak" I like to touch myself at night.
- Mute User: Mutes <user>, preventing them from talking.
- Usage: /mute <user ..>
- Example: /mute Forum Troll
- Unmute User: Unmutes <user>, allowing them to talk.
- Usage: /unmute <user ..>
- Example: /unmute Forum Troll
- Edit Message: Edits message <messageid>, setting the new text to <message ..>
- Usage: /edit <messageid> <message ..>
- Example: /edit 1337 I'm in your message, stealing your texts.
- Delete message: Deletes message <messageid>.
- Usage: /delete <messageid>
- Example: /delete 1497
- Toggle Truesight: If enabled allows you to see who actually sent a message
- Usage: /truesight <0 or 1>
- Example: /truesight 1
- Clear Messages: Clears GCBOS, deleting all messages. Only you will see this.
- Usage: /clear
- Example: /clear
- List Muted Users: Lists all muted users
- Usage: /listmuted
- Example: /listmuted
- Private Message: Sends a private message to <user>
- Usage: /pm <user> <message ...>
- Example: /pm "Kanye West" Do you like fishsticks?
- List Ignored: Lists all users you are currently ignoring
- Usage: /listignores
- Example: /listignores
- Ignore User: Ignores all messages from <username ...>, preventing them from showing.
- Usage: /ignore <username ...>
- Example: /ignore Just Another Forum Troll
- Unignore User: Stops messages from <username ...> from being ignored.
- Usage: /unignore <username ...>
- Example: /unignore Dinnerbone
- Set Notice: Sets the notice to <notice>
- Usage: /notice <message ..>
- Example: /notice Welcome your new overlords!
- User Action: Perform an action, useful for role playing.
- Usage: /me <action ...>
- Example: /me dances
- Help: Displays this help menu
- Usage: /help
- Example: /help
- Prune Messages: Deletes all messages in GCBOS, this cannot be undone
- Usage: /prune
- Example: /prune

When using a command with 'parameters', you may either enter each parameter in the form of:
/command param1 param2 param3
However if the parameter contains spaces you must enclose it in quotes, such as:
/command "parameter 1" 'parameter2' param3.
You may edit messages by double clicking on them (If you have permission to do so), delete messages by clicking on the '#' in front of your messages, send a user a private message by single clicking their name, or speed up/slow down the speed messages are typed at by pressing the 'up' or 'down' arrow keys on your keyboard.

License:
GCBOS was released under the MPL on google code please see http://www.mozilla.org/MPL/MPL-1.1.html or view LICENSE.txt

Compatibility:
-vBulletin 4.x
-IIS7
-Apache2
-Litespeed webserver
-PHP 5.2.x
-PHP 5.3 (if references are enabled)

PHP 5.3
For GCBOS to work with PHP 5.3 you must have

allow_call_time_pass_reference

set to

On

Install:
-Upload the contents of the upload folder
-Import product-gcbos.xml
-Set usergroup permissions
-Insert <!-- {SHOUTBOX} --> into the template you want it to display in (EG FORUMHOME, FORUMDISPLAY) or at the bottom of navbar
-Navigate to vBulletin Settings->GCBOS set the forum restrictions to disable topic notifications or disable them by selecting no
-For 0.7.07 and above i reccomend installing the following modification (https://vborg.vbsupport.ru/showthread.php?t=228507) to add GCBOS to your navbar (http://yoursite.com/forums/gcbos.php?action=page).

Upgrade:
-Overwrite all files then import the product
-Edit permissions as required

[ComoEstaEso-com]

Originally Posted by Videx

This would likely be a permissions issue. Remember you have to manually set everything in vb4. To get it at the top you just want to use the Advertising Manager. AdminCP>Advertising>Add New Ad . It will show at the top of all 3 products - the CMS, Blog, and Forum.

Thanks for the reply and help Videx!
So I go to Add New Ad... Select "Below Navbar"
What code should I drop in the "Ad HTML" box?

Please excuse my n00bness....
Help much appreciated!

[Videx]

Oh dear. No, I'm the one that must beg forgiveness. I think. Actually, I was thinking of a different mod where I slipped the call into an ad block. But really, I don't suppose you couldn't call the shoutbox that way. I don't know. For mine, I just followed the instructions and inserted the call below the navbar line.

[hridayath]

Originally Posted by ComoEstaEso-com

I just installed it and everything went smoothly.
Working like a charm!



hridayath,
I'm no expert... yet let's see.
What are you having problems with?
1- upload contents of 'upload' folder to your forum
2- install new product with the attached .xml file
3- To add the "<!-- {SHOUTBOX} -->" do it like this:

Admin CP >> Styles & Templates >> Style Manager >> drop-down menu "Edit Templates"
Then, scroll down on the list until you see Forum Home Templates, then double-click on it.
Below that, a template called "FORUMHOME" will appear.
Click on that, then click on the "Customize" button on the right (or on the "Edit" button).

Then, here was my edit (there might be a better way to do it... this is what I did and it works)

{vb:raw headinclude_bottom}
</head>
	<body>

	{vb:raw header}

	{vb:raw navbar}
<!-- {SHOUTBOX} -->

	<div id="pagetitle">

Hope that helps!

Thank you for the reply and I tried it without luck but what I am gonna re-install everything starting from the upload. Will let you know the status.

[MyChemicalSelf]

Originally Posted by macheath

If anyone is interested in getting thread replies:

Create a new plugin.
Product: GCBOS
Hook Location: postdata_postsave
Title: New reply
Execution Order: 5
Plugin PHP Code:

PHP Code:

require_once(DIR . '/includes/class_gcbos.php');
$gcbos = new GCBOS();

global $vbulletin;

if ($vbulletin->options['gcbos_forum_alert'] == 1 && !in_array($this->info['forum']['forumid'], (array)explode(';', $vbulletin->options['gcbos_forum_exceptions'])))
{

$titleprefix = '[post=' . intval($this->fetch_field('postid')) . ']';
$titlesuffix = '[/post]';
    $gcbos->create_message('replied to the thread ' . $titleprefix . unhtmlspecialchars($this->info['thread']['title']) . $titlesuffix, $vbulletin->userinfo['userid'], TIMENOW, 0, GCBOS_MESSAGE_TYPE_NORMAL, $vbulletin->userinfo['userid']);
} 


great thanks for the help

if you want this to show as an action you could also use

[QUOTE=macheath;1972385]If anyone is interested in getting thread replies:

Create a new plugin.
Product: GCBOS
Hook Location: postdata_postsave
Title: New reply
Execution Order: 5
Plugin PHP Code:

PHP Code:

require_once(DIR . '/includes/class_gcbos.php');
$gcbos = new GCBOS();

global $vbulletin;

if ($vbulletin->options['gcbos_forum_alert'] == 1 && !in_array($this->info['forum']['forumid'], (array)explode(';', $vbulletin->options['gcbos_forum_exceptions'])))
{

$titleprefix = '[post=' . intval($this->fetch_field('postid')) . ']';
$titlesuffix = '[/post]';
    $gcbos->create_message('replied to the thread ' . $titleprefix . unhtmlspecialchars($this->info['thread']['title']) . $titlesuffix, $vbulletin->userinfo['userid'], TIMENOW, 0, GCBOS_MESSAGE_TYPE_ACTION, $vbulletin->userinfo['userid']);
} 


Anyway im working on the next build of GCBOS 0.7 RC3 at the minute i should have a few new fixes in store (infraction error) etc.

[ComoEstaEso-com]

Originally Posted by Videx

For mine, I just followed the instructions and inserted the call below the navbar line.

Thanks for the reply Videx!

I placed it below {vb:raw navbar}, yet it still only shows in the forums.
What template should I edit in order to have the shoutbox displayed everywhere on the site?

Here's what I have at the moment (partial copy/paste, with the pertinent info)

</head>
	<body>

	{vb:raw header}

	{vb:raw navbar}
<!-- {SHOUTBOX} -->

	<div id="pagetitle">
		<h1>{vb:raw vboptions.bbtitle}</h1>
		<p id="welcomemessage" class="description">{vb:rawphrase welcome_to_the_x, {vb:raw vboptions.bbtitle}}</p>
	</div>

==========

My other query, if somebody could please shed some light:
Unregistered / Not Logged In users are not able to see any of the messages.
The shoutbox displays in the window, yet it contains no messages.

I went to the Unregistered / Not Logged In group, and set the permissions to:
GCBOS Permissions
Can View GCBOS
YES
Can Talk in GCBOS
YES


Any ideas?

THANKS!

[teat]

I tried all that, but I cannot get the box to appear. I have admins to yes you can see it, but I cannot see the thing.

[Videx]

What template should I edit in order to have the shoutbox displayed everywhere on the site?

I don't know, but I wouldn't do that myself since I'm on a shared server. Remember, especially until this box gets an idle timeout feature, that members using it a lot and just hanging out and watching it will use a lot of server resources. People on shared servers could find themselves suspended.

[Trek]

I dropped it in FORUMHOME and FORUMDISPLAY to minimize load.

If you want it on every page, drop it at the very bottom of the NAVBAR template.

[MyChemicalSelf]

Just sent rc3 to some testers fixed the infraction error added notifications for new post and /me and /pm loophole for muted users.

[Trek]

Originally Posted by MyChemicalSelf

Just sent rc3 to some testers fixed the infraction error added notifications for new post and /me and /pm loophole for muted users.

Sounds good, what about a timeout so it stops polling after X minutes? This would help a lot.