Web Messaging Professional 98 for WINS, version F.2
Original archive name: WMP98F2?.ZIP

Author:       Earl Borah          earl.borah@bbs.chemek.cc.or.us
Home Site:    Chemeketa Online    http://bbs.chemek.cc.or.us

WMP98 Home Page:        http://bbs.chemek.cc.or.us/public/ring/sysop.htm#wmp
WMP98 Listserve Info:   http://bbs.chemek.cc.or.us/public/ring/subscribe.htm


  ** NEW ** NEW ** NEW ** NEW ** NEW ** NEW ** NEW ** NEW ** NEW ** NEW **
If you have installed a previous version of WMP98, note that this archive is
in a different format. Please read this readme.txt file before you begin the
installation in order to avoid any headaches later. I reserve the right to
say "I told you so."


     *** BEFORE YOU INSTALL THIS PROGRAM, READ ALL THE DOCUMENTATION ***
NOTE: This document is formatted to be a maximum of 78 characters wide, which
should hopefully make it easy to print, even from something like Notepad.
Make sure your font is small enough to fit 78 monospaced characters on the
page.


Contents:
1. What files are in this archive?
2. Installation
3. Configuration
4. Registration
5. Legal Mumbo-Jumbo (license and copyright)
6. Acknowledgements




1. WHAT FILES ARE IN THIS ARCHIVE?

NAME              DESCRIPTION
buglist.txt       Documentation: List of known bugs
codes.txt         Documentation: Tutorial on use of @ codes in template files
file_id.diz       Documentation: Short description of this archive
readme.txt        Documentation: This file
register.txt      Documentation: How to purchase WMP98
setup.exe         Installation Program for AddressBook (WMP98F1f.ZIP only)
versions.txt      Documentation: Version history, features and fixes added
wishlist.txt      Documentation: Feature requests and future plans for WMP98
WMP Home.zip      Addon: Enhanced Inbox Notification
WMP98.zip         Main program. Unzip in WINS directory using path info


IN WMP98.ZIP:

NAME                         STORED PATH         DESCRIPTION
account_info.htm             http\template       Personal Properties template
account_info.htm             http\template\WMP   Same, for use with frames
addressbook.exe              cgi                 DHTML Address Book CGI
addressbook.mdb              data                DHTML Address Book database
attach.htm                   http\template\WMP   Select file to upload
carbon_ok.htm                http\template\WMP   Carbon copy successful
dhtmlab config.exe           none (WINS home)    Sysop config program
html-personal.wcx            none (WINS home)    Program file (preferences)
html-popup conflist.wcx      none (WINS home)    Easy Conference Selection II
html-read message.wcx        none (WINS home)    Program file
html-thread index.wcx        none (WINS home)    Program file
html-web messaging pro.wcx   none (WINS home)    Program file
html-wmp personal.wcx        none (WINS home)    Program file (preferences)
html-wmp upload.wcx          none (WINS home)    Program file
inbox.htm                    http\template       Inbox with fix
invalidname.htm              http\template\WMP   TO invalid, select again
message.spellcheck.popup.htm http\support        Spell check help file
message.thread.popup.htm     http\support        User help documentation
message_attachment_ok.htm    http\template\WMP   Message w/attachment sent ok 
message_conferences.htm      http\template       List conferences on system
message_create.htm           http\template       Create a new message
message_create_again.htm     http\template\WMP   To, Subject, or Body blank
message_index.htm            http\template       List messages in conference
message_ok.htm               http\template\WMP   Message sent successfully
message_read.htm             http\template\wmp   Read message with threads
message_search.htm           http\template       List index of search results
popup_conflist.htm           http\template\WMP   Select conference from list
properties.popup.htm         http                Personal properties redirect
spell_ok.htm                 http\template\WMP   No misspellings found
spellcheck.htm               http\template\WMP   Select correct spellings
spelldefault.htm             http                Set spell check defaults
spelledit.htm                http\template\WMP   Re-edit after spellcheck
testing.htm                  http                Test WMP - for sysop use
thread_index.htm             http\template\wmp   Index messages from a thread
threadindex1.gif             http\images         Graphic
threadindex2.gif             http\images         Graphic
threadnext1.gif              http\images         Graphic
threadnext2.gif              http\images         Graphic
threadprev1.gif              http\images         Graphic
threadnext2.gif              http\images         Graphic
wmp.key                      data                Registration key


