MSA - Matt's Script Archive SurveyFactory - Create and publish online web surveys
 Matt's Script Archive: TextClock C++: ReadmeView All Readme Files @ MSA
 
  Other sites by Matt:
 FormMail.com
  - hosted form processor
 SurveyFactory
  - hosted survey software
 CGI Resource Index
  - 3,000+ Perl Scripts!
 PHP Resource Index
  - 2,000+ PHP Scripts!
 chumpsoft, inc.
  - online survey software


  Matt's Script Archive
    FormMail
    Guestbook
    WWWBoard
    Simple Search
    Counter
    TextCounter
    Random Text
    TextClock
    Free for all Links
    Random Link
    HTTP Cookie Library
    Countdown
    Random Image
    SSI Random Image
    TextCounter C++
    TextClock C++
      > Readme 
      Download
      FAQ

Table of Contents
Select from the following table of contents to jump to a specific area within this README file. This is a HTML version of the README file distributed with Textclock C++.
Copyright and Header
TextClock C++Version 1.0.3
Copyright 1996-2002 Matt Wrightmattw@worldwidemart.com
Created 07/15/96Last Modified 03/29/97
Matt's Script Archive, Inc.:http://www.scriptarchive.com/

If you run into any problems while trying to configure this scripts, help is available. The steps you should take to get the fastest results, are:
      1) Read this file thoroughly.
      2) Consult the Matt's Script Archive Frequently Asked Questions:
          http://www.scriptarchive.com/faq/
      3) If you are still having difficulty installing this script, send e-mail to:
          scripts-help@tahoenet.com
          Include any error messages you are receiving and as much detail as
          you can so we can spot your problem. Also include the variable
          configuration block that is located at the top of the script.

Hopefully we will be able to help you solve your problems. Thank you.

COPYRIGHT NOTICE:
Copyright 1995 - 2002 Matthew M. Wright All Rights Reserved.

TextClock may be used and modified free of charge by anyone so long as this copyright notice and the comments above remain intact. By using this code you agree to indemnify Matthew M. Wright from any liability that might arise from its use.

Selling the code for this program without prior written consent is expressly forbidden. In other words, please ask first before you try and make money off of my program.

Obtain permission before redistributing this software over the Internet or in any other medium. In all cases copyright and header must remain intact.
Overview
TextClock is a C++ CGI program which is meant to be run from Server Side Includes. For more information on Server Side Includes, check out the FAQ at the URL mentioned above. When this script is implemented, it can be used to show browsers several variations of the current time and/or date.

There are two files included with this script:

1. README - This file; includes detailed installation instructions.
2. tclock.cpp - The Perl script which generates the headers and sends the current time and/or date to your user.

Should you encounter any problems running this script, such as Method Not Implemented, try changing the name of the program to tclock.cgi, as some servers require the use of .cgi extensions. Otherwise, this script must be placed in your cgi-bin. There are several variables which must be edited in the tclock.cpp program.
tclock.cpp
There are nine variables in the tclock.cpp script, however if you wish to receive the default display, you need not edit any of them. You can mix and match all of these options and see which kind of clock you like the best. You can get the clock to display only the day of the week, only the date, only the time, everything or make up your own combination!
 
const int Display_Week_Day = 1;
If this option is set to 1, the day of the week will be displayed; Possible Values: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday and Sunday. Setting this option to 0 will suppress the printing of the Day of the Week.

const int Display_Month = 1;
If this option is set to '1', the month will be printed. Possible values include: January, February, March, April, May, June, July, August, September, October, November and December. If this option is set to '0', the month will not be displayed.

const int Display_Month_Day = 1;
If this option is set to '1', the day of the month is displayed, containing a value from 01 - 31. Setting this to '0' will hide the Day of the Month.

const int Display_Year = 1;
If this option is set to '1', the four digit year is displayed, and it can be hidden by setting this to '0'.

const int Display_Time = 1;
If this option is set to '1', a twenty four hour clock is displayed. Otherwise, if it is set to '0', it is supressed.

const int Display_Time_Zone = 1;
Setting this to '1' allows users to your site to know what time zone the date is being displayed from. If it is set to '1', the script will determine if it is Daylight Savings or not. If so, it uses $Daylight_Time_Zone as the Time Zone to display. Otherwise it uses $Standard_Time_Zone.

const char Standard_Time_Zone[4] = "EST";
const char Daylight_Time_Zone[4] = "EDT";
These are the names of your Time Zones. The ones shown above represent Eastern Coast Time Zones. Other ones in the US include Central Time (CST/CDT), Mountain Time (MST/MDT) and Pacific Coast Time (PST/PDT).

const char Display_Link[] = "http://www.worldwidemart.com/scripts/";
Wanna be generous and offer visitors a link to my site where they can download this script? If so, leave this set to '1' and the displayed date will be linked to my web site. Otherwise, set it to '0'.
Compiling This Program
This program was written to compile on a BSDI BSD/OS version 2.1 with the g++ compiler. In order to compile it and get it ready for execution:

   g++ tclock.cpp
   mv a.out tclock


You can change tclock above to tclock.cgi if you need .cgi extensions for CGI programs to work on your web server.

I tried to compile under MS Visual C++ Version 4.0 and it compiled and ran fine.

If the compiling and stuff doesn't work out, an easier way of getting a TextCounter for your web page may be to go to Matt's Script Archive and download the Perl version.
How To Call This Script From Your Web Page
Calling this script from a web page is fairly simple. You just use a standard Server Side Include call, such as:

   <!--#exec cgi="/url/path/to/tclock.cgi"-->

   OR

   <!--#include virtual="/url/path/to/tclock.cgi"-->
History
Version 1.0.3 03/29/97 - Program converted to C++
- You can now link to other URLs with the clock, not just mine. :-)
Version 1.0.2 07/15/96 - Missing ' after Day of the Week Fixed.
Version 1.0.1 07/15/96 - Minor Day of the Week Problem Fixed.
Version 1.0 07/15/95 - First Version Released.

 

FormMail.com :: HTML Form to Email Processor
[ Linking to MSA | Advertising Opportunities | Contact Matt ]
© 1995 - 2009 Matt Wright and Matt's Script Archive, Inc.