==Yuku TO SMF/phpBB CONVERSION INSTRUCTIONS==
[Scripts tested with SMF 1.1.4 and phpBB 2.0.22]
Before you begin, make some settings that will improve conversion:
In your account preferences, set topics and replies per page to the highest available (probably 100). This reduces the number of extra pages needed. Check the "Use My Settings" box to ensure this takes effect.
In the admin panel, under Community Settings->Display Preferences, in the "Community Display Options->Community Statistics" group, make sure "active members" and "community profile" are both checked; without these settings, members can't be converted.

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.

=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_)
	COOKIEDATA
		Get this by entering this into the address bar while viewing any page in your Proboards forum:
			javascript:document.cookie
		and copying the entire text of the page that appears.
		The COOKIEDATA line should look like
			COOKIEDATA='<Cookie Data retrieved from the prompt message>'
		with the single quotes around your data.
	URL
		URL to the board's index.cgi page (usually something like http://forumname.proboards<number>.com/index.cgi)
	DATEFORMAT
		The date format used on your Yuku forum.
		%a - short weekday name ("Wed")
		%A - long weekday name ("Wednesday")
		%m - numerical month ("02")
		%b - short month name ("Feb")
		%B - full month name ("February")
		%d - numerical day ("16")
		%y - year without century ("08")
		%Y - Year with century ("2008")
	TIMEFORMAT
		The time format on your Yuku forum.
		%H - 24-hour hour (18)
		%I - 12-hour hour (6)
		%p - "AM" or "PM"
		%M - Minute
		%S - Second
	strptime...
		Tests for the formats you've chosen. Just plug in some times and dates from the Yuku forum here, and when the script starts, it'll let you know if there's a problem.
		Times and dates are one of the most important things to convert; without them, nothing is in order.
	[[Member settings]]
	RANDOMNUMBER
		a randomly chosen number used to generate member passwords; put any 9-digit-or-less number here.
	postgroup
		(SMF Only) Definitions for postgroups, IDs as in SMF.
2) Run the members_topics_posts.py Python script (Windows: double click it; *nix use "python members_topics_posts.py" as a command)
3) 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)
4) 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 Yuku apparently allows "flood" PMs, though
		this may need to be higher in the future. Also, Yuku has a habit of denying access if you download too fast.
		Hence, a timeout of 1 or 2 seconds should be sufficient.
	msgtitle
		The title of the personal message to send
	msgbody
		The text in the personal message. <br> is a line break (new line), %(username)s is the username and %(password)s is the password (you can use either as many times as necessary; just don't forget the 's' at the end)
		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!
5) [SMF Only] Find and repair any errors, Recount all forum totals and statistics (both in Admin/ Forum Maintainance)
=FINAL TOUCHES=
Make sure to set your forum permissions correctly.
Manually add any moderators, themes or other settings.

=BUGS/INCOMPLETE CONVERSION NOTES
-No Attachments
-No Polls
-Limited membergroup conversion
