1 rizwank 1.1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html">
5 <meta http-equiv="Content-Style-Type" content="text/css">
6 <title>phpBB 2.0.4 :: Readme</title>
7 <link rel="stylesheet" href="../templates/subSilver/subSilver.css" type="text/css" />
8 <style type="text/css">
9 <!--
10 p,ul,td {font-size:10pt;}
11 .h2 {font-size:15pt;font-weight:bold;color:red}
12 .h3 {font-size:12pt;color:blue}
13 //-->
14 </style>
15 </head>
16 <body bgcolor="#E5E5E5" text="#000000" link="#006699" vlink="#006699">
17
18 <table width="100%" border="0" cellspacing="0" cellpadding="10" align="center">
19 <tr>
20 <td class="bodyline"><table width="100%" border="0" cellspacing="0" cellpadding="0">
21 <tr>
22 rizwank 1.1 <td>
23
24 <table width="100%" border="0" cellspacing="0" cellpadding="0">
25 <tr>
26 <td><img src="../templates/subSilver/images/logo_phpBB.gif" border="0" alt="phpBB 2 : Creating Communities" vspace="1" /></a></td>
27 <td align="center" width="100%" valign="middle"><span class="maintitle">phpBB 2.0.4 README</span></td>
28 </tr>
29 </table>
30
31 <!-- BEGIN DOCUMENT -->
32 <p>Thank you for downloading phpBB 2, the long awaited re-write of the popular phpBB 1.x online community forum. This README will guide through the basics of installation and operation of phpBB 2. Please ensure you read this and the accompanying documentation fully <b>before</b> proceeding with the installation.</p>
33
34 <ol>
35 <li><a href="#install">Installing phpBB 2</a></li>
36 <li><a href="#run">Running phpBB 2</a></li>
37 <ol type="i">
38 <li><a href="#i18n">Internationalisation (i18n)</a></li>
39 <li><a href="#styles">Styles</a></li>
40 <li><a href="#mods">Mods</a></li>
41 </ol>
42 <li><a href="#help">Getting help with phpBB 2</a></li>
43 rizwank 1.1 <ol type="i">
44 <li><a href="#userguide">Userguide</a></li>
45 <li><a href="#website">Community Forums</a></li>
46 <li><a href="#irc">Internet Relay Chat</a></li>
47 </ol>
48 <li><a href="#status">Status of this version</a></li>
49 <li><a href="#bugs">Reporting Bugs</a></li>
50 <ol>
51 <li><a href="#securitybugs">Security related bugs</a></li>
52 </ol>
53 <li><a href="#curbugs">Overview of current bug list</a></li>
54 <li><a href="#php">PHP compatibility issues</a></li>
55 <ol type="i">
56 <li><a href="#phpsec">Notice on PHP security issues</a></li>
57 </ol>
58 <li><a href="#disclaimer">Disclaimer</a></li>
59 </ol>
60
61 <a name="install"></a><h2 class="h2"><u>1. Installing phpBB 2</u></h2>
62
63 <p>Installation and upgrade instructions can be found in the <a href="INSTALL.html">INSTALL</a> document contained in this distribution. If you are intending to upgrade from a previous phpBB 1.4.x installation we highly recommend you backup any existing data before proceeding!</p>
64 rizwank 1.1
65 <p><b>Please note</b> that users of Release Candidate (RC) versions of phpBB 2 should run the update_to_204.php script <b>BEFORE</b> attempting to access your board. Failing to do so may result in errors and unexpected behaviour! While these won't do any damage they will prevent you using your board.</p>
66
67 <p>If you are using RC-1 (pre) you may find some other DB changes have occured and should examine the schemas to see if your installation requires any modifications (note that most of these have already been discussed on the phpBB 2 forums and are handled by the update script). If you are uncomfortable doing any of this we recommend you re-install (you may backup your existing data if you wish, re-install phpBB 2 and then insert your backup).</p>
68
69 <p>Users of phpBB 2.0 Beta-1 cannot directly upgrade to phpBB 2.0 RC-2, 3 or 4, sorry.</p>
70
71 <a name="run"></a><h2 class="h2"><u>2. Running phpBB 2</u></h2>
72
73 <p>Once installed phpBB 2.0 is easily managed by both admin and moderator control panels. If you need help or advice with phpBB 2 please see <a href="#help">Section 3</a> below.</p>
74
75 <a name="i18n"></a><h3 class="h3">2.i. Internationalisation, i18n</h3>
76
77 <p>A number of language packs and subSilver localisations are now available. You can find them on our official download page:</p>
78
79 <p><a href="http://www.phpbb.com/downloads.php#lang" target="_new">http://www.phpbb.com/downloads.php</a></p>
80
81 <p>This is the <i>Official</i> location for all support language sets. If you download a package from a 3rd party site you do so with the understanding that we cannot offer support. So please, do not ask for help in these cases!</p>
82
83 <p>Installation of these packages is straightforward, simply download the required language pack and unarchive it into the languages/ folder. Please ensure you retain the directory structure when doing this! To install the subSilver image packs you should unarchive the file/s into the templates/subSilver/images directory, again you must retain the directory structure. Once installed the languages will become immediately available.</p>
84
85 rizwank 1.1 <p>If your language is not available please visit our forums where you will find a topic listing translations currently available or in preparation. This topic also gives you information should you wish to volunteer to translate a language not currently listed</p>
86
87 <p><b>Please note</b> that users who have upgraded to 2.0.4 from versions prior to RC-3 should will <b>need</b> to download new versions of the language/subSilver image packs. Any package downloaded prior to the availability of RC-3 will <b>not</b> function correctly with this version of phpBB 2.</p>
88
89 <p>If you have upgraded from 2.0.0 and make use of non-English language packs you will benefit from downloading updated versions which will become available shortly. These introduce a number of strings which went missing from the first version plus a few updates and additions.</p>
90
91 <a name="styles"></a><h3 class="h3">2.ii. Styles</h3>
92
93 <p>Although phpBB Group are rather proud of the subSilver style (which has influenced many of our competitors boards <i>updated</i> designs!) we realise that it may not be to everyones tastes. Therefore phpBB 2 allows styles to be switched with relative ease. Firstly you need to locate and download a style you like. We maintain such a site at</p>
94
95 <p><a href="http://www.phpbb.com/styles/" target="_new">http://www.phpbb.com/styles/</a></p>
96
97 <p><b>Please note</b> that 3rd party styles downloaded for versions of phpBB 2 prior to its final (2.0.x) release will <b>not</b> function correctly. You should either remove these styles or (if available) update them to meet changes in 2.0.x.</p>
98
99 <p>Once you have downloaded a style the usual next step is to unarchive (or upload the unarchived contents of) the package into your templates/ directory. You then need to visit Administration -> Styles -> Add, you should see the new style available, click add and it will become available for all your users.</p>
100
101 <a name="mods"></a><h3 class="h3">2.iii. Mods</h3>
102
103 <p>Although not officially supported by phpBB Group, phpBB 2 has a thriving mod (formerly known as <i>hacks</i>) scene. These third party modifications to the standard phpBB 2 extend its capabilities still further and can be found at:</p>
104
105 <p><a href="http://www.phpbb.com/mods" target="_new">http://www.phpbb.com/mods</a></p>
106 rizwank 1.1
107 <p><b>Please remember</b> that any bugs or other issues that occur after you have added any modification should <b>NOT</b> be reported to the bug tracker (see below). First remove the modification and see if the problem is resolved.</p>
108
109 <p>Also remember that any modifications which modify the database in any way may render upgrading your forum to future versions more difficult unless we state otherwise. With all this said many users have and continue to utilise many of the mods already available with great success</p>
110
111 <a name="help"></a><h2 class="h2"><u>3. Getting help with phpBB 2</u></h2>
112
113 <p>phpBB 2 can seem a little daunting to new users in places, particularly with regard the permission system. The first thing you should do is check the <a href="FAQ.html">FAQ</a> which covers a few basic getting started questions. If you need additional help there are several places you should look.</p>
114
115 <a name="userguide"></a><h3 class="h3">3.i. phpBB 2 Userguide</h3>
116
117 <p>A comprehensive userguide is now available online and can be accessed from the following location:</p>
118
119 <p><a href="http://www.phpbb.com/guide/phpBB_Users_Guide.html" target="_new">http://www.phpbb.com/guide/phpBB_Users_Guide.html</a></p>
120
121 <p>This covers everything from installation through setting permissions and managing users.</p>
122
123 <a name="website"></a><h3 class="h3">3.ii. Community Forums</h3>
124
125 <p>phpBB Group maintains a thriving community where a number of people have generously decided to donate their time to help support users. This site can be found at:</p>
126
127 rizwank 1.1 <p><a href="http://www.phpbb.com/" target="_new">http://www.phpbb.com/</a></p>
128
129 <p>If you do seek help via our forums please be sure to do a Search before posting. This may well save both you and us time and allow the developer, moderator and support groups to spend more time responding to people with unknown issues and problems. Please also remember that phpBB is an entirely volunteer effort, no one receives any compensation for the time they give, this includes moderators as well as developers. So please be respectful and mindful when awaiting responses.</p>
130
131 <a name="irc"></a><h3 class="h3">3.iii Internet Relay Chat</h3>
132
133 <p>Another place you may find help is our IRC channel. This operates on the Openprojects IRC network, <b>irc.openprojects.net</b> and the channel is <b>#phpbb</b> and can be accessed by any good IRC client such as mIRC, XChat, etc. Again, please do not abuse this service and be respectful of other users.</p>
134
135 <a name="status"></a><h2 class="h2"><u>4. Status of this version</u></h2>
136
137 <p>This is the second stable release of phpBB 2. The 2.0.x line is essentially feature frozen, point releases will see only bugs and such like fixed. Our next major release will be phpBB 2.2 and work is progressing on this (the unstable development version is 2.1). Please do not post questions asking when 2.2 will be available, no release date has been set. Feel free to suggest new features for phpBB 2.2, we already have a number of improvements in mind and these can be viewed using our task tracker:</p>
138
139 <p><a href="http://sourceforge.net/pm/task.php?group_project_id=13524&group_id=7885&func=browse" target="_new">http://sourceforge.net/pm/task.php?group_project_id=13524&group_id=7885</a></p>
140
141 <p>We do not guarantee that all these will appear in 2.2 but we will do our best! If your idea does not appear on this list please visit our feature request list:</p>
142
143 <p><a href="http://sourceforge.net/tracker/?atid=357885&group_id=7885&func=browse" target="_new">http://sourceforge.net/tracker/?atid=357885&group_id=7885</a></p>
144
145 <p>Before submitting your idea please <b>ensure</b> you have read through the entries in that list. If your idea is similar to an existing one please feel free to add a comment to it. Please <b>do not</b> submit duplicate suggestions!</p>
146
147 <p>For some suggestions we may ask for your feedback via our forums. For those interested in the development of phpBB 2.2 you should keep an eye on the community forums (particularly the Feature Discussion forum) where you may be able to influence the direction we take with certain new features. Finally you may like to visit our development forum to see how things are progressing:</p>
148 rizwank 1.1
149 <p><a href="http://area51.phpbb.com/phpBB 2/" target="_new">http://area51.phpbb.com/phpBB 2/</a></p>
150
151 <p>Please note that this forum should <b>NOT</b> be used to obtain support for or ask questions about phpBB 2.0.x, the main community forums are the place for this. Any such posts will be locked and go unanswered.</p>
152
153 <a name="bugs"></a><h2 class="h2"><u>5. Reporting Bugs</u></h2>
154
155 <p>The phpBB Group uses a bug tracking system to store, list and manage all reported bugs, it can be found at the location listed below. Please <b>DO NOT</b> post bug reports to our forums, they will be locked. In addition please <b>DO NOT</b> use the bug tracker for support requests. Posting such a request will only see you directed to the support forums (while taking time away from working on real bugs).</p>
156
157 <p><a href="http://www.phpbb.com/bugs/" target="_new">http://www.phpbb.com/bugs/</a></p>
158
159 <p>While we very much appreciate receiving bug reports (the more reports the more stable phpBB 2 will be) we ask you carry out a few steps before adding new entries:</p>
160 <ul>
161 <li>Firstly determine if your bug is reproduceable, how to determine this depends on the bug in question. Only if the bug is reproduceable is it likely to be a problem with phpBB 2.0 (or in some way connected). If something cannot be reproduced it may turn out to have been your hosting provider working on something, a user doing something silly, etc. Bug reports for non-reproduceable events can slow down our attempts to fix real, reproduceable issues<br /><br /></li>
162 <li>Next please read or search through the existing bug reports (remember to check open <b>AND</b> closed reports!) to see if <i>your</i> bug (or one very similar to it) is already listed. If it is please add to that existing bug rather than creating a new duplicate entry (all this does is slow us down).<br /><br /></li>
163 <li>Check the forums (use search!) to see if people have discussed anything that sounds similar to what you are seeing. However, as noted above please <b>DO NOT</b> post your particular bug to the forum unless it's non-reproduceable or you are sure it's related to something you have done rather phpBB 2.0<br /><br /></li>
164 <li>If no existing bug exists then please feel free to add it</li>
165 </ul>
166
167 <p>If you do post a new bug (i.e. one that isn't already listed in the bug tracker) firstly make sure you have logged in (your username and password are the same as for the community forums) then please include the following details:</p>
168 <ul>
169 rizwank 1.1 <li>Your server type/version, eg. Apache 1.2.22, IIS 4, Sambar, etc.</li>
170 <li>PHP version and mode of operation, eg. PHP 4.1.1 as a module, PHP 4.0.1 running as CGI, etc.</li>
171 <li>DB type/version, eg. MySQL 3.23.32, PostgreSQL 7.1.2, MSSQL Server 2000 SP1, etc.</li>
172 </ul>
173
174 <p>Please also be as detailed as you can in your report, if possible list the steps required to duplicate the problem. If you have a fix which you are <b>VERY SURE</b> works (and is consistent with our coding guidelines) and does not introduce further problems or incompatibilities please let us know. However only include it in the bug report if you really must, if we need it we'll ask you for it.</p>
175
176 <p>Once a bug has been submitted you will be emailed any follow up comments added to it. <b>Please</b> if you are requested to supply additional information, <b>do so</b>! It is <u>extremely frustrating</u> for us to receive bug reports, ask for additional information but get nothing. In these cases we have a policy of <u>closing the bug</u>, which may leave a very real problem in place. Obviously we would rather not have this situation arise.</p>
177
178 <a name="securitybugs"></a><h3 class="h3">5.i. Security related bugs</h3>
179
180 <p>If you find a potential security related vulnerability in phpBB 2 please <b>DO NOT</b> post it to the bug tracker, public forums, mailing lists, etc.! Doing so may allow unscrupulous users to take advantage of it before we have time to put a fix in place. All security related bugs should be sent directly to one or more of the developers.</p>
181
182 <p>This can be done in one of three ways; email <a href="mailto:security@phpbb.com">security@phpbb.com</a> this is forwarded to all developers, PM one of the developers (see Developer usergroup list for usernames of all developers) or email them directly (either use their listed email address if available or username@phpbb.com where username is their board username). If emailing or PM'ing developers individually please send the message to several and not just one. If you obtain no response in a reasonable timeframe (a day or two) try the other listed developers.</p>
183
184 <a name="curbugs"></a><h2 class="h2"><u>6. Overview of current bug list</u></h2>
185
186 <p>This list is not complete (see above link for full list) but does represent those bugs which may effect users on a wider scale. Other bugs listed in the tracker have typically been shown to be limited to certain setups or methods of installation/upgrade.</p>
187
188 <ul>
189 <li>First four characters of some posted content disappears - this is an issue with PHP not phpBB</li>
190 rizwank 1.1 <li>Cannot post very large messages when using PostgreSQL 7.0.x (limitation of Postgresql 7.0.x)</li>
191 <li>By default cannot post very large messages with MSSQL (this can be configured within MSSQL)</li>
192 <li>Use of non-latin charsets with MSSQL may result in post data being cropped unexpectedly</li>
193 <li>Upgrade may fail to complete on large boards under some hosts</li>
194 <li>PHP 3 compatibility issues remain and we recommend you upgrade to PHP4 as soon as possible ( phpBB 2.0.x will be the last version to support PHP 3 )
195 </ul>
196
197 <a name="php"></a><h2 class="h2"><u>7. PHP compatibility issues</u></h2>
198
199 <p>Please remember that running any application on a developmental version of PHP can lead to strange/unexpected results which may appear to be bugs in the application (which may not be true). Therefore we recommend you upgrade to the newest stable version of PHP before running phpBB 2. If you are running a developmental version of PHP please check any bugs you find on a system running a stable release before submitting.</p>
200
201 <p>This board has been developed and tested under Linux and Windows (amongst others) running IIS and Apache using MySQL 3.23 and 4.0.0, MSSQL Server 2000, MS Access 2000 and XP and PostgreSQL 7.x. Versions of PHP used range from 4.0.6 to 4.2.3 without problem. There may be unconfirmed issues with PHP 4.0.1 including patch level releases. If you experience problems with phpBB and have this PHP version installed it is recommended you upgrade it before posting bug reports.</p>
202
203 <a name="phpsec"></a><h3 class="h3">7.i. Notice on PHP security issues</h3>
204
205 <p>At the end of February 2002 a <a href="http://security.e-matters.de/advisories/012002.html" target="_new">major security issue</a> was found with PHP 3 and 4 which has resulted in many hosting providers disabling file uploads (although patches fixing the security issues are available and new versions of PHP 4 have been released).</p>
206
207 <p>Because of this, and to cope with situations where hosts didn't allow such uploads anyway we have implemented various checks in phpBB 2. These checks prevent you from enabling or making use of functions which will not operate correctly on PHP as installed on your server. At this time this includes locally uploaded avatars and DB restore.</p>
208
209 <p>Third party mods may also be effected but these are outside our control, you should contact the mod writer for more information.</p>
210
211 rizwank 1.1 <a name="disclaimer"></a><h2 class="h2"><u>8. Copyright and disclaimer</u></h2>
212
213 <p>This application is opensource software released under the <a href="http://www.gnu.org/licenses/gpl.html" target="_new">GPL</a>. Please see source code and the Docs directory for more details. This package and its contents are Copyright © 2002 <a href="http://www.phpbb.com/" target="_new">phpBB Group</a>, All Rights Reserved.</p>
214 <!-- END DOCUMENT -->
215
216 </td>
217 </tr>
218 </table></td>
219 </tr>
220 </table>
221
222 </body>
223 </html>
|
Return to
README.html
CVS log
Up to [RizwankCVS] / geekymedia_web / phpBB2 / docs