Contents of /contributions/sandbox/junyor/import/phpbb/README

-- Overview
This script is designed to aid users migrating from PHPBB to Drupal.  You should always back-up your data and files before using this script.  Use this script at your own risk.

The development version of this script will be in the import/phpbb/ directory in my sandbox.  You should grab the version in the folder coinciding with the version of Drupal you're using, i.e. the 4-5 directory if you're using Drupal 4.5.x.  If there is no directory, then the script hasn't been updated and may or may not work.

-- Status
This is script is feature complete, but largely untested.  I've used it successfully on one site going from PHPBB 2.0.11 to Drupal 4.5.2.

-- Instructions
1) Run the import-comment.patch patch
2) Enable the forum module
3) Enable the profile module
4) Install and enable the bbcode module (including input formats) from the contributed modules repository
5) Make sure all current Drupal users have the same e-mail address as their counter-parts being imported, if any
6) Enable anonymous comments with optional contact information
7) Make sure anonymous users can post comments and post comments without approval
8) Make sure anonymous and authenticated users can administer nodes
9) Import phpBB data into the same table as Drupal (you can leave out the phpbb_search) databases.  To import attachments, you'll need to make sure the attachments and attachments_desc tables are included
10) Set the path to your attachments at the top of phpbb.php
11) Set your data's encoding at the top of phpbb.php
12) Run phpbb.php by visiting it in your Web browser

-- Clean-up
1) Revert the import-comment.patch patch
2) Remove the databases imported for phpbb
3) Correct the comment and node permissions for anonymous and authenticated users
4) Remove phpbb.php

-- Limitations
- user avatars will not be imported
- attachments will show up as links to path you set above
- private messages will not be imported

-- Notes
- If you have IMG tags in your posts, you'll need to edit the default input filter to allow those tags.  That goes for any other tag you might have on your page that the input filter doesn't have by default, too.
- You may want to install quote.module to emulate the phpbb quoting feature.  Since you already have bbcode.module installed, you don't need to enable the quote.module input filter.  Quote.module links to a CSS file used for styling quotes, but the quotes use different names in bbcode.module.  So, you should probably change the code in the CSS file to point to the correct class names or comment out that line from quote.module.
1	-- Overview
2	This script is designed to aid users migrating from PHPBB to Drupal. You should always back-up your data and files before using this script. Use this script at your own risk.
3
4	The development version of this script will be in the import/phpbb/ directory in my sandbox. You should grab the version in the folder coinciding with the version of Drupal you're using, i.e. the 4-5 directory if you're using Drupal 4.5.x. If there is no directory, then the script hasn't been updated and may or may not work.
5
6	-- Status
7	This is script is feature complete, but largely untested. I've used it successfully on one site going from PHPBB 2.0.11 to Drupal 4.5.2.
8
9	-- Instructions
10	1) Run the import-comment.patch patch
11	2) Enable the forum module
12	3) Enable the profile module
13	4) Install and enable the bbcode module (including input formats) from the contributed modules repository
14	5) Make sure all current Drupal users have the same e-mail address as their counter-parts being imported, if any
15	6) Enable anonymous comments with optional contact information
16	7) Make sure anonymous users can post comments and post comments without approval
17	8) Make sure anonymous and authenticated users can administer nodes
18	9) Import phpBB data into the same table as Drupal (you can leave out the phpbb_search) databases. To import attachments, you'll need to make sure the attachments and attachments_desc tables are included
19	10) Set the path to your attachments at the top of phpbb.php
20	11) Set your data's encoding at the top of phpbb.php
21	12) Run phpbb.php by visiting it in your Web browser
22
23	-- Clean-up
24	1) Revert the import-comment.patch patch
25	2) Remove the databases imported for phpbb
26	3) Correct the comment and node permissions for anonymous and authenticated users
27	4) Remove phpbb.php
28
29	-- Limitations
30	- user avatars will not be imported
31	- attachments will show up as links to path you set above
32	- private messages will not be imported
33
34	-- Notes
35	- If you have IMG tags in your posts, you'll need to edit the default input filter to allow those tags. That goes for any other tag you might have on your page that the input filter doesn't have by default, too.
36	- You may want to install quote.module to emulate the phpbb quoting feature. Since you already have bbcode.module installed, you don't need to enable the quote.module input filter. Quote.module links to a CSS file used for styling quotes, but the quotes use different names in bbcode.module. So, you should probably change the code in the CSS file to point to the correct class names or comment out that line from quote.module.