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>