<li><a href="#PurgeLogFile">PurgeLogFile</a>
<li><a href="#ArchiveLogRecords">ArchiveLogRecords</a>
<li><a href="#KeepBackupOfHistoricFiles">KeepBackupOfHistoricFiles</a>
-<li><a href="#Lang">Lang</a>
-<li><a href="#DirLang">DirLang</a>
<li><a href="#DefaultFile">DefaultFile</a>
<li><a href="#SkipHosts">SkipHosts</a>
<li><a href="#SkipDNSLookupFor">SkipDNSLookupFor</a>
<li><a href="#URLWithQuery">URLWithQuery</a>
<li><a href="#WarningMessages">WarningMessages</a>
<li><a href="#NbOfLinesForCorruptedLog">NbOfLinesForCorruptedLog</a>
-<li><a href="#FirstDayOfWeek">FirstDayOfWeek</a>
-<li><a href="#MaxNbOfDomain">MaxNbOfDomain</a>
-<li><a href="#MaxNbOfHostsShown">MaxNbOfHostsShown</a>
-<li><a href="#MinHitHost">MinHitHost</a>
-<li><a href="#MaxNbOfLoginShown">MaxNbOfLoginShown</a>
-<li><a href="#MinHitLogin">MinHitLogin</a>
-<li><a href="#MaxNbOfRobotShown">MaxNbOfRobotShown</a>
-<li><a href="#MinHitRobot">MinHitRobot</a>
-<li><a href="#MaxNbOfPageShown">MaxNbOfPageShown</a>
-<li><a href="#MinHitFile">MinHitFile</a>
-<li><a href="#MaxNbOfRefererShown">MaxNbOfRefererShown</a>
-<li><a href="#MinHitRefer">MinHitRefer</a>
-<li><a href="#MaxNbOfKeywordsShown">MaxNbOfKeywordsShown</a>
-<li><a href="#MinHitKeyword">MinHitKeyword</a>
<li><a href="#SplitSearchString">SplitSearchString</a>
<li><a href="#Expires">Expires</a>
-<li><a href="#ShowHeader">ShowHeader</a>
-<li><a href="#ShowMenu">ShowMenu</a>
-<li><a href="#ShowMonthDayStats">ShowMonthDayStats</a>
-<li><a href="#ShowDaysOfWeekStats">ShowDaysOfWeekStats</a>
-<li><a href="#ShowHoursStats">ShowHoursStats</a>
-<li><a href="#ShowDomainsStats">ShowDomainsStats</a>
-<li><a href="#ShowHostsStats">ShowHostsStats</a>
-<li><a href="#ShowAuthenticatedUsers">ShowAuthenticatedUsers</a>
-<li><a href="#ShowRobotsStats">ShowRobotsStats</a>
-<li><a href="#ShowPagesStats">ShowPagesStats</a>
-<li><a href="#ShowCompressionStats">ShowCompressionStats</a>
-<li><a href="#ShowFileTypesStats">ShowFileTypesStats</a>
-<li><a href="#ShowFileSizesStats">ShowFileSizesStats</a>
-<li><a href="#ShowBrowsersStats">ShowBrowsersStats</a>
-<li><a href="#ShowOSStats">ShowOSStats</a>
-<li><a href="#ShowOriginStats">ShowOriginStats</a>
-<li><a href="#ShowKeyphrasesStats">ShowKeyphrasesStats</a>
-<li><a href="#ShowKeywordsStats">ShowKeywordsStats</a>
-<li><a href="#ShowHTTPErrorsStats">ShowHTTPErrorsStats</a>
+</ul>
+
+<br><b>OPTIONAL ACCURACY SETUP SECTION (Not required but increase AWStats features)</b><br>
+<ul>
+<li><a href="#LevelFor">LevelForRobotsDetection</a>
+<li><a href="#LevelFor">LevelForBrowsersDetection</a>
+<li><a href="#LevelFor">LevelForOSDetection</a>
+<li><a href="#LevelFor">LevelForRefererAnalyze</a>
+</ul>
+
+<br><b>OPTIONAL APPEARANCE SETUP SECTION (Not required but increase AWStats features)</b><br>
+<ul>
+<li><a href="#Lang">Lang</a>
+<li><a href="#DirLang">DirLang</a>
+<li><a href="#Show">ShowHeader</a>
+<li><a href="#Show">ShowMenu</a>
+<li><a href="#Show">ShowMonthDayStats</a>
+<li><a href="#Show">ShowDaysOfWeekStats</a>
+<li><a href="#Show">ShowHoursStats</a>
+<li><a href="#Show">ShowDomainsStats</a>
+<li><a href="#Show">ShowHostsStats</a>
+<li><a href="#Show">ShowAuthenticatedUsers</a>
+<li><a href="#Show">ShowRobotsStats</a>
+<li><a href="#Show">ShowPagesStats</a>
+<li><a href="#Show">ShowCompressionStats</a>
+<li><a href="#Show">ShowFileTypesStats</a>
+<li><a href="#Show">ShowFileSizesStats</a>
+<li><a href="#Show">ShowBrowsersStats</a>
+<li><a href="#Show">ShowOSStats</a>
+<li><a href="#Show">ShowOriginStats</a>
+<li><a href="#Show">ShowKeyphrasesStats</a>
+<li><a href="#Show">ShowKeywordsStats</a>
+<li><a href="#Show">ShowHTTPErrorsStats</a>
+<li><a href="#Max">MaxNbOfDomain</a>
+<li><a href="#Max">MaxNbOfHostsShown</a>
+<li><a href="#Max">MinHitHost</a>
+<li><a href="#Max">MaxNbOfLoginShown</a>
+<li><a href="#Max">MinHitLogin</a>
+<li><a href="#Max">MaxNbOfRobotShown</a>
+<li><a href="#Max">MinHitRobot</a>
+<li><a href="#Max">MaxNbOfPageShown</a>
+<li><a href="#Max">MinHitFile</a>
+<li><a href="#Max">MaxNbOfRefererShown</a>
+<li><a href="#Max">MinHitRefer</a>
+<li><a href="#Max">MaxNbOfKeywordsShown</a>
+<li><a href="#Max">MinHitKeyword</a>
+<li><a href="#FirstDayOfWeek">FirstDayOfWeek</a>
+<li><a href="#DetailedReportsOnNewWindows">DetailedReportsOnNewWindows</a>
<li><a href="#ShowFlagLinks">ShowFlagLinks</a>
<li><a href="#ShowLinksOnUrl">ShowLinksOnUrl</a>
<li><a href="#MaxLengthOfURL">MaxLengthOfURL</a>
-<li><a href="#DetailedReportsOnNewWindows">DetailedReportsOnNewWindows</a>
<li><a href="#HTMLHeadSection">HTMLHeadSection</a>
<li><a href="#HTMLEndSection">HTMLEndSection</a>
-<li><a href="#BarWidth">BarWidth</a>
-<li><a href="#BarHeight">BarHeight</a>
+<li><a href="#Bar">BarWidth</a>
+<li><a href="#Bar">BarHeight</a>
<li><a href="#Logo">Logo</a>
<li><a href="#Logo">LogoLink</a>
<li><a href="#StyleSheet">StyleSheet</a>
<br># %HH-n is replaced with hour we were n hours ago
<br># %WM-n is replaced with the week number in month (1-5)
<br># You can use 0 for n if you need current year, month, day, hour...
-<br># Example: "/var/log/access_log.%YYYY-24%MM-24%DD-24.log"
-<br># Example: "C:/WINNT/system32/LogFiles/W3SVC1/ex%YY-0%MM-0%DD-0.log"
+<br># Example: "/var/log/access_log.%YYYY-0%MM-0%DD-0.log"
+<br># Example: "C:/WINNT/system32/LogFiles/W3SVC1/ex%YY-24%MM-24%DD-24.log"
<br>#
<br>LogFile="/var/log/httpd/mylog.log"
<br># server name used to reach the web site.
<br># This parameter is only used to generate full URLs links when ShowLinksOnUrl
<br># option is set to 1.
-<br># Note: \. means .
-<br># Example: "www\.mysite\.com"
-<br># Example: "user\.mydomain\.com"
+<br># Example: "www.mysite.com"
+<br># Example: "user.mydomain.com"
<br># Example: "myintranetserver"
<br># Default: ""
<br>#
<br># This parameter is used to analyze referer field in log file and to help
<br># AWStats to know if a referer URL is a local URL of same site or an URL of
<br># another site.
-<br># Note: \. means .
-<br># Example: "www\.myserver\.com x\.y\.z\.w localhost 127\.0\.0\.1"
+<br># Example: "www.myserver.com x.y.z.w localhost 127.0.0.1"
<br>#
-<br>HostAliases="www\.myserver\.com x\.y\.z\.w localhost 127\.0\.0\.1"
+<br>HostAliases="www.myserver.com x.y.z.w localhost 127.0.0.1"
<br><br><hr>
<br><br><hr>
<a name="CreateDirDataIfNotExists"><b>CreateDirDataIfNotExists</b></a><br>
+<b>Version : </b>4.0 +<br>
<br># If the "DirData" directory (see above) does not exists, AWStats return an
<br># error. However, you can ask AWStats to create it. This option can be used by
<br># some Web Hosting Providers that has defined a dynamic value for DirData (for
<br><br><hr>
<a name="SaveDatabaseFilesWithPermissionsForEveryone"><b>SaveDatabaseFilesWithPermissionsForEveryone</b></a><br>
+<b>Version : </b>4.0 +<br>
<br># In most case, AWStats is used as a cgi program. So AWStats process is runned
<br># by default web server user (nobody for Unix, IUSR_xxx for IIS/Windows,...).
<br># To avoid permission problems between update process often runned by an admin
<br><br><hr>
<a name="KeepBackupOfHistoricFiles"><b>KeepBackupOfHistoricFiles</b></a><br>
+<b>Version : </b>3.2 +<br>
<br># Each time you run the update process, AWStats overwrite the 'historic file'
<br># for the month (awstatsMMYYYY[.*].txt) with the updated one.
<br># When write errors occurs (IO, disk full,...), this historic file can be
<br><br><hr>
-<a name="Lang"><b>Lang</b></a><br>
-<br># Set your primary language.
-<br># Possible value:
-<br># Bosnian=ba, Chinese (Taiwan)=tw, Chinese (Traditional)=cn, Czech=cz,
-<br># Danish=dk, Dutch=nl, English=en, French=fr, German=de, Greek=gr,
-<br># Hungarian=hu, Indonesian=id, Italian=it, Japanese=jp, Korean=kr,
-<br># Norwegian (Nynorsk)=nn, Norwegian (Bokmal)=nb, Polish=pl, Portuguese=pt,
-<br># Portuguese (Brazilian)=br, Romanian=ro, Russian=ru, Spanish=es, Swedish=se,
-<br># Turkish=tr, Ukrainian=ua
-<br># Default: en
-<br>#
-<br>Lang="en"
-
-<br><br><hr>
-
-<a name="DirLang"><b>DirLang</b></a><br>
-<br># Set the location of language files.
-<br># Example: "/opt/awstats/lang"
-<br># Default: "./lang" (means lang directory is in same location than awstats.pl)
-<br>#
-<br>DirLang="./lang"
-
-<br><br><hr>
-
<a name="DefaultFile"><b>DefaultFile</b></a><br>
<br># Index page name for your web server.
<br># Example: "default.htm"
<br><br><hr>
+<a name="SkipHosts"><b>SkipHosts</b></a><br>
<br># Do not include access from clients that match following criterias.
<br># If your log file contains IP adresses in host field, you must put here
<br># matching IP adresses criterias.
<br># If DNS lookup is already done in your log file, you must put here hostname
<br># criterias.
<br># Note: Use space between each value.
-<br># Note: \. means .
-<br># Example: "127\.0\.0\.1 163\.84\. 201\.101\.51\.1"
+<br># Example: "127.0.0.1 163.84. 201.101.51.1"
<br># Example: "localhost abcxyz"
<br># Default: ""
<br>#
<br><br><hr>
+<a name="SkipDNSLookupFor"><b>SkipDNSLookupFor</b></a><br>
<br># You can specify specific IP addresses that should NOT be looked up in
<br># the DNS. You may specify partial addresses (ie 163.85. for everything
<br># behind the usual firewall setup, etc)...
<br># This is only useful if DNSLookup=1.
<br># Note: Use space between each value and put a backslash before each dot.
-<br># Example: "163\.85\. 201\.101\.51\.2"
+<br># Example: "163.85. 201.101.51.2"
<br># Default: ""
<br>#
<br>SkipDNSLookupFor=""
<br><br><hr>
+<a name="SkipFiles"><b>SkipFiles</b></a><br>
<br># Use SkipFiles to ignore access to URLs that match one of following entries.
<br># You can, with this option, add a list of not important frame pages (like
<br># menus, etc...) to exclude them from statistics.
<br># to ignore "users" homepage in your stats, you can add "/~".
<br># The oposite parameter of "SkipFiles" is "OnlyFiles".
<br># Note: This parameter is not case sensitive.
-<br># Note: Use space between each value and do not remove default values
-<br># Note: \. means . and xxx$ means URL ending by xxx.
-<br># Example: "\.css$ \.js$ \.class$ robots\.txt$ badpage\.html /~"
-<br># Default: "\.css$ \.js$ \.class$ robots\.txt$"
+<br># Note: Use space between each value and do not remove default values.
+<br># Note: xxx$ means URL ending with xxx.
+<br># Example: "robots.txt$ favicon.ico$ badpage.html /~"
+<br># Default: "robots.txt$ favicon.ico$"
<br>#
-<br>SkipFiles="\.css$ \.js$ \.class$ robots\.txt$"
+<br>SkipFiles="robots.txt$ favicon.ico$"
<br><br><hr>
+<a name="OnlyFiles"><b>OnlyFiles</b></a><br>
<br># Include in stats, only accesses to URLs that match one of following entries.
<br># For example, if you want AWStats to filter access to keep only stats that
<br># match a particular string, like a particular directory, you can add this
<br><br><hr>
+<a name="NotPageList"><b>NotPageList</b></a><br>
<br># Add here a list of kind of url (file extension) that must be counted as
<br># "Hit only" and not as a "Hit" and "Page viewed". You can set here all images
<br># extensions as they are hit downloaded that must be counted but they are not
<br># Note: If you want to exclude your own URLs from stats (No Pages and no Hits
<br># reported), you should use SkipFiles parameter instead.
<br># Example: ""
-<br># Example: "gif jpg jpeg png bmp zip arj gz z wav mp3 wma"
-<br># Default: "gif jpg jpeg png bmp"
+<br># Example: "css js class gif jpg jpeg png bmp zip arj gz z wav mp3 wma mpg"
+<br># Default: "css js class gif jpg jpeg png bmp"
<br>#
-<br>NotPageList="gif jpg jpeg png bmp"
+<br>NotPageList="css js class gif jpg jpeg png bmp"
<br><br><hr>
<br><br><hr>
+<a name="NbOfLinesForCorruptedLog"><b>NbOfLinesForCorruptedLog</b></a><br>
<br># To help you to detect if your log format is good, AWStats report an error
<br># if the first NbOfLinesForCorruptedLog lines have all a format that does not
<br># match the LogFormat parameter.
<br><br><hr>
-<br># Choose if you want week to start on sunday or monday
-<br># Possible values:
-<br># 0 - Week start on sunday
-<br># 1 - Week start on monday
-<br># Default: 1
-<br>#
-<br>FirstDayOfWeek=1
-
-<br><br><hr>
-
-<br># This value can be used to choose maximum number of lines shown for each
-<br># particular reporting.
-<br>#
-<br># Stats by domains
-<br>MaxNbOfDomain = 25
-<br># Stats by hosts
-<br>MaxNbOfHostsShown = 25
-<br>MinHitHost = 1
-<br># Stats by authenticated users
-<br>MaxNbOfLoginShown = 10
-<br>MinHitLogin = 1
-<br># Stats by robots
-<br>MaxNbOfRobotShown = 25
-<br>MinHitRobot = 1
-<br># Stats by pages
-<br>MaxNbOfPageShown = 25
-<br>MinHitFile = 1
-<br># Stats by referers
-<br>MaxNbOfRefererShown = 25
-<br>MinHitRefer = 1
-<br># Stats for keywords
-<br>MaxNbOfKeywordsShown = 25
-<br>MinHitKeyword = 1
-
-<br><br><hr>
-
+<a name="SplitSearchString"><b>SplitSearchString</b></a><br>
<br># Search engines keywords reported are full search string or separate keywords
<br># Possible values:
<br># 0 - Search keywords reported are full search string (ie: "town maps")
<br><br><hr>
+<a name="Expires"><b>Expires</b></a><br>
+<b>Version : </b>3.1 +<br>
<br># You can add in the HTML report page a delay to force browsers to reload page
<br># if page is loaded a second time after this delay (in seconds).
<br># Example: 3600
<br><br><hr>
+<a name="LevelFor"><b>LevelFor</b></a><br>
+<b>Version : </b>4.0 +<br>
+<br># You can change value for following option to increase AWStats capabilities
+<br># (but this reduce AWStats speed).
+<br># Possible values: 0, 1 or 2
+<br># Default: 1
+<br>#
+<br>LevelForRobotsDetection=1 # 0 will increase AWStats speed by 1%.
+<br>LevelForBrowsersDetection=1 # 0 disables Browsers detection. No speed gain.
+<br>LevelForOSDetection=1 # 0 disables OS detection. No speed gain.
+<br>LevelForRefererAnalyze=1 # 0 will increase AWStats speed by 6%.
+
+<br><br><hr>
+
+<a name="Lang"><b>Lang</b></a><br>
+<br># Set your primary language.
+<br># Possible value:
+<br># Bosnian=ba, Chinese (Taiwan)=tw, Chinese (Traditional)=cn, Czech=cz,
+<br># Danish=dk, Dutch=nl, English=en, French=fr, German=de, Greek=gr,
+<br># Hungarian=hu, Indonesian=id, Italian=it, Japanese=jp, Korean=kr,
+<br># Norwegian (Nynorsk)=nn, Norwegian (Bokmal)=nb, Polish=pl, Portuguese=pt,
+<br># Portuguese (Brazilian)=br, Romanian=ro, Russian=ru, Spanish=es, Swedish=se,
+<br># Turkish=tr, Ukrainian=ua
+<br># Default: en
+<br>#
+<br>Lang="en"
+
+<br><br><hr>
+
+<a name="DirLang"><b>DirLang</b></a><br>
+<br># Set the location of language files.
+<br># Example: "/opt/awstats/lang"
+<br># Default: "./lang" (means lang directory is in same location than awstats.pl)
+<br>#
+<br>DirLang="./lang"
+
+<br><br><hr>
+
+<a name="Show"><b>Show...</b></a><br>
<br># You choose here which summary report you want to see in the main page.
<br># Whatever is your setup here, all detailed reports are still available.
<br># So if you setup to 1 only ShowHeader, ShowMenu and ShowMonthDayStats, all
<br><br><hr>
+<a name="Max"><b>Max...</b></a><br>
+<br># This value can be used to choose maximum number of lines shown for each
+<br># particular reporting.
+<br>#
+<br># Stats by domains
+<br>MaxNbOfDomain = 25
+<br># Stats by hosts
+<br>MaxNbOfHostsShown = 25
+<br>MinHitHost = 1
+<br># Stats by authenticated users
+<br>MaxNbOfLoginShown = 10
+<br>MinHitLogin = 1
+<br># Stats by robots
+<br>MaxNbOfRobotShown = 25
+<br>MinHitRobot = 1
+<br># Stats by pages
+<br>MaxNbOfPageShown = 25
+<br>MinHitFile = 1
+<br># Stats by referers
+<br>MaxNbOfRefererShown = 25
+<br>MinHitRefer = 1
+<br># Stats for keywords
+<br>MaxNbOfKeywordsShown = 25
+<br>MinHitKeyword = 1
+
+<br><br><hr>
+
+<a name="FirstDayOfWeek"><b>FirstDayOfWeek</b></a><br>
+<br># Choose if you want week to start on sunday or monday
+<br># Possible values:
+<br># 0 - Week start on sunday
+<br># 1 - Week start on monday
+<br># Default: 1
+<br>#
+<br>FirstDayOfWeek=1
+
+<br><br><hr>
+
+<a name="DetailedReportsOnNewWindows"><b>DetailedReportsOnNewWindows</b></a><br>
+<br># This parameter ask your browser to open detailed reports into a different
+<br># window than the main page.
+<br># Possible values: 1 or 0
+<br># Default: 1
+<br>#
+<br>DetailedReportsOnNewWindows=1
+
+<br><br><hr>
+
+<a name="ShowFlagLinks"><b>ShowFlagLinks</b></a><br>
<br># List of visible flags with link to other language translations.
<br># If you don't want any flag link, set ShowFlagLinks to "".
<br># This parameter is used only if ShowHeader is set to 1.
<br><br><hr>
+<a name="ShowLinksOnUrl"><b>ShowLinksOnUrl</b></a><br>
<br># Each URL shown in stats report views are links you can click.
<br># Possible values: 1 or 0
<br># Default: 1
<br><br><hr>
+<a name="MaxLengthOfURL"><b>MaxLengthOfURL</b></a><br>
<br># Maximum length of URL shown on stats page (number of characters). This
<br># affects only URL visible text, link still work.
<br># Default: 72
<br><br><hr>
-<br># This parameter ask your browser to open detailed reports into a different
-<br># window than the main page.
-<br># Possible values: 1 or 0
-<br># Default: 1
-<br>#
-<br>DetailedReportsOnNewWindows=1
-
-<br><br><hr>
-
+<a name="HTMLHeadSection"><b>HTMLHeadSection</b></a><br>
<br># You can put here HTML code that will be added at the top of AWStats reports.
<br># Default: ""
<br>#
<br><br><hr>
+<a name="HTMLEndSection"><b>HTMLEndSection</b></a><br>
<br># You can put here HTML code that will be added at the end of AWStats reports.
<br># Great to add advert ban.
<br># Default: ""
<br><br><hr>
+<a name="Bar"><b>Bar...</b></a><br>
<br># Value of maximum bar width/heigth for horizontal/vertical graphics bar
<br># Default: 260/180
<br>#
projects / thirdparty / AWStats.git / commitdiff
