You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: development/start/getting_started.rst
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -51,7 +51,7 @@ Although we are rather proud of the included styles, we realise that they may no
51
51
52
52
For more information about styles, please see: https://www.phpbb.com/styles/
53
53
54
-
**Please note** that 3rd party styles downloaded for versions of phpBB2 will **not** work in phpBB3. It is also important to ensure that the style is updated to match the current version of the phpBB software you are using.
54
+
**Please note** that 3rd party styles downloaded for previous versions of phpBB will **not** work. It is important to ensure that the style is updated to match the current version of the phpBB software you are using.
55
55
56
56
Once you have downloaded a style, the usual next step is to unarchive (or upload the unarchived contents of) the package into your ``styles/`` directory. You then need to visit ``Administration Control Panel -> Customise tab -> Style management -> Install Styles`` where you should see the new style available. Click "Install style" to install the style.
57
57
@@ -139,7 +139,7 @@ Please note that the development forums should **NOT** be used to seek support f
139
139
140
140
The phpBB developers use a bug tracking system to store, list and manage all reported bugs, it can be found at the location listed below. Please **DO NOT** post bug reports to our forums. In addition please **DO NOT** 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).
141
141
142
-
http://tracker.phpbb.com/browse/PHPBB3
142
+
http://tracker.phpbb.com/browse/PHPBB
143
143
144
144
While we very much appreciate receiving bug reports (the more reports the more stable phpBB will be) we ask you carry out a few steps before adding new entries:
Copy file name to clipboardExpand all lines: development/start/install.rst
+16-16Lines changed: 16 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -5,23 +5,23 @@ Installation
5
5
1. Quick install
6
6
================
7
7
8
-
If you have basic knowledge of using FTP and are sure your hosting service or server will run phpBB3 you can use these steps to quickly get started. For a more detailed explanation you should skip this and go to `2. Requirements`_ below.
8
+
If you have basic knowledge of using FTP and are sure your hosting service or server will run phpBB you can use these steps to quickly get started. For a more detailed explanation you should skip this and go to `2. Requirements`_ below.
9
9
10
-
Decompress the phpBB3 archive to a local directory on your system.
10
+
Decompress the phpBB archive to a local directory on your system.
11
11
Upload all the files contained in this archive (retaining the directory structure) to a web accessible directory on your server or hosting account.
12
12
Change the permissions on config.php to be writable by all (``666`` or ``-rw-rw-rw-`` within your FTP Client)
13
13
Change the permissions on the following directories to be writable by all (``777`` or ``-rwxrwxrwx`` within your FTP Client):
14
14
``store/``, ``cache/``, ``files/`` and ``images/avatars/upload/``.
15
-
Point your web browser to the location where you uploaded the phpBB3 files with the addition of ``install/app.php`` or simply ``install/``, e.g. ``http://www.example.com/phpBB3/install/app.php``, ``http://www.example.com/forum/install/``.
15
+
Point your web browser to the location where you uploaded the phpBB files with the addition of ``install/app.php`` or simply ``install/``, e.g. ``http://www.example.com/phpBB/install/app.php``, ``http://www.example.com/forum/install/``.
16
16
Click the **INSTALL** tab, follow the steps and fill out all the requested information.
17
17
Change the permissions on config.php to be writable only by yourself (``644`` or ``-rw-r--r--`` within your FTP Client)
18
-
phpBB3 should now be available, please **MAKE SURE** you read at least `6. Conversion from phpBB 2.0.x to phpBB 3.2.x`_ below for important, security related post-installation instructions, and also take note of `7. Important (security related) post-Install tasks for all installation methods`_ regarding anti-spam measures.
18
+
phpBB should now be available, please **MAKE SURE** you read at least `6. Conversion from phpBB 2.0.x to phpBB 3.2.x`_ below for important, security related post-installation instructions, and also take note of `7. Important (security related) post-Install tasks for all installation methods`_ regarding anti-spam measures.
19
19
If you experienced problems or do not know how to proceed with any of the steps above please read the rest of this document.
20
20
21
21
2. Requirements
22
22
===============
23
23
24
-
phpBB 3.2.x has a few requirements which must be met before you are able to install and use it.
24
+
phpBB has a few requirements which must be met before you are able to install and use it.
25
25
26
26
A webserver or web hosting account running on any major Operating System with support for PHP
27
27
A SQL database system, **one of**:
@@ -53,7 +53,7 @@ All .php, .sql, .cfg, .css, .js, .html, .htaccess and .txt files should be uploa
53
53
54
54
phpBB comes supplied with British English as its standard language. However, a number of separate packs for different languages are available. If you are not a native English speaker you may wish to install one or more of these packages before continuing. The installation process below will allow you to select a default language from those available (you can, of course, change this default at a later stage). For more details on language packs, where to obtain them and how to install them please see :ref:`i-languages-internationalisation-i18n`.
55
55
56
-
Once all the files have been uploaded to your site, you should point your browser at this location with the addition of ``/install/``. For example, if your domain name is ``www.example.com`` and you placed the phpBB files in the directory ``/phpBB3`` off your web root you would enter ``http://www.example.com/phpBB3/install/`` or (alternatively) ``http://www.example.com/phpBB3/install/app.php`` into your browser. When you have done this, you should see the **phpBB Introduction** screen appear.
56
+
Once all the files have been uploaded to your site, you should point your browser at this location with the addition of ``/install/``. For example, if your domain name is ``www.example.com`` and you placed the phpBB files in the directory ``/phpBB`` off your web root you would enter ``http://www.example.com/phpBB/install/`` or (alternatively) ``http://www.example.com/phpBB/install/app.php`` into your browser. When you have done this, you should see the **phpBB Introduction** screen appear.
57
57
58
58
3.i. Introduction
59
59
-------------------
@@ -166,7 +166,7 @@ To perform the update, either follow the instructions from the **Administration
166
166
- Go to the `downloads page <https://www.phpbb.com/downloads/>`_ and download the latest update package listed there, matching your current version.
167
167
- Upload the uncompressed archive contents to your phpBB installation - only the ``install/`` and ``vendor/`` folders are required. Upload these folders in their entirety, retaining the file structure.
168
168
- After the install folder is present, phpBB will go offline automatically.
169
-
- Point your browser to the install directory, for example ``http://www.example.com/phpBB3/install/``
169
+
- Point your browser to the install directory, for example ``http://www.example.com/phpBB/install/``
170
170
- Choose the "Update" Tab and follow the instructions
171
171
172
172
@@ -198,23 +198,23 @@ Delete the ``install/`` directory
198
198
6. Conversion from phpBB 2.0.x to phpBB 3.2.x
199
199
=============================================
200
200
201
-
This paragraph explains the steps necessary to convert your existing phpBB2 installation to phpBB3.
201
+
This paragraph explains the steps necessary to convert your existing phpBB2 installation to the latest phpBB.
202
202
203
203
6.i. Requirements before converting
204
204
-----------------------------------
205
205
206
-
Before converting, we heavily recommend you do a **full backup of your database and files!** If you are unsure how to achieve this, please ask your hosting provider for advice. You basically need to follow the instructions given for `3. New installation`_. Please **do not** overwrite any old files - install phpBB3 at a different location.
206
+
Before converting, we heavily recommend you do a **full backup of your database and files!** If you are unsure how to achieve this, please ask your hosting provider for advice. You basically need to follow the instructions given for `3. New installation`_. Please **do not** overwrite any old files - install phpBB in a different location.
207
207
208
-
Once you made a backup of everything and also have a brand new phpBB3 installation, you can now begin the conversion.
208
+
Once you made a backup of everything and also have a brand new phpBB installation, you can now begin the conversion.
209
209
210
-
Note that the conversion requires ``CREATE`` and ``DROP`` privileges for the phpBB3 database user account.
210
+
Note that the conversion requires ``CREATE`` and ``DROP`` privileges for the phpBB database user account.
211
211
212
212
6.ii. Converting
213
213
----------------
214
214
215
-
To begin the conversion, visit the ``install/`` folder of your phpBB3 installation (the same as you have done for installing). Now you will see a new tab **Convert**. Click this tab.
215
+
To begin the conversion, visit the ``install/`` folder of your phpBB installation (the same as you have done for installing). Now you will see a new tab **Convert**. Click this tab.
216
216
217
-
As with install, the conversion is automated. Your previous 2.0.x database tables will not be changed and the original 2.0.x files will remain unaltered. The conversion is actually only filling your phpBB3 database tables and copying additional data over to your phpBB3 installation. This has the benefit that if something goes wrong, you are able to either re-run the conversion or continue a conversion, while your old board is still accessible. We really recommend that you disable your old installation while converting, else you may have inconsistent data after the conversion.
217
+
As with install, the conversion is automated. Your previous 2.0.x database tables will not be changed and the original 2.0.x files will remain unaltered. The conversion is actually only filling your phpBB database tables and copying additional data over to your phpBB installation. This has the benefit that if something goes wrong, you are able to either re-run the conversion or continue a conversion, while your old board is still accessible. We really recommend that you disable your old installation while converting, else you may have inconsistent data after the conversion.
218
218
219
219
Please note that this conversion process may take quite some time and depending on your hosting provider this may result in it failing (due to web server resource limits or other timeout issues). If this is the case, you should ask your provider if they are willing to allow the convert script to temporarily exceed their limits (be nice and they will probably be quite helpful). If your host is unwilling to increase the limits to run the convertor, please see this article for performing the conversion on your local machine: `Knowledge Base - Offline Conversions <https://www.phpbb.com/kb/article/offline-conversions/>`_
220
220
@@ -231,7 +231,7 @@ During the conversion, the search index is not created or transferred. This mean
231
231
232
232
After verifying the settings in the ACP, you can delete the install directory to enable the board. The board will stay disabled until you do so.
233
233
234
-
Once you are pleased with your new installation, you may want to give it the name of your old installation, changing the directory name. With phpBB3 this is possible without any problems, but you may still want to check your cookie settings within the administration panel; in case your cookie path needs to be adjusted prior to renaming.
234
+
Once you are pleased with your new installation, you may want to give it the name of your old installation, changing the directory name. With phpBB this is possible without any problems, but you may still want to check your cookie settings within the administration panel; in case your cookie path needs to be adjusted prior to renaming.
235
235
236
236
6.iv. Common conversion problems
237
237
--------------------------------
@@ -240,9 +240,9 @@ Once you are pleased with your new installation, you may want to give it the nam
240
240
241
241
**http 500 / white pages** The conversion is a load-heavy procedure. Restrictions imposed by some server hosting providers can cause problems. The most common causes are: values too low for the PHP settings ``memory_limit`` and ``max_execution_time``. Limits on the allowed CPU time are also a frequent cause for such errors, as are limits on the number of database queries allowed. If you cannot change such settings, then contact your hosting provider or run the conversion procedure on a different computer. The phpBB.com forums are also an excellent location to ask for support.
242
242
243
-
**Password conversion** Due to the utf-8 based handling of passwords in phpBB3, it is not always possible to transfer all passwords. For passwords "lost in translation" the easiest workaround is to use the **I forgot my password** link on the login page.
243
+
**Password conversion** Due to the utf-8 based handling of passwords in phpBB, it is not always possible to transfer all passwords. For passwords "lost in translation" the easiest workaround is to use the **I forgot my password** link on the login page.
244
244
245
-
**Path to your former board** The convertor expects the relative path to your old board's files. So, for instance, if the old board is located at ``http://www.yourdomain.com/forum`` and the phpBB3 installation is located at ``http://www.yourdomain.com/phpBB3``, then the correct value would be ``../forum``. Note that the webserver user must be able to access the source installation's files.
245
+
**Path to your former board** The convertor expects the relative path to your old board's files. So, for instance, if the old board is located at ``http://www.yourdomain.com/forum`` and the phpBB installation is located at ``http://www.yourdomain.com/phpBB``, then the correct value would be ``../forum``. Note that the webserver user must be able to access the source installation's files.
246
246
247
247
**Missing images** If your default board language's language pack does not include all images, then some images might be missing in your installation. Always use a complete language pack as default language.
0 commit comments