How to get more out of WebBoard version 4.x, 5.x, and 6.x with Rog's Full-Page Posting System (version 1.0)

This describes freeware that I wrote which breaks down the distinction between message boards and web sites ... even as it allows you to meld the two together into a seamless unity.

In theory, web sites perform (at least) the function of delivering content: web site designers have the option of laying out their pages as they choose, and defining the relationships between these pages.

Unlike WebBoard managers and administrators, web site designers have no restrictions when it comes to using forms, client-side scripting languages, arbitrary numbers of fonts and colors, etc.

Message boards, on the other hand, support text- based interactions between users and/or the site administrators.  Insofar as WebBoard provides freedom to customize pages, this freedom (ostensibly) exists only within the confines of the "standard" pages required by the message board function.

WebBoard is a message board package: not a web site server ... at least not, until now.


Imagine a situation in which a user clicks on a link in WebBoard's topics list: only to find that a fully-featured web page opens up in a new window (or the messages frame, if you like).

By fully-featured,, I mean that this page can have both client-side and server-side scripting, even if ASP isn't available - as well as forms, frames, etc.

On this page there are "feedback" links which let the user see what other users think (by viewing a WebBoard discussion thread), or offer his or her own feedback (by posting a WebBoard message).

Each post in the discussion ("feedback") thread carries a red regarding link back to the original web page, so that users who run into the discussion thread "accidentally" can see what all the chatter concerns.


But that's not all: consider a scenario in which a user clicks on a link in WebBoard's topics list.

In the messages frame, a very short web page (not necessarily a WebBoard message) opens up, which emphasizes that a PowerPoint presentation, or an Adobe file, or an MS-WORD document has just loaded in a new window.

The short web page is the "mediator" between the primary content (the PowerPoint presentation, Adobe file, or whatever it may be), and the discussion (in which users may provide feedback).  As before, each post in the discussion thread provides a red regarding link back to the original "mediating" web page, so that users who run into the discussion thread "accidentally" can see what all the chatter concerns.  The whole set-up looks like this:


Now go all the way: imagine creating a full-featured web site with a WebBoard "no authorization" board.  In other words, a web site that's indistinguishable from any other site on the net.  Users don't have to log in, they don't see a "frameset", a "conferences menu" (i.e. a topics list), or any of the other WebBoard overhead: all they see are the pages that you've placed in the site.


Did we go too far in the direction of web sites?

Perhaps, so let's move back a little bit towards message boards: consider the possibility of having a web site with various articles, written by experts - each designed to promote your firm's products or services.  Each article has "feedback" links that allow the user to post responses, or read other users' responses.  But there's no frameset, "conferences menu" (i.e. topics list), or any of the other WebBoard overhead.

In effect what you have is a "one-thread miniature message board" associated with each web page.  And users don't have to log in or register!

(How many virtal boards do you need to create that structure?  Just one.)


And to create any or all of these points on the spectrum between web sites and message boards, you don't need IIS, you don't need ASP, and you don't even need to be able to access the server via FTP!  The fact that you don't need FTP means that those who create your structures don't need the higher level of "security clearance" often required for those with FTP access.  Indeed, many system administrators don't even allow direct FTP access to their servers.

For those of you who are doubters at this moment, you might want to take a look at the on-line help pages.  There are three (cross-linked) pages, starting with: this one.

(You may be interested to know that there are "context" links into these help pages, in order to assist your staff in using this system.)


Why use this system, if you already have a web server?  First of all, without this system, your web server and WebBoard exist in two separate application arenas: they only way you can let them come together is via passive links.

Moreover, as the saying goes: "A person with one watch might know what time it is, whereas someone who has two watches is never quite sure."  In other words, one server is either "up" or "down": whereas there are four possibilities with two servers.


This code is freeware.  You use it at your own risk.  No warrany of fitness for use or any other form of guarantee inheres.

You may use it and/or the source code in whole or in part for any otherwise legal purpose that you deem fit; however you may not claim legal ownership of same for legal purposes against anyone who's obtained it from an "independent source" (such as this web page).


