ricolog

Warning: Abandoned
This page/script has been classified as abandoned and will no longer be updated. I will keep this page here indefinitely as a reference, but it will no longer be updated and I no longer offer support of any kind regarding content found on this page.

Description

  • ricolog is a CGI script that is able to log page hits and referers for a unlimited number of pages.
  • It also includes an on-the-fly administration that has options for boolean search filtering, updating logs, checking records, and search engine query parsing.

Download

Terms of Use

  • This script was abandon by me in 2002 and is listed as public domain. I do however reserve full rights to the name.

Instructions

Quick Setup

  • By default, none of the settings should need changing. The default settings will work on 80% of hosts so likely all you will need to do is upload and CHMOD the files. However, the settings are there so you can change them if needed

Open counter.cgi and set the variables

  • Set the Path to perl. On most systems it's #!/usr/bin/perl but varies by host
  • Set the path to your log files. currently set at "referer.txt" and "counter.txt" but you can be set to any file
  • Set the blocked referers. for each domain or url that you don't want the referers to be logged, stick them in the @block. It's handy to set your own site URL as blocked, otherwise it'll log each page they visit on your site as a referer. (since technically it is)
  • Set the display type (note: how hits are displayed will not effect the logs)
    • set to 0 : Nothing is displayed on the page. The counter is hidden.
    • set to 1 : Shows the number of hits to only that page.
    • set to 2 : Adds the hits for all the logged pages then displays total.
  • Set the use FLOCK. If you are running on Windows machine set to 0. Otherwise it is probably safe to leave set to 1.

Open admin.cgi and set the variables

  • Set the Path to perl. (same as above)
  • Set the path to your settings file. currently set at "settings.cgi" but you can be set to anything (for security reasons, highly recommended you leave with .cgi extension)
  • If you keep getting "bad referer" error, set the 'script_name' otherwise leave as is
  • Set the use FLOCK. (same as above)

Settings in Administration

  • Load the admin.cgi up in your browser. It should forward you to the settings for first time setup.
  • Set the password for administration (if later you forget your password, you can change it via FTP by editing the settings file directly)
  • Set the username for administration
  • Set the path to your log files. currently set at "referer.txt" and "counter.txt" but you can be set to any file
  • You can set the maximum number of URL characters that are displayed. Otherwise if you get a 255 character referer, you have to scroll several screens to the right to see the counts.
  • If Parse search engine referers is checked the script will try to parse out the search engine referers to show search terms instead of the long URL. (Example:
    http://www.google.com/search?q=drop+down+html+source
    becomes:
    http://www.google.com drop down html source
  • Quickview settings are the custom filter that is used each time you use the "Quick Counter" or "Quick Referer" buttons at top. (see move under filtering below)
  • You can also set your own custom headers and footers for the pages generated.

Uploading Files

  • Upload all the files in ASCII mode (the cgi files MUST be uploaded in ASCII, and for the others it's preferable)
  • CHMOD admin.cgi and counter.cgi to 755. both log (txt) and the setting.cgi file to 766.

Call the timer from your HTML (or SHTML) page

  • To call <!--#include virtual="cgi-bin/counter.cgi"-->
    (if that's where you put the script)
  • To enter the administration part, simply type in the administration script's full URL into your browser

Filtering displayed results

  • Booleans: URL word filter now accepts boolean expressions including and, or, not. For instance: google and yahoo not msn (if you need more help, any good search engine has information about boolean searches)
  • Specific range is the minimum and maximum range of hits to show. To show all, you would put 0 to -1 hits. Or to show all results that have more than 100 hits you would go 100 to -1 hits.

What's New in version 6?

  • Complete on-the-fly filters
  • Boolean text filtering
  • all new logging method in counter.cgi
  • clean logs option added
  • on-the-fly update for settings like password, username, lognames, etc.
  • better error checking to prevent corrupt data in the logs
  • much better security
  • faster counting in counter.cgi
  • Internal revisions that make the scripts run & load much faster than previous versions
  • (6.3.2) (2002-12-24 released) - minor spelling and layout errors fixed. this may be my last CGI version released. I'm working on a PHP & MySQL version
  • (6.3.1) (2002-05-03 released) - faster parsing of search engine referers using RegExp
  • (6.3.1) - the ability to see how many pages/hits are hidden
  • (6.3) (2002-05-27 released) - separate filters for counters and referers. before was using same filter as both