#################################################
#                                               #
#         YABB 3.2 RELEASE                      #
#                                               #
#################################################


**************************************************
PLEASE READ THE FOLLOWING IMPORTANT INFORMATION
**************************************************

    This version is the latest Stable release!
	
	
    If your web host has disabled running perl in the webroot, you need to manually instruct the Apache web server to handle those extensions as executable scripts.

    Create or edit the .htaccess file in your webroot folder and add the following lines:

    Options +ExecCGI
    AddHandler cgi-script .pl .cgi

    
**************************************************
UPGRADING 
**************************************************

	To upgrade from any previous version except 2.7

	Make a backup of the entire forum directory and have it readily available

	If you have any modified files at all, ensure you copy those mods to the new file after upgrade, 1 change at a time then test, I use meld for that but there are several compare apps available

	The date format has changed & will change the forum start date so record that and you can reset it later under Forum Config

	
	
	*******************
	OPTION 1.
	
	Install a complete fresh install & copy back the contents of 
	
	Members, Messages, Boards, Backups 1 step at a time (do not overwrite any of the new .htaccess files with your old ones as they contain updated config)
	
	At this point you can go to Admin and see what's new and what needs to be added from your old config, if you do need to add, don't change anything in Admin yet
	
	copy/overwrite/edit any file into Variables that have your mods/details in that need restoring (best compare each file first)
	
	compare Settings.pm to yours and copy over/add any fields that you need to keep into the new file
	
	Check/Reset your admin settings & configure what's new	
	
	
	
	*******************
	OPTION 2. (easiest)
	
	Move all files in /cgi-bin/yabb2/ to the base forum folder & delete /cgi-bin/yabb2
	
	Select the following directories and files from your new YaBBForum zip package and copy to your forum directory, overwriting all

	Admin
	Convert
	Help
	Languages
	Modules
	Quick-Guide
	Sources
	Templates
	yabbfiles

	Setup.pl
	AdminIndex.pl
	index.pl
	Variables/bots.hosts
	Variables/iplookup.urls
	license.txt
	MANIFEST.txt
	INSTALLING.txt
	UPGRADING.txt
	VERSION.txt
	meta.pm < open this in a text editor and change to your site details
	Paths.pm
	.htaccess in every other directory
	
		DO NOT COPY OVER ANY OTHER FILE OR DIRECTORY

	** Delete files **
	YaBB.pl
	Sources/SpellChecker.pl
	readmeFIRST.txt
	MANIFEST
	
	** Delete Folders **
	Quick-Guide_26
	yabbfiles/googiespell < only googiespell, not yabbfiles
	conf
	db
	hooks
	locks
	
	** Edit **
	.htaccess if exists in the root directory, change Yabb to index to keep Guardian happy
	
	Delete Variables/Setup.lock
	
	Run https://yourdomain/forumfolder/Setup.pl (ensure it's 755 first) using your current admin password & make sure the paths are correct, this will install/upgrade some new items in Settings.pm
	
	Check/Reset your admin settings & configure what's new
	Run Rebuild Messages & Members etc under Maintenance Controls
	
	###########
	
	Make sure Setup.pl is chmod 755 (that's executable)
	and Variables, Members, Messages, Boards, Backups, Languages & Convert to 775 recursively; index.pl, AdminIndex.pl to 755 & Paths.pm to 664
	
	If you host with PerlHost.nz you can ignore the step above, simply upload your files and go have a rest, every hour the server sets up everything you need, changes owner and permissions, you don't even need to chmod the .pl files, it's all done for you!!!
	
	
	
	The following is highly unlikely as the upgrade is seemless, provided you follow the instructions & make sure your modified files are married up with the new as outlined above
	
	If you get an error check the logs if it's not displayed on screen and fix whatever is broken
	if you can't fix it try running Setup.pl again
	otherwise copy back the file with issues and compare the old and new to see what is different

	If you get to the point where you can't get it sorted, rename the forum folder you just upgraded (name.bak) and restore the original folder
	You can then go through and find which files are causing problems by comparing
	
	You can get help at https://yabb.nz/support

	