1:  Important Limits and Considerations

2:  Some other Considerations

3:  Install (1): Complete Install Zips

4:  Install (2): Standard Install

5:  Install (3): Install configuration

6:  Install (4): Rebuilding the source files, and/or making modifications

7:  Bug reports, comments, and change requests, etc.

8:  Other freeware products

9:  Version history information

10:  Acknowledgements


1:  Important Limits and Considerations

Please read this section carefully before you install and run this system.

Return to table of contents

2:  Some other Considerations

The items in this section are less critical than those I listed in the previous section.

Return to table of contents

3:  Install (1): Complete Install Zips

If you want this documentation, as well as all the included zip files, WebBoard 4 users can download fp4.zip instead.  WebBoard 6 users should download fp6.zip.

Once you download the complete zip file, you'll still have to follow the rest of the install instructions.

This system isn't currently supported for WebBoard 5, or the "modern" layout of WebBoard 6.  If you need such an animal, please contact me.

Return to table of contents

4:  Install (2): Standard Install

For WebBoard 4 users, the install file is: fp_rel4.zip.

For WebBoard 6, use: fp_rel6.zip.

This system isn't currently supported for WebBoard 5, or the "modern" layout of WebBoard 6.  If you need such an animal, please contact me.


Once you unpack the zip, you'll find that there are two folders: one is called fp: this contains the files that should be placed on the folder for your virtual board(s).  Note that there are some files in the help subfolder: these must be transferred to the help subfolder of the folder for your virtual board(s).

There are also some files in the images folder.  I'll tell you what to do with those in section 5.


If you've customized any of the WebBoard pages that are in my install, you'll have to either propagate your customizations to my pages, or propagate my alterations to your customized pages.

Here's a list of each file, along with the role it plays in the various operations:

