home *** CD-ROM | disk | FTP | other *** search
/ Web Designer 98 (Professional) / WebDesigner 1.0.iso / cgi2 / download.cgi-s=textclock&c=txt&f=readme < prev    next >
Encoding:
Text File  |  1996-06-04  |  6.6 KB  |  136 lines
  1. ##############################################################################
  2. # TextClock                     Version 1.0.2                                #
  3. # Copyright 1996 Matt Wright    mattw@worldwidemart.com                      #
  4. # Created 7/15/96               Last Modified 7/15/96                        #
  5. # Scripts Archive at:           http://www.worldwidemart.com/scripts/        #
  6. ##############################################################################
  7. # If you run into any problems while trying to configure this scripts, help  #
  8. # is available.  The steps you should take to get the fastest results, are:  #
  9. #    1) Read this file thoroughly                         #
  10. #    2) Consult the Matt's Script Archive Frequently Asked Questions:     #
  11. #        http://www.worldwidemart.com/scripts/faq/             #
  12. #    3) If you are still having difficulty installing this script, send   #
  13. #       e-mail to: scripts-help@tahoenet.com                     #
  14. #       Include any error messages you are receiving and as much detail   # 
  15. #       as you can so we can spot your problem.  Also include the variable#
  16. #       configuration block that is located at the top of the script.     #
  17. #                                         #
  18. # Hopefully we will be able to help you solve your problems.  Thank you.     #
  19. ##############################################################################
  20. # COPYRIGHT NOTICE                                                           #
  21. # Copyright 1996 Matthew M. Wright  All Rights Reserved.                     #
  22. #                                                                            #
  23. # TextClock may be used and modified free of charge by anyone so long as     #
  24. # this copyright notice and the comments above remain intact.  By using this #
  25. # code you agree to indemnify Matthew M. Wright from any liability that      #  
  26. # might arise from it's use.                                                 #  
  27. #                                                                            #
  28. # Selling the code for this program without prior written consent is         #
  29. # expressly forbidden.  In other words, please ask first before you try and  #
  30. # make money off of my program.                                              #
  31. #                                                                            #
  32. # Obtain permission before redistributing this software over the Internet or #
  33. # in any other medium.    In all cases copyright and header must remain intact #
  34. ##############################################################################
  35.  
  36. TextClock is a Perl CGI script which is meant to be run from Server Side 
  37. Includes.  For more information on Server Side Includes, check out the 
  38. FAQ at the URL mentioned above.  When this script is implemented, it can 
  39. be used to show browsers several variations of the current time and/or 
  40. date.
  41.  
  42. There are two files included with this script:
  43.         1) README     - This file; includes detailed installation 
  44.               instructions.
  45.         2) textclock.pl - The Perl script which generates the headers 
  46.               and sends the current time and/or date to 
  47.               your user.
  48.  
  49. Should you encounter any problems running this script, such as Method Not
  50. Implemented, try changing the name of the program to nph-textclock.cgi, 
  51. as some servers require the use of .cgi extensions.  Otherwise, this 
  52. script must be placed in your cgi-bin.  There are several variables which
  53. must be edited in the textclock.pl script.
  54.  
  55. TEXTCLOCK.PL -
  56.  
  57.     There are up to nine variables in the textclock.pl script, however
  58.     if you wish to receive the default display, you need not edit any
  59.     of them.  You can mix and match all of these options and see which
  60.     kind of clock you like the best.  You can get the clock to display
  61.     only the day of the week, only the date, only the time, everything
  62.     or make up your own combination!
  63.  
  64.     $Display_Week_Day = '1';
  65.         If this option is set to '1', the day of the week will be 
  66.         displayed; Possible Values: Monday, Tuesday, Wednesday,
  67.         Thursday, Friday, Saturday and Sunday.  Setting this option
  68.         to '0' will suppress the printing of the Day of the Week.
  69.  
  70.     $Display_Month = '1';
  71.         If this option is set to '1', the month will be printed.
  72.         Possible values include: January, February, March, April, May,
  73.         June, July, August, September, October, November and December.
  74.         If this option is set to '0', the month will not be displayed.
  75.  
  76.     $Display_Month_Day = '1';
  77.         If this option is set to '1', the day of the month is
  78.         displayed, containing a value from 01 - 31.  Setting this to
  79.         '0' will hide the Day of the Month.
  80.  
  81.     $Display_Year = '1';
  82.         If this option is set to '1', the four digit year is 
  83.         displayed, and it can be hidden by setting this to '0'.
  84.  
  85.     $Display_Time = '1';
  86.         If this option is set to '1', a twenty four hour clock is
  87.         displayed.  Otherwise, if it is set to '0', it is supressed.
  88.  
  89.     $Display_Time_Zone = '1';
  90.         Setting this to '1' allows users to your site to know what
  91.         time zone the date is being displayed from.  If it is set
  92.         to '1', the script will determine if it is Daylight Savings
  93.         or not.  If so, it uses $Daylight_Time_Zone as the Time Zone
  94.         to display.  Otherwise it uses $Standard_Time_Zone.
  95.  
  96.     $Standard_Time_Zone = 'EST';
  97.     $Daylight_Time_Zone = 'EDT';
  98.         These are the names of your Time Zones.  The ones shown above
  99.         represent Eastern Coast Time Zones.  Other ones in the US
  100.         include Central Time (CST/CDT), Mountain Time (MST/MDT) and
  101.         Pacific Coast Time (PST/PDT).
  102.  
  103.     $Display_Link = '1';
  104.         Wanna be generous and offer visitors a link to my site where
  105.         they can download this script?  If so, leave this set to '1'
  106.         and the displayed date will be linked to my web site.
  107.         Otehrwise, set it to '0'.
  108.  
  109.  
  110. ##############################################################################
  111.  
  112.         How to Call This Script From Your Web Page
  113.         ------------------------------------------
  114.  
  115. Calling this script from a web page is fairly simple.  You just use a standard
  116. Server Side Include call, such as:
  117.  
  118.     <!--#exec cgi="/url/path/to/textclock.cgi"-->
  119.  
  120. ##############################################################################
  121.  
  122. HISTORY
  123.  
  124.    Version 1.0.2 - 7/15/96      - Missing ' after Day of the Week Fixed.
  125.    Version 1.0.1 - 7/15/96      - Minor Day of the Week Problem Fixed.
  126.    Version 1.0     - 7/15/95    - First Version Released.
  127.  
  128. ##############################################################################
  129.  
  130. Have fun with this script, but if you implement it on a page, please let me 
  131. know the URL of where it is implemented so I can see my work.
  132.  
  133. If you have any questions, let me know and I will try and help!
  134. ______________________________________________________________________________
  135. Matt Wright - mattw@worldwidemart.com - http://www.worldwidemart.com/scripts/
  136.