Page Index Toggle Pages: 1 Print
MOD the Complete Instructions (Read 6373 times)
Captain John
Ex Member


MOD the Complete Instructions
Sep 24th, 2007 at 11:44pm
Print Post  
 Go to http://www.boardmod.org/downloads.php and download the latest version of BoardMod (currently 2.5.6)
 Unpack the .zip-file into a directory of your choice(use one that's easy to access, like C:\BoardMod) Download YaBB off your server(via FTP) to a folder on your hard drive. Start BoardMod. You will see a box with a Browse button next to it in the upper left corner Click the Browse button and point it to the directory you downloaded YaBB into (the directory containing YaBB.pl) You see the select-box in the top right corner? Click it. You should get a list of YaBB versions(actually this is a list of folders within the Mods folder in the BoardMod main directory) Select your version of YaBB. Currently, this is YaBB 2.2.3, First, save the mod you downloaded into this directory: *boardmod dir*/Mods/*your YaBB version*. If the mod is packed to .zip then only copy the file that has the .mod extension to this directory. Now, start BoardMod and follow the steps in Topic 2 of this FAQ if you haven't already done so. Now, when you select your version, a list of mods should appear. Browse through the list until you find the one you just downloaded and click the checkbox next to it. Installation should commence.

NOTE: Mods with a checked checkbox are INSTALLED mods, those unchecked are not installed.

To eliminate getting MOD ver. errors, be sure that you downloaded a mod, for your version of YaBB:

I. Introduction Please read this all the way through before you start. It can save you a lot of grief if you do. Smiley If you don't...you were warned! Sad

It is assumed that: You have a working understanding of Windows and how to create folders (directories and sub-directories) You have an FTP program to connect to your remote server and that you know how to use that program. You have your YaBB board up and running BEFORE you try to install any mods. If you do not have your YaBB board up and running...go to the YaBB -Yet another Bulletin Board web site for help in installing your board. You have downloaded and installed BoardMod on your computer in C:\Program Files\BoardMod or somewhere similar.

First, you have to know that BoardMod v2.5.6 can only modify files which are located on your computer's hard drive (off-line). That means that you first have to download your cgi-bin\yabb files (as described below) from your remote server to your computer's hard drive.

Before you start to use BoardMod to modify any files, you'll want to download the cgi-bin\yabb files from the remote server to your computer's hard drive twice. Once, as a back-up and once as the set of files for BoardMod to work on. The back-up is just an insurance policy in case you crash your board while setting up the mod and need to restore your board to its pre-mod condition.

II. Creating the Back-up Folder We want to create the YaBB directory structure you have on your remote server on your computer's hard drive. You can call it YaBBbackup (or whatever you want to call your backup folder).

Go to My Computer or Windows Explorer and make the directories (folders) as below: YaBBbackup (or whatever you decided to call it)

   Admin
   Boards
   Members
   Messages
   Sources
   Variables

After you've got your directory structure set up, use your FTP program (ex. CuteFTP, Filezilla or whichever one you're using) to connect to your remote server. Once connected: 1. Download all folders & files from the cgi-bin\yabb folder on the server to the YaBBbackup folder on your hard drive.

2. Change directories to down load all the files from the Variables folder on the remote server to the YaBBbackup\Variables directory on your hard drive.

3. Next, change directories to down load all the files from the Messages folder on the remote server to the YaBBbackup\Messages directory on your hard drive.

4. Next, change directories to down load all the files from the Members folder on the remote server to the YaBBbackup\Members directory on your hard drive.

5. Next, change directories to down load all the files from the Boards folder on the remote server to the YaBBbackup\Boards directory on your hard drive.

Now, we've downloaded a complete set of your server's cgi-bin\yabb files. If something happens during the installation of the mod...you can always put your board back the way it was before you started simply by re-uploading your back-up files.

III. Creating the YaBBforBoardMod Folder Now, we want to download the cgi-bin\yabb files from the server to your hard drive so that BoardMod can modify them. Go to My Computer or Windows Explorer and make the directories (folders) as below: YaBBforBoardMod (or whatever you decided to call it)

   Admin
   Languages/*
   Sources
   Templates/*
   Variables

Since BoardMod doesn't change files in the Boards, Members, or Messages folders there is no reason to download them here.

After you've got your directory structure set up, use your FTP program (ex. CuteFTP or whichever one you're using) to connect to your remote server. Once connected: 1. Download the following files from the cgi-bin\yabb folder on the server to the YaBBforBoardMod folder on your hard drive: YaBB..pl. & AdminIndex.pl

2. Next, change directories to download all the files from the Admin folder on the remote server to the YaBBforBoardMod\Admin directory on your hard drive.

3. Next, change directories to down load all the files from the Sources folder on the remote server to the YaBBforBoardMod\Sources directory on your hard drive.

4. Next, change directories to down load all the files from the Languages folder on the remote server to the YaBBforBoardMod\Languages\* directory on your hard drive.

5. Next, change directories to down load all the files from the Templates/* folder on the remote server to the YaBBforBoardMod\Templates\* directory on your hard drive.


Now, you have the files that we need for BoardMod to work on. You're ready to get started installing mods!


More Info

BoardMOD MOD FAQ's: http://www.boardmod.org/faq.php

BoardMODding Useage:
http://www.boardmod.org/docs/boardmodforthebloodynovice.html


Edited:
Edited to update most recent version number of BoardMOD and to correct broken link to BoardMOD FAQs- ohe

« Last Edit: Jan 17th, 2010 at 5:54am by »  
Back to top
 
IP Logged
 
Captain John
Ex Member


MOD the Complete Instructions Part 2
Reply #1 - Feb 29th, 2008 at 12:07am
Print Post  
Now that you have completed the above......

Your directory structure on your hard drive, should look like this ....

c:\YaBBBackup\Admin
           |_____\Boards
           |_____\Members
           |_____\Messages
           |_____\Sources
           |_____\Variables

  The files you have downloaded to these folders above are your Safety Backup, incase something goes wrong.  NOT to be used unless needed.

You should also have this directory file structure setup, below ......

c:\BoardMOD                               <~~~~ BoardMOD Program files
          |____\ModEditor                <~~~~ ModEditor Program files
          |____\Mods
          |            |_2.1                  <~~~~
          |            |_2.2                  <~~~~| Depending on Version (for example create 2.3 or now 2.4)
          |            |_2.2.1               <~~~~
          |
          |           These folders below hold your forum files
          |
          |____\Forum                    <~~~~ YaBB.pl & AdminIndex.pl files
                        |__\Admin
                        |__\Help\English
                        |__\Languages\English
                        |__\Sources
                        |__\Templates\default
                        |__\Variables

  According to the Version of your YaBB Forum you MUST use a MOD that is compatible with your Forum.
 Copy the file within the MOD zip file you downloaded, that has a .mod extension (No others !) in to the folder shown above, that matches your YaBB version number.
  Now you are ready to Run BoardMOD.exe

"After" you have run BoardMOD the program on your files ...

Note:  a lot of MODs require New additional files to be uploaded to your server, be sure to include these to your sever.

ALWAYS be aware of the proper transfer mode !  AscII mode for everything except images, which should be uploaded using Binary transfer mode.
« Last Edit: Apr 25th, 2010 at 6:06am by »  
Back to top
 
IP Logged
 
Page Index Toggle Pages: 1
Print
 
  « Board Index ‹ Board  ^Top