################################################################################ # # # "WEBALIZER Xtended" # # # ################################################################################ README Version: RB-15 Date : July 01, 2006 Author : Patrick Frei Copyright (c) 2005-2006 Patrick Frei. All rights reserved. ================================================================================ INDEX 1. INTRODUCTION 1.1. OVERVIEW OF FEATURES 1.2. NEW CONFIGURATION KEYWORDS 1.3. COMMAND LINE PARAMETERS 2. SUPPORT 3. LICENSE ================================================================================ 1. INTRODUCTION ----------------------------------------------- The following sections attempt to provide a short introduction to using Webalizer Xtended. This document is not meant to be a comprehensive manual on understanding or using Webalizer, but should be sufficient to get you running Webalizer with some more features (Webalizer Xtended). For further information see the original README of Webalizer that can be obtained here: ftp://ftp.mrunix.net/pub/webalizer/README For information on building and installing Webalizer Xtended, see the INSTALL file. 1.1. OVERVIEW OF FEATURES ----------------------------------------------- The current release supports the following features: The original features of Webalizer (of course)... + Fully user definable colors for all statistics (e.g. background, text, links, charts) + User definable table and chart borders (3D-effects) + Additional monthly statistics for all "HTTP 404 Not Found"-errors found in your server log-files. Information: Hits, number of requests, percentage requests and URL's of the "HTTP 404 Not Found"-errors. Configurable in the configuration file. + Automatic sorting and incremental or full logfile processing of the "HTTP 404 Not Found"-errors. + Separate HTML page that displays all "HTTP 404 Not Found"-errors. + All HTTP response codes with additional percentage hits. + Grouping enabled for several well known browsers, user-agents and bots. + New configuration keywords to control the new Webalizer Xtended features with the configuration file. + Bug-fix for truncated user agent strings in the "User Agents" statistics of the original Webalizer version 2.01-10 (user agent fields can now be grouped correctly). + Bug-fixes for serveral other truncated string problems (e.g. referrers) in the original Webalizer 2.01-10. + Security bug-fixes for several buffer overflows in the original Webalizer version 2.01-10. 1.2. NEW CONFIGURATION KEYWORDS ----------------------------------------------- The new features in Webalizer Xtended can be controlled with new configuration keywords in your configuration file. These keywords are listed below: ColorBackground Sets the page's background-color to the specified html color (no '#'). ColorText Sets the page's text-color to the specified html color (no '#'). ColorLink Sets the page's link-color to the specified html color (no '#'). ColorVLink Sets the page's visited-link-color to the specified html color (no '#'). ColorALink Sets the page's activated-link-color to the specified html color (no '#'). ColorGrp Sets the table's group-color (see group* keywords) to the specified html color (no '#'). ColorHeadline Sets the table's headline-color to the specified html color (no '#'). ColorCounter Sets the table's counter-color ('Day', 'Hour', '#') to the specified html color (no '#'). ColorHit Sets the table's/graph's 'HITS'-color to the specified html color (no '#'). ColorFile Sets the table's/graph's 'FILES'-color to the specified html color (no '#'). ColorSite Sets the table's/graph's 'SITES'-color to the specified html color (no '#'). ColorKbyte Sets the table's/graph's ''KILOBYTES'-color to the specified html color (no '#'). ColorPage Sets the table's/graph's 'PAGES'-color to the specified html color (no '#'). ColorVisit Sets the table's/graph's 'VISITS'-color to the specified html color (no '#'). ChartBackgroundColor Sets the chart's background-color to the specified html color (no '#'). ChartLegendColor Sets the chart's legend-color to the specified html color (no '#'). ChartShadowColor1 Sets the chart's frist shadow-color (left/top) to the specified html color (no '#'). ChartShadowColor2 Sets the chart's second shadow-color (bottom/right) to the specified html color (no '#'). PieColor1 Sets the pie slice's first additional color to the specified html color (no '#'). PieColor2 Sets the pie slice's second additional color to the specified html color (no '#'). PieColor3 Sets the pie slice's third additional color to the specified html color (no '#'). PieColor4 Sets the pie slice's fourth additional color to the specified html color (no '#'). TableBorder Display the table border with size 'num'. Disable by using zero ('0'), default is 1, maximum is 5. ChartBorder Display the chart border with size 'num'. Disable by using zero ('0'), default is 1, maximum is 5. CodeNotFound CodeNotFound defines the number of entries in the 404 error table. The default value for CodeNotFound is 20. The 404 error table may be disabled by using zero (0) for the value. Using one (1) for the value shows all 404 errors in the table. AllErrors The AllErrors keyword allows the display of all 404-errors on a separate HTML page. A link will be added to the bottom of the "Code 404 Monthly Statistics" table if enabled. Value can be either 'yes' or 'no', with 'yes' being the default. For furhter information about all other configuration keywords of the original Webalizer see the original README of Webalizer that can be obtained here: ftp://ftp.mrunix.net/pub/webalizer/README 1.3. COMMAND LINE PARAMETERS ----------------------------------------------- Webalizer allows certain configuration options to be provided as parameters. The most common way to specify a parameter is via the command line. For further information see the original README of Webalizer that can be obtained here: ftp://ftp.mrunix.net/pub/webalizer/README ================================================================================ 2. SUPPORT For general information and support of Webalizer Xtended, please contact http://www.patrickfrei.ch/webalizer/ ================================================================================ 3. LICENSE Copyright (c) 2005-2006 Patrick Frei. All rights reserved. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. The full GNU General Public License is included in this distribution in the file called LICENSE. Contact Information: Patrick Frei freicaramail.com ================================================================================