These are general instructions on how to upgrade your existing YaBB forum from ANY previous version of YaBB. Please
follow all 6 steps! Do not report upgrade bugs until you have made sure to upload all new images, variable files and
source files and used the new settings.pl file (after configuring it).
| Step 1 - Configure Settings, Template, and Language Pack |
First open 'YaBB.pl', 'Reminder.pl', and 'PrintPage.pl'. Each of those files contains a path to your server's Perl location. Generally,
this setting is correct, but Perl is installed in different locations. For example on a Windows or WinNT machine, your Perl
path should probably be set to #!C:/Perl/Bin. Check your server for the proper path and change accordingly.
Open 'Settings.pl' and set the variables inside as follows:
Required Settings-->
require "english.lng" Change to language pack you want to use
$mbname The name of your YaBB forum
$boardurl URL of your board's folder (without trailing '/') - where YaBB.pl is located
$cookieusername Name of the username cookie (no change necessary)
$cookiepassword Name of the password cookie (no change necessary)
$mailprog Location of your sendmail program (generally "/usr/sbin/sendmail" or similar)
$webmaster_email Your e-mail address (must have the slash in it as shown "webmaster\@mysite.com")
$boarddir Absolute path to the board's folder (usually can be left as '.')
$datadir Directory with messages (can be left alone unless you wish to move elsewhere)
$memberdir Directory with member files (can be left alone unless you wish to move elsewhere)
$boardsdir Directory with board data files (can be left alone unless you wish to move elsewhere)
$sourcedir Directory with YaBB source files (can be left alone unless you wish to move elsewhere)
$vardir Directory with variable files (can be left alone unless you wish to move elsewhere)
$facesurl URL to your avatars folder (without trailing '/')
$facesdir Absolute Path to your avatars directory
$imagesdir URL to your images folder (without trailing '/')
$helpfile URL to your help index file (http://www.mysite.com/yabbhelp/index.html)
The remaining settings in Settings.pl are not required, but are only feature and layout variables. It is recommended that
you do not change them until you get YaBB working! After that, have fun.... This new Settings.pl file is required because
there are many new settings.
Open 'template.html' and modify the layout as you wish (to make it look like your site). Important Step-> if
you wish to use your existing template, you MUST add the tag "<yabb copyright>" or you will get an illegal copy notice
error on your forum! Note: the tags beginning with "<yabb " MUST REMAIN in the template.html file. You may move them
around as you wish as long as you keep those tags on lines BY THEMSELVES. The tag "<yabbnews>" has been removed in
this version, in favor of the NewsFader script. You may insert this tag if you would like the old text news format back on
your YaBB. (But be sure to set $ShowNewsFader to '0' before you put that tag back in, or you'll have the news twice on the
Board Index.) It is recommended that you do not change template.html either until you get YaBB working!
** Open 'english.lng', or the language pack you wish to use, and edit the text strings as you wish. The new language
file is REQUIRED because there are approximately 200 new strings from the last release of YaBB.
| Step 2 - Upload the script/image files |
Place the files from the downloaded zip into the directories as shown below (and please not that the directory names
as show may be different from the ones you actually use):
------- NON cgi-bin section ---------
/ubbc.js (Upload in Ascii)
/fader.js (Upload in Ascii)
/yabbhelp/ *.* (Upload in Ascii)
/yabbhelp/images *.* (Upload in Binary!)
/yabbimages/ *.gif all files (Upload in Binary!)
/yabbimages/avatars *.* all files (Upload in Binary!)
------- CGI-BIN section (all files in ASCII) ---------
/yabb/ drwxrwxrwx (chmod 777)
/yabb/YaBB.pl -rwxr-xr-x (chmod 755)
/yabb/Printpage.pl -rwxr-xr-x (chmod 755)
/yabb/Reminder.pl -rwxr-xr-x (chmod 755)
/yabb/Settings.pl drwxrwxrwx (chmod 777)
/yabb/template.html drwxrwxrwx (chmod 777)
/yabb/english.lng -rw-r--r-- (leave as is) # or another language file
/yabb/Sources drwxrwxrwx (chmod 766 or 777)
/yabb/Sources/Admin.pl -rw-r--r-- (leave as is)
/yabb/Sources/BoardIndex.pl -rw-r--r-- (leave as is)
/yabb/Sources/Display.pl -rw-r--r-- (leave as is)
/yabb/Sources/ICQPager.pl -rw-r--r-- (leave as is)
/yabb/Sources/InstantMessage.pl -rw-r--r-- (leave as is)
/yabb/Sources/Load.pl -rw-r--r-- (leave as is)
/yabb/Sources/LockThread.pl -rw-r--r-- (leave as is)
/yabb/Sources/LogInOut.pl -rw-r--r-- (leave as is)
/yabb/Sources/Maintenance.pl -rw-r--r-- (leave as is)
/yabb/Sources/ManageBoards.pl -rw-r--r-- (leave as is)
/yabb/Sources/ManageCats.pl -rw-r--r-- (leave as is)
/yabb/Sources/Memberlist.pl -rw-r--r-- (leave as is)
/yabb/Sources/MessageIndex.pl -rw-r--r-- (leave as is)
/yabb/Sources/ModifyMessage.pl -rw-r--r-- (leave as is)
/yabb/Sources/MoveThread.pl -rw-r--r-- (leave as is)
/yabb/Sources/Notify.pl -rw-r--r-- (leave as is)
/yabb/Sources/Post.pl -rw-r--r-- (leave as is)
/yabb/Sources/Profile.pl -rw-r--r-- (leave as is)
/yabb/Sources/Recent.pl -rw-r--r-- (leave as is)
/yabb/Sources/Register.pl -rw-r--r-- (leave as is)
/yabb/Sources/RemoveOldThreads.pl -rw-r--r-- (leave as is)
/yabb/Sources/RemoveThread.pl -rw-r--r-- (leave as is)
/yabb/Sources/Search.pl -rw-r--r-- (leave as is)
/yabb/Sources/Security.pl -rw-r--r-- (leave as is)
/yabb/Sources/SendTopic.pl -rw-r--r-- (leave as is)
/yabb/Sources/Subs.pl -rw-r--r-- (leave as is)
/yabb/Variables/agreement.txt -rw-r--r-- (leave as is)
| Step 3 - Delete Extra Files |
Next, you will need to delete Search.pl from you /yabb (or your board's directory). It has been replaced by the
/Sources/Search.pl. If you are upgrading from Y1G - Beta 4 and below, you'll need to also delete /Sources/SearchResults.pl.
| Step 4 - Running Maintenance Upgrade Links |
You will notice a new "Upgrade/Maintenance" section at the bottom of the Admin
Center when logged in as an Administrator. You must click (one at a time of course)
both of these links so YaBB updates it's totals files. When you first upgrade,
it has to create these files anew....
You will next need to go into the Admin Center and click the "Edit Membergroups"
link. Most likely, you'll have to reorder your membergroups (especially if you
had custom ones) and edit the text. When finished and saved, go back to the
Admin Center and click the "modify your settings/colors" link. Scroll down to
the section that asks for # of posts to be in a certain membergroup. Either
specify your own #'s, or click save and some default values (50, 100, 250, 500)
will be used.
| Step 5 - Updating
your template |
YaBB 1 Gold uses new class names to make things easier to edit, inorder to do
this you'll have to update your template.html file.
| |
1) Change |
form1 to windowbg
form2 to windowbg2
form3 to windowbg3
cat1 to catbg
title1 to titlebg
|
| |
2) Add classes |
quote
nav (and nav:hover, nav:link, nav:visited)
code
|
Note: Look into the template file in this YaBB package for an example.
Please read this short section for some upgrading tips. These are some
things that might happen when you upgrade, but they should fix themselves
after the board has been used again:
Recent Posts not showing correct posts.
"Started By" not showing anyone.
"Started By" dates are incorrect.
Some things not displaying (new features must be turned on)
back to top