How to get more out of WebBoard version 4.x, 5.x, and 6.x with Rog's "Cut-and-Paste Users" System (version 1.0)

Word processors and text editors are great.  You can take a sentence from one document, a paragraph from another, and combine both of them with a page from a third file: in order to create a fourth document - minus a paragraph from the third document.  (Let's assume that you want to exclude that paragraph.)

Wouldn't it be nifty if WebBoard worked that way?  For example, you should be able to "cut and paste" the user list for one private conference into another.  Or copy the subscriber list for e-mail lists, or the membership lists of boards, regardless of whether they're open or closed boards.

Perhaps you wish to take the membership list of a private conference, and create a new board with those users.

In fact, why can't you take the user list from board A, add the members of a private conference on board B as well as the subscribers to a conference e-mail list on board C, and then use the combination to create a private conference, or an e-mail list on board D, except for the members of a private conference on board E?

This system allows you to just about anything you can imagine with the subscribers to conference e-mail lists, the membership list for private conferences, and the users associated with any board.  However, only WebBoard Administrators can "cut and paste" the user lists for boards.

Because this free product works entirely on the client side, it requires no direct WebBoard database access.


If you're a WebBoard administrator, you can also use this system to get a "quick list" of all the user's login names and real names on any given board.

This assumes that none of the users have placed tabs, commas, parentheses, or double quotes in their login names, first names, or last names.

The system comes with special versions of the profile editing and new user registration pages: these stop users from using those illegal characters in their login or real names.  So: if you wish, you can "clean up" the existing user list by modifying the profiles of the few users who actually do have tabs, commas, parentheses, or double quotes in their real or login names.  After that, you'll be assured that no other users will have these illegal characters in their real or login names.


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:  Before you begin: would you prefer to install the "automatic e-mail list signup" system, instead?

2:  How the system works

3:  Example 1: Combining and Excluding

4:  Example 2: Intersections

5:  Install (1): Complete Install Zips

6:  Install (2): Standard Install

7:  Install (3): Rebuilding the source files, and/or making modifications

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

9:  Other freeware products

10:  Version history information

11:  Acknowledgements


1:  Before you begin: would you prefer to install the "automatic e-mail list signup" system, instead?

The automatic e-mail list signup system has all the capabilities of this system ... plus: it allows you to designate up to 8 "suggested" conference e-mail lists.

The user has the option of signing up for any of these lists on the new registration page.

You may also designate any number of conference e-mail lists as "mandatory": the user is forced into these lists, and can't unsubscribe from the web (for WebBoard 4, that's the only way to unsubscribe).

The automatic e-mail list signup system also allows users to look up their passwords, simply by entering their e-mail address ... this prevents board staff from having to look up login names for users who rarely visit the board on the web.


So-o, you ask: "Why are there two separate systems?"

The downside is that the automatic e-mail list signup system requires database access: you absolutely must be able to use "tag scripts" that read the WebBoard database.

If you want to learn more about this system, please browse to: http://www.rs-freeware.org/ls/.

Return to table of contents

2:  How the system works

WebBoard uses three very similar pages to manage the user list for private conferences, the subscribers for conference e-mail lists, and the users in a board (the latter is accessible only to WebBoard administrators).

The key here is that lists of user ID#s are the coin of the realm.

To see how this works, first install the system (see below for the installation instructions).

Then create a private conference (if you don't have one already), and then add a few users to the conference.

Note that in the right frame, you can extract all the user ID#s for that conference (the users have to be currently enrolled).  If you click on the show user list link and scroll down in the left frame, you'll see a place where you can paste in a list of user ID#s, to be added to this conference's user list.

In the right frame, you can also delete users by using a list of user ID#s.


Finally in the right frame, you can also extract a list of user ID#s, login names, and first/last names: this list can be formatted in "commas-and-quotes" format, or in "tab-delimited" format.

Caveat: the detailed list of users won't necessarily be accurate, if some users have placed tabs, commas, parentheses, or double quotation marks within their login names, first names, or last names.  Although WebBoard 5 and 6 are fairly careful about allowable login names, they exert very little control over first and last names.

If you're a WebBoard administrator, you can access the users on the board, by going to the administrator menu, and selecting the "Add users to board" option.  Assuming that none of the users on your board have any of those forbidden characters (tabs, commas, parentheses, or double quotes) in their login names, first names, or last names, you can also get a fairly informative user list.

Note that the useredit page, and the new user registration pages have been altered, in order to prevent these illegal characters from appearing in login names, first names, or last names.

The same hasn't been done for the Add users option: so you can manually add users with these prohibited characters in their login names, first names, or last names.  Obviously, I don't recommend doing this.

If you're a WebBoard administrator, and you want to use the detailed user info. feature, then I recommend that you use my User DB Batch Processor to extract the information for all the users on the board, paste the results into a text editor, and then check for users who appear to have illegal login names, first names, or last names.  Or, if you have database access, you can write a very simple SQL query (e-mail me if you'd like help writing it).

