==phpBB3 (Crawler) TO phpBB3 CONVERSION INSTRUCTIONS==
[Scripts tested with phpBB3 3.0.0]
[To convert to a different forum software, modify members_topics_posts_XXXX.py accordingly]
Before you begin, make some profile changes (NOTE: If these changes are not done, conversion will probably fail!)
In your user profile preferences (User Control Panel->Board Preferences->Edit global settings):
    - [My language] Choose the English language
    - [My board style] Choose the "prosilver" style
    - [My date format] Set the date format to Custom; in the box, enter "U" (without quotes).
        All dates should now appear as large numbers.

==REQUIRED STUFF==
A Web Server with [preferably] MySQL.
Forum Software installed on this web server, configured and ready to go -- if you aren't using phpBB or SMF, you should convert to phpBB then use a converter to your software (a double conversion may cause a lot to be lost, but the topics, posts, forums and members should be intact)
Database Access - need to be able to insert, delete and truncate
Python (versions 2.5 to 2.6 will work, but Python 3 will NOT work!) -- download from http://www.python.org

=FORUM STRUCTURE=
1) The converter will crawl for forums, but you may have to fix the forum permissions as well as adding categories.
=POSTS AND TOPICS=
2) Change some settings in settings.py (edit the file)
	table_prefix
		When you set up your forum software, what prefix did you use (default will depend on the exact software used; it's usually the product name plus an underscore)
	URL
		URL to the board's root (http://<name>.<number>.<domain>.<com|net|etc.>/)
	sticky
		A list of IDs which are stickied (pinned). You'll have to do this manually by going into each forum and recording the IDs of the pinned topics.
		This is optional (set the sticky variable to [] to disable).
		The line should look like
			sticky=[1,2,3,4,5]
		where 1,2,3,4,5 should be replaced by a comma separated list of pinned IDs.
	CONVERT_ATTACHMENTS
		Set to True to download and convert attachments, False otherwise.
		Note that this may significantly slow down conversion depending on the number of attachments on your board.
	[[Member settings]]
	RANDOMNUMBER
		a randomly chosen number used to generate member passwords, so they stay the same from run to run.
	NUMUSERS
		ID number of the most recent member. You can safely go much higher, since the crawler will only convert members with entries.

3) Run the phpbb3_get_cookie.py script (Windows: double click it; *nix use "python phpbb3_get_cookie.py" as a command).
	Enter your username and password when requested. This information is used to grab the board cookie.
4) Run the members_topics_posts.py Python script (Windows: double click it; *nix use "python members_topics_posts.py" as a command)
5) Import the SQL batch files members.sql, topics_posts.sql and categories_forums.sql to the forum database using the "utf8" character set (encoding)
6) If you opted to convert attachments with CONVERT_ATTACHMENTS, upload the entire contents of the files/ subfolder from the converter folder to the files/ directory on your web server (e.g. by using FTP).
7) To notify members of the new passwords (randomly generated), run the pm_passwords.py file (configuring settings.py first to suit your needs).
	[in settings.py]
	msgtitle
		The title of the personal message to send
	msgbody
		The text in the personal message. %%0A is a line break (new line), %s is the password (use this only once!)
		If you must use a % sign for any reason, place two of them (%%), only one will show up in the PM. Failure to do so will result in a failed script run!

On the new forum:
1) In your ACP, resynchronize statistics, post counts and dotted topics (main ACP page),
	Maintenance->Search index->Create Index for the active search method (if the Delete
	Index button is shown instead, click it first)
2) In your ACP, resynchronize all forums (you must resynchronize subforums separately)
3) Use this script:
http://www.startrekguide.com/community/viewtopic.php?p=47648#p47648. This script is designed
to resynchronize individual post data which this converter is unable to reproduce. Instructions
are posted there.

=FINAL TOUCHES=
Make sure to set your forum permissions correctly.
Manually add any moderators, themes or other settings.

=BUGS/INCOMPLETE CONVERSION NOTES
-No Polls
