Upgrade
Instructions
- 
|
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 note 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 your /yabb
(or your board's directory) if it exists. 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,
in order 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
|