SMTPit 3.0 for Windows and Macintosh
1999-2001, Comm-Unity Networking Systems - All Rights Reserved.

Before using SMTPit, please read through the License Agreement
included with this archive. [LicenseAgrmnt(SMTPit_Dmo).pdf]


Description:

SMTPit is a FileMaker Pro 4.x/5.x plug-in that allows you to send
email directly from FileMaker Pro. With SMTPit, there is no need
for any external helper application, such as Eudora or Outlook.
For a complete description of how to use SMTPit, please consult
the SMTPit Guide provided with this archive in Adobe Acrobat
(PDF) format.


Contents:

- New Features in SMTPit 3.0
- Installation
- Quick Start
- Features
- Feedback
- Purchasing SMTPit
- How to Contact CNS
- SMTPit History
- Known Issues


New Features in SMTPit 3.0

SMTPit has many new features for version 3.0:

- SMTPit now supports Japanese and Central and Eastern European
    characters! No longer do you have to fool around with
    AppleScripts to convert between SJIS and JIS. SMTPit
    does it all automatically for you. All you have to do
    is type your Japanese or Central and Eastern European
    characters into your localized version of FileMaker,
    and send the email!
- New Connect and Disconnect functions for use with Mass Email
    Solutions. The Send function works as it always did,
    connect, send email, disconnect, if you use it by itself.
    However, if you use the new Connect and Disconnect functions,
    the Send function will detect that you are already
    connected and will simply send the email. This makes it
    much more efficient for Mass Email Solutions.
- New Status Window. SMTPit now has the ability to show you
    what it's doing as it's doing it. You no longer have to
    wonder if it's frozen, or if it's just sending that large
    attachment.
- Support for the OS X version of FileMaker 5.5. You can now
    download a Carbonized version of SMTPit to work in OS X.
- Authentication support! SMTPit now allows you to log in to
    mail servers that require authentication before allowing
    you to send emails. SMTPit supports the Plain, Login, and
    CRAM-MD5 Authentication types.
- Better multi-tasking support for Macintosh! Now you can run
    FMP/SMTPit on the same machine as your mail server and be
    able to send email to it. (We do, however, highly recommend
    that you do not do this. You will get much better performance
    by running FMP and your mail server on two separate machines.)
- New PathToDB function to return the File Path to the folder
    containing your database. This is useful if you want to
    place your attachments in the same folder as your database,
    either for convenience, or for bound solutions that can
    be in some unknown location on the user's computer.
- Email Address Validation. SMTPit now checks the email
    addresses you give it to see if they "look" like valid
    email addresses. If SMTPit cannot find anything that
    looks like a valid email address, it will return an error.
- Better support for Multipart/Alternative Text and HTML emails.
    Now you can send emails that have a Text part, an HTML
    part, Inline HTML Images, *and* Attachments.
- New Developer's Versions that have many enhancements for
    developers, like no splash screens, and better control
    over the registration of the plug-in.
- New Port function and Default Port configuration setting. No
    longer do you have to edit the Windows Registry or the
    Macintosh Preference file just to send email to a
    different TCP/IP Port.
- Send and Connect functions can now take optional parameters,
    like bringing up a dialog if the email was sent
    successfully, or to return a transcript of the
    interaction between SMTPit and your mail server.
- Many minor bug fixes and a few other minor enhancements.

Download the newest version of SMTPit today to see all the new
features!


Installation:

Windows:

To install the plug-in on the Windows platform, first quit
FileMaker Pro if it is open. Next unzip the contents of the
SMTPit zip file into a directory. After you have unzipped the
zip file into a directory, run the SMTPit_Installer application.

NOTE: The installer WILL NOT run from inside an unzipping program
like WinZip. You MUST unzip the file into a directory first.

The installer will place the STMPit Plug-in file into the "System"
directory located in your FileMaker Pro 4.x/5.x directory. If you
have a previous version of SMTPit installed, the installer will
overwrite it. The next time you open FileMaker Pro the plug-in will
automatically be active.

Macintosh:

To install the plug-in on the Macintosh platform, first quit
FileMaker Pro if it is open. Next unstuff the contents of the
SMTPit Stuffit file into a folder. After you have unstuffed the
Stuffit file into a folder, run the SMTPit_Installer application.

The installer will place the STMPit Plug-in file into the
"FileMaker Extensions" folder located in your FileMaker Pro 4.x/5.x
directory. If you have a previous version of SMTPit installed, the
installer will overwrite it. The next time you open FileMaker Pro
the plug-in will automatically be active.