The names and locations of most of these files are critical! Changing the
name of any of these files (particularly .htm or .wcx files), or placing any
of them in the wrong directory, can prevent WMP from working properly.

If you unzip these files into your WINS directory with the "use stored path"
switch turned on, then they will be placed in the appropriate directories
automatically. BEFORE YOU INSTALL THIS PROGRAM, READ ALL THE DOCUMENTATION.




2. INSTALLATION

Version F.1 caused problems for some sysops. The ones who followed my super-
secret advanced-level advice were saved. Want to know what the secret advice
was? Here you go:

Read everything before doing anything. Backup your system. Read everything
before doing anything. Backup your system. Read everything before doing
anything. Backup your system.

Read everything before doing anything.

Backup your system.

Got the hint yet?

In the first ZIP file you encountered, you found this readme.txt file, as
well as another ZIP file. The WMP98.ZIP file contains the actual program
code, and how you extract it is important. Make sure you have a 32-bit unzip
utility (such as WinZip) that supports long filenames. When you are ready to
install, unzip WMP98.ZIP into your WINS directory, with the switch to "Use
Folder Names" enabled. This will install Web Messaging Pro 98 on your system
-- you can do it while wcServer is running if you wish, and the update will
be effective immediately!

      ***   CAUTION   ***   CAUTION   ***   CAUTION   ***   CAUTION ***

CAUTIONS: Some files from your system may be overwritten by this installation.
The most likely files to be overwritten are the following:

  html-personal.wcx                      - Adds new customization options for
                                           systems running WINS build 443 or
                                           higher
  html-read message.wcx                  - Will not exist unless you have a
                                           custom version in your WINS
                                           directory
  \data\AddressBook.mdb                  - BACK UP THIS FILE! This is the
                                           database that stores ALL your
                                           users' address book information.
                                           This file can be placed anywhere
                                           on your server, but if it is lost,
                                           your users' entries are lost. Back
                                           it up regularly and before every
                                           upgrade to WMP98 to minimize risk
                                           of loss
  \data\wmp.key                          - BACK UP THIS FILE! If you have
                                           purchased a WMP98 registration, be
                                           careful about installing new
                                           versions and make sure your key
                                           file is not overwritten by the
                                           "sample" key file included in the
                                           installation archive
  \http\account_info.htm                 - New version adds option for
                                           changing the default spell checker
                                           settings AND is more frame-friendly
                                           Requires the html-WMP personal.wcx
  \http\template\inbox.htm               - New version fixes bugs in the way
                                           the inbox behaves
  \http\template\message_conferences.htm - New version adds link to the DHTML
                                           AddressBook CGI
  \http\template\message_create.htm      - New version adds essential
                                           elements required by WMP
  \http\template\message_index.htm       - New version adds message style
                                           options
  \http\template\message_search.htm      - New version adds message style
                                           options

*** NEW TO VERSION E.x ***

SPECIAL NOTE: Easy Conference Selection Addon
Versions of WMP98 prior to E.1 included an Easy Conference Selection Addon
(also available as freeware). This addon allowed users to select the
conference for a new message via a drop-down dialog box. THIS ADDON HAS BEEN
REPLACED IN VERSIONS E.1 AND HIGHER, AND SHOULD BE REMOVED FROM YOUR SYSTEM.
To remove this addon from your system, look in your WINS directory for a file
named "html-new message.wcx" and delete it or move it from that directory.
You may also wish to move or delete the file named "message_create2.htm" from
your http\template directory. It may be necessary to restart wcOnline after
you remove the .wcx file to force WINS to see the change.

