Chat Modifications - Dion Dev Shoutbox v2.0 (uses AJAX)

Preview:

http://www.diondev.com/vb

Screenshots:

(see attached)

Features:

- Uses AJAX so new shouts show up without the page having to be refreshed
- Set the title and other language features to anything you want
- Will ignore empty shouts, and ones that are being repeated one after the other
- Enter how many shouts you want it to show
- Enter how many days you want it to store shouts in the database (even forever)
- Enable or disable guest shouting
- Members names are linked to their profile pages
- Admins can delete shouts directly through the shoutbox itself
- A fully customizable shout archive with pagination
- Works with any custom theme automatically
- Parses BBcode, smilies, and images if you allow it to
- Installation takes about 5 minutes and is all done through the admin CP
- You can even modify the amount of time it waits in between checking for new shouts
- Plus lots more!

Installation instructions:

1.a) Extract the "ddshoutbox2.zip" file onto your computer using a program like winrar, or winzip

2. Log in to your admin CP, everything will be done within here

3.a) Go to Plugins & Products -> Manage Products
3.b) Click on the "[Add/Import Product]" link
3.c) Browse for the "product-ddsb2.xml" file
3.d) Click on the "Import" button

4. Upload all the ".js" and ".php" files into your main vbulletin directory (the same directory as index.php)

5 Decide where you want the shoutbox on your site (I recommend the top of your forum index)

If you want the shoutbox at the top of your forum index, go to the "FORUMHOME" template, find:
"<!-- / guest welcome message -->
<br />
</if>"
Copy and paste the contents of "template.txt" underneath.

If you want it at the top of every page, go to the "navbar" template, find:
"<!-- / nav buttons bar -->
<br />"
Copy and paste the contents of "template.txt" underneath.

6.a) Go to vBulletin Options -> vBulletin Options
6.b) Select "Dion Dev Shoutbox v2.0 Options"
6.c) Click on the "Edit Settings" button
6.d) Edit all of the values as you desire
6.e) Click on the "Save" button

Additional options:

1. If you want to change the time in which it checks for new shouts, open up "shoutshow.js" with notepad, find "timeint = 2000" at the top of the file, and change "2000" to the time (in milliseconds) you want it to wait before checking for new shouts. 1 second equals 1000 milliseconds. If you want shouts to show up faster, set it to a lower number. If you are worried about server load, set it higher. Don't forget to upload it to your server after you change it so the new timer takes effect.

2. You can edit the shoutbox width and height by changing the iframe width="100%" and height="200" attributes from the "template.txt" file.

You're done! Please donate anything you can spare to donations@diondev.com before removing my copyright notice.

[CFodder]

Originally Posted by DionDev

... Cfodder I checked your site and it seems to be quite slow. This lag could cause a large delay in the AJAX response ...

Slow it could possibly be, but the shouts appear in the archive immediately and I don't think it would be that slow that they still don't appear after 2 days in the main shoutbox area.

[Reycer]

Also, is there any way that we would be able to see the IP's of the Guest Comments?

[DionDev]

Originally Posted by mdelcour

Also, is there any way that we would be able to see the IP's of the Guest Comments?

i'll add it to the next version list.

[Reycer]

um. We discovered today that the shoutbox dosen't recognize characters such as "&" or "$" any reason why?

[DevJw]

Originally Posted by columbonet

Is there an edit I can do to allow mods to delete chatbox posts? We only have 2 admins and don't have time to monitor the chatbox.

I editted shoutshow.php so supermoderators can now also delete shouts.
Find:

PHP Code:

if ($vbulletin->userinfo['permissions']['adminpermissions']) 


New:

PHP Code:

  if ($vbulletin->userinfo['permissions']['adminpermissions'] & $vbulletin->bf_ugp_adminpermissions['ismoderator']) 


Originally Posted by mdelcour

um. We discovered today that the shoutbox dosen't recognize characters such as "&" or "$" any reason why?

I've edited shoutinsert.js and now it works.
At the end of the file:

  var url = 'shoutinsert.php';
  var params = 'body=' + document.getElementById('body').value;

I changed it to:

  var url = 'shoutinsert.php';

  var value = document.getElementById('body').value;
  if (encodeURIComponent) {
    url = encodeURIComponent(value);
  } else {
    url = escape(value);
  }
  
  var params = 'body=' + url;

Note to the creator:
I had to change line 44 in shoutshow.php because it was not showing the time.
Old:

PHP Code:

$shout_time = vbdate($vbulletin->options['ddsb_time'], $row['shout_time']); 


New:

PHP Code:

$shout_time = date($vbulletin->options['ddsb_time'], $row['shout_time']); 


[DionDev]

Originally Posted by DevJw

I editted shoutshow.php so supermoderators can now also delete shouts.
Find:

PHP Code:

if ($vbulletin->userinfo['permissions']['adminpermissions']) 


New:

PHP Code:

  if ($vbulletin->userinfo['permissions']['adminpermissions'] & $vbulletin->bf_ugp_adminpermissions['ismoderator']) 


I've edited shoutinsert.js and now it works.
At the end of the file:

  var url = 'shoutinsert.php';
  var params = 'body=' + document.getElementById('body').value;

I changed it to:

  var url = 'shoutinsert.php';

  var value = document.getElementById('body').value;
  if (encodeURIComponent) {
    url = encodeURIComponent(value);
  } else {
    url = escape(value);
  }
  
  var params = 'body=' + url;

Note to the creator:
I had to change line 44 in shoutshow.php because it was not showing the time.
Old:

PHP Code:

$shout_time = vbdate($vbulletin->options['ddsb_time'], $row['shout_time']); 


New:

PHP Code:

$shout_time = date($vbulletin->options['ddsb_time'], $row['shout_time']); 


Thos are some great fixes! By the way, you should use the vbdate function. It is a vbulletin function which is like the php date() function, but I believe it also shows the date in the time zone the user specified in their profile.

[adiboy.net]

Can the time and date be on the extremely left instead of on the right?

[Chadi]

Can someone please explain how to get this working if I uploaded all the files neatly inside a directory called "shoutbox"? I tried already, modified the files and couldn't get this working

I changed all instances of:

require_once('global.php');

to

require_once('/global.php');

I changed the template code to add /shoutbox/ before the shoutbox.php code, still didn't work.

[DionDev]

Originally Posted by Chadi

Can someone please explain how to get this working if I uploaded all the files neatly inside a directory called "shoutbox"? I tried already, modified the files and couldn't get this working

I changed all instances of:

require_once('global.php');

to

require_once('/global.php');

I changed the template code to add /shoutbox/ before the shoutbox.php code, still didn't work.

It won't work that way because the shoutbox uses paths relative to the main vbulletin directory.

Maybe the next version I release will be in its own folder.

[Milez]

Originally Posted by DionDev

Maybe the next version I release will be in its own folder.

Sweet as soon as this happens I will try this on my big board. Awesome plugin (have tested it) with a very active and dedicated designer - so refreshing! Great work Dion.

Uhm, any time frame on the changes? I can beta test