Quick Start:

Once you have installed the plug-in as described above, you can
go to Edit->Preferences->Application, click on the Plug-ins tab,
and double-click the SMTPit plug-in to configure the Default
Settings.

Once in the configuration box, click the Basics tab to enter your
SMTP mail server domain name or IP address in the Default SMTP Host
field. Also, you can enter your email address into the Default From
Field. You can also enter in a Default Subject as well as many other
Default settings. For a complete description of each setting, please
see the SMTPit Documentation.

To begin sending email with SMTPit open the SMTPit_Readme database
which has links to all of the other example databases. You can try
out any of the example databases. Please read through the SMTPit
Documentation for a complete understanding of the each of the
databases. The documentation covers some of the scripts in the
example databases, step by step. The documentation also gives a
brief introduction to FileMaker Pro plug-ins, in case you have
never worked with them before.

All of the example database are free and are not password protected.
Feel free to examine them, change them around to test out other SMTPit
features, and just try things out. You can use the example databases
simply as examples on how to incorporate SMTPit into your own databases,
or as starting points for new databases that fit your specific needs.
Please keep in mind that the example databases are just that, examples.
They are by no means the only way to integrate SMTPit with FileMaker
Pro.


Features:

SMTPit enables you to send email directly from FileMaker Pro
using To, From, CC, BCC, Attachments, Email Headers, plus a few
added features such as a Header and a Footer that is added to the
message body. You can set a default value for most features in the
configuration box.