POSSIBLE BUG
One registered user of WMP98 had trouble with upgrading to version E.x.
Specifically, removing the "html-new message.wcx" file caused errors when he
tried to send a message. While this appears to be a WINS-related bug, you can
work around it for now by returning the "html-new message.wcx" you removed in
the paragraph above, and copying the new message_create.htm included with
this archive to message_create2.htm.

SPECIAL NOTE: AddressBook.exe
This file must be installed in your CGI directory. If you run wcOnline on
multiple servers, then you may need to install this file on each server,
depending on your configuration. This file should be saved to the directory
specified in wcConfig/Computers/Edit/CGI Path (this directory can be
different for every machine that runs wcOnline -- please see the MSI online
help file for more information). We recommend this path be set to something
like c:\wc5\cgi -- it should *NOT* be set to a directory inside your
\wc5\http directory, for security purposes.

Regardless of the location of your CGI directory, the URL for your cgi
directory is http://yourdomain/cgi/application.exe -- so do *NOT* modify the
included templates to point to a different directory, because they are
already correct.

BEFORE YOU CAN USE THE ADDRESSBOOK CGI, you must run the DHTMLAB Config.exe
application. This program must be run on every machine that runs wcOnline.
You must point the program to the location of the AddressBook.mdb (point
every machine to the SAME file on the same machine -- UNC paths are
acceptable) and you must enter your WMP98 Registration Key. These settings
are saved in the registry, and are used by the AddressBook CGI every time it
is run.

TROUBLESHOOTING
If the AddressBook CGI generates errors, check the following:

* Do you have wcsrv.dll in the path? It should be in the WC5 directory.

* Do you have wcvb.dll in the path? If not, you can download the latest
version as part of the wcSDK from MSI's file areas -- it was not included in
this archive to avoid potential version conflicts.

* Have you ever installed a VB5 application (particularly one that accesses a
database)? If not, then you may need to download the "full" version of WMP98
(approximately a 3.7 Meg download) so you can run the Setup program included
with the archive. The "full" versions of WMP98 have filenames that end with
the letter "f", like WMP98E2f.ZIP

* Are you getting the error: "ActiveX component can't create object Error
Number =  429"? If so, then you need to download the "full" version of WMP98
(approximately a 3.7 Meg download) so you can run the Setup program included
with the archive. The "full" versions of WMP98 have filenames that end with
the letter "f", like WMP98E2f.ZIP

That's really it for installation! Make sure you read the configuration notes
below, however.




3. CONFIGURATION

You can choose to edit any of the template files for Web Messaging Pro, just
as you can edit the templates that WINS uses internally. The CODES.TXT file,
included with this archive, includes more information. Here's some more
things to be aware of, and some tricks to try.

NEW:To provide a simple link to the DHTML Address Book sysop utilities, use a
    link like this: <A HREF="/cgi/AddressBook.exe?action=SYSOP">Utilities</A>
    We use a link like this on our sysop home page.

