Setting up WebLog 3THE PERL SCRIPTS ARE NO LONGER BEEING SUPPORTED - PLEASE GO TO TETRABB.COM FOR THE NEWEST VERSION OF THE WEBBBS FORUM
$NoSessions: If set to “1″ this variable will instruct WebLog *not* to
include visitor counts on the monthly, daily and day-of-week lists.
It will also disable creation of the details report.
$NoResolve: By default, WebLog will attempt to resolve any IP numbers
in the log file to domain names. This can take a while, especially
with larger log files. If you don’t want the script to bother — if,
for example, you don’t care whether visitors came from “.com”, “.net”
or “.jp” sites, or if your log file already contains resolved domain
names wherever possible, anyway — just set this variable to “1″.
$HourOffset: If you are in one time zone and your Web host is in
another, you can use this variable to adjust the times shown in
the various reports. For example, if your server is located in the
Eastern time zone, but you’re in the Pacific time zone, set it to
$DetailsFilter: A regex defining files to exclude from the details
report. (It’s also used to determine what qualifies as a “page view”
in the main report.) The default value of “(\.gif|\.jpg|\.jpeg)” will
filter out most image files, making it easier to follow which actual
pages were viewed, and allowing a (theoretically) more accurate
tracking of the time spent on each page.
$DetailsDays: The number of “days” past to include in the details
report. (This, of course, is only relevant if you’re actually printing
the details report.) The number cannot be greater than 36. Note that
this only refers to literal days if you are in fact running the script
once per day (as most users would). Technically, this actually tells
the script the number of previous runs from which to still show info
on the report. So if you only generate a report once per week, and
this variable is set to 7, you’ll actually end up with 7 *weeks*
of details data in your report. Of course, keeping that much info in
the report is not a good idea, and is likely to cause “out of memory”
errors when you try to run the script.
$DetailsSummaryDays: You can keep the “summary” data from the details
report longer, if you like, than you keep the actual detailed traffic
breakdown. The $DetailsDays variable, above, defines how many “days”
worth of detailed data you want in the report; this variable defines
the total number of “days” for which you want at least summary data.
For example, you might set $DetailsDays to 2, and $DetailsSummaryDays
to 30; that would give you a detailed look at the paths taken through
your site by visitors in the past two days, and general info about the
number of visitors and how long they spent on your site, for the
entire past month.
$refsexcludefrom and $refsexcludeto: If you want references to or from
certain files ignored in the referring URLs report, define them here.
You might want to exclude any references from within the same domain,
for example, so that you can more easily see what *outside* locations
are sending visitors to your site.
$RefsStripWWW: Setting this variable to “1″ will instruct the script to
remove the “www” prefix from URLs. If you don’t strip those, the same
URL could end up appearing twice in your referring URL list, both as
“www.foo.com” and as “foo.com”; if you *do* strip the prefix, though,
while the lists will be a bit easier to read and interpret, you’ll end
up with some URLs which you can’t actually follow unless you manually
put the “www” back. (On some systems, for whatever reason, it’s
$RefsFilterLists: This variable determines whether or not *all*
referring URLs and/or keywords will be listed in the reports. If it’s
set to 1, the reports will automatically “filter out” less significant
URLs and keywords. This will of course keep the size of the reports
down. If you have a very busy site, and just want to know where
*most* people are coming from, filter your reports. On the other
hand, if you have a fairly quiet site, or if you’re interested in
tracking all accesses, set this variable to 0.
$TopNRefDoms: This variable tells WebLog how many domains, if any, to
include in the “top referers” list. (This is just a list of the
domains — not the specific pages — from which the majority of your
visitors seem to be coming.)
$TopNKeywords: This variable defines the number of entries you want
included in your “top keywords” listing. (As with the top referring
domains list above, defining the variable as “0″ will disable the
creation of the list.)
$AgentsIgnore: If you wish to ignore references to particular files in
your agents/platforms report, list them here. Eliminating references
to graphic images, for example, will prevent your report from
indicating an overly-high percentage of graphical browsers, since
only hits to actual pages will be included.
$Verbose: Setting this variable to “1″ will instruct the script to
provide you with “status” comments as it runs. Setting it to “0″
will disable the comments. Any error messages, of course, will still
$bodyspec: This variable defines any traits to be assigned to reports’
$headerfile and $footerfile: These variables define the locations of
text files containing HTML code and text to appear at the top and
bottom, respectively, of the reports.
This documentation assumes that you have at least a general familiarity
with setting up Perl scripts. If you need more specific assistance,
check with your system administrators, consult the WebScripts FAQs
(frequently-asked questions) files <http://awsd.com/scripts/faqs.shtml>,
or post your question on the WebScripts General Support Forum