From c40c9a14a29022754f4e2ffea64deba7cc2c8db4 Mon Sep 17 00:00:00 2001 From: "Paul S. Owen" Date: Mon, 24 Dec 2001 21:42:40 +0000 Subject: First draft of RC_1 docs git-svn-id: file:///svn/phpbb/trunk@1717 89ea8834-ac86-4346-8a33-228a782c2dd0 --- phpBB/docs/FAQ_RC1 | 53 ++++++++++++++++++++++ phpBB/docs/INSTALL_RC1 | 40 ++++++++++++++++ phpBB/docs/README_RC-1 | 121 +++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 214 insertions(+) create mode 100644 phpBB/docs/FAQ_RC1 create mode 100644 phpBB/docs/INSTALL_RC1 create mode 100644 phpBB/docs/README_RC-1 diff --git a/phpBB/docs/FAQ_RC1 b/phpBB/docs/FAQ_RC1 new file mode 100644 index 0000000000..8f1b42a490 --- /dev/null +++ b/phpBB/docs/FAQ_RC1 @@ -0,0 +1,53 @@ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +phpBB 2.0 RC-1 release : 24th December 2001 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + + +Some basic configuration instructions: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +phpBB 2.0 features a fairly intuitive configuration interface however there are some issues that may cause you to scratch your head, this mini-FAQ should address most of these! + + +* How do I use the avatar settings? + +There are three types of avatar; upload, remote and local. Upload types require you to create a directory (the default is images/avatars) and to set this to public read/write (ie. chmod a+rw), users can then upload avatars (subject to width, height and size limits definable by you). Remote avatars allow the user to supply a URI pointing to an image available on the internet, PLEASE NOTE that size limits do not apply to remote avatars! Local avatars allow you to upload your own avatars to a set directory, users can then pick from this avatar gallery. The default location for this is images/avatars/gallery. PLEASE NOTE that avatars are categorised according to sub-folders in this location! ie. you MUST place your avatars in subdirectories, eg. images/avatars/gallery/cartoons, images/avatars/gallery/real-life, etc. + + +* How do I set forum permissions + +You set forum permissions from the administration control panel->Forums->Permissions. This system has two modes of operation; Simple and Advanced. Simple uses a set of pre-defined authorisation levels, these set each type of authorisation setting to a specific level. Advanced settings allow you to specify individual levels for each operation in each forum. Experiment! + + +* How do I set user and group permissions + +These are set from Admin->Users (Groups)->Permissions. The system may appear strange but it's very powerful. When you look up a user or group it will give you basic information (at the top of the page) followed by the available forum listing and current settings for this user. You can assign moderator status to users and groups and if you have PRIVATE forums (or forums with any of their individual operations set to PRIVATE) you can also assign access. + + +* How do I set a user (group) as moderator? + +See above + + +* Why are there no entries in the user (group) permission "Allow Access" column? + +You can only allow (or deny) users access to PRIVATE forums, or forums which have one or more operations set to PRIVATE + + +* My users are complaining about being logged out too quickly! + +You can increase the default length of sessions (ie. how long before a users session is considered 'dead') in Admin->General->Configuration->Cookie Settings->Session Length. Set it to whatever value your users feel comfortable with, remember that security issues may affect your decision (ie. having too long a session may allow non-users to abuse your board should a user forget to logout or otherwise leave a current session on a public workstation). + + +* Why are their so many entries under Guests? + +If your users are behind a proxy that switches IP's quickly without forwarding them you may find lots of entries like this. Don't worry about it too much. + + +* My question isn't answered here! + +Feel free to search our test boards for the information you require. PLEASE DO NOT post your question without having first used search, chances are someone has already asked and answered your question. You can find our board here: + +http://phpbb.sourceforge.net/phpBB2/ + +Good luck and thanks for using phpBB 2.0 : phpBB Group 2001 diff --git a/phpBB/docs/INSTALL_RC1 b/phpBB/docs/INSTALL_RC1 new file mode 100644 index 0000000000..60d1c40a07 --- /dev/null +++ b/phpBB/docs/INSTALL_RC1 @@ -0,0 +1,40 @@ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +phpBB 2.0 RC-1 release : 24th December 2001 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Please note these instructions are by no means complete! If you are using this software it is assumed you are somewhat comfortable with uploading files, running scripts, etc. If you are not we recommend you wait till a more complete userguide is available (and phpBB 2.0 is declared final!). + + +New Installations: +~~~~~~~~~~~~~~~~~~ + +Installation of phpBB 2.0 RC-1 will vary according to your server and database. In most cases all you need to do is unarchive the the file you downloaded (using whichever application is applicable, eg. Winzip, tar, WinRAR, etc.), upload all the resulting files to an appropriate directory on your webserver and point your browser to this location. Everything from this point is fully automated. + +You should enter the data asked for (check with your hosting provider if you are unsure as to the values of the first two sections) and click submit. The installation script will create and populate all the necessary tables. It will then attempt to write the config.php file, this file contains basic connection data essential to phpBB 2.0. If this file cannot be written (for whatever reason) you will be given the option of either downloading the file (which you should then subsequently upload to your server, overwriting the existing config.php) or, if possible to FTP the file directory to your directory. If you choose to FTP the file you will need to supply some extra information, should FTP fail you will be able to download the file. + +Once completed you will be taken to the administration control panel where you may make further changes to the board + + +Upgrade from phpBB 1.4.x: +~~~~~~~~~~~~~~~~~~~~~~~~~ + +Before upgrading we recommend you do a full backup of your database! If you are unsure how to achieve this please ask your hosting provider for advice. + +One you have backed up your database you should unarchive the phpBB 2.0 archive your downloaded and upload them to a completely clean directory on your server. DO NOT copy the files over an existing phpBB 1.x installation! Once upload you should point your browser to this location but add upgrade.php to the path. The upgrade is automated and should proceed without error. Once completed you will be given the same options for the config.php file as for the New Installation above. + +Once completed your board should be immediately available. If you encountered errors you should restore your original database and report the problems to our bug tracker (see README_RC1 for details) + + +Upgrade from phpBB 2.0 beta-1: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Sorry but no direct upgrade is available from beta-1 (we did warn you!). If you are reasonably confident with the use of SQL, etc. you may be able to make the required changes to the database manually. You will need to examine the CVS check-ins to determine what needs changing where. + + +Upgrade from phpBB 2.0 RC-1 (pre): +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +In the main all you need do is overwrite your existing installation (except config.php!!) and run update_to_RC1.php. This will automatically make a few changes to the database that occured after RC-1 (pre) was made available. You may need to modify some other values depending on your installation. Please search our forums if this becomes necessary (it shouldn't). + + +Good luck and thanks for using phpBB 2.0 : phpBB Group 2001 diff --git a/phpBB/docs/README_RC-1 b/phpBB/docs/README_RC-1 new file mode 100644 index 0000000000..f6070463f1 --- /dev/null +++ b/phpBB/docs/README_RC-1 @@ -0,0 +1,121 @@ +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +phpBB 2.0 RC-1 release : 24th December 2001 +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This is the first full Release Candidate version of phpBB 2.0, the number of RC releases will depend on how quickly we squish bugs. Our intention is to release one version a week as significant numbers of bugs are fixed. ABSOLUTELY NO NEW FEATURES WILL BE ADDED TO THE CORE phpBB 2.0 APPLICATION FROM THIS POINT SO DON'T ASK! (a feature request list for 2.2 will be opened in due course) + +Visit the phpBB 2.0 test board at : + +http://phpbb.sourceforge.net/phpBB2/ + + +Running phpBB 2.0 RC-1 +~~~~~~~~~~~~~~~~~~~~~~ + +The install and upgrade scripts should be fully functional. As always we suggest you backup your old phpBB database files before carrying out an upgrade. NOTE TO RC-1 (pre) USERS: You MUST run the update_to_RC1.php script BEFORE attempting to access your board, failing to do so will result in errors. While these won't do any damage they will prevent you using your board. + +In addition users of RC-1 (pre) or users of old CVS versions should change the modify topic_moved_id in the _topics table from NULL to NOT NULL DEFAULT '0' (if required). If you do not do this then topic read tracking may appear to work incorrectly. + +Other minor DB changes have occured and you should examine the schemas to see if your installation requires any modifications (note that most of these have already been discussed on the phpBB2 forums). If you are uncomfortable doing any of this we recommend you re-install (you may backup your existing data if you wish, re-install phpBB2 and then insert your backup). + + +PHP compatibility issues +~~~~~~~~~~~~~~~~~~~~~~~~ + +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.0 (the most recent stable release of PHP is 4.1.0). If you are running a developmental version of PHP please check any bugs you find on a system running a stable release before submitting. + +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.0.x and 7.1.x. + + +Changes since RC-1 (pre) +~~~~~~~~~~~~~~~~~~~~~~~~ + +* Upgrade script completed for initial fully functional release +* Sessions code updated +* Mark read code updated and hopefully fixed +* Significant changes to properly deal with \' for non-MySQL boards +* mssql, msaccess and mssql-odbc DB classes re-written +* Avatar issues addressed and fixed +* Search (INSERT) bug using MySQL fixed +* Search highlighting issues addressed +* Search own/other users posts fixed +* BBCode fixes for magic URIs and other issues +* Template updates for subSilver +* User and group permissions problems fixed +* Forum management problems (deletion of forum causing category not to display) fixed +* Pagination problem with groupcp fixed +* Backslash issues with posting and profile fixed +* Backslash issues with emails fixed +* preg_quote problems fixed +* User management updated with full avatar control and missing fields +* Private messaging box limits fixed +* Private messaging ?folder= strangeness fixed +* Forum pruning code updated to cope with search system +* Emoticon system in posting updated +* BBCode FAQ link added to posting form +* Language file updates to address concerns of translators +* Various other bug fixes and updates + +Note that a full list of fixed bugs can be found at the bug tracker (see below) + + +Status of this version +~~~~~~~~~~~~~~~~~~~~~~ + +This is feature frozen, no major additions will be made from this point on. Please do not post suggestions for additional features at this time they won't be included in this version! + +Fully functional features (bugs are noted below): + +* Fully featured Templating sytem (includes subSilver template) +* Multi-lingual capable (English supplied by default) +* Robust and secure posting system including previews, topic review, polls and fulltext search updating +* Notification on topic replies (including people who have not participated in topic) +* Usergroups (each user can belong to numerous groups) +* Individial control of forum permissions for each user, each group and each major forum operation +* Modular Administration system (with numerous configuration options) +* Moderator Control Panel +* One click installation and upgrade process +* Database abstraction layers for MySQL 3.x/4.x, MSSQL 7/2000, MS Access 2000/XP and Postgresql 7.x +* User Profile and User settings including a range of avatar options, definable timezones, dates, etc. +* Fully linked self-contained FAQ +* Fulltext based (boolean capable) search system +* Private Messaging (Inbox, Sentbox, Outbox, Savebox inc. box size limits) +* Email from board + +Features yet to be frozen for release: + +* Template variable names + +Incomplete features: + +* Possible compatibility issues with PHP3 + + +Known bugs +~~~~~~~~~~ + +Please note the following issues, if you find additional bugs please report them to our Sourceforge bug tracker page: + +http://sourceforge.net/tracker/index.php?group_id=7885 + +Please DO NOT post bug reports to our forums, they will be locked. + +If you do post a new bug (i.e. one that isn't already listed in the bug tracker) then please include details of your server type/version (Apache 1.2.22, IIS 4, Sambar, etc.), PHP version and DB type/version (eg. MySQL 3.23.32, PostgreSQL 7.1.2, etc.) and please select the right "Group" when submitting the bug (ie. 2.0 RC-1). + +Once you have submitted a bug it would be helpful to us if you monitored it to enable us to ask you for feedback or to supply additional information (if required). + +Overview of current bug list: + +* Cannot post very large messages when using PostgreSQL 7.0.x (limitation of Postgresql 7.0.x) +* Various issues affecting PostgreSQL 7.0.x in general +* Possible issues with MSSQL +* Some possible remaining issues with the upgrade script +* Some minor subSilver related issues +* Autologin/refresh issues with MS Internet Information Server +* Possible missing data for board emails and related information under some server configurations + + +Copyright and disclaimer +~~~~~~~~~~~~~~~~~~~~~~~~ + +This application is opensource software released under the GPL. Please see source code and the Docs directory for more details. This package and its contents are Copyright © 2001 phpBB Group, All Rights Reserved. -- cgit v1.2.1