FTPit 1.5 for Windows and Macintosh
©2001-2003, Comm-Unity Networking Systems - All Rights Reserved.

Before using FTPit, please read through the License Agreement
included with this archive (LicenseAgrmnt(FTPit_Dmo).pdf). By using
this software you will be bound to the terms in that agreement. If
you do not agree to the terms in that agreement, please destory all
copies of this software and documenation.


Contents:

- Description
- Features
- Installation
- Quick Start
- Feedback
- Purchasing FTPit
- How to Contact CNS
- FTPit History
- Known Issues


Description:

FTPit is a FileMaker Pro plug-in that allows you to connect to and
transfer files between your computer to an FTP site using the File
Transfer Protocol (FTP). You do not need any external application to
send the files, only this plug-in and FileMaker Pro. For a
complete description of how to use FTPit, please consult the FTPit
Guide provided with this archive in Adobe Acrobat (PDF) format.
(If you do not have Adobe Acrobat, you can download it from Adobe at
http://www.adobe.com/products/acrobat/readstep.html)


Features:

- Upload or download any file you have access to on any FTP site.
- Upload a full static webpage using only FileMaker Pro and FTPit.
- Queue multiple files and move on to something else while FTPit
    transfers the files in the background.
- Watch everything that FTPit is doing with its Status Window.
- Catalog all the files on an FTP site using FTPit's directory
    listing functions.
- NEW! - Download text files directly into a field in your database.
- NEW! - More example databases show you how to transfer single or
    multiple files and how to use the Text functions.
- NEW! - New WaitForQueue function allows your complex FTPit scripts
    to flow more naturally.

For a complete description of how to use FTPit please refer to the
FTPit_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)


Installation:

Windows:

To install the plug-in on the Windows platform, first quit
FileMaker Pro if it is open. Next unzip or unstuff the contents
of the FTPit .zip or .sit file into a directory. After you have
unzipped or unstuffed the archive file into a directory, you
should find a file in that directory called "FTPit_WIN.fmx". This
is the plug-in file. Copy this file to the directory named
"System" inside your FileMaker Pro application directory. This
directory is usually on your hard drive in a directory similar to
this:

c:\Program Files\FileMaker\FileMaker Pro\System\

If you had FTPit installed previously, you may find a file in
your System directory named "FTPit.fmx". You will need to delete
this before starting FileMaker Pro so that you do not have two
versions of the plug-in installed.

After installation, you can start up FileMaker Pro, and the
plug-in should automatically be active. You can then open one of
the example databases included in this archive to begin exploring
FTPit. If you need more help installing the plug-in, please see the
FTPit Guide PDF provided in this archive.

Macintosh:

To install the plug-in on the Macintosh platform, first quit
FileMaker Pro if it is open. Next unstuff or unzip the contents
of the FTPit .sit or .zip file into a folder. After you have
unstuffed or unzipped the archive file into a folder, you should
find a couple of files in that folder named "FTPit_OS9" and
"FTPit_OSX". (If you downloaded the Windows .zip file, the Mac
plug-ins will be stuffed and named "FTPit_OS9.sit" and
"FTPit_OSX.sit".  You will need to unstuff them on your Mac
before installing them.) These are the plug-in files, one for
each Mac OS. Copy the version that corresponds to your operating
system into the folder named "FileMaker Extensions" inside your
FileMaker Pro application folder. This folder is usually on your
hard drive in a folder similar to this:

<Your HD>:Applications:FileMaker Pro:FileMaker Extensions:

If you had FTPit installed previously, you may find a file in
your FileMaker Extensions folder named "FTPit". You will need
to delete this before starting FileMaker Pro so that you do not
have two versions of the plug-in installed.

After installation, you can start up FileMaker Pro, and the
plug-in should automatically be active. You can then open one of
the example databases included in this archive to begin exploring
FTPit.If you need more help installing the plug-in, please see the
FTPit Guide PDF provided in this archive.


Quick Start:

We have provided example databases to get you started working with
FTPit. The first database is the Text Transfer Example database
(FTPit_Text_Transfer_Ex.fp5) which shows you how to upload text 
from a FileMaker Pro field to your FTP site and how to download a
text file from your FTP site directly into a FileMaker Pro field. 
The documentation explains in detail how this database works.

The next database is the Single File Transfer Example database
(FTPit_Single_Transfer_Ex.fp5) which shows you how to transfer
single files to and from an FTP site. The documentation also
explains this example database in detail.

The next database is the Multi File Transfer Example database
(FTPit_Multi_Transfer_Ex.fp5) which shows you how to transfer whole
directories of files at a time, either to or from your FTP site. For
information on how the scripts in this example database work, please
see the documentation provided with this archive.

The final database is the FTP Client Example database 
(FTPit_Client_Example.fp5) which is set up like a standard FTP
client. This database allows you to connect to any FTP site, browse
the files and folders, and download or upload files. To navigate
the folders and to download or upload files, you "double-click" on
them. 

The Example databases provided with FTPit are free and are not
password protected. Feel free to examine them and take ideas from
them, however, Comm-Unity Networking Systems maintains the copyright
for the databases. Feel free to use them as examples only.


Feedback:

Comm-Unity Networking Systems would like to know how you are using
FTPit. 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. Our website is
http://www.cnsplug-ins.com/, and our support email address for FTPit
is FTPit@comm-unity.net.


Purchasing FTPit:

You can purchase FTPit from our secure website. Simply go to
http://www.cnsplug-ins.com/ and choose the "Purchase (Prices)" link
at the top of every page (in the grey area). We accept Visa,
MasterCard, American Express, and Discover. We will also accept
Purchase Orders and checks under special circumstances. Please email
or call us if you would like to purchase with a Purchase order or a
check.

Our pricing structure for FTPit is as follows:

License             Price            Cost per License
 1 User            $ 45.00             $45.00 each
 5 User            $158.00             $31.60 each
10 User            $221.00             $22.10 each
25 User            $387.00             $15.48 each
50 User            $542.00             $10.84 each
Site / Worldwide   $759.00
Developer's        $461.00

You can purchase any number of licenses based on the above cost
points per license. Educational Discounts are available for roughly
%20 percent off the listed price. Prices are subject to change
without notice.

After purchasing FTPit, you will be sent an email receipt containing
your Registration Number. You can register FTPit from any of the
example databases simply by pressing the "Register FTPit" button.
You can also register FTPit from the FTPit Configuration Dialog.
When you register FTPit, you will turn the "demo" version you 
downloaded into a "final" version.


How to Contact CNS:

Please send any suggestions or questions to our support email
address for FTPit, FTPit@comm-unity.net. Updates can be downloaded
from http://www.cnsplug-ins.com/. If you find a bug, please use our
online Bug Report form at http://www.cnsplug-ins.com/bug_report.htm


FTPit History:

-- 1-28-2004 1.5.2
               - Fixed a bug on mac where you couldn't create a 
                   directory that wasn't off the root.
               - Fixed a bug on windows when creating directories
                   with long names.
               - Added partial long file name support to OSX. You 
                   can see long file names in the Local List, you
                   can "Put" files by specifying their long file 
                   name, you can "Get" files with long file names.
               - Added a new "AppendText" function that works like
                   "PutText" except that it appends the text to the
                   file instead of overwrites it. (Don't confuse
                   with "TextAppend"!)
               - Fixed a bug on mac with the PutText function 
                   uploading the wrong text.
               - Modified the Size function to be more aware of the
                   error messages it was receiving so as to not do
                   needless time-consuming operations.
               - Fixed a bug in DoGet and DoGetText that caused it
                   to error out if the Size function was getting an
                   error.
               - Fixed the status dialog to make sure it was showing
                   progress on OS X.
               - Fixed a bug on mac where the Timeout setting in the
                   Configuration Dialog was being ignored.

-- 9-12-2003 1.5.1
               - Fixed a bug in WaitForQueue function that caused it
                   to not end when the queue became empty in rare
                   circumstances.
               - Fixed a bug in the TextAcquire function that didn't
                   allow you to request an Ammount value that was
                   less than the Start value.
               - Adds a new feature on OS X that allows you to
                   specify "ShowInvisibles=Yes" in the LocalListFirst
                   function to list invisible files.

-- 8-7-2003 1.5.0
               - New Functions: doFTP-Append, doFTP-DataPortRangeEnd,
                   doFTP-DataPortRangeStart, doFTP-GetText,
                   doFTP-TextAcquire, doFTP-WaitForQueue.
               - Changed Functions: doFTP-Register, doFTP-MakeDir
               - All dialogs on OS X are now properly integrated
                   into the plug-in and function correctly.
               - The doFTP-MakeDir function will now create all
                   subdirectories on the remote site if they do not
                   exist.
               - Fixed a bug that didn't trigger the 
                   "CompletedScript" for every file if the files
                   were very small.
               - Made the WildCard parsing case-insensitive
               - OS X version adds support for the tilde (~) for
                   referencing the "Home" directory.
               - Fixed a few connection bugs.

-- 8-7-2002 1.1.9
               - Adds GetPathToFM function to return the path
                   to the folder containing the FileMaker Pro
                   Application.
               - Adds the Quote function to quote commands
                   directly to the FTP server.
               - Fixes GetLocalRoot on Mac OS X to return the
                   local hard drive.
               - Fixes Passive Mode on mac (couldn't turn it off).
               - Sets creator/file type to Text/ttxt for ASCII
                   mode on mac.

-- 10-4-2001 1.1.7
               - Fixed a bug with the Register function that
                   caused it to fail if a previous version
                   of FTPit had been registered on that
                   machine.

-- 9-21-2001 1.1.6
               - Fixed a bug where the line endings on Mac
                   were not correct in ASCII mode.
               - Fixed a bug where the character set of
                   Mac files was not converted in ASCII mode.
               - Fixed a bug where FTPit would completely
                   hang FMP and the OS when closing FMP under
                   Mac OS 9.2.1.

-- 9-4-2001 1.1.5
               - Fixed a bug where the Configuration Dialog
                   was not opening properly on Mac OS X.
               - Fixed a few bugs with saving the preference
                   files on Macs with more than one volume.

-- 8-3-2001 1.1.4
               - Fixed a few problems with the MacBinary
                   transfers on Macintosh.
               - Updated the FTPit logo, fixing the drawing
                   bug in the windows splash screen.

-- 7-27-2001 1.1.3
               - Added GetPathToDB function.

-- 7-26-2001 1.1.2
               - Corrected some more file list parsing bugs.

-- 7-12-2001 1.1.1
               - Corrected the file list parsing routines for
                   some FTP servers.

-- 7-8-2001  1.1.0
               - Added support for the Mac OS X version of
                   FileMaker Pro 5.5.
               - Updated the demo splash screen to include
                   our CNS logo and added code to bring up
                   the splash screen every 60 minutes. We
                   had to do this, unfortunately, because
                   some users were abusing our demos.

-- 5-21-2001 1.0.0
               - Released out of Beta
               - doFTP-Port function and Default Port field
                   added to the Configuration Dialog so that
                   a non-standard TCP/IP FTP port can be used.
               - "Advanced" tab added to Configuration Dialog.

-- 5-9-2001  1.0b6
               - Added code to clear the Queue when you
                   disconnect. If you disconnected in the
                   middle of uploading or downloading, and
                   then reconnected, you couldn't do things
                   like change directories because it
                   thought you were uploading or downloading.

-- 4-27-2001 1.0b5
               - Fixed a bug in the Macintosh version that
                   caused the Text Upload example database
                   to not work.
               - Fixed a bug in the Installer applications
                   where both the FMP4 and FMP5 checkboxes
                   were greyed-out (unclickable).
               - Fixed a few minor things in some of the
                   databases (references to .fp3 databases
                   in .fp5 databases, hiding the status
                   window on shutdown, etc.).

-- 4-22-2001 FTPit 1.0b4 released into public beta.


Known Issues:

-- Macintosh: You must close the FTPit 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 FTPit Status Window is closed
is to put a call to doFTP-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/