WebBoard name or name on server: Purpose:
confadd.html Added a warning to the effect that conferences with associated e-mail and/or news groups must be excluded from the system, through the options available on the "manage conferences" page.
confedit.html Same as confadd.html, above.
confintro.html Removed the target of "_top" for no frames users who invoke the conferences menu.  See the description of fp_tpld.html below.  This file doesn't exist in WebBoard 4.
confmanage.html Added the section that allows a WebBoard Administrator or a virtual board manager to exclude conferences from this system (normally those conferences with associated e-mail lists or news groups), as well as to set the default window options for full-page posts that load in a new window.
confnotify.html "Massaged" the subject lines of posts, so the "annotations" at the end don't appear in the "watched topic" list.  This page doesn't exist for WebBoard 4.
help\fp_blk1.html This is the blank page that initially loads in the topics frame, for frames users.  See the description of layout1.html, below, for more information.  Actually, this page isn't blank: it says "Please wait ... ".
help\fp_blk2.html This is the blank page that initially loads in the hidden frame.  See the description for layout1.html, below, for more details.
cstat.txt This is the conference status include, which appears the toolbar frame (toolbar.html) of layout1.html, help\fp_npld.html, and help\fp_tpld.html.  It's maintained by confmanage.html (the actual writing is done by fp_wrtf.html and fp_wrtf.js), and it contains a list of all the conferences which are excluded from the system, as well as the window options for full-page posts that are loaded in a new window.
help\fp_bdid.html This page returns the board ID and some helpful information (like the "board prefix").  It uses the tag script, fp_bdid.js.
fp_bdid.js See the entry for help\fp_bdid.html.
help\fp_dirm.html This page is used to maintain the board's help folder, the main help folder and the images folder (the latter option isn't present in the WebBoard 4 version).  It uses the tag script fp_dirmt.js, to do most of its work.  But when the user clicks on links to image folder files, it loads help\fp_dirmi.html.
help\fp_dirmi.html See the entry for help\fp_dirmi.html.
fp_dirmt.js See the entry for help\fp_dirmi.html.
help\fp_fpld.html When a full-page post is loaded in a new window, this page will initially be loaded, instead.  It "talks" to the toolbar page, in order to collect the HTML that it will "print," via a document.writeln.
help\fp_npld.html This is the specialist that loads regardED posts in a new window, it's actually one of the frames that's contained within help\fp_npldx.html
help\fp_npldx.html Whenever a regardED post is loaded in a new window, this frameset loads: it contains a dummy "message" frame (this is where the regardED post will be loaded), a hidden "toolbar" frame (this actually loads the toolbar), and an "extra" frame (which is used for any additional processing that the regardED post may require).  This is the analogue of layout1.html, but for regardED posts.
help\fp_stfo.html This is the "staff options for this post" page.  It uses the tag script, fp_stfot.js.
fp_stfot.js See the entry for help\fp_stfo.html.
help\fp_tpld.html This is the page that automatically reloads, whenever a "no frames" user logs in, or the topics page is opened up in a new window.  It's actually a frameset, with a structure equivalent to that of layout1.html or help\fp_npld.html  See the explanation in section 2.
help\fp_wrtf.html This page actually writes fp_cstat.txt, by calling the tag script fp_wrtf.js.  See the explanation above for fp_cstat.txt.
fp_wrtf.js See the entry for help\fp_wrtf.html.
help\_fp_hlp?.html help\_fp_hlp1.html, help\_fp_hlp2.html, and help\_fp_hlp3.html are the three help pages: these are available via the link on the "more options" menu, but also load in "context dependent" ways from the posting page (for the staff posting options) and on the "staff options for this post page" (this is different from the posting page: you'll find a link to this page displayed after the text for each "ordinary" post.)
layout1.html This file was modified to load fp_blk1.html on the help subfolder (the URL is actually "help?fp_blk1") instead of the topics frame.  This is because 12K of compressed JavaScript source code resides in the toolbar frame, and I don't wish to reload it every time the user refreshes the topics frame.  This is the code that actually reformats the topics list.  Once the toolbar frame loads completely, it will load the topics list in the topics frame.  This file will also load fp_blk2.html on the help subfolder into a hidden frame.  That frame is used to perform certain additional functions, such as load the post-reading pages, in order to extract the message body.  It's also possible to load full-page posts into this hidden frame, if requested (this occurs when the posts contain the JavaScript needed to open up a new window.)
login.html The form tag was modified here, in order to remove the <board~> section: this will allow WebBoard to open up the frameset (for frames users) without a URL of http://www.yourdomain.com[:8080]/~BOARD/login.  It turns out that this URL syntax interferes with this system's ability to load files from the images or the upload folder via the syntaxes "wbimages/FILENAME" or "/upload/FILENAME" (the latter restriction occurs only under WebBoard 4).
more.html A new table was added here, for the additional options available to staff.
msgdelete.html Same changes as those for confnotify.html, above.
msgsearch.html Added code to prevent this page from loading in a new window.
msgsearched.html Same changes as those for confnotify.html, above.
msgtoday.html Same changes as those for confnotify.html, above.
postmsg-f.html Added the "staff posting options" form elements, and many other changes needed to support full-page posts, red regarding links and reply redirection.
postmsg.html Same changes those for postmsg-f.html.
preview.html Same changes as those for confnotify.html, above.
read.html Many changes were made here, in order to support the proper loading of full-page posts, red regarding links, and reply redirection.
readfull.html Same changes as those for postmsg-f.html.
toolbar.html This is where the code resides that will reformat the topics list, and handle much of the work associated with loading full-page posts.  Service functions for the post reading pages (read.html and readfull.html) as well as the posting pages (postmsg-f.html and postmsg.html) are also here.  This page is actually contained within help\fp_npldx.html and help\fp_tpld.html, but in a hidden frame.
topics.html This page captures the topics list, passes it to the code in the toolbar frame, and then displays the reformatted result: in the case of full-page posts, JavaScript is used to load them properly.
useredit.html Removed the target of "_top" for no frames users who invoke the conferences menu.  See the description of ea_tpld.html above.

Return to table of contents

5:  Install (3): Install configuration

Be sure you read the warning for administrators about possible security risks that may come from "renegade" virtual board Managers and/or conference moderators in section 1

Also, if there's any question about the trustworthiness of your board's conference moderators, see the first point in section 2


The rest of this section explains how to make the help pages available.  Since these are linked-to in a "contextual" way, I strongly recommend that you follow these instructions.

The first set of bullet points is for WebBoard 4; the second is for WebBoard 6.


  • WebBoard 4 - if you have direct access to the server (i.e. you can put files wherever you desire):

    Move the files in the images folder of the release zip to the c:\webboard\upload folder.  (Don't worry, you're not going to find any files by the same name that are already there!)

    Then move _fp_hlp1.html, _fp_hlp2.html, and _fp_hlp3.html to the c:\webboard\html\help folder.  You'll find these files in the fp\help folder, in the release zip.

  • WebBoard 4 - if you don't have direct access to the server (i.e., you only have web access), and you only need the help files available for one board:

    Create a private conference.  Then post a "dummy" message, in which you upload all the files on the images folder of the release zip.

  • WebBoard 4 - if you don't have direct access to the server (i.e., you only have web access), and you need the help files available for multiple boards:

    Create a private conference.  Then post a "dummy" message, in which you upload all the files on the images folder of the release zip.

    Now open up Windows Notepad.  Make sure that the Edit | Word Wrap option is off.

    Open up the file _fp_hlp1.html on the fp\help folder of the release zip.  Paste this file into a message post on your private conference, and post the message.

    When the post displays, scroll to the bottom and click on the "staff options for this post" link.

    Then scroll to the section entitled "Move Post to Main Help Folder", enter the file name of _fp_hlp1 in the box, and click on the COPY button.

    Repeat the procedure in the previous 3 paragraphs for _fp_hlp2.html and _fp_hlp3.html on the fp\help folder of the release zip (obviously, you'll be varying the file name that you put into the form that's in the "staff options for this post" page!).


  • WebBoard 6 - if you have direct access to the server (i.e. you can put files wherever you desire):

    Move the files in the images folder of the release zip to the c:\webboard\upload folder.  (Don't worry, you're not going to find any files by the same name that are already there!)

    Create a private conference.

    Now open up Windows Notepad.  Make sure that the Edit | Word Wrap option is off.

    Open up the file _fp_hlp1.html on the fp\help folder of the release zip.  Paste this file into a message post on your private conference, and post the message.

    When the post displays, scroll to the bottom and click on the "staff options for this post" link.

    Then scroll to the section entitled "Move Post to Main Help Folder", enter the file name of _fp_hlp1 in the box, and click on the COPY button.

    Repeat the procedure in the previous 3 paragraphs for _fp_hlp2.html and _fp_hlp3.html on the fp\help folder of the release zip (obviously, you'll be varying the file name that you put into the form that's in the "staff options for this post" page!).

    Finally go to the "more options" menu, and select the option to "Maintain files on the local (board's) help folder".  Delete the files _fp_hlp1.html, _fp_hlp2.html and _fp_hlp3.html from the board's help folder.

  • WebBoard 6 - if you don't have direct access to the server (i.e. you only have Web access):

    Create a private conference.  Then post a "dummy" message, in which you upload all the files on the images folder of the release zip.

    Now open up Windows Notepad.  Make sure that the Edit | Word Wrap option is off.

    Open up the file _fp_hlp1.html on the fp\help folder of the release zip.  Paste this file into a message post on your private conference, and post the message.

    When the post displays, scroll to the bottom and click on the "staff options for this post" link.

    Then scroll to the section entitled "Move Post to Main Help Folder", enter the file name of _fp_hlp1 in the box, and click on the COPY button.

    Repeat the procedure in the previous 3 paragraphs for _fp_hlp2.html and _fp_hlp3.html on the fp\help folder of the release zip (obviously, you'll be varying the file name that you put into the form that's in the "staff options for this post" page!).

    Finally go to the "more options" menu, and select the option to "Maintain files on the local (board's) help folder".  Delete the files _fp_hlp1.html, _fp_hlp2.html and _fp_hlp3.html from the board's help folder.

Return to table of contents

6:  Install (4): Rebuilding the source files, and/or making modifications

First, you'll need to download the source code.  For WebBoard 4, this is in: fp_src4.zip.  For WebBoard 6, this is in fp_src6.zip

Note that these zip files are contained within the "complete" install download, as described in section 3.

You'll need to unzip these files into a new folder on your hard drive.

After you do so, you'll have to install my "JavaScript MakeFile" system onto that same folder: http://www.rs-freeware.org/jsm.

Within the JavaScript MakeFile system, I offer specific instructions for WebBoard users, at: http://www.rs-freeware.org/jsm/jsmdoc.htm#WebBoard_Regenerate.

In a nutshell: after installing the "JavaScript MakeFile" system, you'll have to modify the "make" file: ea.mak.

This is the line that you'll have to change:


DEST=f:\\w\\html\\fp

DEST should have the folder name of the board from which you wish to run the thread sequencing system.  If you wish to use multiple boards, please be sure to read (?install_mult)section (#?install_mult).

Note that double backslashes are required to separate folder names.

For more information about folder names, please see my DOS primer.


This doesn't show you how to rebuild or customize the "help" files.  Please contact me if you want more information on how to do this.

Return to table of contents

7:  Bug reports, comments, and change requests, etc.

You can e-mail me at rog@NOSPAM_rs-freeware.org if you encounter problems, or think that you've found a bug.

I can also be reached by telephone in the U.S. from about 9 AM U.S. central time to 5 PM U.S. central time at: 765-742-6705.  If you don't get an answer, you can use my numeric pager at: 765-417-0664 ... I'll try to call you back, if you're in the U.S, Canada, or Mexico.


Please supply me with as much information as you can about your server, your version of WebBoard, any browser or Operating System that was involved, including the WebBoard Server's Operating System  (9x, NT, 2K, XP?).  Also, please provide any configuration files, or customized WebBoard files that you were using.  Keep in mind that I might actually have to have the opportunity to try what you were doing, in order to diagnose the problem.


BTW, I don't gaurantee to answer all e-mail or fix all bugs, etc.  Please remember that this is freeware, and that my time and resources are limited.

That said, I've put a lot of work into designing, coding, testing, and documenting this product, and I'm probably going to be fairly interested in any comments anyone has, fixing any bugs, and/or extending the scope to applications that strike me as being potentially valuable to a large number of users.


Naturally, if you're willing to hire me to make changes for your special-purpose application, I'm certainly willing to consider your offer.  My standard rate is $75/hr., but I may charge less if the work is to be done for a small business (less than 25 employees), or a nonprofit organization (in the latter case, I might even do it on a gratis basis  :-)  I may also consider charging you nothing if you're suggesting an improvement that I feel is of value to a large number of other users.

You can find out more about me, including references, and a list of clients/projects at: http://www.rs-freeware.org/rog.

Return to table of contents

8:  Other freeware products

WebBoard users will find lots of WebBoard freeware at: http://www.rs-freeware.org/freeware.htm.

Anyone who writes JavaScript  (regardless of whether this is written on the client or server side),  deals with SQL, or who happens to be interested in obtaining the full power available from DOS may wish to check out http://www.rs-freeware.org/free2.htm

Return to table of contents

9:  Version history information

This is version 1.0, released on Nov. 1, 2002.

Aug. 7, 2003: patched bug in post exporting that omitted the inclusion of the JS to process the automatic rewrite of the URL for posts that are viewable from "outside the board" (i.e. on no-authentication boards) if the post lacked the Q_Post or Q_Reply JS calls and a reference to images on the WBImages folder.  This is incorrect: the inclusion of either an image on the upload folder or the Q_Post call should also trigger the inclusion of the extra JS.

This documentation was generated by Rog's FAQHack: a DOS/Windows-based freeware program that handles simple macro preprocessing with special support for FAQs and other structured HTML documents.

Return to table of contents

10:  Acknowledgements

Thanks to Lisa Henning (the user interface manager at O'Reilly), and Sheryl McKenna (the Information Services manager at the Academy of General Dentistry), for reviewing previous incarnations of this system.

Return to table of contents