Send To Ftp
by Glenn Delahoy
(C) Copyright 2009
All rights reserved

Description
-----------
Adds ftp functionality to your "Send To" folder. Create ftp configurations for
parent folders and all sub-folders and files are mapped accordingly. Provides
for multiple ftp targets for a single source, file rename during transfer etc.

Installation
------------
There's no installer or uninstaller as such. Unzip to some convenient
location, for example "C:\Program Files\SendToFtp". When you run the program the
configuration screen is displayed. Click the Install button to add "SendToFtp"
to your "Send To" folder.

Uninstallation
--------------
To remove "SendToFtp" from your "Send To" folder, start the program, go to the
configuration screen and click "Uninstall". Close the application and delete the
application folder and you're done.

Usage
-----
When you run the application directly you'll start at the configuration screen.
From here you can add, modify and remove the path and ftp settings. See the
configuration section below.

When you select one or more files/folders on Windows Explorer and select the
"Send To" menu item on the right click context menu, the "Send To Ftp" option is
available. Select this to send the selected items to SendToFtp.

The rows on the display shows each item you selected on Windows Explorer, be it
a file or a folder. The icon on each row indicates whether there is a valid
configuration for that item. An "OK" indicates the configuration is ok and ready
to send. A question mark means there is no valid configuration or the
configuration is somehow invalid (missing information) and you'll need to do
something. Select the questionable item and click the "Edit Entry" to modify the
item's configuration.

Configuration
-------------
The principle is to do as little configuration as possible yet allow for
maximum flexibility. If you have a local file structure which is identical to
the remote file structure, a single configuration will do the job. You would
simply map the root of the local structure to the root of the remote structure.
For example, the local path is "C:\MyWebSite\" and the remote path is "/html/".
With this set up you can transfer the entire site or any portion thereof.
Remember the trailing slashes. If you need to transfer say,
"C:\MyWebSite\folder1\index.html", SendToFtp will work out the correct remote
path as "/html/folder1/index.html".

Configuration Screen
--------------------

      Local Path:  The top level directory or file to be sent. It can represent
                   a directory, single file or wildcarded file spec. If it's a
                   directory, make sure it ends with a backslash.
      Host:        The ftp address.
      Port:        The ftp port.
      Remote Path: The path on the remote ftp server. If it's a directory, make
                   sure it ends with a forward slash. If the local path is a
                   directory, this must also be a directory. If the local path
                   is a single file, this can be a directory or file name. If
                   the local path is a wildcarded file spec, this must be a
                   directory.
      Login Name:  The ftp login name.
      Password:    The ftp login password.
      Timeout:     The connection and transfer timeout in seconds. Zero is no
                   timeout.
      Include Sub Folders: Also transfer all sub-folders and files. If the
                   local path is a directory, the whole tree structure is
                   transferred. If the local path is a file or file spec, only
                   matching files in the tree structure are transferred.
      Abort session on transfer failure: The session is aborted following the
                   first failure.
      Passive mode: Use ftp passive mode.
      Save As New: Save the current settings to a new permanent configuration.
                   This allows you to open an existing configuration, modify it
                   and save it to a second configuration, keeping the first as
                   it was or saving a temporary configuration permanently.
      Clone From:  Read the configuration from some other existing configuration
                   item into the current one.
      Test Connection: Tests the ftp connection and login without performing
                   any transfers.


--------------------------------------------------------------------

Release Notes
-------------

Version 1.00
------------
June 2009 Initial release.

--------------------------------------------------------------
Contact:
http://www.glenn.delahoy.com