NEW:Some Sysops have expressed a desire to exchange the buttons that launch
    the popup DHTML AddressBook window with a graphic (perhaps a graphic of a
    Rolodex, for example). Since I couldn't find a graphic I felt suitable, I
    did not include that as a standard option in the templates. However, you
    can edit the message_create.htm and replace the HTML code for the buttons
    with HTML code for a graphic and an appropriate link. Find the line:
    <input type=button value=" ... "
    onClick="openWindow('/cgi/AddressBook.exe?action=SELECT','DHTMLAB');">
    and replace it with something like this:
    <a href=
    "javascript:openWindow('/cgi/Addressbook.exe?action=SELECT','DHTMLAB');">
    <img src="/images/rolodex.gif" border=0></a>
    You could do the same thing for the conference selection popup, and for
    the AddressBook popup where it appears on other templates pages (such as
    message_ok.htm, carbon_ok.htm, and message_attachment_ok.htm).

  * In any of the @ codes, capitalization may be important. If you edit or
    move them and WMP stops working, make sure you did not change the
    capitalization. See the enclosed CODES.TXT file for more details.

  * With few exceptions, all WMP templates must be in your system's
    wc:\http\template\WMP\ directory (where "wc:" is the drive and directory
    where WINS is installed). If you place the files in the template
    directory instead of the template\WMP directory, then they will not be
    found and you will get errors when you try to use WMP.

  * Want to force spell checking on for all users, and keep them from turning
    it off? You can -- see the CODES.TXT file for instructions on modifying
    the message_create.htm file!

  * Want your users to be able to easily edit their personal properties? Use
    the new account_info.htm templates to add this functionality to the DHTML
    Personal Properties client. Plus, if you ever launch the Personal
    Properties client by clicking on a link in one frame, but want it to open
    in another frame, have the link point to the enclosed
    properties.popup.htm file instead of pointing the the .wcx directly, and
    the Personal Properties DHTML client becomes frames-friendly! If you
    don't use frames, just use the standard link you've been using all along
    -- it couldn't be much simpler than that!

  * Want to send carbon copies of a message, but want one to be public and
    the rest to be private? Edit the templates slightly, and you can! In all
    three of the template files that end in "ok.htm", find this line:
    <INPUT TYPE="hidden" NAME="private" VALUE="@SUB query.private@">
    and replace it with something like this:
    <B>Private:</B> <input type=checkbox name="private" value=1 checked>
    This would allow the user to edit the private status of the message, and
    would assume the carbon copy would be private (regardless of the status
    of the original).

  * In the threaded messaging component, two sets of thread buttons are
    provided (the thread buttons are provided courtesy of Steven Aiello of
    Toastronics Online, http://www.bai-net.com:81). You can choose which
    version of the buttons you want by editing the message_read.htm and
    thread_index.htm files -- look for the IMG tags, and change the
    filenames (or easier yet, just rename the files in your images
    directory).

Also, make sure a WMP.KEY file exists in your data directory. It can be a
blank file, but it *MUST* exist. When you register, you will be given a code
to place on the first line of this file. This code will "unlock" WMP for all
your users. Make sure you back up the code once you receive it -- and when
you install updates to WMP98, make sure your key file isn't overwritten with
the demo file included with most versions of the WMP98 archives.

Next up -- you may want a custom dictionary, right? So you can make sure your
system's name and your system administrator's name don't show up as
misspelled words, right? No problem. In fact, the situation may be solved
before you even installed WMP98. That's because WMP98 uses the same spell
check dictionaries used by the ANSI side of your system -- so if you were
ever in the ANSI side of your system and added "Chemeketa" to your dictionary
(we did!), then it's there in DHTML mode, too! There are two ways to update
your system's dictionary:

  1. Go to the ANSI side of your system, and type in a message with a word
     the spell checker doesn't recognize. If you are the sysop, you'll be
     given the option of adding that word to the dictionary (your users will
     NOT be given this option). Add it on the ANSI side, and it's there for
     the DHTML side as well! Remember that the changes you make affect
     everyone on your entire system, so don't make "duh" a word unless you're
     sure you want it to be valid for everyone!

  2. Fire up Notepad (or your favorite text editor -- I personally couldn't
     do without the freeware notepad replacement RogSoft Notepad+:
     http://www.xs4all.nl/~theroge/  -- now it even has spellcheck support
     through a third party!). Okay, that add is over, but what you need to
     look for is a file named USERDICT.TXT in your data directory. Open it
     up, and you'll see it's just a standard text file, with a separate word
     on each line. Just add the words you want (remember to check the
     spelling!), and you're set. If you can't find the file, you can add it
     manually (make sure it's a plain text or "ASCII" file, and that there is
     one word per line).

BTW...you may want to add a few words like "telnet" and "Microsoft" and
"Netscape" to your custom dictionary, if they're not there already. It seems
the dictionary MSI uses doesn't recognize those as legitimate words. At least
it's got a handle on "internet."




4. REGISTRATION

You can purchase Web Messaging Pro for just $49! See the REGISTER.TXT file
for more details. We can accept checks, money orders, VISA, and MC orders (US
funds only, please).

From time to time, specials may be announced. These announcements will be
made *ONLY* on WMP's home page, at http://bbs.chemek.cc.or.us/public/ring/sysop.htm
If you don't visit that site, you may not hear about the latest offers, and
you may not be eligible for any discounts.




5. LEGAL MUMBO-JUMBO

MY WORDS:
I promise nothing -- even if you pay me, I still promise nothing. In plain
English, that means that if this breaks, tough. I don't promise it will work,
nor do I promise it won't reformat your hard drive, thoroughly trash WINS
(not to mention all those X-Rated GIFs you have hiding under the "UNIX news"
directory where you think nobody will see them), drive you to drink, steal
your dog's loyalty, drink the last of the milk, make prank phone calls to
911, and basically make a nuisance of itself. However, thanks to user
suggestions, future versions may have the capability of calling the IRS and
suggesting they audit you -- but no promises on that feature until it's
formally announced in the VERSIONS.TXT file.

If it breaks, tough. If it doesn't work, tough. If it makes everything else
go "cabloooey!", tough. Don't blame me. That's the disclaimer in a nutshell.

I will say (although I don't promise, guarantee, or warrant -- or otherwise
say anything that an expensive lawyer could make me wish I hadn't said) that
if you have a problem and you let me know about it, I'll try to fix it. After
all, I want to be honest and fair (without risking my livelihood to an idiot
with a great attorney).


Now, the copyright notice in a nutshell: This program belongs to me. It's
mine, mine, mine, mine, MINE!

You can use it if you want to spend the bucks to register it. You can even
distribute it (*EXCEPT* for prerelease/preview versions, which you are *NOT*
allowed to distribute) as long as you don't charge anyone for it (charging
enough to cover distribution costs is acceptable).

What you CAN'T do is try to "decompile" any portion of this code for any
reason (besides, we all know you'd only try it in order to try to cheat the
registration process or to write your own version of this program, which
would be a BAAAAD thing to do and would make you feel terribly guilty once
you got over that satisfied feeling of pseudo-accomplishment).

If you buy a license, you can use it only on the WINS system you purchased
the license for (if that system runs on multiple physical computers, you can
run it on multiple physical computers, and that's NOT a violation of the
copyright or license agreement). The definition of "WINS system" is a single
running version of wcServer, with any number of instances of wcOnline running
simultaneously. In the event of any confusion or ambiguity over this license,
the author retains the sole authority to clarify, define, or even redefine
any and all terms.


SOMEBODY ELSE'S WORDS:

DISCLAIMER:
THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
WARRANTY, EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
PRODUCT BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES,
ARISING OUT OF ANY USE THEREOF, INABILITY TO USE OR BREACH OF ANY WARRANTY.

COPYRIGHT:
This program is copyrighted under US law and international treaty provisions.
You agree that your use of this program is subject to these laws, which
prohibit unauthorized copying or duplication of this program software,
documentation, and other materials.
This program may not be decompiled or reverse engineered for any reason.




6. ACKNOWLEDGEMENTS

Thanks to all the registered users -- your suggestions and registrations make
improvements and new features possible!

Special thanks go to Steven Aiello of Tostronics Online, who created the
buttons for the Threaded Messaging addon and provided them free of charge!
You can visit his site at: http://www.bai-net.com:81

Thanks also to the sysops and MSI staff (current and former) who hang out in
MSI's message areas, specifically those who frequent the wcCode message area.
Your comments and assistance helped me develop the skills that made this
project possible.

While I'm making acknowledgements, some final legal junk:

Microsoft, Microsoft Internet Explorer, Windows, Windows 95, and Windows NT
are trademarks or registered trademarks of Microsoft Corporation.

Netscape, Netscape Communicator, and Netscape Navigator are registered
trademarks of Netscape Communications Corporation.

Wildcat!, Wildcat! Navigator, and Wildcat! Interactive Net Server (WINS) are
trademarks or registered trademarks of Mustang Software, Inc.

WinZip is a registered trademark of Niko Mak Computing, Inc.

Other products and corporate names may be trademarks or registered trademarks
of other companies, and are used in these documents for illustrative purposes
only, and to the owners benefit, without an intent to infringe.




Web Messaging Professional 98
copyright 1998, Earl Borah. All rights reserved