Unless you have a very large number of users, you may not find any users with tabs, commas, double quotes, or parentheses in their login or real names.  And if you do find some, then edit their profile information and remove those illegal characters.  From then on, you'll be able to rapidly extract detailed user information for any current board.

Return to table of contents

3:  Example 1: Combining and Excluding

(This example presumes that you have administrator access.  However, if you're a virtual board manager, similar techniques will work in order to "copy" or combine private conferences' user lists or subscriber lists for conferences that have associated e-mail lists.)


Suppose you have a board that concerns childrearing issues.

On this board, there's a private conference for parents of "gifted" or "above average" children.

You have another board that's directed to educators, some of whom are associated with special "magnet schools" that draw in unusually capable students.

A third board is populated by child psychologists.  On that board, there's a mailing list for psychologists who treat autistic children.


You'd like to create a new board, for everyone who's concerned with the education of gifted children.  It should contain the parents who are in the first board's conference for gifted children, all the educators in the second board, and all the child psychologists on the third board, except those who are on the mailing list that focuses on autistic children.

(If these requirements seem strange to you, please try not to worry: I'm just trying to come up with an interesting example!)


Here's what you do:

  • Step 1: Extract the user ID#s from the private conference for parents of gifted children.

    Go to that board, choose "manage conferences" and click on the "users" link for that conference.  Scroll down on the right until you find the "EXTRACT" button, and click on it.  For the fastest results, you may wish to check the box that indicates that you only want the user ID# list.

    Next, open up a notepad window.  Paste the list of user ID#s into that window.

    Note: if there are a lot of users, you may wish to right-click in the box and choose "select all."

  • Step 2: Extract the user ID#s from the board for educators

    Go to the administrator menu (in "more options") and choose "Add users to board".

    As before, click on the "EXTRACT" button.  Again, for the fastest results, you may wish to check the box that indicates that you only want the user ID# list.

    Now paste the list of user ID#s into the open notepad window that you created in Step 1, above.  (You don't even need to add a new line between the two lists: just make sure that the comma at the end of the first list remains there.)

  • Step 3: Extract the user ID#s from the board for child psychologists.

    This is essentially the same as Step 2, above -- except that there's a different board involved.

  • Step 4: Extract the user ID#s from the subscriber list for the psychologists who specialize in autistic children.

    Go to the administrator menu (in "more options") and choose "manage mailing lists".  Then select that mailing list.

    As before, click on the "EXTRACT" button.  Again, for the fastest results, you may wish to check the box that indicates that you only want the user ID# list.

    Now open up a new Notepad window, and paste the list of user ID#s in.  Remember, these are the users who aren't going to be added to the new board!

  • Step 5: Build your new board, and create the user list.

    Go to the administrator menu for the new board, and select "add users to board."  Then click on "show user list" and paste the users from the first notepad window into the box in the lower part of the left frame.

    Then, click the button that says "ADD".  (Be sure to wait until you get the alert which tells you that the system is done adding users.)

    Finally, click the "SUBMIT" button near the top of the right frame.

  • Step 6: Remove the subscribers to the e-mail list for psychologists who specialize in autistic children.

    Scroll down in the right frame, to the box that allows you to delete users.

    Paste in the users from your second notepad window.

    Then, click the "DELETE" button.  Wait for the alert that says that the system is done deleting users.

    Finally, click the "SUBMIT" button near the top of the page.

Return to table of contents

4:  Example 2: Intersections

If you want to be even fancier, you can perform intersections on groups of users.

For example, suppose you have two private conferences: let's call them conference A and conference B.

You want to build a new conference, C: this consists of the users who are in both conference A and conference B.

The trick here is to use a little "set theory" (remember those Venn diagrams from high school?).

Return to table of contents

5:  Install (1): Complete Install Zips

If you want this documentation, as well as all the included zip files, WebBoard 4/5 users can download cu4.zip instead.  WebBoard 6 users should download cu6.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 the "modern" layout of WebBoard 6.  If you need such an animal, please e-mail me at flagger14@hotmail.com.

Return to table of contents

6:  Install (2): Standard Install

For WebBoard 4/5 users, the install file is: cu_rel4.zip.

WebBoard 5 users will have to copy useredit5.html to useredit.html, and sysadmin5.html to sysadmin.html.


For WebBoard 6, use: cu_rel6.zip.

This system isn't currently supported for the "modern" layout of WebBoard 6.  If you need such an animal, please e-mail me at flagger14@hotmail.com

These files should be placed on the folder of the board that you designate for this system.  Note that there's a subfolder called "help" in each of the zips: the files on this folder must end up on the corresponding subfolder of the board.


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:
newuser.html Blocked users from using tabs, commas, parentheses, or double quotees in their login names or first/last names when registering as new users.
newuser-e.html Same as newuser.html, above, but for boards that use e-mail address verification.
select_forum.html For deleting a list of numeric user ID#s all-at-once from a private conference, or extracting user ID# lists from that conference  (or even a detailed list of users' ID#s, login names, and real names).  This is the page that comes up on the right frame when you maintain the user list for a private conference.
select_boardusers.html For deleting a list of numeric user ID#s all-at-once from a board's user list, or extracting user ID# lists from that board's user list  (or a detailed list of users' ID#s, login names, and real names).  This is the page that comes up on the right frame when a WebBoard administrator selects the "Add users to board" option on the administrator menu.
select_listusers.html For deleting a list of numeric user ID#s all-at-once from the subscribers to a conference e-mail list, or extracting user ID# lists from the e-mail list's subscribers  (or even a detailed list of users' ID#s, login names, and real names).  This is the page that comes up on the right frame when you manage the mailing list for the conference.
sysadmin.html Allowed access to select_boardusers.html for open boards.
sysadmin5.html Same as sysadmin.html but for WebBoard 5.  This file only exists in the WebBoard 4/5 install.
useredit.html Same changes as in newuser.html, above.
useredit5.html Same as useredit.html, above, but for WebBoard 5.  This file only exists in the WebBoard 4/5 install.
userlisting.html For adding a list of numeric user ID#s all-at-once to a private conference, a conference e-mail list, or the second method of replicating board membership.  (This is the page that comes up on the left frame when you ask maintain the user list for a private conference, a conference e-mail list, or adding users to a closed board.  It's also used to select conference moderators, virtual board managers, and administrators, but my code won't hurt those other functions.)

Return to table of contents

7:  Install (3): Rebuilding the source files, and/or making modifications

(Note: this section is here only because I offer it for all my systems.  However, this system contains no compressed JavaScript source code, because there are no pages that need to load quickly.  For that reason, there's not much point in "rebuilding" the source files -- you can easily modify each file as you see fit.)


First, you'll need to download the source code.  For WebBoard 4 and 5 users, this is in: cu_src4.zip.  For WebBoard 6 users, this is in cu_src6.zip

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

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://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: cu.mak.

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


DEST=f:\\w\\html\\cu

DEST should have the folder name of the board from which you wish to run this system.

Note that double backslashes are required to separate folder names.

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

Return to table of contents

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

You can e-mail me at flagger14@hotmail.com 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

9:  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

10:  Version history information

This is version 1.0, released on Dec. 5, 2002.

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

11:  Acknowledgements

Many users on the WebBoard suppport boards have expressed their need for capabilities of this sort, although I was mainly prompted to write this system by a recent post from Dave DeBronkart, as well as a request from Clesson Duke for another system.

Return to table of contents