1007 lines
83 KiB
HTML
Executable File
1007 lines
83 KiB
HTML
Executable File
<HTML>
|
|
<HEAD>
|
|
|
|
<META NAME="GENERATOR" CONTENT="Adobe PageMill 3.0 Win">
|
|
|
|
<TITLE>Welcome to the LogCount</TITLE>
|
|
</HEAD>
|
|
<BODY LINK="#0000FF" BGCOLOR="#ffffff" text="#000000" vlink="#0000FF" alink="#FF0000">
|
|
|
|
|
|
<P>
|
|
<CENTER>
|
|
<font face="arial,geneva,helvetica" size="2">Welcome to the
|
|
www.dtp-aus.com Counter and Log Viewer scripts.<br>
|
|
</font>
|
|
</CENTER>
|
|
</P>
|
|
<P>
|
|
<CENTER>
|
|
<font color="#000099" face="arial,geneva,helvetica" size="2">IMPORTANT
|
|
INFORMATION THAT <B>MUST BE READ</B> IF YOU WANT TO USE THESE
|
|
SCRIPTS</font>
|
|
</CENTER>
|
|
</P>
|
|
<P>
|
|
<CENTER>
|
|
<TABLE WIDTH="590" CELLPADDING="0" CELLSPACING="0"
|
|
BORDER="0">
|
|
<TR>
|
|
<TD><BASEFONT SIZE=2>
|
|
<P><font face="arial, geneva, helvetica" size="2">The scripts "LOGCNT.CGI" and "LOGLOOK.CGI" written (and </font><font color="#ff0000" face="arial,geneva,helvetica" size="2">(</font><font size="2"><b><font color="#ff0000" face="arial,geneva,helvetica">c</font></b><font color="#ff0000"
|
|
face="arial,geneva,helvetica">)</font></font><font face="arial, geneva, helvetica" size="2">) by Ron F Woolley, Melbourne
|
|
Australia. <b>
|
|
Copyright 1998 '99 2000</b>. These free-to-use scripts can be altered
|
|
for personal use, BUT <br>
|
|
</font><font face="arial,helvetica,geneva" size="2"> ALL COPYRIGHT NOTICES must remain in the code, and <b>visible</b> on all output pages,<br>
|
|
AND ALL of the header notices MUST REMAIN intact as is,<br>
|
|
AND using the script(s) without first reading the README.HTM, is prohibited. </font></P>
|
|
<center>
|
|
<p><font face="arial, geneva, helvetica" size="2"><b>Australian copyright</b> is recognised/supported in over 130 countries<br>
|
|
per Berne Convention and other treaties
|
|
( including USA! ) </font>
|
|
</p>
|
|
</center>
|
|
<p align="center"><font face="arial,helvetica,geneva" size="2"><b><font color="#990000">The
|
|
scripts and associated files remain</font></b><font color="#990000"> the property of Ron F Woolley/HostingNet</font>.</font></p>
|
|
<blockquote>
|
|
<p><font face="arial,helvetica,geneva" size="2">
|
|
NO PROFIT what so ever is to be gained from users for supply of these scripts for the use of
|
|
these
|
|
scripts,
|
|
except that a reasonable minimal charge for installation may be allowed
|
|
if
|
|
installing
|
|
as a site
|
|
developer, for a user on the users site that is not on / in the developers domain OR site... remote hosting NOT allowed.</font></p>
|
|
<p><font face="arial,helvetica,geneva" size="2">
|
|
<b>This programs must NOT be used for multiple LogCount users on one site/domain<br>
|
|
and the program/resources must not be supplied as a remote service. </b></font></p>
|
|
<p align="center"><font face="arial,helvetica,geneva" size="2" color="#990000">
|
|
Ron Woolley, the author, MUST be notified via the addresses/URLs
|
|
below<br>
|
|
if any monetary charge is applied for the installation of these scripts.</font></p>
|
|
<p><font face="arial,helvetica,geneva" size="2"><b><i>NOTE</i></b>: If you use these
|
|
files, you do so entirely at your own risk, and take on full responsibility for the
|
|
consequences of using the described files. You must first agree that Ron Woolley /
|
|
HostingNet, the only permtted supplier of this and/or accompanying files are exempt from any responsibility for
|
|
all or any resulting problems, losses or costs caused by your using these or any
|
|
associated files - even if problems are known. </font></p>
|
|
</blockquote>
|
|
<p align="center"><font face="arial,helvetica,geneva" size="2"><strong>If you disagree
|
|
with any of these requirements,<br>
|
|
you must immediately destroy all files.</strong></font></p>
|
|
<p><font face="arial,helvetica,geneva" size="2">Although this program script is free to
|
|
use, if you use it and find it useful, a donation to help continue this support and keep
|
|
new scripts / upgrades coming would of course be appreciated.<br>
|
|
On line Visa / MasterCard payments are available for donations and low cost installations.</font>
|
|
<ul>
|
|
<dl>
|
|
<dt><font face="arial,helvetica,geneva" size="2"><b><a name="hlp"></a>For INTERMEDIATE installation experience</b>....<br>
|
|
.....<b>Help / Advice</b> information is available at: </font></dt>
|
|
<dd><font face="arial,helvetica,geneva" size="2"><a href="http://www.dtp-aus.com/cgiscript/scrpthlp.htm">http://www.dtp-aus.com/cgiscript/<b>scrpthlp.htm</b></a>
|
|
</font></dd>
|
|
<dt><font face="arial,helvetica,geneva" size="2">Files from: </font></dt>
|
|
<dd><a href="http://www.dtp-aus.com/cgiscript/cntscrpt.shtml"><font face="arial,geneva" size="2">http://www.dtp-aus.com/cgiscript/cntscrpt.shtml</font></a></dd>
|
|
<dt><font face="arial,helvetica,geneva" size="2">An outline of all dtp-aus scripts is at: </font></dt>
|
|
<dd><font face="arial,helvetica,geneva" size="2"><a
|
|
href="http://www.dtp-aus.com/cgiscript/allcgi.shtml">http://www.dtp-aus.com/cgiscript/allcgi.shtml</a>
|
|
</font></dd>
|
|
</dl>
|
|
</ul>
|
|
<p align="center"><font color="#ff0000" face="arial,helvetica,geneva" size="2"><b><a name="menu"></a>These
|
|
files</b> can only be obtained via the above web addresses, and<br>
|
|
<b>must not be passed on to others</b> in any form by any means what so ever.<br>
|
|
This does not contradict any other statements above - & ensures user obtained the latest.</font></p>
|
|
<p>
|
|
|
|
|
|
<font face="arial,geneva">
|
|
|
|
<hr width="90%">
|
|
</font>
|
|
|
|
<center>
|
|
<table border="1" cellspacing="0" cellpadding="5" align="center">
|
|
|
|
<tr bgcolor="#FFD599">
|
|
|
|
<th><font face="arial,geneva"><font face="verdana, arial, geneva, helvetica" size="2">• <a href="#bout">DESCRIPTION</a></font><font size="2"><font face="verdana, arial, geneva, helvetica"> • <a href="#vars">VARIABLES</a> </font><font face="verdana, arial, geneva, helvetica" size="2">• <a href="#post">INSTALLING</a></font><font face="verdana, arial, geneva, helvetica">• <a href="#tags">TAGS</a> •<br>
|
|
• <a href="#lnks">LINK COUNTING</a> • <a href="#llk">LOGLOOK</a> • <a href="#utils">UTILITIES</a> •</font></font></font></th>
|
|
</tr>
|
|
|
|
</table>
|
|
</center>
|
|
<p></p>
|
|
<p align="center">
|
|
|
|
<font size="2"><b><font color="#0000ff" face="arial,geneva,helvetica">NEW</font><font
|
|
face="arial,geneva,helvetica">** Version 3.8, February 2000;
|
|
NEW and CHANGED: **</font><font color="#0000ff" face="arial,geneva,helvetica">Changed</font>
|
|
<font
|
|
color="#0000ff" face="arial,geneva"><br>
|
|
</font></b><font face="verdana, arial, geneva, helvetica" size="1">check every few months for upgrades </font></font>
|
|
</p>
|
|
<p><font face="arial, geneva, helvetica" size="2">Like all other dtp-aus.com free programs, <font color="#660000"><b>LogCount</b></font><b> is a fully working program for webmasters</b>, and not a common "play with and plagiarise" free script as found on many sites... <br>
|
|
|
|
available / continuously developed for more than 15 months supporting webmasters.</font></p>
|
|
<P><font size="2"><FONT FACE="arial,geneva,helvetica"><i>History....</i></FONT><B><FONT FACE="arial,geneva,helvetica"><br>
|
|
1</FONT></B><FONT FACE="arial,geneva,helvetica">.
|
|
<I>v2.0</I> The auto creation of count and log files has been
|
|
removed because of the possible temporary loss of access deleting
|
|
file contents. The empty files are now supplied in the zip file
|
|
(<I>see 3</I>).<br>
|
|
</FONT><B><FONT FACE="arial,geneva,helvetica">2</FONT></B><FONT FACE="arial,geneva,helvetica">.
|
|
<I>v2.0</I> If your server does not supply 'REMOTE_HOST' info,
|
|
the counter script now attempts to create this info from the
|
|
local Domain Name Server.<br>
|
|
</FONT><B><FONT FACE="arial,geneva,helvetica">3</FONT></B><FONT FACE="arial,geneva,helvetica">.
|
|
<I>November ’98 vrsn. 2.0 to 2.1</I><BR>
|
|
- included free utility SSI script for inserting text counts
|
|
of counted hyperlinks into SSI HTML pages. (<I>instructions in
|
|
file, somename.cgi</I>)<BR>
|
|
- included utility set up script for creating directory structure,
|
|
files and chmod permissions (makedir.cgi).<br>
|
|
</FONT><B><FONT FACE="arial,geneva,helvetica">4</FONT></B><FONT FACE="arial,geneva,helvetica">.
|
|
<I>v3.0</I> The 'referrer rejection' option did not work at all
|
|
and had been overlooked. This version fixes that with a very
|
|
minor change to the <B>$rjct variable</B> values (see 'Rejecting
|
|
Specific Addresses' below), and corrected code in the logcnt.cgi
|
|
script. Also added to LogCount is the ability to show a <B>static
|
|
digital clock</B> or <B>time display</B> (hours and minutes).
|
|
The clock can be used for display only, or used as the counter
|
|
adding to the log etc.<BR>
|
|
<I>v3.1</I> Minor change that now uses the character "n"
|
|
in place of "C" to display the time WITHOUT counting.
|
|
This is necessary for non case-sensitive servers.<br>
|
|
</FONT></font><font face="arial,geneva,helvetica" size="2"><b>5</b>. v3.3 Changes to the date / time routines <i>September '99.</i><br>
|
|
<b>6</b>. v3.5 Major additions to LogLook plus minor changes to the LogCount program and config files <i>October '99.<br>
|
|
</i><b>7</b>. v3.5b Only a week or so after releasing v3.5, the supplied utility SSI program has been upgraded to two SSI programs. "linkname.cgi" that displays just a hyperlink count total as text, and "linkcount.cgi" that displays both the counted hyperlink tag and the hyperlink count total as text. <i>see below </i><font size="1"><br>
|
|
|
|
3.5<font color="#CC0000">c</font> = minor addition to LogLook counted-link tag generation </font></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><b><font color="#FF0000"><a name="38new"></a>8</font></b><font color="#FF0000">. v3.8</font> Changes to the config files (LogLook now has its own config file). Ability to <b>display and count individual page counts while</b> still updating the site count and log! <b>Major enhancements</b> to the free LogLook viewer. All <b>page names logged with their directory name</b> (if in a sub dir off the root). Use one of <b>three display methods for SSI</b> counters - display blank (hidden), or Text, or Images! Two new "require" sub routine files to trim the counter program.</font></P>
|
|
<P align="center"><font face="arial, geneva, helvetica"><b><font size="2" color="#6600CC"><a name="bout"></a>Low cost installations</font></b><font size="2" color="#6600CC"> can be carried out by the author; see program page for details link.</font></font><br>
|
|
<font face="arial, geneva, helvetica" size="2"><b>This program is written to be compiled by Perl versions 5+ on Unix servers</b></font></P>
|
|
<p align="right"><font face="verdana, arial, geneva, helvetica" size="2"><b><a href="#menu">MENU</a></b></font></p>
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
<TABLE WIDTH="590" CELLPADDING="0" CELLSPACING="0"
|
|
BORDER="0">
|
|
<TR>
|
|
<TD>
|
|
<hr>
|
|
<P align="center"><font size="2"><B><font face="arial,geneva,helvetica" size="3" color="#000099">ABOUT</font><FONT FACE="arial,geneva,helvetica"><br>
|
|
</FONT></B></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">Six programs are supplied. <b>LogCount</b> the counter, <b>LogLook</b> the very unique basic log viewer, <b>two utilities</b> to help you install the program, and <b>two utilities</b> some may find handy to SSI imbed activated counted hyperlink totals, or link and totals, in ot SSI activated pages</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">This "About" section plus the other detailed sections will cover all the options available to you for your site. However here is a list of things to look for:<br>
|
|
• Leading Zeros control<br>
|
|
• Hidden img tag counter<br>
|
|
• Visible img tag counter/display<br>
|
|
• Visible img tag NON counting display<br>
|
|
• Display Time counter<br>
|
|
• Display Time NON counter
|
|
<br>
|
|
• SSI Hidden counting<br>
|
|
• SSI Text Display counting
|
|
<br>
|
|
• SSI Img Tag Display counting<br>
|
|
• Visible SSI Displays with/without leading zeros<br>
|
|
• Page Counting Display while still adding to site log AND site counter<br>
|
|
• Keep count totals of Clicked Hyperlinks of special interest<br>
|
|
• Generate ALL counter and activated named link tags - simple copy and paste!<br>
|
|
</font><font face="arial, geneva, helvetica" size="2">• visually track visitors page accesses<br>
|
|
• view most popular pages<br>
|
|
• view browser type comparisons<br>
|
|
• view total unique IP#s and pages-viewed averages
|
|
<br>
|
|
• view above for any date retained in the current log<br>
|
|
• view IP# page totals for any date in the current log</font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2">So, you can use the lot or just one of those options. But you can see why you get such a large help page as this one.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2" color="#FF0000">Version 3.8</font><font face="arial,geneva,helvetica" size="2"> includes some important set up changes and enhancements to LogLook and a new page counting option - LogCount is a proper site counter - <a href="#38new">see history above</a>.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><b>v3.5</b> LogLook included administrative options for creating, editing, resetting, and deleting counted hyperlinks. The tag for any counted hyperlink can be readily generated for a simple copy and paste in to web pages. The tags for all counter methods can also be readily generated via LogLook for simple copy and paste in to web pages, plus several other setup options can be changed.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><b>pre v3.3 UPGRADE</b><br>
|
|
Pre version 3.3 users will find several new variables in the config file. Also note the renaming of both the config and GMT files. If you are using other dtp-aus.com programs sharing the "sets" sub directory, either rename the gmt file reference in those other programs or change the new file name.
|
|
This has occurred because gradually all programs will be using require files with the extension ".pl". The new LogCount and LogLook programs can upload over v3.3 - <i>unless the previous have been altered... and I cannot help.</i></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><b><font size="3">Once installed</font></b><br>
|
|
<b>It is strongly suggested</b> that LogLook be the first program to test. The simple mistakes often made in setting up counter tags can be misleading and many inexperienced people assume wrongly when fault tracking. By using LogLook first, once it works and options can be changed, or even if the error reports inbuilt are generated, then most of the installation can be then be assumed as correct and later counter tags can be looked at with more confidence.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">Then install the webmasters access page even if not going to use the supplied one! This includes a couple of NON-counting visible counters to check paths etc. All digits should show zero unless you manually add a count to the count file - see variables below</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">PROPERLY SET UP the programs CANNOT be accessed from remote pages containing links to them OR a browser command line - this is a <a href="#refs">first level security feature</a> and <b>INCLUDES YOU</b>!</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">All relevant files are
|
|
supplied in one compressed .zip file that includes the recommended
|
|
directory structure. It is assumed that the .zip file has been
|
|
uncompressed to the directory structure included in the .zip
|
|
file on your local pc before proper FTP uploading - keep perl programs away from MSFrontPage and other site posting wysiwyg editors!</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">You MUST alter all reference
|
|
to "yourdomain.name" in the config 'require' files plus the
|
|
webmasters page, and change the configuration variables, as described
|
|
in this Readme text. Also set up the paths and URLs correctly in both program config files in the sets directory (<b>the "sets" directory</b> is used by all dtp-aus.com programs and will achieve even greater importance in the near future - currently the GMT config file is accessed/can be changed by all dtp-aus.com programs <i>ie</i> one change upgrades all programs!).</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">Firstly, a few explanations.
|
|
LogCount does not use in-built count images, allowing you to
|
|
use any counter image "sets" that are readily available
|
|
via the Internet. These sets must include 10 images, displaying
|
|
0 - 9, and when placed in the appropriate directory (folder),
|
|
they must be named or renamed "0.gif" through to "9.gif".
|
|
</font><font size="2"><B><FONT COLOR="#ff0000" FACE="arial,geneva,helvetica">*Note*</FONT></B><FONT
|
|
FACE="arial,geneva,helvetica"> The clock option, if used, requires
|
|
conversion of any of your current images to a full colon ( :
|
|
) named "-.gif", an image displaying "am"
|
|
named "a.gif", and one displaying "pm" named
|
|
"p.gif".</FONT></font></P>
|
|
<P><font color="#000099" face="arial,geneva,helvetica" size="2">Both of
|
|
the supplied image sets have been updated</font><font face="arial,geneva,helvetica" size="2">
|
|
with these images (to display the clock on any page, see "<B>Displaying
|
|
The Clock</B>" <a href="#tags">below</a>).</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">Extra server resources
|
|
are not called upon by calling additional "on call"
|
|
programs that create the images. The only loss here is the ability
|
|
to add "pretty" borders to the count display. Logcount,
|
|
and Loglook scripts are designed for conservative tracking and analysing visitor
|
|
trends and page popularity etc, so it is suggested that the majority
|
|
of pages only include the simple "Hidden Counter" options.
|
|
Small conservative light and dark background count images are
|
|
supplied.</font></P>
|
|
<center>
|
|
<table width="96%" border="0" cellspacing="0" cellpadding="3">
|
|
|
|
<tr>
|
|
|
|
<td><font size="2"><b><font color="#990000" face="arial,geneva">Please NOTE</font></b><font
|
|
face="arial,geneva">:</font></font></td>
|
|
</tr>
|
|
|
|
<tr bgcolor="#EFEFFF">
|
|
|
|
<td><font size="2"><font
|
|
face="arial,geneva">If you install and use this script, please contact us at <a
|
|
href="mailto:logcount@dtp-aus.com?subject=LogCount_report">logcountreport@dtp-aus.com</a> with server
|
|
type detailsand how the script installed and worked etc,
|
|
for a report base assisting others.<br>
|
|
</font><font size="3" face="arial,geneva" color="#0000CC"><b><a name="vars"></a></b></font><font
|
|
face="arial,geneva">( <font color="#000099">a <b>vote</b> at cgi.resourceindex.com - via red form <u><a href="#hlp">on the LogCount program page</a></u> - or any other cgi links site would also be appreciated to help "spread the word"</font> )<br>
|
|
</font><font size="2" face="arial,geneva"> <i> Thank you</i>.</font></font></td>
|
|
</tr>
|
|
|
|
</table>
|
|
</center>
|
|
<p align="right"><font face="verdana, arial, geneva, helvetica" size="2"><b><a href="#menu">MENU</a></b></font></p>
|
|
<hr width="100%">
|
|
<p align="center"><font size="2"><b><font face="arial,helvetica,geneva" size="2">For INTERMEDIATE installation experience - <a href="#hlp">Help / Advice</a> information is available.</font><font face="arial,geneva" size="3" color="#000099"> CONFIGURATION VARIABLES in DETAIL</font></b></font></p>
|
|
<P align="center"><font face="Arial, Helvetica, sans-serif" size="2"><b><font color="#FF0000">NOTE</font></b>: these variables are now spread over <b>two config files</b> but are all covered below!</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">INCLUDED or REQUIRED
|
|
FILES<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">The Perl language
|
|
allows the inclusion of extra files containing libraries of commonly
|
|
accessed sub routines or common lists of script variables etc.
|
|
The scripts logcnt.cgi and loglook.cgi together "require" four
|
|
such files. One includes a variable used by the date/time routines
|
|
and the other contains the "user" variables. In case
|
|
I get a few more scripts prepared and available for general use,
|
|
I have included the GMT reference variable in a separate file
|
|
as used by all my scripts on dtp-aus.com. If I need to change
|
|
this common variable, then I only have to change one file, not
|
|
many.</FONT></font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">SSI IMBEDDED SCRIPT
|
|
CALLS<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">If you wish to
|
|
place a simple "hidden", "text", or "image" count on your page, and your
|
|
Host service allows SSI (Server Side Includes) calls, then the
|
|
inclusion of one simple SSI call to the script will perform this
|
|
task. Place the call in the text of your html page where you
|
|
want it to appear ie:</FONT></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">"<p>Current
|
|
site count is </font><font face="courier,courier new" size="2"><!--#exec
|
|
cgi="/cgi-bin/logcnt.cgi"--></font><font face="arial,geneva,helvetica" size="2">
|
|
page views.</p>" and the result could be:<BR>
|
|
'</font><font color="#000099" face="arial,geneva,helvetica" size="2">Current
|
|
site count is 02365 page views.</font><font face="arial,geneva,helvetica" size="2">'</font></P>
|
|
<P><font face="Courier New, Courier, mono" size="2" color="#CC0000"><b>$ssi_img</b></font><font face="arial,geneva,helvetica" size="2"> Which of the three display methods depends on the $ssi_img config variable.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">LogCount recognises an
|
|
SSI call and responds accordingly. NOTE: Most servers require
|
|
the HTML page file extensions of ".shtml" or ".sht"
|
|
for SSIs to work. NOT all servers allow SSI to receive external data for very good security reasons, Although some simple SSI programs rely on that, LogCount does not and is designed to work without!</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">Comments about relative
|
|
paths and directory choices etc are included below.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">GMT TIME ZONE reference - </FONT></B><font face="arial,geneva,helvetica" color="#FF0000"><b>NOTE</b>: this value can be set easily from the LogLook admin pages</font><B><FONT FACE="arial,geneva,helvetica"><BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">Like myself with
|
|
www.dtp-aus.com, Hosting services are being used now that are
|
|
"remote" from ones local ISP service. Normally this
|
|
means that all of our scripts etc report dates and times different
|
|
to that of our local access points, ie our home locality from
|
|
where we view our sites. To overcome this I use a Perl facility
|
|
that allows us to use (G)reenwich (M)ean (T)ime with an offset
|
|
reference reporting in my local time and date. One of the perl
|
|
"Include" files, 'gmt.set', contains a variable name
|
|
- <BR>
|
|
</FONT></font><font face="courier,courier new" size="2">$gmtPlusMinus</font><font face="arial,geneva,helvetica" size="2"><BR>
|
|
- whose value MUST be set for your local GMT offset. I live in
|
|
a world time zone 15 hours ahead of that of my Host Servers.
|
|
Therefore, when I set the variable to 36000 (GMT+10hrs), the
|
|
server logs record, and I view, all dates and times relevant
|
|
to my locality irrespective of where my Hosting service is. With
|
|
this method I can move my Domain and the results would not change.</font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2">This value <b>can now be changed via the LogLook program</b>. To get an idea of your local GMT zone value, <b>check the "date" set up in your local pc</b> date configuration - <i>ie</i> Windows.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">The manual calculation is simple.
|
|
Your local GMT time, multiplied by 60, and multiplied by 60 again.
|
|
ie 10X60X60. Therefore my variable entry is "</font><font face="courier,courier new" size="2">$gmtPlusMinus = 36000</font><font face="arial,geneva,helvetica" size="2">". If your GMT zone is a
|
|
negative value, simply include a negative value ie "</font><font face="courier,courier new" size="2">$gmtPlusMinus = -36000</font><font face="arial,geneva,helvetica" size="2">"</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">LEADING ZEROs<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">All displays of
|
|
the count value will include the standard "leading zeros"
|
|
method of displaying numbers. The configuration file for LogCount
|
|
and LogLook is called 'cntcnfg.set'. By adjusting the variable
|
|
named "</FONT></font><font face="courier,courier new" size="2">$iszeros</font><font face="arial,geneva,helvetica" size="2">", you can control the length
|
|
of the output number. ie <BR>
|
|
'</font><font face="courier,courier new" size="2">$iszeros = "000000"</font><font face="arial,geneva,helvetica" size="2">' will display 029384, and '</font><font face="courier,courier new" size="2">$iszeros = "0000"</font><font face="arial,geneva,helvetica" size="2">' will display 0087 and so forth.
|
|
If your site receives a small number of hits per month then it
|
|
probably looks better with a smaller number of digits. However,
|
|
never be too pessimistic and allow for growth. ie '00000' will
|
|
allow the count to proceed up to 99999 without altering your
|
|
html code calls to the counter, and 000000 will display up to
|
|
999999.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">The length or number of
|
|
zeros MUST be matched by the number of <img src... calls and
|
|
visa versa when using the visible counter options.</font> <font size="2"><B><FONT
|
|
FACE="arial,geneva,helvetica">How you call each digit will be
|
|
described below</FONT></B><FONT FACE="arial,geneva,helvetica">.</FONT></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><b><font color="#FF0000">NOTE</font></b>: </font><font size="2" face="arial,geneva,helvetica">"<font face="Courier New, Courier, mono"><b>$ssi_zro</b></font>" </font><font face="arial,geneva,helvetica" size="2"><b>The SSI calls</b> can now be set to include <i>OR</i> not include the leading zeros.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">US, BRITISH, or INTERNATIONAL DATE
|
|
reporting<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">LogCount and LogLook
|
|
can save and view logs using the US mm/dd/yyyy format,
|
|
or the BRITISH dd/mm/yyyy format, or the International date format yyyy/mm/dd. In the configuration file,
|
|
'cntcnfg.set', you will find a variable named </FONT></font><font face="courier,courier new" size="2">$dtUS</font><font face="arial,geneva,helvetica" size="2">. Leaving this variable value
|
|
as null, ie '</font><font face="courier,courier new" size="2">$dtUS =
|
|
""</font><font face="arial,geneva,helvetica" size="2">' will
|
|
cause the scripts to use "dd/mm/yyyy". Setting this
|
|
variable to '</font><font face="courier,courier new" size="2">$dtUS =
|
|
"1"</font><font face="arial,geneva,helvetica" size="2">' will
|
|
force 'mm/dd/yyyy'. Setting this
|
|
variable to '</font><font face="courier,courier new" size="2">$dtUS =
|
|
"2"</font><font face="arial,geneva,helvetica" size="2">' will
|
|
force 'yyyy/mm/dd'.</font></P>
|
|
<P><font size="2"><B><font face="Courier New, Courier, mono" size="3"><a name="refs"></a>@referers<font face="arial, geneva, helvetica"> array</font></font><FONT FACE="arial,geneva,helvetica"><br>
|
|
CHECKING FOR CORRECT
|
|
REFERRERS</FONT><font size="2" face="arial,geneva"> - " <font color="#FF0000">Bad referrer, access denied!</font>"</font><FONT FACE="arial,geneva,helvetica"><BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">This option in
|
|
the 'cntcnfg.set' file allows you create an "array"
|
|
of Domain names and IP numbers that LogCount and LogLook will
|
|
respond positively to. By including the acceptable calls to your
|
|
pages and/or your IP#, ie 'http://www.yourdomain.com' and http://yourdomain.com'
|
|
you effectively stop improper additions to your count and log.
|
|
However, LogCount saves incorrect referrers to a separate log
|
|
that you can view from time to time to see if there are any patterns
|
|
in the list. This is not 100% foolproof, but in most cases you
|
|
will also be able to detect copied pages from your site that
|
|
are being viewed on "online servers" elsewhere. <BR>
|
|
The array is named "</FONT></font><font face="courier,courier new" size="2">@referers</font><font face="arial,geneva,helvetica" size="2">" and you simply (MUST) enter
|
|
your preferences in place of the examples. NOTE: The brackets,
|
|
quotes and commas enclosing each item must be included else an
|
|
error will occur, ie:</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">('www.yourdomain.com','yourdomain.com','000.000.000.000',).
|
|
Leave out the IP# if you do not have a true domain name with
|
|
a static IP#. "www.ahost.net/mysite/" etc will also
|
|
work for second level site calls etc. If your scripts are called
|
|
from the cgi-bin of a domain that is housing your site and your
|
|
specific scripts are in that domains cgi-bin, you will have to
|
|
include the cgi-bin also ie: "ahost.net/cgi-bin/".</font></P>
|
|
<P><font face="arial,geneva" size="2"><b><font color="#FF0000" size="4">NOTE</font></b>: <b>Even your</b> browser command line <b>AND</b> a copy of your page on <b>your</b> home computer will be blocked by referrer checking. <b>ONLY use links / forms ON your site</b>. This is not just to stop others spamming your counter BUT is a first level security measure should a program have security holes. Use a/the webmasters access page - <a href="#utils">see below</a> in "utilities" section.</font></P>
|
|
<P align="center"><font face="arial,geneva,helvetica" size="2">At this point I will bring
|
|
your attention to the semi colons (;) appearing at the end of
|
|
<br>
|
|
each line in the config files. These MUST remain else an error
|
|
will occur.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">REJECTING SPECIFIC
|
|
ADDRESSES<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">If have the need
|
|
to reject certain domains or IP#s from adding to the count, the
|
|
variable named </FONT></font><font face="courier,courier new" size="2">$rjct</font><font face="arial,geneva,helvetica" size="2"> in the 'cntcnfg.set' file must
|
|
include them. Unlike an indexed array, this is a simple variable
|
|
that will be searched for items INBETWEEN the important ( | )
|
|
separators. <B>NOTE</B>: There is now a required vertical bar
|
|
character ( | ) at the beginning AND end of this string.<BR>
|
|
I have left an example string in the variables value, to show
|
|
the separators, but you can leave this as a null value. ie </font><font face="courier,courier new" size="2">$rjct = ""</font><font face="arial,geneva,helvetica" size="2">. Remember, if you include a server
|
|
address in this variable, then ALL visitors from that server
|
|
will not be counted - a large company, ISP or university will
|
|
have many computers that could access your site through that
|
|
one server address.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">PATHS TO FILES ACCESSED
|
|
BY SCRIPTS<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">The defaults used
|
|
in the 'cntcnfg.set' file assume you will place these files in
|
|
your cgi-bin and add a directory to it called "counters".
|
|
If you have to use other directory names, or your "cgi-bin"
|
|
has a different name, then you will have to change the paths
|
|
accordingly; "cgi-yourdomain" is not uncommon. There
|
|
are three path types that can be used at various times with in
|
|
a program or script. A full URL is the same as the path you enter
|
|
in your browsers address box when typing in a site path that
|
|
you wish to go to: ie 'http://www.wooz.com/harry.htm'. A relative
|
|
path is a path description to a source, relative to the directory
|
|
of the program, file or web page that is calling it: ie "jimbo.htm"
|
|
means that the file being called should be in the same directory.
|
|
"inone/jimbo.htm" refers to a file that should be in
|
|
a directory named 'inone' which is a directory within the current
|
|
directory, and "../jimbo.htm" means that the file should
|
|
be in a directory one above the current directory, and "../../jimbo.htm"
|
|
is in a directory two above etc.</FONT></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">For some servers, a simple
|
|
relative path called by a script is unacceptable, so a path relative
|
|
to the sites root directory must be called. There are also variations
|
|
to this description but "web/yourdomain/yourdirectory/jimbo.htm"
|
|
(example only) is a relative root path description that works
|
|
on many servers. Another root path is "/home/yourdomain/www/yourdirectory/jimbo.htm".
|
|
If you have trouble with accessing the default simple relative
|
|
paths included in the 'cntcnfg.set' file, try the root reference
|
|
ie "web/yourdomain/cg-bin/counters/hitcount.t" etc.
|
|
If this is still a problem, look in any installed scripts on
|
|
your server for a reference, or contact your hosting support
|
|
staff and send them the 'cntcnfg.set' file.</font></P>
|
|
<P><font size="2"><B><I><FONT FACE="arial,geneva,helvetica">NOTE</FONT></I></B><FONT
|
|
FACE="arial,geneva,helvetica">: Double check ALL permission's
|
|
(below) before changing the default paths, unless you know in
|
|
advance what the paths should be.</FONT></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><b>CONFIG FILES PATHS</b> - <font color="#CC0000">program code AND config files</font><br>
|
|
The programs need to load the config files. Admin editing also needs a reference to the three config files, cntcnfg.pl and gmtset.pl. Near the top of BOTH program's code just below the header info are paths that must be set before installation.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">
|
|
</font><font face="arial,geneva,helvetica" size="2"><font face="Courier New, Courier, mono">$gmt_url</font> and <font face="Courier New, Courier, mono">$lookcfg_pth</font> are also the variables needed for this purpose in the config files.<br>
|
|
</font><font face="arial,geneva,helvetica" size="2">NOTE: the LogLook config file includes the "$lookcfg_pth" variable and the LogCount config file includes the "$gmt_url".</font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2"><b>RECORDS DIRECTORY AND FILES</b><br>
|
|
These variables direct the programs to the record files. They should be self explanatory and not need changing. NOTE the first is the PATH to the records directory (default relative), the others are the names of files residing in that directory.</font><br>
|
|
<font face="Courier New, Courier, mono" size="2">$log_path = "counters/";<font face="arial, geneva, helvetica"> # - MUST end with a forward slash
|
|
</font><br>
|
|
$count_name = "hitcount.t";
|
|
<br>
|
|
$log_name = "hitlog.t";
|
|
<br>
|
|
$lnks_name = "hitlnk.t";
|
|
<br>
|
|
$badlog_name = "hitbadlog.t";
|
|
</font></P>
|
|
<P>
|
|
<font face="arial, geneva, helvetica" size="2"><b>DEFAULT PAGE NAME</b><br>
|
|
<font face="Courier New, Courier, mono">$def_pge = "index";</font>
|
|
<br>
|
|
When the counter or LogLook viewer encounters a referrer not including a page name (ie "http://yourdomain.name/") this value will be appended. Without an extension it will be distinguishable from the other directory default pages. </font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2">Left empty only the directory name will be logged/displayed - <b>LogCount now saves page names WITH their directory name also</b>!! <i>ie</i>:<br>
|
|
/<br>
|
|
wally/<br>
|
|
wally/page.name<br>
|
|
<i>even a multi level directory will be displayed as above - reducing viewer distortion from long URLs.
|
|
</i></font><br>
|
|
</P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><b>IMAGE SIZE</b><br>
|
|
To generate the tags for you for all the counter methods, LogLook needs to know the image width and height of the bitmaps used to display the count or time.
|
|
The value of <font face="courier,courier new">$iwid</font> is the width set to the default images, and the value of </font><font size="2" face="courier,courier new">$ihgt</font><font face="arial,geneva,helvetica" size="2"> is the height also set to the default images. Change these only if you decide to use other images. </font></P>
|
|
<P><font size="2" face="arial, geneva, helvetica"><b>IMAGE DIRECTORY</b><br>
|
|
LogCount can now access and read/send images from the default "counters" sub directory of the cgi-bin OR now access images from an HTML Docs directory. One or two servers have been reported to get cranky when opening/sending images so this option has been added.<br>
|
|
<font face="Courier New, Courier, mono"> $img_url = "counters/";</font> - <b>PATH</b> - with forward slash<br>
|
|
<i>OR</i>
|
|
<br>
|
|
<font face="Courier New, Courier, mono"> #$img_url = "http://yourdomain.name/ssi_img/";</font> - <b>URL</b> - with forward slash</font></P>
|
|
<P><font size="2" face="arial, geneva, helvetica">Place a hash character ( # ) at the beginning of the option you do NOT wish to use.<br>
|
|
<b>NOTE</b>: the URL option should be set to the same directory as the SSI Images directory - see next variable description.</font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2"><b>SSI IMAGE DIRECTORY</b> - value = a URL<br>
|
|
<font face="Courier New, Courier, mono">$ssi_url</font> SSI counter displays have to be written as a URL to the images - embedded in the pages HTML code - so this is the url to those SSI images. NOTE: this should be the same as the "URL" option in the previous description UNLESS you want to use two different image sets.
|
|
</font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2"><b>LOGLOOK BAR GRAPHS - <i>do NOT change these variables</i></b><br>
|
|
Version 3.8 of LogCount included major enancements to the free LogLook log viewer and admin program. The first page that should be accessed via the password entry in the webmastres page should be a list of all current log pages listed from most popular down. With this list each page name is also accompanied by a simple but affective bar garph for easy visual comparison. These are the file names of the graph images AND they MUST be in the SSI HTML Docs directory.<br>
|
|
<font face="Courier New, Courier, mono"> $grf1_url = "$ssi_url"."grf0.gif";</font><br>
|
|
<font face="Courier New, Courier, mono"> $grf0_url = "$ssi_url"."grf1.gif";</font><br>
|
|
NOTE the URL includes the previous variable!!
|
|
</font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2"><b>SSI COUNTER DISPLAY TYPE</b><br>
|
|
$ssi_img
|
|
Adding more versatility to LogCount, SSI counters can be preset to one of three styles.<br>
|
|
<i>They are:</i><br>
|
|
HIDDEN<br>
|
|
NUMBER<br>
|
|
IMAGES<br>
|
|
Preset this value at installation time (or change at time afterwards!)<br>
|
|
<b>NOTE</b>: the visible options, "number" and "images" can be enhanced by including leading zeros just like the main standard counter by setting the "$ssi_zro" variable to "1". </font>
|
|
</P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">RETURN PAGE URL<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">The value for
|
|
the variable named "</FONT></font><font face="courier,courier new" size="2">$hm_url</font><font face="arial,geneva,helvetica" size="2">" in the 'cntcnfg.set' file
|
|
needs to be altered to include the FULL URL Path to your home
|
|
page or any page that you wish to return to after using the LogLook
|
|
script to view your log details.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">LOGLOOK.CGI URL<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">The value for
|
|
the variable named "</FONT></font><font face="courier,courier new" size="2">$logScrpt</font><font face="arial,geneva,helvetica" size="2">" in the 'cntcnfg.set' file
|
|
needs to be altered to include the FULL URL Path to the loglook.cgi
|
|
script (the viewer). It is suggested that the scripts be placed
|
|
in your cgi-bin or equivalent.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">LOGCNT.CGI URL<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">The value for
|
|
the variable named "</FONT></font><font face="courier,courier new" size="2">$countScrpt</font><font face="arial,geneva,helvetica" size="2">" in the 'cntcnfg.set' file
|
|
needs to be altered to include the FULL URL Path to the logcnt.cgi
|
|
script (the counter). It is suggested that the scripts be placed
|
|
in your cgi-bin or equivalent.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">WEBMASTERS E-MAIL ADDRESS<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">The LogLook script
|
|
includes various errors that can be reported back to you via
|
|
an html page. Although it is expected that only you will use
|
|
the counting facilities, I have included the webmasters address
|
|
in some of these hyperlink error reports. Probably of little use in the current
|
|
versions, but change this address to yours or your webmasters
|
|
if you are not he/she. ie <BR>
|
|
'</FONT></font><font face="courier,courier new" size="2">$webmstr = "webmaster\@yourdomain.name?subject=Link
|
|
Error</font><font face="arial,geneva,helvetica" size="2">"'.</font></P>
|
|
<P><font size="2"><B><I><FONT COLOR="#ff0000" FACE="arial,geneva,helvetica">NOTE</FONT></I></B><FONT
|
|
FACE="arial,geneva,helvetica">: The backslash ( <B>\</B> ) is
|
|
very important for Perl 5 users. All string references that include
|
|
the (@) character must insert a backslash before that character.</FONT></font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">DISPLAY LAST 7 DAYS<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">The value for
|
|
the variable named "</FONT></font><font face="courier,courier new" size="2">$shwDays7</font><font face="arial,geneva,helvetica" size="2">" in the 'lookcnfg.set' file
|
|
enables the last 7 days display option
|
|
from the LogLook viewer. If you do not have a high daily
|
|
hit count and yet keep a large log file, then you can try using
|
|
the 7 day list view option by setting the value for this variable
|
|
to ("1"). On the other hand, you just may be cooking
|
|
AND eating dinner while your server attempts to send back the
|
|
possibly gynormous (big) html file. Therefore, '</font><font face="courier,courier new" size="2">$shwDays7 = ""</font><font face="arial,geneva,helvetica" size="2">' diables the option, and '</font><font face="courier,courier new" size="2">$shwDays7 = "1"</font><font face="arial,geneva,helvetica" size="2">' enables the display of the last 7.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><b><font color="#FF0000">Note </font></b> With the supplied and
|
|
useful <b>LogLook</b> viewer, you can change this value via an admin page. </font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><b><font color="#FF0000">Note v3.5</font></b> Also with the supplied <b>LogLook</b> viewer, you can now delete
|
|
entries as the log file gets too large. Around midnight Saturdays
|
|
is a good time to prune or delete files. </font></P>
|
|
<P> </P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">SHOW DOMAIN NAMES<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">LogCount records
|
|
the domain names as well as the IP#s (referers) for each access.
|
|
However, not all hosting servers enable this option, resulting
|
|
in the IP# and the domain name being just an identical IP number.
|
|
The value for the variable named "</FONT></font><font face="courier,courier new" size="2">$showDoms</font><font face="arial,geneva,helvetica" size="2">" in the 'cntcnfg.set' file
|
|
can disable the duplication of IP#s in the daily log list displayed
|
|
by LogLook. '</font><font face="courier,courier new" size="2">$showDoms
|
|
= ""</font><font face="arial,geneva,helvetica" size="2">' disables
|
|
their inclusion, and '</font><font face="courier,courier new" size="2">$showDoms
|
|
= "1"</font><font face="arial,geneva,helvetica" size="2">' will
|
|
display them.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">PASSWORDS<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">You MUST include
|
|
a basic password-only access to the <b>LogLook</b> script by entering </FONT></font><font face="arial,geneva,helvetica" size="2">your unique password to
|
|
the value of the variable named "</font><font face="courier,courier new" size="2">$theword</font><font face="arial,geneva,helvetica" size="2">". <b>The default</b> is "log". Change it to suit.</font></P>
|
|
<P><font face="Courier New, Courier, mono" size="2"><b>$pwrd_name</b></font><font face="arial,geneva,helvetica" size="2"> the name of the <b>Admin Password file</b> written to by LogLook admin.<br>
|
|
The use of <b>LogLook</b> can
|
|
be protected from others by a basic password method that requires
|
|
that the password be included in the call to the script. Also,
|
|
once you have accessed the main page the password is imbeded
|
|
in the html so that you can jump between the two main pages by
|
|
hyperlinks. If you are generally the only user of the computer
|
|
you access the log with, then this is a simple answer. However,
|
|
you must remember that Browser Cache can keep copies of your
|
|
pages, and even worse is the History folder that records all
|
|
page access calls. So <b>editing of options via LogLook is protected via a further "admin" editing password</b> you must <b>create</b> when the LogLook program is first run.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">Although I have included
|
|
the "no-cache" meta tag in the pages generated by LogLook,
|
|
and a "WebMasters" access page that you can add other
|
|
utilities to also, the only sure-fire way of protecting access
|
|
to any web page (unless your host server is hacked) is to place
|
|
the webmasters access page in a server controlled password protected
|
|
directory; most decent host services will supply one for you
|
|
for free, often named "secure" (except perhaps the
|
|
'Free Web Page' services).<a name="post"></a></font></P>
|
|
<P>
|
|
|
|
<FONT FACE="arial,geneva,helvetica">
|
|
</FONT>
|
|
|
|
<p align="right"><font face="verdana, arial, geneva, helvetica" size="2"><b><a href="#menu">MENU</a></b></font></p>
|
|
<hr width="100%">
|
|
|
|
<p></P>
|
|
<P align="center"><font color="#000099" size="3" face="arial, geneva, helvetica"><b>INSTALLING</b></font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">THE PATH TO PERL<br>
|
|
</FONT></B><font face="arial,geneva,helvetica">At the top of
|
|
each script (and must remain as the first line) is a default
|
|
path to the Perl program on your host server. This can vary slightly
|
|
between UNIX servers. If you have problems running the scripts,
|
|
check with your host support staff about the correct path described
|
|
in this line. The default entry is "</font></font><font face="courier,courier new" size="2">#!/usr/bin/perl</font><font face="arial,geneva,helvetica" size="2">" and another common variation
|
|
is "</font><font face="courier,courier new" size="2">#!/usr/local/bin/perl</font><font face="arial,geneva,helvetica" size="2">". In Perl scripts the hash
|
|
sign "</font><font size="2"><b><font face="courier,courier new">#</font></b><font
|
|
face="arial,geneva,helvetica">" character comments out
|
|
the code on a line starting with this character. <b>Here it has
|
|
a special meaning</b> to Perl.</font></font></P>
|
|
<p><font face="arial,geneva" size="2">Even if you have installed other CGI programs you are not necessarily an experienced cgi installer. Because a path worked on another program does not mean it is v5+ (<i>5.003+ preferred</i>)!<br>
|
|
<b><font color="#CC0000">The scripts help page</font></b> (<a href="#hlp">URL above</a>) contains helpful advice; <i>if you are humble enough to learn!</i></font></p>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">LOG AND COUNT FILES
|
|
Plus PERMISSIONS<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">LogCount will
|
|
attempt to create and set permissions on the files it needs for
|
|
the count, counter log, and bad referrers log. Should your server
|
|
refuse to give</FONT></font><font face="arial,geneva,helvetica" size="2">scripts the right to create
|
|
new files, then you will have to create them your self via FTP
|
|
or Telnet. The Link List file needs to be created by you because
|
|
you have to enter the links and their names (see below). Each
|
|
of these files must be given read and write permissions (chmod
|
|
766). The directory that they are placed in will also have to
|
|
have read and write permissions. Either read and write chmod
|
|
766 (r+w) or possibly chmod 777 (r+w+x) will work - try the first
|
|
before the latter. Note the makedir comment below if using makedir.cgi to setup quickly.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">UP LOADING FILES (Posting)<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">CGI-BIN permissions
|
|
are set by the server and no attempt should be made to change
|
|
them. Should you have to use another directory, AND your server
|
|
allows the execution of Perl CGI scripts in other directories,
|
|
then that directory should be set with read and execute permissions
|
|
- chmod 755 (r+x). Also, The scripts and 'require files should
|
|
be set to chmod 755 (r+x).</FONT></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">By far the biggest problems
|
|
faced when installing scripts are firstly the file transport
|
|
encoding used and secondly the permissions settings set for both
|
|
files and new directories. Bitmap images must be sent to the
|
|
server using the "Binary" protocol. Text files, ie
|
|
html pages, CGI SCRIPTS and require files, MUST be sent in "ASCII"
|
|
format. Failure to do this will result in a server failing to
|
|
recognise and execute the scripts. Although often referred to
|
|
as programs, scripts must be compiled before they do anything.
|
|
As an example, files with the .EXE extension on programs that
|
|
are installed on Wintel machines are pre-compiled binary executable
|
|
programs. Perl scripts on the other hand are compiled in memory
|
|
by Perl before they can be executed. The script (text) must be
|
|
in ASCII text format for the interpreter to be able to read it.
|
|
</font></P>
|
|
<P align="center"><font face="arial,geneva,helvetica" size="2">REPEAT: <B>Up load scripts as "ASCII" files, images
|
|
as "Binary"</B>.</font></P>
|
|
<P><font size="2" face="arial,geneva,helvetica"><b>So, assuming the default
|
|
directory structure is used, you will up load into:</b></font></P>
|
|
<blockquote>
|
|
<dl>
|
|
<dt><font size="2" color="#000099" face="arial,geneva,helvetica"><i>Directory:</i>
|
|
</font>
|
|
<dt><font face="arial,geneva,helvetica" size="2">cgi-bin (server)</font>
|
|
<dd><font face="arial,geneva,helvetica" size="2">logcnt.cgi, loglook.cgi
|
|
(chmod 755)</font>
|
|
<dt><font face="arial,geneva,helvetica" size="2">cgi-bin/sets (chmod 766
|
|
or 777)</font>
|
|
<dd><font face="arial,geneva,helvetica" size="2">cntcnfg.pl, lookcnfg.pl, gmtset.pl
|
|
(chmod 766 or 777)</font>
|
|
<dt><font face="arial,geneva,helvetica" size="2">cgi-bin/counters (chmod
|
|
766 or 777)</font>
|
|
<dd><font face="arial,geneva,helvetica" size="2">hitlnk.t, hitbadlog.t, a_dolink.pl, a_errlog.pl, look.pwd (chmod 766
|
|
or 777),
|
|
<br>
|
|
hitcount.t, hitlog.t, trans.gif, images(0 to 9 + a,p,-).gif</font>
|
|
<font face="arial,geneva,helvetica" size="2"> (chmod 766
|
|
or 777)</font>
|
|
<dt><font face="arial,geneva,helvetica" size="2">html page directory ( named "ssi_img" ) </font>
|
|
<dd><font face="arial,geneva,helvetica" size="2">images(0 to 9 + a,p,-).gif, grf0.gif, grf1.gif,
|
|
[ trans.gif ? ]</font>
|
|
<dt><font face="arial,geneva,helvetica" size="2">html page directory -
|
|
preferably secure</font>
|
|
<dd><font face="arial,geneva,helvetica" size="2">webmster.html (server)</font>
|
|
<dt><font size="2" color="#000099" face="arial,geneva,helvetica"><i>If
|
|
you have to create them yourself:</i>
|
|
</font>
|
|
<dt><font face="arial,geneva,helvetica" size="2">cgi-bin/counters</font>
|
|
<dd><font face="arial,geneva,helvetica" size="2">counters/hitcount.t (chmod
|
|
766
|
|
or 777)</font>
|
|
<dd><font face="arial,geneva,helvetica" size="2">counters/hitlog.t (chmod
|
|
766
|
|
or 777)</font><br>
|
|
<font face="arial,geneva,helvetica" size="2">counters/hitlnk.t (chmod
|
|
766
|
|
or 777)<br>
|
|
counters/look.pwd (chmod
|
|
766
|
|
or 777)</font>
|
|
<font face="arial,geneva,helvetica" size="2">
|
|
</font>
|
|
<dd><font face="arial,geneva,helvetica" size="2">counters/hitbadlog.t
|
|
(chmod 766
|
|
or 777)</font>
|
|
<font size="2" face="arial,geneva,helvetica"><b><a name="tags"></a></b></font>
|
|
</dl>
|
|
</blockquote>
|
|
<p align="right"><font face="verdana, arial, geneva, helvetica" size="2"><b><a href="#menu">MENU</a></b></font></p>
|
|
<hr width="100%">
|
|
<P align="center"><font size="3" face="arial, geneva, helvetica" color="#000099"><b>TAGS CALLING THE COUNTERS</b></font></P>
|
|
<P align="center"><b><font face="arial, geneva, helvetica" size="2" color="#CC0000">NOTE: the complete set of counter call tags are generated by LogLook Admin.</font></b></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">INSTALLING COUNTER
|
|
CALLS IN HTML<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">If you can follow
|
|
the above example of a call to LogCount for a link count, then
|
|
the general counting and display calls are even easier. Remember
|
|
the "<B>l</B>" (lowercase "L") refers to
|
|
a </FONT></font><font color="#000099" face="arial,geneva,helvetica" size="2">link</font><font face="arial,geneva,helvetica" size="2"> count.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">To call a <B>HIDDEN COUNTER</B>
|
|
- the most common use for LogCount - you include the letter "<B>t</B>"
|
|
instead of the "<B>l</B>", ie:</font></P>
|
|
<P><font face="courier,courier new" size="2"><img src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>t</B>"
|
|
width="1" height="1"></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">…and there is no
|
|
"=**" value needed. The "<B>t</B>" stands
|
|
for </font><font color="#000099" face="arial,geneva,helvetica" size="2">transparent</font><font face="arial,geneva,helvetica" size="2">, and there is a tiny transparent
|
|
GIF file supplied in the default 'counters' directory. When the
|
|
page is accessed, the server sends the 1X1 pixel image to the
|
|
browser and records a hit. It is best to place the counter call
|
|
near the top of the page to ensure the hit is recorded before
|
|
the visitor goes to another page.</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">The next <B>VISIBLE COUNTER</B>
|
|
option requires as many "img src.." tags as there are
|
|
images to display (numbers). If you want the counter to show
|
|
five numbers including zero padding (if any), then you simply
|
|
repeat the tag five times and change the query character in each
|
|
accordingly ie:</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><img src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>0</B>"
|
|
width="13" height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?1" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?2" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?3" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?4" width="13"
|
|
height="17"></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">The query tag is a number,
|
|
0 to (<B>1 less than</B> the total images), where the total number
|
|
of images equals the length of 'zeros' configured in the 'cntcnfg.set'
|
|
file. If you have less image calls than the zero padding, then
|
|
you will only see the left-most numbers of the count. If you
|
|
have more the script will return an error because it will look
|
|
for a digit that does not exist.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">To VIEW THE COUNT WITHOUT
|
|
RECORDING A HIT</FONT></B><FONT FACE="arial,geneva,helvetica"><BR>
|
|
Repeat the img tags as above, BUT change the query letter on
|
|
the first imag tag to "<B>v</B>" (view) ie:</FONT></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2"><img src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>v</B>"
|
|
width="13" height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?1" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?2" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?3" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?4" width="13"
|
|
height="17"></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">Only the query characters
|
|
"<B>t</B>" and "<B>0</B>"(zero) will record
|
|
a hit. Numbers <B>1</B> to <B>7</B> will simply return the appropriate
|
|
count character image (a number). LogCount will only! handle
|
|
numbers up to 8 characters in length. For most of us this would
|
|
be wishful thinking indeed as that would represent 99999999!!</font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">If you do not understand
|
|
why I have written the tags with the second and subsequent tags
|
|
broken after the "<img " name, this is the method
|
|
used to stop the browser placing one space between objects. You
|
|
could just write all img src tags out in one long line instead
|
|
but the above method produces very readable code.</font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">DISPLAYING THE CLOCK</FONT></B><FONT
|
|
FACE="arial,geneva,helvetica"><BR>
|
|
From version 3 onwards the script can be used to show a static
|
|
digital clock or time display. The time display can also be used
|
|
as the counter adding to the log etc.</FONT></font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">Counting With The Clock</FONT></B><FONT
|
|
FACE="arial,geneva,helvetica"><BR>
|
|
Similar to the normal counter display, the clock is called with
|
|
"img src" calls, but the number of calls is fixed at
|
|
6, and uses two characters as reference. ie:</FONT></font></P>
|
|
<P><font color="#000099" face="arial,geneva,helvetica" size="2">TIME DISPLAY</font><font face="arial,geneva,helvetica" size="2"> (number of tags = 6)<BR>
|
|
<img src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>c0</B>"
|
|
width="13" height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>c1</B>"
|
|
width="13" height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>c2</B>"
|
|
width="13" height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>c3</B>"
|
|
width="13" height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>c4</B>"
|
|
width="13" height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>c5</B>"
|
|
width="13" height="17"></font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">Clock Display Without
|
|
Counting</FONT></B><FONT FACE="arial,geneva,helvetica"><BR>
|
|
To display the clock without adding to the counter or log, use
|
|
the above code BUT simply change the lowercase "<B>c</B>"
|
|
to "<B>n</B>".</FONT></font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">USING OTHER IMAGE SETS<BR>
|
|
</FONT></B><FONT FACE="arial,geneva,helvetica">Correct html coding
|
|
should always include the width and height attributes in img
|
|
src... tags. To use other counter image sets, just change the
|
|
width and height attribute values accordingly. Also make sure
|
|
the names are (or changed to) 0.gif, 1.gif, 2.gif, 3.gif, 4.gif,
|
|
5.gif, 6.gif, 7.gif, 8.gif, 9.gif. DO NOT use .JPGs. NOTE: See
|
|
the ABOUT section at the top of this page regarding the need
|
|
for "<B>-.gif</B>, <B>a.gif</B> and <B>p.gif</B>" if
|
|
you want to use the <B>digital clock</B> with images other than
|
|
those supplied .</FONT></font></P>
|
|
<P><font face="arial,geneva,helvetica" size="2">The .zip file includes
|
|
two extra directories that contain the <B>original default counter
|
|
digit .gif files</B>. Simply copy either of these image sets
|
|
in to the "counters" directory or equivalent. The default
|
|
"counters" directory already includes the white digits
|
|
on black background images.</font></P>
|
|
<P><font size="2" face="arial,geneva,helvetica"><B>Two sample logcnt.cgi counter
|
|
calls are:</B></font></P>
|
|
<P><font color="#000099" face="arial,geneva,helvetica" size="2">SSI TEXT
|
|
COUNTER DISPLAY<BR>
|
|
</font><font face="courier,courier new" size="2"><!--#exec cgi="/cgi-bin/logcnt.cgi"--></font><font face="arial,geneva,helvetica" size="2"> - <I>or similar for your server</I></font></P>
|
|
<P><font color="#000099" face="arial,geneva,helvetica" size="2">HIDDEN
|
|
COUNTER<BR>
|
|
</font><font face="courier,courier new" size="2"><img src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>t</B>"
|
|
width="1" height="1"></font></P>
|
|
<P><font color="#000099" face="arial,geneva,helvetica" size="2">VISIBLE
|
|
COUNTER</font><font face="arial,geneva,helvetica" size="2"> (number of
|
|
tags = number of zero padding digits)<BR>
|
|
<img src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>0</B>"
|
|
width="13" height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?1" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?2" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?3" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?4" width="13"
|
|
height="17"></font></P>
|
|
<P><font color="#000099" face="arial,geneva,helvetica" size="2">NO-HIT
|
|
VISIBLE COUNTER</font><font face="arial,geneva,helvetica" size="2"> (number
|
|
of tags = number of zero padding digits)<BR>
|
|
<img src="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>v</B>"
|
|
width="13" height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?1" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?2" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?3" width="13"
|
|
height="17"><img<BR>
|
|
src="http://yourdomain.name/cgi-bin/logcnt.cgi?4" width="13"
|
|
height="17"></font></P>
|
|
<P><font color="#000099" face="arial,geneva,helvetica" size="2">LINK TRACKING<BR>
|
|
</font><font face="courier,courier new" size="2"><a href="http://yourdomain.name/cgi-bin/logcnt.cgi?<B>l</B>=name"></font><font face="arial,geneva,helvetica" size="2">hyperlink</font><font face="courier,courier new" size="2"></a></font></P>
|
|
<P><font color="#000099" face="arial,geneva,helvetica" size="2">LINK DATA
|
|
FORMAT</font><font face="arial,geneva,helvetica" size="2"> (hitlnk.t)<BR>
|
|
Name<B>|</B>Link<B>|</B>Count (ie "</font><font face="courier,courier new" size="2">widget<B>|</B>http://www.widgetstuff.com/<B>|</B>0</font><font face="arial,geneva,helvetica" size="2">") - <I>also see the supplied
|
|
sample file.</I></font></P>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">A Link to the </FONT><FONT
|
|
COLOR="#990000" FACE="arial,geneva,helvetica">LogLook.cgi</FONT><FONT
|
|
FACE="arial,geneva,helvetica"> log viewer script<BR>
|
|
</FONT></B><FONT FACE="courier,courier new"><a href="http://yourdomain.name/cgi-bin/loglook.cgi?<B>m</B>=password"></FONT></font><font face="arial,geneva,helvetica" size="2">View Log Data</font><font face="courier,courier new" size="2"></a>
|
|
</font><font size="2"><B><FONT FACE="arial,geneva,helvetica">NOTE</FONT></B><FONT
|
|
FACE="arial,geneva,helvetica">: For security, the script can
|
|
only be called from a hyperlink on a page loaded from your server.
|
|
<b>Calling it from a remote server or a browsers command line</b> will
|
|
not work; this is controlled by the security @referers array.</FONT></font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2"><b>SSI COUNT VIEWS - non counting</b></font><br>
|
|
<font face="arial, geneva, helvetica" size="2">Supplied with LogCount and LogLook was a simple SSI program that could be copied and renamed with the name given to a counted hyperlink (ie "<b>widgets</b>.cgi"). As of version 3.5b that one script was replaced by two scripts. "<b>linkname.cgi</b>" works the same as the previous 'somename' in that it displays only the link total for the counted hyperlink it is named after, and now "<b>linkcount.cgi</b>" will display the actual hyperlink tag followed by the count total for the counted hyperlink it is named after.</font>
|
|
<P><font face="arial, geneva, helvetica" size="2">Because they are SSI programs the SSI call has to be placed in the texts of an SSI html page, ie pagename.shtml, pagename.sht. You have to know if your host service allows SSI HTML pages before using these programs. </font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2">So by placing this code calling the <b>linkname.cgi</b> script now copied and renamed barts.cgi (the name barts is the name of a hyperlink created in the LogLook admin pages):<br>
|
|
<font color="#000099"> File downloaded <!--#exec cgi="/cgi-bin/barts.cgi"--> times.</font></font>
|
|
<font face="arial, geneva, helvetica" size="2"><br>
|
|
in your page when it was loaded you would see<br>
|
|
<font color="#CC0033"> File downloaded 2033 times.</font></font>
|
|
<font face="arial, geneva, helvetica" size="2"><br>
|
|
<i>OR</i><br>
|
|
by placing this code calling the <b>linkcount.cgi</b> script now copied and renamed Bonzo-Zip.cgi (the name Bonzo-Zip is the name of a hyperlink created in the LogLook admin pages):<br>
|
|
<font color="#000099">Down Load <!--#exec cgi="/cgi-bin/Bonzo-Zip.cgi"-->.</font></font>
|
|
<font face="arial, geneva, helvetica" size="2"><br>
|
|
in your html code you would see<br>
|
|
<font color="#CC0033">Down Load </font><font color="#0000FF"><u>Bonzo-Zip</u></font></font><font color="#CC0033" face="arial, geneva, helvetica" size="1"> (284)</font><font color="#CC0033" face="arial, geneva, helvetica" size="2">.</font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2">You can of course also use the standard hyperlink counting method:<br>
|
|
<font color="#000099"> <a href="http://yourdomain.name/cgi-bin/logcnt.cgi?<b>l</b>=linkname">Text</a>
|
|
</font><br>
|
|
followed by the "linkname.cgi" renaming method:<br>
|
|
<font color="#000099"> <!--#exec cgi="/cgi-bin/barts.cgi"-->
|
|
</font><br>
|
|
to add the count where and how you want. This way you can place it all in the pages texts if the above "linkcount.cgi" method is difficult to include in a manner that makes sense.</font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2">So I have included the two utility scripts giving you three SSI counted link options PLUS the standard counted link method generated in the LogLook admin page. Either way for displaying the count next to a counted ink, or just the including the count total in the pages text will work as long as the page is an SSI named and enabled page. Notes for renaming these two cgi scripts are also in the script header.</font><a name="lnks"></a> </P>
|
|
<p align="right"><font face="verdana, arial, geneva, helvetica" size="2"><b><a href="#menu">MENU</a></b></font></p>
|
|
<hr width="100%">
|
|
<p align="center"><b><font color="#000099" size="3" face="arial, geneva, helvetica">COUNTING LINKS</font></b></p>
|
|
<p><font size="2"><b><font face="arial,geneva,helvetica">LINK USAGE RECORDS
|
|
and HYPERLINK CALLS<br>
|
|
</font></b><font face="arial,geneva,helvetica">LogCount can be
|
|
used to log the number of times visitors use specific hyperlinks
|
|
on your web pages. Both links from one page to another local
|
|
page, or links to other sites can be included. The call is a
|
|
simple change to the "A HREF tag that you wish to track,
|
|
ie:</font></font></p>
|
|
<p><font face="courier,courier new" size="2"><a href="http://yourdomain.name/cgi-bin/logcnt.cgi?l=3">hyperlink</a></font><font face="arial,geneva,helvetica" size="2"><br>
|
|
<i>or<br>
|
|
</i></font><font face="courier,courier new" size="2"><a href="http://yourdomain.name/cgi-bin/logcnt.cgi?l=jimbo"><img
|
|
src....></a></font><font face="arial,geneva,helvetica" size="2">.</font></p>
|
|
<p><font face="arial,geneva,helvetica" size="2">The question mark denotes
|
|
the start of the query string that follows it. The "<b>l</b>"
|
|
is a lowercase "L", NOT a numeric 1. The "<b>l</b>"
|
|
tells LogCount to handle the query as a hyper(l)ink. After the
|
|
"=" sign is a number in the first example and a word
|
|
in the second example. I have shown this so you can see that
|
|
this is indeed a name, and numbers could be used while words
|
|
could be more descriptive. The name refers to an identical name
|
|
entered in the Link List file, 'hitlnk.t', that you must configure
|
|
if using this option.</font></p>
|
|
<p><font face="arial,geneva,helvetica" size="2">Also in the examples are
|
|
two hyperlinked objects, a simple text link in the first example
|
|
and an image link in the second. If you want your link to open
|
|
another browser window then include the standard 'target="_blank"'
|
|
attribute ie:</font></p>
|
|
<p><font face="courier,courier new" size="2"><a href="http://yourdomain.name/cgi-bin/logcnt.cgi?l=widget"
|
|
target="_blank"></font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2"><b><font color="#FF0000">Note v3.5</font></b> The counted hyperlinks can now be set up via the LogLook admin page, plus the tag for each named link can also be readily generated.</font></p>
|
|
<p><font face="arial,geneva,helvetica" size="2">I have included an example
|
|
'hitlnk.t' file for you to configure and up load to the "counters"
|
|
directory (default). In this file you will identify four example
|
|
links, and they include the special "<b>|</b>" vertical
|
|
line character. The item pattern is as follows: Name<b>|</b>Link<b>|</b>Count,
|
|
ie <br>
|
|
"</font><font face="courier,courier new" size="2">widget<b>|</b>http://www.widgetstuff.com/<b>|</b>0</font><font face="arial,geneva,helvetica" size="2">".<br>
|
|
The third item, the count value must be set initially to zero
|
|
"0". You can configure as many hyperlink click records
|
|
as you wish, but do not apply them to all of your links just
|
|
because you can. This is an excellant way of analysing how many
|
|
visitors leave your site to other sites you link to.</font></p>
|
|
<p><font face="arial,geneva,helvetica" size="2">The second page of LogLook
|
|
will display the count progress of your links. Each listed link
|
|
shown by LogLook includes an embedded hyperlink to logcnt.cgi
|
|
allowing you to occasionally check that the call is working and
|
|
not a broken link.<a name="llk"></a></font></p>
|
|
<p align="right"><font face="verdana, arial, geneva, helvetica" size="2"><b><a href="#menu">MENU</a></b></font></p>
|
|
<hr width="100%">
|
|
<p align="center"><font size="3" color="#000099" face="arial, geneva, helvetica"><b>LOGLOOK - free LOG VIEWER</b></font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2">There is no need to describe in detail the options/views in LogLook as they are self evident once viewed. REMEMBER you MUST access the program ONLY via a password form ON your site - <i>ie</i> the supplied webmasters page.</font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2">Besides the various viewing options, LogLook generates all the necessary tag code for your counters for simple "copy and paste" in to relevant HTML pages (or perhaps a temporary open text file where they can be stored).</font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2">LogLook also manages all the creation, editing, and deleting of counted "named" hyperlinks. The html tag code for these links can also be generated once activated.</font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2"><b>New views added to v3.8</b> are:<br>
|
|
most popular pages<br>
|
|
visitor browser type comparisons<br>
|
|
view any date retained in the current log<br>
|
|
view IP# page totals for any date in the current log</font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2">As your log gets over around 1.4Meg in size (approx. by experinece - some servers will vary) the hit tracking pages may be very slow to load and eventually crash due to server applied "life" time restrictions. Use the admin page to regularly "prune" dates from the log; once viewed, trends noted, days compared, there is realy little need to keep old dates in the log. In the future (partially complete) there will be a history option for those that want to keep a few details but just can't be bothered writing them down!! </font><font face="arial,geneva,helvetica" size="2"><a name="utils"></a></font> </p>
|
|
<p align="right"><font face="verdana, arial, geneva, helvetica" size="2"><b><a href="#menu">MENU</a></b></font></p>
|
|
<hr width="100%">
|
|
<P align="center"><b><font size="3" color="#000099" face="arial, geneva, helvetica">UTILITIES</font></b></P>
|
|
<P><font size="2"><b><font face="arial,geneva,helvetica">THE WEBMASTERS PAGE - <font color="#FF0000">NOTE: you need this or similar to <a href="#refs">access</a> LogLook!</font><br>
|
|
</font></b><font face="arial,geneva,helvetica">The supplied webmasters
|
|
page includes a form for accessing the LogLook log viewer script.
|
|
You must enter
|
|
the correct password in the form on this page to view your
|
|
logs. This page
|
|
also includes a current Non-Counting Count display, so the form
|
|
"action" path and the img src paths need to be altered
|
|
as instructed.</font></font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2"><b>UTILITY testbin.cgi</b><br>
|
|
I have created a simple utility script that can be placed in your cgi-bin and run from your browsers command line. This script will, in almost all cases, detect the Perl version you are using and report its findings. If it reports version 4 as a default, then you must ask your Host Service for the correct path to Perl 5 (Always top and FIRST line in all scripts). LogCount and LogLook are Perl 5 programs for Unix servers.</font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2">Testbin.cgi will attempt to get all perl paths from the server and list them at the bottom of its page. Not all servers will make this information available.</font></P>
|
|
<P><font face="arial, geneva, helvetica" size="2">Testbin.cgi can also be used to test your path to "Sendmail". The program will attempt to get this information from the server but not all will make it available. <b>To test the Sendmail path you MUST</b> change the variable value near the top of the code which is the URL to the testbin program!</font></P>
|
|
<p><font face="arial, geneva, helvetica" size="2"><i><b>So!</b></i><br>
|
|
Place "testbin.cgi" in your cgi-bin directory and chmod 755 (7=r+w+x, 5=r+x).<br>
|
|
Then run from a browser command line, ie http://www.yourdomain.path/cgi-bin/testbin.cgi</font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2"><b>UTILITY makedir.cgi
|
|
</b><br>
|
|
I have created a simple utility script that can be placed in your cgi-bin and run from your browsers command line. If your server allows directory creation via cgi scripts, then this utility will attempt to create the default (recommended) directories and file names for you, and set the permissions. It is unprotected and there is no guarantee that it will work; try it at your own risk (<i>disclaimer only</i>). It has worked well on many sites.
|
|
|
|
</font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2">Try installing and running this script first. It will report success or failure when creating the files/directories and prove the correctness of your Perl Path", plus indicate that the default relative paths will work OK. If the default urls/paths are not used, then you will have to change them first.</font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2">
|
|
|
|
To use it, make sure the "Perl Path" at the top of the script is correct. <font color="#FF0000"><b>NOTE</b></font>: the default Dir/File permissions are set to 766. Change these values to 777 if your site so requires BEFORE running the script. If running the script is successful, you only have to FTP your supplied files over the new empty ones. (note: for security reasons, makedir does NOT prepare an empty file for the cgi scripts, you must upload them (as ascii) and set chmod 755 your self). </font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2">777 for sub directories and 766 for files is probably the most common in a well set-up true cgi-bin directory.
|
|
|
|
</font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2">Once run, delete the file immediately because it has no input protection and could be run again by some low-life wanting to cause mischief
|
|
|
|
</font></p>
|
|
<p><font face="arial, geneva, helvetica" size="2"><b><i>So!</i></b><br>
|
|
Place "makedir.cgi" in your cgi-bin directory and chmod 755 (7=r+w+x, 5=r+x).
|
|
Then run from a browser command line, ie:
|
|
http://www.yourdomain.path/cgi-bin/makedir.cgi
|
|
</font></p>
|
|
<P><font size="2"><B><FONT FACE="arial,geneva,helvetica">Enjoy</FONT></B><FONT
|
|
FACE="arial,geneva,helvetica"> - & please let me know how
|
|
you get on with this script, how/what server type it installed
|
|
to.<BR>
|
|
<I> Ron</I></FONT></font></P>
|
|
<P align="right"><font face="verdana, arial, geneva, helvetica" size="2"><b><a href="#menu">MENU</a></b></font>
|
|
<hr width="100%">
|
|
</TD>
|
|
</TR>
|
|
</TABLE>
|
|
</CENTER>
|
|
</BODY>
|
|
</HTML>
|