Shoutbox — Thank you for purchasing & using it.

Install - top

The installation is really easy with the "Shoutbox Installation Wizard"! You have to upload just one file and follow the introductions. Here is an example of an installation with the wizard:

With installer: Create folder

Create an folder on your www-root/webspace called for example "shoutbox":

Then upload the folder "install" (from the directory "shoutbox_with_installer") with the one file inside ("index.php") to the previous created folder:

After that change the file permissions (chmod) of the "index.php" to (0)777:

Now go to the path of your previous created folder and add "install/" after it:

Now the "Shoutbox Installation Wizard" should apper. Follow the introductions of the wizard to install the Shoutbox. After the installation please delete the "install" folder if it still exists.

The installation is really easy with the "Shoutbox Installation Wizard"! You have to upload just one file and follow the introductions. Here is an example of an installation with the wizard:

Without installer

Create an folder on your www-root/webspace called for example "shoutbox":

Then upload the content of the folder "shoutbox" (from the directory "shoutbox_without_installer") inside to the previous created folder.

Afterwards import the file "install-database.sql" into your database.

Now open the file "lib/shoutbox.class.php" and edit there (on the lines 29-40, see customize) the self explaining configuration of your shoutbox and its database settings.

Update - top

You could update the Shoutbox by doing the same like you would install it.

Usage - top

If you want to integrate the shoutbox in any (X)HTM(L)/PHP page you could do that with an iframe. Just copy (and change the "src" attribute) the following code to your wished place on page:

<iframe src="yourdomain.com/shoutbox/" width="96%" height="420" frameborder="0"></iframe>

 

If you want to integrate the shoutbox with a prefilled name value (e.g. the member username) add the following parameter:

<iframe src="yourdomain.com/shoutbox/?name=Username" width="96%" height="420" frameborder="0"></iframe>

Customize - top

If you want to customize the shoutbox after the installation, you could do that in the file "shoutbox.class.php" inside the "lib" folder. In the lines 29 to 40 you could change the settings. Please change just these lines:

private $_options = array(
    'db_server'      => 'localhost',
    'db_charset'     => 'utf8',
    'db_user'        => 'your_db_username',
    'db_password'    => 'your_mysql_passwort',
    'db_name'        => 'db_table_name',
    'db_prefix'      => 'your_prefix_',
    'charset'        => 'utf-8',
    'heading'        => 'YourName - Shoutbox',
    'refresh'        => 2.5,
    'spam_protect'   => 1,
    'enable_bbcode'  => true,
    'enable_smilies' => true
);

Features - top

  • Ajax powered (no page reloads needed!)
  • You have to upload just ONE file to get the shoutbox running/install it.
  • Very easy to integrate into any existing (X)HTML or PHP page on your site
  • Cross browser support (IE7+, Firefox, Safari, Chrome, Opera and more)
  • Yery fast shoutbox
  • Yery small: About 122KB (including jQuery (94KB), JavaScripts, images and all the rest)
  • Magic quotes compatible (for older PHP versions)
  • XSS secure
  • SQL-Injection protected
  • UTF-8 support
  • Shoutbox uses just 1 CSS file (+1 for mobile)
  • Clean PHP5 OOP code (very well commented!)
  • Valid HTML5
  • Mobile support
  • HTTPS support
  • Simple and elegant user interface
  • Smooth transitions
  • SPAM protection
  • Smilie support
  • Really simple installation
  • Uses standard PHP server features

Changelog - top

v1.4 (22 October, 2014)

  • Added: Mobile support
  • Added: Retina support
  • Added: HTTPS support
  • Added: IPv6 support
  • Added: Prepopulate username field over parameter (optional)
  • Updated: Updated code to be compatible with PHP 5.6
  • Updated: Switched to HTML5 (Shoutbox, Documentation, Installer)
  • Updated: Improved overall performance, partially heavy code refactoring
  • Updated: Lossy compression of images (additional performance improvement)
  • Updated: Updated to current jQuery version (additional performance improvement)
  • Updated: Documentation and Installer update
  • Bugfix: Fixed deprecated mysql_* code
  • Bugfix: Reduced error possibility during SQL import
  • Bugfix: Expanded length of IP database field for IPv6
  • Removed: IE6 support

v1.3 (08 July, 2013)

  • Bugfix: Added the Shoutbox without the installer
  • Bugfix: Updated some CSS for latest browser support

v1.2 (18 December, 2011)

  • Added: Support for mobile deviced (e.g. iPhone, Android etc.)
  • Bugfix: 500 server error fixed

v1.1 (05 November, 2009)

  • Bugfix: PHP-Bug: Returned empty name & message
  • Bugfix: Apache 500er
  • Bugfix: Doubble shouting reduced
  • Bugfix: Empty shouting fixed
  • Added: Too long words/lines are seperated in several lines
  • Added: Posibility to disable smilies
  • Added: Login-Button added
  • Feature: BBCode: [b][/b] (bold) added
  • Feature: BBCode: [i][/i] (italic) added
  • Feature: BBCode: [url][/url] (link) added
  • Feature: BBCode: [url=][/url] (link) added

v1.0 (2009)

  • Release of the first version

Sources - top

I've used the following images and javascripts/css: