=========================================================================
                         FTP Server Assistant v1.02	
=========================================================================

FTP Server Assistant is an application that you can run in the background
on your personal computer that will display the IP address of your computer
on a web page.  It was originally an application that I thought would be
helpful for those that like to have a connection to their computer away from
home, but don't necessarily have a consistant IP address.  If you are such
a person, this application will definately help!

========
 v1.10
========

Added/Removed Features:

     I included support for some added information on a created web page.
     Now, you can use %DATE% to insert the time and date of the update, and
     you can also use %NEXT% to insert text on how often it is updated.

     eg.  "%DATE% %NEXT%" would insert something like:
          "Thursday March 19, 1999  12:03:04 Every 1 hour"

     I also fixed a bug with the "-auto" switch.  The problem was that if you
     used the "-auto" switch, the app would update the page once, then show
     itself.  If you were not present for it "showing up" then it wouldn't
     update the pages any more.  From a programming standpoint, it actually
     was somewhat of an interesting bug.  The fix was basically not allowing
     MFC to do what it wanted to :)  It should work properly now.

     I also cleaned up a few routines that allocated memory and wrote files
     to disk.

     I also removed the install shield program.  I can't seem to justify bloating
     my program by over 3850% just to make it install nicely.  So, it is out
     for now.  I may add it in later once I sit down with InstallShield and
     learn it.


========
 v1.02
========

Added/Removed Features:

     Took out the automatic web page altering if the user is creating their own.  Now, if
     the user creates their own page, it will only look for the ###.###.###.### string, 
     and replace it with the IP address.

     Added in InstallShield setup program to make it a bit more professional.


=======
 v1.0
=======

WebSite Upload:
     This box should contain the upload address for your web site.  A
     common address might be, "www.website.com".

Login:
     Your normal login when uploading to your web site.

Pass:
     Your normal pass when uploading to your web site.

Port:
     Defaults to "21", however, if you upload to a different port, insert
     the port number here.

Home Directory for Web Site:
     This is the directory structure to the root of your web site, if you 
     have one.  Common entries are, "/", "/login", "/users/login", etc.
     The directories should be separated by a forward slash, "/", however,
     they may also be separated with a backward slash, "\".  It doesn't 
     matter which you use, but do NOT mix slashes!

Web Page Name:
     This is the name of the file that will be uploaded.  The simplest method
     is letting FTP Server Assistant generate a web page for you.  However, if
     you would like to customize the page that other potential users may see,
     you have the option of browsing for a file and using it.

     To make sure that the IP address shows up where you would like it when
     customizing your own page, use the string "###.###.###.###" in the HTML
     wherever you want your ip address to be substituted.  For example,

      This is how your HTML file may look before upload:

                Rastlin's FTP site is: ###.###.###.###!
                     be sure to visit soon!

      This is how it will look after upload:

                Rastlin's FTP site is: 127.0.0.1!
                     be sure to visit soon!


     When you are first prompted to locate a custom file, a dialog box will
     appear reminding you of this.  You can disable the dialog box when you feel
     you no longer need reminding.

Refresh Rate:
     This will set the amount of time the application will sleep until it decides
     to upload the page again.  The times range from 15 seconds to 1 hour.  It may
     initiate a connection if it sees that you are currently not connected to the 
     network.

Title of Web Page if Generating:
     This is in case you are letting FTP Server Assistant generate the web page for
     you.  Whatever you type in will be centered in big letters at the top of the
     web page.  A simple example may be, "Rastlin's FTP Site is:".  It inserts a
     carriage return after the title, then inserts the IP address.

IP Address of Machine:
     You must select what type of configuration you have on your machine.  It depends
     on whether you have a network card and a dialup adaptor, or some sort of
     combination.  Just select what type of system you have, and it should find your
     IP address correctly.  This is necessary to be useful for dialup users as well
     as those unfortunate ones that have BOOTP or DHCP like myself!

UPDATE!:
     This button will initiate the first upload transfer immediately, and then will
     sleep for the amount of time you designate.  It will also hide itself, however,
     the system tray icon can be used (left dbl click or click) to adjust a setting
     after you have clicked the update button.  If you keep the cursor on the system
     tray icon, it will tell you when it last uploaded your current IP address.

     When you update for the first time, it will create settings that it stores in
     the registry.  These are useful if you don't feel like typing in your web site
     uploading parameters each time you start the program.

Cancel/Exit:
     Does what it says.  When you leave it closes the program down, prohibiting any
     updates to your web site.  Therefore, if you use it once, then never run it again,
     the wrong IP address will be displayed after you hang up, or receive a new IP
     from your DHCP or BOOTP server.



====================
  Troubleshooting
====================

Q: The program doesn't seem to be uploading the file to my web site.  What can I do?

A: First.  Make sure your settings are correct.  Log in using an ftp server to make sure.
   Then try generating a web page in the program.  If that doesn't work make sure you have
   the correct upload directories.. many ISPs give a directory structure from the default
   login location such as "/<username>/" or "/webpages" or something to that effect.  The
   direction of the slash is not important!

Q: It uploads the page correctly, but it doesn't seem to be inserting my IP address where
   I want it to.

A: Make sure that you have added the key, "###.###.###.###" into your HTML file wherever
   you want your IP address to appear.. Second, make sure that you have put that key in a
   location where your IP address can be seen.  A good default page would be just to create
   a blank document and add in the key without any HTML tags.  Then see if that file shows
   the correct IP address through your browser.

Q: Everything seems to work, but it doesn't give the correct IP address.

A: Ok.  Since this application is geared towards dynamic IP holders, ethernet and dialup,
   you have to select what type of system configuration you have.  This can be done by 
   clicking on the box named "IP Address of Machine".  In there you can check what type
   of connection you have to the internet.. Make sure you select the correct one.  If
   you have selected the correct configuration and it still does not report your IP
   address correctly, try one of the other configurations.




=========================================================

Any questions, comments, suggestions, or bug reports (there might be some still)
email: gerkyn@earthlink.net

or visit: http://home.earthlink.net/~gerkyn/ftpsa.html  for updates and a possible FAQ
that I may put up soon!  
