Subversion Repositories svnkaklik

Rev

Details | Last modification | View Log

Rev Author Line No. Line
6 kaklik 1 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2 
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
3 
<head><meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
4 
<title>BlaB! Lite README</title>
5 
<style type="text/css">
6 
body{font-family:Verdana,sans-serif;font-size:11px;color:#000000;background-color:#ffffff}
7 
pre{font-family:"Courier New",monospace;font-size:11px}
8 
ul{font-family:Verdana,sans-serif;font-size:11px}
9 
ol{font-family:Verdana,sans-serif;font-size:11px}
10 
A:link{color:blue;background-color:#ffffff}
11 
A:visited{color:blue;background-color:#ffffff}
12 
A:hover{color:red;background-color:#ffffff}
13 
A:active{color:red;background-color:#ffffff}
14 
.l{font-size:10px}
15 
.k{color:#cccccc;background-color:#bbbbbb}
16 
.m{color:#333333;background-color:#ffffff}
17 
.n{color:#ff0000;background-color:#ffffff}
18 
</style></head><body>
19 
 
20 
<a name="0"></a>
21 
<h2>BlaB! Lite 2.x README</h2>
22 
Homepage: <a href="http://hot-things.net" target="_blank">http://hot-things.net</a>
23 
<ul>
24 
<li><a href="#a">Description and features</a></li>
25 
<li><a href="#b"><b>License</b></a><br /><br /></li>
26 
<li><a href="#1">How to install BlaB! Lite 2.x</a></li>
27 
<li><a href="#2">Settings, security issues, possible problems</a><br /><br /></li>
28 
<li><a href="#3">How to create a skin</a></li>
29 
<li><a href="#4">How to create a language file in another language</a></li>
30 
</ul><hr size="1" class="k" />
31 
 
32 
<br /><a name="a"></a>
33 
<h3>Description and features</h3>
34 
BlaB! Lite 2.x (formerly <a href="http://hot-things.net/htschat.php" target="_blank">Simple Chat</a>) is a chat system written in PHP and JavaScript.
35 
The output produced by BlaB! Lite 2.x is very clean, XHTML1.1 compliant (except both frameset files: index.php and frameset.php due to some browser limitations)
36 
and also looks fine with any modern browser that supports HTML4 and JavaScript.
37 
<h4>Features</h4><ul>
38 
<li>Fast processing, extremely low bandwidth required</li>
39 
<li>Easy to install. No MySQL database required</li>
40 
<li>XHTML 1.1 and CSS2 compliant output</li>
41 
<li>PHP3/PHP4/PHP5 compatibility (supports <i>safe mode, error_reporting(8), register_globals:off</i>)</li>
42 
<li>Best viewed with any modern browser (Netscape4 is not supported due to some CSS limitations)</li>
43 
<li>Advanced skinning system</li>
44 
<li>Smilies, bb codes, 'http' links, unrecognizable 'mailto' links</li>
45 
<li>Sound alert on new messages</li>
46 
<li>Custom date/time settings</li>
47 
</ul><a href="#0">top</a><hr size="1" class="k" />
48 
 
49 
<br /><a name="b"></a>
50 
<div style="color:#A00000">
51 
<i>BlaB! Lite 2.x is <b>NOT</b> a GPL product - please read carefully the following lines!</i> <br />
52 
<h4>BlaB! Lite 2.x LICENSE AGREEMENT</h4>
53 
By downloading and using BlaB! Lite 2.x, you indicate your acceptance of the following terms and conditions:<br />
54 
<br />&nbsp; - You are granted the right to run multiple instances of this software free of charge.
55 
<br />&nbsp; - You may not rent, sub-license, sell or redistribute this software without our prior written permission.
56 
<br />&nbsp; - You may not remove or modify our copyright marks without our prior written permission.
57 
<br />&nbsp; - The source code may be altered (at your own risk!), but the altered code may not be distributed without our prior written permission.
58 
<br />&nbsp; - If any terms are violated, we reserve the right to terminate this license at any time.
59 
<br /><br /><b>DISCLAIMER OF WARRANTY</b><br /><br />
60 
THIS SOFTWARE AND THE ACCOMPANYING FILES ARE PROVIDED 'AS IS' AND WITHOUT WARRANTIES OF ANY KIND!
61 
</div><br /><a href="#0">top</a><hr size="1" class="k" />
62 
 
63 
<br /><a name="1"></a>
64 
<h3>How to install BlaB! Lite 2.x</h3><ol>
65 
<li>Unzip the files from the ZIP archive in an empty directory keeping the directory structure</li>
66 
<li>Upload the whole directory (and all files/subdirectories in it) to your server by an FTP program</li>
67 
<li>CHMOD the subdirectory <b>/data</b> to 777
68 
<div class="l"><br />------------------------------<br /><br />CHMOD means to change permissions/attributes of a file or a directory on a Linux/Unix system, usually by an FTP program.<br />   If you are running a Windows server you should make the subdirectory <b>/data</b> readable/writeable (in most cases from the admin panel).<br /><br />------------------------------</div><br /></li>
69 
<li>Open a browser and enter the admin panel to setup your ADMIN password: <a href="#" onclick="return false">http://yoursite.com/blab/admin.php</a></li>
70 
</ol>
71 
<a href="#0">top</a><hr size="1" class="k" />
72 
 
73 
<br /><a name="2"></a>
74 
<h3>Settings, security issues, possible problems</h3>
75 
There is a number of well commented settings in <i>config.php</i>. Please, consider carefully what you are changing.
76 
BlaB! Lite 2.x is set to work in a developer mode: <i>error_reporting(8)</i>, which displays php error messages and notices if any.
77 
Remove the line <i>error_reporting(8);</i> from <i>config.php</i> when you have done with the settings.
78 
<br /><br />With PHP3 and some earlier PHP4.0x versions you may experience PHP errors when running the script for the first time.
79 
CHMOD both files <i>data/room</i> and <i>data/user</i> to 777.
80 
<br /><br />The file <i>online.php</i> can be loaded in an <i>iframe</i> window if you would like to display <i>OnlineUsers/ActivityTime</i> anywhere on your site.
81 
<br /><br />There are two files in your skin directory: 'custom-left.inc' and 'custom-right.inc' that contain ordinary HTML tags for a logo and a title. They are provided for BlaB! users who would like to display a company logo, banners or just a site navigation bar.
82 
<br /><br />Running BlaB! Lite 2.x on Apache server is secure. Make sure that the folder <b>/data</b> contains a .htaccess file against http access.
83 
Try to load:<pre>
84 
<a href="#" onclick="return false">http://<i>www.yoursite.com</i>/blab/data/room</a>
85 
<a href="#" onclick="return false">http://<i>www.yoursite.com</i>/blab/data/user</a>
86 
</pre>
87 
You should get a 403 answer: <span style="color:#A00000">Forbidden You don't have permission to access <i>FILE</i> on this server.</span>
88 
<br /><br />If you want to run BlaB! Lite 2.x on any other server, you need to rename the folder <i>/data</i> and also change its name in <i>config.php</i> accordingly.
89 
<br /><br />Sometime, you may experience a disk error that might damage files under the subdirectory <b>/data</b> (running out of space would have the same effect).
90 
We suggest you to empty the damaged room from the admin panel.
91 
<br /><br /><a href="#0">top</a><hr size="1" class="k" />
92 
 
93 
<br /><a name="3"></a>
94 
<h3>How to create a skin</h3>
95 
If you are good at graphics and enjoy some CSS experience, you may create nice BlaB! skins in minutes.
96 
<br />Please check our online tutorial at: <a href="http://hot-things.net/skin_howto/" target="_blank">http://hot-things.net/skin_howto/</a>.
97 
<br /><br /><a href="#0">top</a><hr size="1" class="k" />
98 
 
99 
<br /><a name="4"></a>
100 
<h3>How to create a language file in another language</h3>
101 
The language files are simple ASCII text files - <i>lang-en.inc</i>, <i>lang-bg.inc</i> etc.
102 
Create your own file or/and tell BlaB! Lite which one to load: (<i>config.php</i>).
103 
If you are about to use a non-English alphabet, we recommend you to set the right encoding in your language file: (lang-xx.inc file, line #6 and #7).
104 
This will decrease the loading time and prevent some browsers from displaying incorrect letters.<br />
105 
<br />examples:<br />
106 
<br /><b>$lang[1]='ISO-8859-1';</b> &nbsp; <i>ISO-8859-1</i> is the proper charset for English.
107 
<br /><b>$lang[2]='en';</b> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <i>en</i> is a 2-letters language code.
108 
<br />
109 
<br /><b>$lang[1]='euc-jp';</b> &nbsp; <i>euc-jp</i> is the proper charset for Japanese.
110 
<br /><b>$lang[2]='jp';</b> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <i>jp</i> is a 2-letters language code.
111 
<br /><br /><a href="#0">top</a><hr size="1" class="k" />
112 
</body></html>