For a complete description of how to use SMTPit please refer to the
SMTPit_Guide.pdf file. (If you do not have Adobe Acrobat, you can
download it from Adobe at
http://www.adobe.com/products/acrobat/readstep.html)


Feedback:

Comm-Unity Networking Systems would like to know how you are using
SMTPit. Send us an email telling us about your solution and we will
place a link to it on our site. We will also be creating a user
solutions section to the site for you to display solutions created
with Comm-Unity Networking Systems' plug-ins.


Demo Version:

You can evaluate SMTPit for 30 days for free, however, after 30 days,
SMTPit should be removed from your hard drive if you do not purchase
it. The demo version of SMTPit displays a splash screen and appends
a message identifying each message as being sent with a demo version
of the plug-in. Once you purchase and register your copy, the splash
screen and demo message will go away.


Purchasing SMTPit:

Upgrades:
  If you purchased SMTPit after May 1, 2001, you are entitled to a
  free upgrade. However, you will need a new registration number.
  To receive your new registration number, please email
  sales@comm-unity.net with the name you used on your order and we
  will email you a new receipt with your new registration number.

  If you purchased prior to May 1, 2001, you can upgrade to SMTPit
  3.0 for the low cost of $9 for Single User Licenses and $36 for
  Site Licenses. You can use our online purchase form to purchase
  the upgrade. (If you own a Developer's License, please email
  jake@comm-unity.net for information on the upgrade.)

New purchases:
  A Single User License for SMTPit costs $65, a Site License is
  $250, and a Developer's License is $780. A Single User
  Educational License is also available for $45. To order SMTPit
  from our secure website, simply go to
  http://www.cnsplug-ins.com/ and choose the "Purchase" link at
  the top (in the grey area). We accept Visa, MasterCard, and
  AMEX. We will also accept checks under special circumstances.
  Please email us if you would like to purchase with a check.

Money made from sales will go directly back into making other
great plug-ins like SMTPit!


How to Contact CNS:

Please send any suggestions or questions to
SMTPit@comm-unity.net. Updates can be downloaded from
http://www.cnsplug-ins.com/. If you wish to receive product
information you can subscribe to our newsletter by sending email
to filemakertools@comm-unity.net with the word "subscribe" in the
subject (without the quotes). If you find a bug, please use our
online Bug Report form at
http://www.cnsplug-ins.com/bug_report.htm/.


SMTPit History:

-- 10-4-2001 SMTPit 3.0.7 released.

This version fixes a bug with the Register function that caused
it to fail if a previous version of SMTPit had been registered
on that machine.

-- 9-19-2001 SMTPit 3.0.6 released.

This version fixes several things. There was a small cosmetic bug
associated with a single To email address that did not have the
angled brackets around it. This bug added a space before the email
address. This also changes the Content-Type of inline jpeg images
from "image/jpg" to "image/jpeg", which seems to be more supported.
(It makes Mac Outlook Express and Win Eudora see that it is indeed
a jpeg that it can use.) Finally, this version fixes a Mac only
bug that caused the system to completely hang when closing FMP
on some systems with Mac OS 9.2.1.

-- 9-04-2001 SMTPit 3.0.4 released.

This version fixes a bug with displaying the Configuration Dialog
on Mac OS X. It also fixes a few bugs with saving the preference
files on Macs with more than one volume. This version also fixes
a bug where if the Default Host in the Configuration Dialog was
set to a single space, and no Host was defined with the
HostAssign function, then SMTPit wouldn't report a "Missing Host"
error.

-- 8-28-2001 SMTPit 3.0.3 released.

This version fixes a few bugs, mostly dealing with the Japanese
encoding of emails.

-- 8-22-2001 SMTPit 3.0.2 released.

This fixes a bug in the AssignAll function where the From
Email Address was reeiving the same email address as the To
Email Address.

-- 8-21-2001 SMTPit 3.0.1 released.

This fixes a bug on the Macintosh where the Headers and Footers
in the Configuration Dialog were getting cut off at 255
characters.

-- 8-6-2001  SMTPit 3.0.0 Final released.

This is the official release of SMTPit 3.0.0 Final. This release
also fixes a problem where the Content-Transfer-Encoding of
Japanese emails was set improperly. It now is set to the correct
"7bit" that it needs to be in order for Japanese email clients
to correctly interpret the email. It also fixed a bug where the
To, CC, and From email addresses were not getting encoded
properly.

-- 8-4-2001 SMTPit 3.0.0b4 released.

This version adds support for Localized character in the To, CC,
From, and User Defined Headers. It also fixes a small bug
introduced in Mac 3.0.0b3 where random characters would show up in
the HTML body where blank lines should be.

-- 8-1-2001 SMTPit 3.0.0b3 released.

This version fixes a few more spelling mistakes in the Mac
Configuration Dialog. It also fixes a problem when multiple
inline HTML images are on the same line.

-- 7-25-2001 SMTPit 3.0.0b2 released.

This version fixed the Macintosh status window to correctly show
the information. It also fixed a few spelling mistakes in the Mac
Configuration Dialog.

-- 7-23-2001 SMTPit 3.0.0b1 released.

This version brings many enhancements and new features to
SMTPit, including Japanese and Central and European
character support, a new Status Window, OS X support, new
Connect and Disconnect buttons, Authentication support,
and many other things.

-- 8-10-2000 SMTPit 2.5.0 officially released out of beta.

This version fixes a few bugs that were brought to our attention
in the beta testing period. It also adds one new feature: the
ability to define the column where SMTPit breaks lines before
sending to the mail server.

-- 7-26-2000 SMTPit 2.5.0b1 released.

This version adds HTML Email support and Inline HTML Images for
your HTML emails. The Macintosh version has now been stabilized
and both Macintosh and Windows versions are equal in
functionality and features.

-- 6-4-99 SMTPit 2.0 released.

This version brings attachments, email headers, better
documentation, new dialog boxes, and plug-in registration so that
you only have to download it once.

-- 4-16-99  SMTPit 1.03 released.

This version fixes a few bugs.  Headers and footers will now show
returns appropriately.  This version also adds a new function:
SMTP-FromNameAssign which will allow you to set a from name.  Also
added is a default from name in the configuration box.

-- 3-22-99  SMTPit 1.0 released.

-- 3-10-99  First public release, version 1.0b1

Known Issues:

-- Windows: There is a problem if you send an email message with
SMTPit and then break your internet connection by hand.  To solve the
problem, make sure that you have an internet connection before you
start sending email, and maintain that connection until you are
through sending email.  If you have to break the connection, make
sure to reestablish your connection before sending email again.

-- Windows: When the Configuration Dialog is open, and you open up
the "Add Email Header" Dialog, or the "Register" Dialog, and then
switch applications, when you switch back to FileMaker, the extra
dialog is not always on top. Work Around: Click on the Dialog Window
on your Task Bar (next to the "Start" button).

-- Macintosh: You must close the SMTPit Status Window before
closing FileMaker Pro. If you do not, FileMaker Pro will give
you an error stating that it cannot write to the disk. The
easiest way to ensure that the SMTPit Status Window is closed
is to put a call to SMTP-HideStatus in a Close script that
you define in Edit->Preferences->Document for your main
database.


--------------------------------------------------------
Comm-Unity Networking Systems
http://www.cnsplug-ins.com/



