diff options
author | Henry Sudhof <kellanved@phpbb.com> | 2007-05-28 18:10:08 +0000 |
---|---|---|
committer | Henry Sudhof <kellanved@phpbb.com> | 2007-05-28 18:10:08 +0000 |
commit | 17b6b1e230cd51b4cb76e41243af827b596895e2 (patch) | |
tree | 9ccf5bfba4600096197004231d3874431ced1a8d /phpBB | |
parent | bc631bb242fddc91fde129a9855a25a3b8a4de1e (diff) | |
download | forums-17b6b1e230cd51b4cb76e41243af827b596895e2.tar forums-17b6b1e230cd51b4cb76e41243af827b596895e2.tar.gz forums-17b6b1e230cd51b4cb76e41243af827b596895e2.tar.bz2 forums-17b6b1e230cd51b4cb76e41243af827b596895e2.tar.xz forums-17b6b1e230cd51b4cb76e41243af827b596895e2.zip |
Adding to the conversion documentation. This introduces and changes languages variables.
#11407
#11251
#11673
#11671
#11215
git-svn-id: file:///svn/phpbb/trunk@7694 89ea8834-ac86-4346-8a33-228a782c2dd0
Diffstat (limited to 'phpBB')
-rwxr-xr-x | phpBB/adm/style/install_convert.html | 2 | ||||
-rw-r--r-- | phpBB/docs/CHANGELOG.html | 1 | ||||
-rw-r--r-- | phpBB/docs/INSTALL.html | 38 | ||||
-rw-r--r-- | phpBB/install/install_convert.php | 2 | ||||
-rwxr-xr-x | phpBB/language/en/install.php | 5 |
5 files changed, 40 insertions, 8 deletions
diff --git a/phpBB/adm/style/install_convert.html b/phpBB/adm/style/install_convert.html index b17ea838d2..5d52015da6 100755 --- a/phpBB/adm/style/install_convert.html +++ b/phpBB/adm/style/install_convert.html @@ -102,7 +102,7 @@ <!-- IF options.S_LEGEND --> <!-- IF not options.S_FIRST_ROW --> </fieldset> - + <fieldset> <!-- ENDIF --> <legend>{options.LEGEND}</legend> diff --git a/phpBB/docs/CHANGELOG.html b/phpBB/docs/CHANGELOG.html index c5c0702259..b385b724e2 100644 --- a/phpBB/docs/CHANGELOG.html +++ b/phpBB/docs/CHANGELOG.html @@ -229,6 +229,7 @@ p a { <li>[Feature] The converter no longer relies on the smiley ID to decide if it should be displayed on the posting page</li> <li>[Fix] Inconsistent display of more smileys link fixed (Bug #11801)</li> <li>[Fix] Outbox messages are no always neither new nor unread post-conversion(Bug #11461)</li> + <li>Some changes to the conversion documentation</li> </ul> </div> diff --git a/phpBB/docs/INSTALL.html b/phpBB/docs/INSTALL.html index e67e9b2a10..8dab282a25 100644 --- a/phpBB/docs/INSTALL.html +++ b/phpBB/docs/INSTALL.html @@ -33,8 +33,8 @@ p { font-size: 8pt; } -hr { - height: 0; +hr { + height: 0; border: solid #D1D7DC 0; border-top-width: 1px; } @@ -93,7 +93,7 @@ h3 { } code { - color: #006600; + color: #006600; font-weight: normal; font-family: 'Courier New', monospace; border-color: #D1D7DC; @@ -189,6 +189,7 @@ p a { <li><a href="#prereq">Requirements before converting</a></li> <li><a href="#conversion">Converting</a></li> <li><a href="#postreq">Things to do after conversion</a></li> + <li><a href="#convprob">Common conversion problems</a></li> </ol> </li> <li><a href="#postinstall">Important (security related) post-Install tasks for all installation methods</a> @@ -264,7 +265,7 @@ p a { <a name="install"></a><h1>3. New installation</h1> <div class="paragraph"> - + <p>Installation of phpBB3 will vary according to your server and database. If you have <em>shell access</em> to your account (via telnet or ssh for example) you may want to upload the entire phpBB3 archive (in binary mode!) to a directory on your host and unarchive it there.</p> <p>If you do not have shell access or do not wish to use it you will need to decompress the phpBB3 archive to a local directory on your system using your favourite compression program, e.g. winzip, rar, zip, etc. From there you must FTP <strong>ALL</strong> the files it contains (being sure to retain the directory structure and filenames) to your host. Please ensure that the cases of filenames are retained, do <strong>NOT</strong> force filenames to all lower or upper case doing so will cause errors later.</p> @@ -430,6 +431,8 @@ p a { <p>Before converting we heavily recommend you do a <em>full backup of your database and files</em>! If you are unsure how to achieve this please ask your hosting provider for advice. In order to convert, you need to have a new phpBB3 installation within the same database (but with a different prefix) as your old 2.0.x installation. You basically need to follow the basic instructions given for <a href="#install">New installations</a>. Please <strong>do not</strong> overwrite any old files - install phpBB3 at a different location.</p> <p>Once you made a backup of everything and also have a brand new phpBB3 installation, you can now begin the conversion.</p> + + <p>Note that the conversion requires CREATE and DROP privileges for the phpBB3's database user account.</p> </div> <a href="#top">Top</a> <br /><br /> @@ -442,7 +445,7 @@ p a { <p>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 <em>Convert</em>. Click this tab.</p> <p>As with install the conversion is automated. Your previous 2.0.x database tables will not be touched as well as the original 2.0.x files remaining untouched. 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 you disable your old installation while converting, else you may have inconsistent data after the conversion.</p> - + <p>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 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).</p> <p>Once completed your board should be immediately available. If you encountered errors you should report the problems to our bug tracker or seek help via our forums (see <a href="README.html">README</a> for details).</p> @@ -461,12 +464,36 @@ p a { <p>Within the conversion the search index has not been created or transferred. This means after conversion you are not able to find any matches if you want to search for something. We recommend you rebuild your search index within <code>Admin -> Maintenance -> Database -> Search Index</code>.</p> + <p>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.</p> + <p>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, if the cookie path need to be adjusted prior to renaming.</p> </div> <a href="#top">Top</a> <br /><br /> +<a name="convprob"></a><b>5.iv. Common conversion problems</b> +<br /><br /> + +<div class="paragraph"> + + <p><strong>Broken non-latin characters</strong> The conversion script assumes that the database encoding in the source phpBB2 matches the encoding defined in the <code>lang_main.php</code> file of the default language pack of the source installation. Edit that file to match the database's encoding and re-start the conversion procedure.</p> + + <p><strong>http 500 / white pages</strong> The conversion is a load-heavy procedure. Restrictions imposed by some server hosting providers can cause problems. The most common causes are: too low values for the php settings <code>memory_limit</code> and <code>max_execution_time</code>. Limits on the allowed CPU time are also a frequent cause for such errors, as are caps 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.</p> + + <p><strong>Password conversion</strong> 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 "forgotten password" function.</p> + + <p><strong>path to your former board</strong></p> The converter expects the relative path to your old board's files. So, -for instance - if the new board is located at <code>http://www.yourdomain.com/forum</code> and the phpBB3 is located at <code>http://www.yourdomain.com/phpBB3</code>, then the correct value would be <code>../forum</code>. Note that the webserver user must be able to access the source installation's files. + + <p><strong>Missing images</strong></p> 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. + + <p><strong>Smilies</strong></p> During the conversion you might see warnings about image files where the copying failed. That can happen if the old board's smilies have the same file names as those on the new board. Copy those files manually after the conversion, if you want to continue using the old smilies. + +</div> +<a href="#top">Top</a> +<br /><br /> + + <hr /> <a name="postinstall"></a><h1>6. Important (security related) post-Install tasks for all installation methods</h1> @@ -476,6 +503,7 @@ p a { <p>Once you have succssfully installed phpBB3 you <strong>MUST</strong> ensure you remove the entire install/ directory. Leaving the install directory in place is a <em>very serious potential security issue</em> which may lead to deletion or alteration of files, etc. Please note that until this directory is not removed phpBB3 will not operate and a warning message will be displayed. Beyond this <strong>essential</strong> deletion you may also wish to delete the docs/ directories if you wish.</p> <p>With these directories deleted you should proceed to the administration panel. Depending on how the installation completed you may have been directed there automatically. If not, login as the administrator you specified during install/conversion and click the <strong>Administration Panel</strong> link at the bottom of any page. Ensure that details specified in <code>Admin -> General</code> are correct!</p> + </div> <a href="#top">Top</a> <br /><br /> diff --git a/phpBB/install/install_convert.php b/phpBB/install/install_convert.php index 33b41f88d2..c5a6df33b6 100644 --- a/phpBB/install/install_convert.php +++ b/phpBB/install/install_convert.php @@ -572,6 +572,8 @@ class install_convert extends module } $template->assign_vars(array( + 'TITLE' => $lang['STAGE_SETTINGS'], + 'BODY' => $lang['CONV_OPTIONS_BODY'], 'L_SUBMIT' => $lang['BEGIN_CONVERT'], 'U_ACTION' => $this->p_master->module_url . "?mode={$this->mode}&sub=settings&tag=$convertor_tag", )); diff --git a/phpBB/language/en/install.php b/phpBB/language/en/install.php index 32a66ba62b..a457f1b6b7 100755 --- a/phpBB/language/en/install.php +++ b/phpBB/language/en/install.php @@ -73,7 +73,7 @@ $lang = array_merge($lang, array( 'CONTINUE_OLD_CONVERSION' => 'Continue previously started conversion', 'CONVERT' => 'Convert', 'CONVERT_COMPLETE' => 'Conversion completed', - 'CONVERT_COMPLETE_EXPLAIN' => 'You have now successfully converted your board to phpBB 3.0. You can now login and <a href="../">access your board</a>. Remember that help on using phpBB is available online via the <a href="http://www.phpbb.com/support/documentation/3.0/">Documentation</a> and the <a href="http://www.phpbb.com/community/viewforum.php?f=46">support forums</a>.', + 'CONVERT_COMPLETE_EXPLAIN' => 'You have now successfully converted your board to phpBB 3.0. You can now login and <a href="../">access your board</a>. Please ensure that the settings were transferred correctly before enabling your board by deleting the install directory. Remember that help on using phpBB is available online via the <a href="http://www.phpbb.com/support/documentation/3.0/">Documentation</a> and the <a href="http://www.phpbb.com/community/viewforum.php?f=46">support forums</a>.', 'CONVERT_INTRO' => 'Welcome to the phpBB Unified Convertor Framework', 'CONVERT_INTRO_BODY' => 'From here, you are able to import data from other (installed) board systems. The list below shows all the conversion modules currently available. If there is no convertor shown in this list for the board software you wish to convert from, please check our website where further conversion modules may be available for download.', 'CONVERT_NEW_CONVERSION' => 'New conversion', @@ -106,6 +106,7 @@ $lang = array_merge($lang, array( 'CONV_ERROR_REPLACE_FORUM' => 'Unable to insert new forum replacing old forum.', 'CONV_ERROR_USER_ACCESS' => 'Unable to get user authentication information.', 'CONV_ERROR_WRONG_GROUP' => 'Wrong group "%1$s" defined in %2$s.', + 'CONV_OPTIONS_BODY' => 'This page collects the data required to access the source board. Enter the database details of your former board; the converter will not change anything in the database given below. The source board should be disabled to allow a consistent conversion.', 'CONV_SAVED_MESSAGES' => 'Saved messages', 'COULD_NOT_COPY' => 'Could not copy file <strong>%1$s</strong> to <strong>%2$s</strong><br /><br />Please check that the target directory exists and is writable by the webserver.', @@ -162,7 +163,7 @@ $lang = array_merge($lang, array( 'FORUM_ADDRESS' => 'Board address', 'FORUM_ADDRESS_EXPLAIN' => 'This is the URL of your former board, for example <samp>http://www.example.com/phpBB2/</samp>. If an address is entered here and not left empty every instance of this address will be replaced by your new board address within messages, private messages and signatures.', 'FORUM_PATH' => 'Board path', - 'FORUM_PATH_EXPLAIN' => 'This is the <strong>relative</strong> path on disk to your former board from the <strong>root of your phpBB installation</strong>.', + 'FORUM_PATH_EXPLAIN' => 'This is the <strong>relative</strong> path on disk to your former board from the <strong>root of this phpBB3 installation</strong>.', 'FOUND' => 'Found', 'FTP_CONFIG' => 'Transfer config by FTP', 'FTP_CONFIG_EXPLAIN' => 'phpBB has detected the presence of the FTP module on this server. You may attempt to install your config.php via this if you wish. You will need to supply the information listed below. Remember your username and password are those to your server! (ask your hosting provider for details if you are unsure what these are).', |