==ZetaBoards TO SMF/phpBB CONVERSION INSTRUCTIONS==
[Scripts tested with SMF 1.1.4 and phpBB 2.0.22]
Before you begin, you must make the following time format adjustments:
In the Administration Panel:
Admin CP -> Board Preferences -> Board Clock:
	Change the Standard Time Format to the format matching "Mar 2 2008, 01:23:45 PM".
	Change the Join Date Format to the format matching "Mar 2 2008".
	Change "Use relative times" to No.

You're set.

==REQUIRED STUFF==
A Web Server with [preferably] MySQL.
Forum Software (phpBB2 or SMF) installed on this web server, configured and ready to go.
Database Access - need to be able to INSERT and TRUNCATE (usually available with most hosts)
Python (versions 2.5 to 2.6 will work, but Python 3 will NOT work!) -- download from http://www.python.org
**N.B. Read all comments in settings.py to understand what each setting does! Setting bad settings may result in a poor quality conversion (missing stuff), a broken board, or no conversion at all.

Note: If you want to do a conversion as a guest user, create a blank text file called "cookie.txt", then skip step 2 below.

=POSTS AND TOPICS=
1) 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; phpbb_ or smf_)
	URL
		URL to the board's root (usually something like http://s<number>.zetaboards.com/forumname/)
		If you use a custom domain, enter the primary domain here.
	ZBURL
		URL to the board on zetaboards.com (usually something like http://s<number>.zetaboards.com/forumname/)
		Enter the zetaboards.com domain here even if you use a custom domain.
	lockimage
		Location of the "Locked" icon which appears beside a locked topic on the board view
	[[Member settings]]
	RANDOMNUMBER
		a randomly chosen number used to generate member passwords; put any 9-digit-or-less number here.
	groups
		Member groups on your forum (postgroups excluded). The left side of the colon is the Invisionfree name, the right side is the SMF group number/ID. For phpBB, 1 means admin, any others mean regular member.
	postgroup
		(SMF Only) Definitions for postgroups, IDs as in SMF.
2) Run the zetaboards_get_cookie.py script (Windows: double click it; *nix use "python zetaboards_get_cookie.py" as a command).
	Enter your username and password when requested. This information is used to grab the board cookie.
3) Run the members_topics_posts.py Python script
4) Import the SQL batch files categories_forums.sql, members.sql and topics_posts.sql and to the forum database using the "utf8" character set (encoding)
5) 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]
	waittime
		Time to wait (in seconds) between successive PMs. Default is 0, since ZetaBoards apparently allows "flood" PMs, though
		this may need to be higher in the future, if flood control is added.
	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!
6a) [SMF Only] Find and repair any errors, Recount all forum totals and statistics (both in Admin/ Forum Maintainance)
6b) [phpBB only] Resync all boards.
=FINAL TOUCHES=
Make sure to set your forum permissions correctly.
Manually add any moderators, themes or other settings.

=BUGS/INCOMPLETE CONVERSION NOTES
-No spoilers
-Limited membergroup conversion
