BlaB! - How to install / upgrade / FAQ

How to install BlaB!

  1. Download BlaB! from the product page and extract the files from the ZIP archive in an empty directory keeping the directory structure. You can use You can use 7-zip, WinZip or any other archive program.
  2. Upload the whole directory (and all files/subdirectories in it) to your server with an FTP program.
  3. CHMOD to 666 the files config.php, errors.txt and CHMOD to 777 the subfolder /paintings. Load BlaB! with your web browser (install pops up) and follow the instructions (3 steps only).
  4. Remove the subfolder /install, go to yoursite.com/blab/ and you should be able to see the login page which indicates that you completed the install successfully.

top

How to upgrade from a previous version

  1. Download the latest version of BlaB!
  2. Unzip the files from the ZIP archive in a new empty directory e.g. /new_chat.
  3. Upload the directory /new_chat (and all files/subdirectories in it) to your server by an FTP program.
  4. Overwrite config.php with your old config.php file
  5. Transfer all files from your old /paintings directory to /new_chat/paintings and CHMOD /new_chat/paintings to 777.
  6. Go to /new_chat » ACP » Settings » Update DB and update your database entries if necessary.
  7. Go to /new_chat » ACP » Settings and make sure that your default language is set properly.
  8. Remove or rename the directory /install
  9. Make sure that your new chat is working properly, remove the old chat directory and rename /new_chat to whatever you wish.

top

BlaB! License Agreement

By downloading and using BlaB!, you indicate your acceptance of the following terms and conditions:

  1. You may not rent, sub-license, sell or redistribute this software.
  2. The source code may be altered (at your own risk!), but the altered code may not be distributed.
  3. You are allowed to remove the line 'Powered by BlaB!' if you place a visible link to our site on your front page.
  4. If any terms are violated, we reserve the right to terminate this license at any time.

DISCLAIMER OF WARRANTY

THIS SOFTWARE AND THE ACCOMPANYING FILES ARE PROVIDED 'AS IS' AND WITHOUT WARRANTIES OF ANY KIND!

top

How to translate in another language

The language files reside in the subfolder /lang. You need a text editor that supports UTF-8 encoding without BOM e.g. Notepad++ for Windows, gedit for Linux. You have to translate english.utf8 and save it as patagonian.utf8 presuming that the language you want to translate in is Patagonian. Remember to save the file as UTF-8: Encoding » UTF-8 without BOM Finally, you have to register patagonian.utf8 in lang/languages.inc

<?php
// language abbreviation
$lang_abbr=array();
$lang_abbr[]='en';
$lang_abbr[]='pg';
$lang_abbr[]='...';

$lang_names=array();
$lang_names[]='English';
$lang_names[]='Patagonian';
$lang_names[]='...';

$lang_files=array();
$lang_files[]='english.utf8';
$lang_files[]='patagonian.utf8';
$lang_files[]='...';
?>

top

Running BlaB! in an iframe from another domain

With the default MSIE settings you cannot run BlaB! in a frame/iframe if the domain name in the address bar of the browser is different from the one of the frame/iframe, which is because MSIE does not accept 3rd-party cookies. There is a quick fix for this. Put in incl/main.inc (where headers are sent) an additional line:

if(!headers_sent()){

// add the next line here...
header('P3P:CP="IDC DSP COR ADM DEVi TAIi PSA PSD IVAi IVDi CONi HIS OUR IND CNT"');

header("Expires: Mon, 26 Jul 1997 05:00:00 GMT");
header("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
header("Cache-Control: no-store, no-cache, must-revalidate");
header("Content-type: text/html; charset=UTF-8");}

More about the weird header above

top

How do I reset the ACP key?

You have a file in the main BlaB! directory: _reset_acp.txt. Rename this file via FTP to anything.php, load it with your browser and follow the instructions. After resetting the ACP key, rename the file back to anything.txt. Once you are in, you can replace the automatically generated ACP key from ACP » SETTINGS » ACP KEY.

top

Can I add or replace emoticons?

Yes but it's not easy. The list of emoticons can be found in ui/emocodes.php. There are no image files, all emoticons in SVG format are base64 encoded entries in ui/emoticons.css.

top

Can I add or replace stickers?

Yes, easily. Put your stickers in JPG/PNG/GIF/SVG format in the directory ui/stickers. The image files will be scaled automatically when posted. It is recommended to use SVG images with 2:1 aspect ratio.

top

Alternative sound notifications

Download this sound pack, unzip it in an empty folder and load preview.html with your browser to choose sounds. Under /ui/sounds/ you have 18 files (9 .mp3 files and 9 .ogg files) which you can replace with ones from from the sound package. Remember to rename the files you picked: 1.mp3 & 1.ogg, 2.mp3 & 2.ogg, 3.mp3 & 3.ogg ... 9.mp3 & 9.ogg. (Most browsers can play mp3, the rest - .ogg)

top

How do I filter bad words?

Your bad words list is set as an array in config.php. The entries are case insensitive:

$bwords=array('word1','word2'); // Bad words array. $bwords=0; == off. Turn it off to save CPU resources.

If you are using non-latin letters remember to save the file as UTF-8 without BOM (signature).

top

How to display a list of the online users

We provide a PHP file that can be loaded as an external JavaScript file if you would like to display a list of the online chatters anywhere on your site. The file can be called from any HTML or PHP page with the following syntax:

<!-- displays the number of the chatters online / outputs document.write(3): -->
<script type="text/javascript" src="blab/online.php"></script>
<!-- displays a list of the chatters online / outputs Peter, John, Monica: -->
<script type="text/javascript" src="blab/online.php?mode=1"></script>
<!-- displays a clickable number of the chatters online. When clicking on the number displays a list of the chatters online: -->
<script type="text/javascript" src="blab/online.php?mode=2"></script>

top

Remote File Inclusion Vulnerability

http://www.hack0wn.com/view.php?xroot=1528.0&cat=exploits
http://www.exploit-db.com/exploits/12591

This so-called exploit does NOT work. The author has never tested it. The mentioned variable $skin_dir is defined in config.php.

top

How to enable or disable native emoji

IOS, Android - not fully supported on desktop browsers

Make a backup of your database! You have two files in the main BlaB! directory: _enable_emoji.txt and _disable_emoji.txt. Depending on what you want to do, rename one of the files via FTP to anything.php, load it with your browser and follow the instructions. You'll have to change (or add if upgraded from version prior to 8.2) a setting in config.php - instructions are provided. When done delete the file or rename it back to enable|disable_emoji.txt.

top

How to CHMOD files/folders

CHMOD = CHange MODe

CHMOD means to change permissions or "attributes" of a file or folder on a Linux/Unix based system. This can be done with an FTP program of your choice e.g. Filezilla, you simply need to right-click on a file or folder and select File permissions.

top

How to create a new database

top


Page updated: 2017-11-01