Web Messaging Professional 98 for WINS, version A.1
Original archive name: WMP98A.ZIP
Formal release date: February 14, 1998

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

Contents:
1. What files are in this archive?
2. What does WMP do/What's New?
3. Installation
4. Configuration
5. Registration
6. Known bugs
7. Legal Mumbo-Jumbo (license and copyright)




1. WHAT FILES ARE IN THIS ARCHIVE?

NAME                         STORED PATH         DESCRIPTION

attach.htm                   http\template\WMP   Select file to upload
carbon_ok.htm                http\template\WMP   Carbon copy successful
conflist.zip                 none                Freeware messaging addon
html-web messaging pro.wcx   none (WINS home)    Program file
html-wmp upload.wcx          none (WINS home)    Program file
invalidname.htm              http\template\WMP   TO invalid, select again
message_attachment_ok.htm    http\template\WMP   Message w/attachment sent ok 
message_create.htm           http\template       Create a new message
message_create_again.htm     http\template\WMP   To, Subject, or Body blank
message_ok.htm               http\template\WMP   Message sent successfully
readme.1st                   none                Special prerelease info
readme.txt                   none                This documentation
register.txt                 none                Registration information
spell_ok.htm                 http\template\WMP   No misspellings found
spellcheck.htm               http\template\WMP   Select correct spellings
spelledit.htm                http\template\WMP   Re-edit after spellcheck
wmp.key                      data                Registration key


The names and locations of these files are critical! Changing the name of any
of these files, or placing any of them in the wrong directory, can prevent WMP
from working properly. The exceptions are readme.txt, register.txt, and
conflist.zip, which are not required by the program when it runs.

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.
As always, it is good advice to back up everything before doing anything.




2. WHAT DOES WMP DO? WHAT'S NEW?

What is Web Messaing Professional (WMP)?
Web Messaging Professional adds professional tools to the WINS dynamic-HTML
messaging system. Several features that should have been there from the start
can now be integrated into your system, and more are being planned! Here's
what's already in the program:

  * Spell checking 
  * File attachments (requires browser with HTTP Upload support) 
  * Carbon copies 
  * Users can send message to "all" or "All" instead of just "ALL" 
  * If TO, SUBJECT, or BODY fields are blank, user is prompted to fill them
    out 
  * In conferences set to "Prompt the user for a name to match," the user is
    prompted for a valid name and presented with a list of suggestions (if
    available) 

Additional plans include support for threaded messaging, modelled after the
threads on the ANSI side of the system.


About the Shareware version:
If you have not purchased a valid registration key, then WMP will work only
for the sysop (the user's name must match the name of the System
Administrator, as defined in wcConfig under General Info). Other users will
not be able to take advantage of spell checking, file attachments, or carbon
copies, although the other minor features will be active.


Versions:
2/14/98 - Update (version "A.1") fixed typo in "ATTACH.HTM" template.

2/14/98 - Initial release (version "A") posted to Mustang Online, and on
          Chemeketa Online's home site. Unlimited distribution rights granted.

2/13/98 - Prerelease versions 2 and 3 posted for a limited time, available
          only from Chemeketa Online's home site. DISTRIBUTION IS PROHIBITED.
          Fixed filename and template bugs. Fixed bug that kept free trial
          period from working properly (free trial period available ONLY in
          prerelease version -- allows all users to access all features until
          3/31/98).

2/12/98 - Prerelease version posted for a limited time, available only from
          Chemeketa Online's home site. DISTRIBUTION IS PROHIBITED.




3. INSTALLATION

Extract the files to the locations given. You may choose to use the supplied
TESTING.HTM file for your personal testing of all the features, before you
copy the MESSAGE_CREATE.HTM to the appropriate location (which will allow all
your users to see the spell check, carbon copy, and file attachment options).
If you don't update your MESSAGE_CREATE.HTM, then your users won't see the new
options and will continue to use WINS built-in messaging. If you choose to
update MESSAGE_CREATE.HTM before you register the program, then you may want
to comment out the references to spell checking and file attachments.

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




4. 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. There are just a few
keys to be careful of when you edit the WMP templates.

  * If the template doesn't have a </FORM>, a </BODY>, or a </HTML>, then do
    NOT add them to the template! Web Messaging Pro will add hidden fields,
    buttons, and more to some of the templates, and if you close the form or
    the body of the web page, the user's web browser will not properly process
    the hidden data and WMP will stop working.

  * 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.

  * With the exception of MESSAGE_CREATE.HTM, all WMP templates must be in the
    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.

  * In the MESSAGE_CREATE.HTM page, you can choose to have a single submit
    button (instead of the four that are used now -- two at the top and two at
    the bottom). To allow users to attach a file when you only have one submit
    button, add a checkbox field (like the one for spell checking) with the
    name "ATTACHMENT". If ATTACHMENT equals "YES" or "ON", then the user will
    be prompted to upload an attachment, just as they would if they clicked
    the "Save with attachment" button. 

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.




5. 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




6. KNOWN BUGS

If it takes the user more than 3 to 5 minutes to upload a file attachment,
WINS may reset their connection and the attachment will not be saved. You can
witness the same behavior by trying to upload a large file into the file areas
using the DHTML interface. The only known workaround at this time is to use a
CGI-based upload processor, which would require the use of temp files and at
least one additional web page for the user. We are looking into this
possibility, and may release it as an optional update to WMP.

**YOU CAN HELP**
Let us know whether or not the above bug occurs on your system. If it does not
affect everyone, then we may be able to troubleshoot the problem easier!




7. 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 attention, drink the last of the milk, make prank phone calls to
911, and basically make a nuisance of itself.

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) 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 a sue-happy
idiot).

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 the prerelease version, 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" this code in order to cheat the
registration process or to write your own version of this program (or for any
other reason that might come to you). 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 servers, that's NOT a violation of the copyright).


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.




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