1 rizwank 1.1 # AWSTATS CONFIGURE FILE 6.3
2 #-----------------------------------------------------------------------------
3 # Copy this file into awstats.www.mydomain.conf and edit this new config file
4 # to setup AWStats (See documentation in docs/ directory).
5 # The config file must be in /etc/awstats, /usr/local/etc/awstats or /etc (for
6 # Unix/Linux) or same directory than awstats.pl (Windows, Mac, Unix/Linux...)
7 # To include an environment variable in any parameter (AWStats will replace
8 # it with its value when reading it), follow the example:
9 # Parameter="__ENVNAME__"
10 # Note that environment variable AWSTATS_CURRENT_CONFIG is always defined with
11 # the config value in an AWStats running session and can be used like others.
12 #-----------------------------------------------------------------------------
13 # $Revision: 1.305 $ - $Author: eldy $ - $Date: 2005/01/22 15:26:06 $
14
15
16
17 #-----------------------------------------------------------------------------
18 # MAIN SETUP SECTION (Required to make AWStats work)
19 #-----------------------------------------------------------------------------
20
21 # "LogFile" contains the web, ftp or mail server log file to analyze.
22 rizwank 1.1 # Possible values: A full path, or a relative path from awstats.pl directory.
23 # Example: "/var/log/apache/access.log"
24 # Example: "../logs/mycombinedlog.log"
25 # You can also use tags in this filename if you need a dynamic file name
26 # depending on date or time (Replacement is made by AWStats at the beginning
27 # of its execution). This is available tags :
28 # %YYYY-n is replaced with 4 digits year we were n hours ago
29 # %YY-n is replaced with 2 digits year we were n hours ago
30 # %MM-n is replaced with 2 digits month we were n hours ago
31 # %MO-n is replaced with 3 letters month we were n hours ago
32 # %DD-n is replaced with day we were n hours ago
33 # %HH-n is replaced with hour we were n hours ago
34 # %NS-n is replaced with number of seconds at 00:00 since 1970
35 # %WM-n is replaced with the week number in month (1-5)
36 # %Wm-n is replaced with the week number in month (0-4)
37 # %WY-n is replaced with the week number in year (01-52)
38 # %Wy-n is replaced with the week number in year (00-51)
39 # %DW-n is replaced with the day number in week (1-7, 1=sunday)
40 # use n=24 if you need (1-7, 1=monday)
41 # %Dw-n is replaced with the day number in week (0-6, 0=sunday)
42 # use n=24 if you need (0-6, 0=monday)
43 rizwank 1.1 # Use 0 for n if you need current year, month, day, hour...
44 # Example: "/var/log/access_log.%YYYY-0%MM-0%DD-0.log"
45 # Example: "C:/WINNT/system32/LogFiles/W3SVC1/ex%YY-24%MM-24%DD-24.log"
46 # You can also use a pipe if log file come from a pipe :
47 # Example: "gzip -d </var/log/apache/access.log.gz |"
48 # If there is several log files from load balancing servers :
49 # Example: "/pathtotools/logresolvemerge.pl *.log |"
50 #
51 #LogFile="/home/rizwank/logs/enigmata.org/http/access.log"
52 LogFile="../../tools/logresolvemerge.pl /home/rizwank/log/enigmata.org/http/access.log /home/rizwank/log/enigmata.org/http/access.log.0 |"
53 #LogFile="../../tools/logresolvemerge.pl /home/rizwank/log/enigmata.org/http/access.log* |"
54
55 # Enter the log file type you want to analyze.
56 # Possible values:
57 # W - For a web log file
58 # S - For a streaming log file
59 # M - For a mail log file
60 # F - For a ftp log file
61 # Example: W
62 # Default: W
63 #
64 rizwank 1.1 LogType=W
65
66
67 # Enter here your log format (Must match your web server config. See setup
68 # instructions in documentation to know how to configure your web server to
69 # have the required log format).
70 # Possible values: 1,2,3,4 or "your_own_personalized_log_format"
71 # 1 - Apache or Lotus Notes/Domino native combined log format (NCSA combined/XLF/ELF log format)
72 # 2 - Old IIS log format (IIS W3C log format). See FAQ for IIS 6.x.
73 # 3 - Webstar native log format.
74 # 4 - Apache or Squid native common log format (NCSA common/CLF log format)
75 # With LogFormat=4, some features (browsers, os, keywords...) can't work.
76 # "your_own_personalized_log_format" = If your log is ftp, mail or other format,
77 # you must use following keys to define the log format string (See FAQ
78 # for ftp, mail or exotic web log format examples):
79 # %host Host client name or IP address
80 # %lognamequot Authenticated login/user with format: "john"
81 # %logname Authenticated login/user with format: john
82 # %time1 Date and time with format: [dd/mon/yyyy:hh:mm:ss +0000] or [dd/mon/yyyy:hh:mm:ss]
83 # %time2 Date and time with format: yyyy-mm-dd hh:mm:ss
84 # %time3 Date and time with format: Mon dd hh:mm:ss or Mon dd hh:mm:ss yyyy
85 rizwank 1.1 # %time4 Date and time with unix timestamp format: dddddddddd
86 # %methodurl Method and URL with format: "GET /index.html HTTP/x.x"
87 # %methodurlnoprot Method and URL with format: "GET /index.html"
88 # %method Method with format: GET
89 # %url URL only with format: /index.html
90 # %query Query string (used by URLWithQuery option)
91 # %code Return code status (with format for web log: 999)
92 # %bytesd Size of document in bytes
93 # %refererquot Referer page with format: "http://from.com/from.htm"
94 # %referer Referer page with format: http://from.com/from.htm
95 # %uaquot User agent with format: "Mozilla/4.0 (compatible, ...)"
96 # %ua User agent with format: Mozilla/4.0_(compatible...)
97 # %gzipin mod_gzip compression input bytes: In:XXX
98 # %gzipout mod_gzip compression output bytes & ratio: Out:YYY:ZZpct.
99 # %gzipratio mod_gzip compression ratio: ZZpct.
100 # %deflateratio mod_deflate compression ratio with format: (ZZ)
101 # %email EMail sender (for mail log)
102 # %email_r EMail receiver (for mail log)
103 # %virtualname Web sever virtual hostname. Use this tag when same log
104 # contains data of several virtual web servers. AWStats
105 # will discard records not in SiteDomain nor HostAliases
106 rizwank 1.1 # %cluster If log file is provided from several computers (merged by
107 # logresolvemerge.pl), use this to define cluster id field.
108 # %extraX Another field that you plan to use for building a
109 # personalized report with ExtraSection feature (See later).
110 # If your log format has some fields not included in this list, use:
111 # %other Means another not used field
112 # %otherquot Means another not used double quoted field
113 #
114 # Examples for Apache combined logs (following two examples are equivalent):
115 # LogFormat = 1
116 # LogFormat = "%host %other %logname %time1 %methodurl %code %bytesd %refererquot %uaquot"
117 #
118 LogFormat=1
119
120
121 # If your log field's separator is not a space, you can change this parameter.
122 # This parameter is not used if LogFormat is a predefined value (1,2,3,4)
123 # Backslash can be used as escape character.
124 # Example: " "
125 # Example: "\t"
126 # Example: "\|"
127 rizwank 1.1 # Default: " "
128 #
129 LogSeparator=" "
130
131
132 # "SiteDomain" must contain the main domain name, or the main intranet web
133 # server name, used to reach the web site.
134 # If you share the same log file for several virtual web servers, this
135 # parameter is used to tell AWStats to filter record that contains records for
136 # this virtual host name only (So check that this virtual hostname can be
137 # found in your log file and use a personalized log format that include the
138 # %virtualname tag).
139 # But for multi hosting a better solution is to have one log file for each
140 # virtual web server. In this case, this parameter is only used to generate
141 # full URL's links when ShowLinksOnUrl option is set to 1.
142 # If analysing mail log, enter here the domain name of mail server.
143 # Example: "myintranetserver"
144 # Example: "www.domain.com"
145 # Example: "ftp.domain.com"
146 # Example: "domain.com"
147 #
148 rizwank 1.1 SiteDomain="enigmata.org"
149
150
151 # Enter here all other possible domain names, addresses or virtual host
152 # aliases someone can use to access your site. Try to keep only the minimum
153 # number of possible names/addresses to have the best performances.
154 # You can repeat the "SiteDomain" value in this list.
155 # This parameter is used to analyze referer field in log file and to help
156 # AWStats to know if a referer URL is a local URL of same site or an URL of
157 # another site.
158 # Note: Use space between each value.
159 # Note: You can use regular expression values writing value with REGEX[value].
160 # Note: You can also use @/mypath/myfile if list of aliases are in a file.
161 # Example: "www.myserver.com localhost 127.0.0.1 REGEX[mydomain\.(net|org)$]"
162 #
163 HostAliases="www.enigmata.org localhost 127.0.0.1 REGEX[enigmata\.org$]"
164
165 # If you want to have hosts reported by name instead of ip address, AWStats
166 # need to make reverse DNS lookups (if not already done in your log file).
167 # With DNSLookup to 0, all hosts will be reported by their IP addresses and
168 # not by the full hostname of visitors (except if names are already available
169 rizwank 1.1 # in log file).
170 # If you want/need to set DNSLookup to 1, don't forget that this will reduce
171 # dramatically AWStats update process speed. Do not use on large web sites.
172 # Note: Reverse DNS lookup is done on IPv4 only (Enable ipv6 plugin for IPv6).
173 # Note: Result of DNS Lookup can be used to build the Country report. However
174 # it is highly recommanded to enable the plugin 'geoipfree' or 'geoip' to
175 # have an accurate Country report with no need of DNS Lookup.
176 # Possible values:
177 # 0 - No DNS Lookup
178 # 1 - DNS Lookup is fully enabled
179 # 2 - DNS Lookup is made only from static DNS cache file (if it exists)
180 # Default: 2
181 #
182 DNSLookup=1
183
184
185 # When AWStats updates its statistics, it stores results of its analysis in
186 # files (AWStats database). All those files are written in the directory
187 # defined by the "DirData" parameter. Set this value to the directory where
188 # you want AWStats to save its database and working files into.
189 # Warning: If you want to be able to use the "AllowToUpdateStatsFromBrowser"
190 rizwank 1.1 # feature (see later), you need "Write" permissions by web server user on this
191 # directory (and "Modify" for Windows NTFS file systems).
192 # Example: "/var/lib/awstats"
193 # Example: "../data"
194 # Example: "C:/awstats_data_dir"
195 # Default: "." (means same directory as awstats.pl)
196 #
197 DirData="./data"
198
199
200 # Relative or absolute web URL of your awstats cgi-bin directory.
201 # This parameter is used only when AWStats is run from command line
202 # with -output option (to generate links in HTML reported page).
203 # Example: "/awstats"
204 # Default: "/cgi-bin" (means awstats.pl is in "/yourwwwroot/cgi-bin")
205 #
206 DirCgi="/home/rizwank/geekymedia.com/awstats-6.3/wwwroot/cgi-bin"
207
208
209 # Relative or absolute web URL of your awstats icon directory.
210 # If you build static reports ("... -output > outputpath/output.html"), enter
211 rizwank 1.1 # path of icon directory relative to the output directory 'outputpath'.
212 # Example: "/awstatsicons"
213 # Example: "../icon"
214 # Default: "/icon" (means you must copy icon directories in "/mywwwroot/icon")
215 #
216 DirIcons="/awstats-6.3/wwwroot/icon"
217
218
219 # When this parameter is set to 1, AWStats add a button on report page to
220 # allow to "update" statistics from a web browser. Warning, when "update" is
221 # made from a browser, AWStats is ran as a CGI by the web server user defined
222 # in your web server (user "nobody" by default with Apache, "IUSR_XXX" with
223 # IIS), so the "DirData" directory and all already existing history files
224 # awstatsMMYYYY[.xxx].txt must be writable by this user. Change permissions if
225 # necessary to "Read/Write" (and "Modify" for Windows NTFS file systems).
226 # Warning: Update process can be long so you might experience "time out"
227 # browser errors if you don't launch AWStats enough frequently.
228 # When set to 0, update is only made when AWStats is ran from the command
229 # line interface (or a task scheduler).
230 # Possible values: 0 or 1
231 # Default: 0
232 rizwank 1.1 #
233 AllowToUpdateStatsFromBrowser=0
234
235
236 # AWStats save and sort its database on a month basis, this allows to build
237 # build a report quickly. However, if you choose the -month=all from command
238 # line or value '-Year-' from CGI combo form to have a report for all year,
239 # AWStats needs to reload all data for full year, and resort them completely,
240 # requiring a large amount of time, memory and CPU. This might be a problem
241 # for web hosting providers that offer AWStats for large sites, on shared
242 # servers, to non CPU cautious customers.
243 # For this reason, the 'full year' is only enabled on Command Line by default.
244 # You can change this by setting this parameter to 0, 1, 2 or 3.
245 # Possible values:
246 # 0 - Never allowed
247 # 1 - Allowed on CLI only, -Year- value in combo is not visible
248 # 2 - Allowed on CLI only, -Year- value in combo is visible but not allowed
249 # 3 - Possible on CLI and CGI
250 # Default: 2
251 #
252 AllowFullYearView=2
253 rizwank 1.1
254
255
256 #-----------------------------------------------------------------------------
257 # OPTIONAL SETUP SECTION (Not required but increase AWStats features)
258 #-----------------------------------------------------------------------------
259
260 # When the update process run, AWStats can set a lock file in TEMP or TMP
261 # directory. This lock is to avoid to have 2 update processes running at the
262 # same time to prevent unknown conflicts problems and avoid DoS attacks when
263 # AllowToUpdateStatsFromBrowser is set to 1.
264 # Because, when you use lock file, you can experience sometimes problems in
265 # lock file not correctly removed (killed process for example requires that
266 # you remove the file manualy), this option is not enabled by default (Do
267 # not enable this option with no console server access).
268 # Change : Effective immediatly
269 # Possible values: 0 or 1
270 # Default: 0
271 #
272 EnableLockForUpdate=0
273
274 rizwank 1.1
275 # AWStats can do reverse DNS lookups through a static DNS cache file that was
276 # previously created manually. If no path is given in static DNS cache file
277 # name, AWStats will search DirData directory. This file is never changed.
278 # This option is not used if DNSLookup=0.
279 # Note: DNS cache file format is 'minsince1970 ipaddress resolved_hostname'
280 # or just 'ipaddress resolved_hostname'
281 # Change : Effective for new updates only
282 # Example: "/mydnscachedir/dnscache"
283 # Default: "dnscache.txt"
284 #
285 DNSStaticCacheFile="dnscache.txt"
286
287
288 # AWStats can do reverse DNS lookups through a DNS cache file that was created
289 # by a previous run of AWStats. This file is erased and recreated after each
290 # statistics update process. You don't need to create and/or edit it.
291 # AWStats will read and save this file in DirData directory.
292 # This option is used only if DNSLookup=1.
293 # Note: If a DNSStaticCacheFile is available, AWStats will check for DNS
294 # lookup in DNSLastUpdateCacheFile after checking into DNSStaticCacheFile.
295 rizwank 1.1 # Change : Effective for new updates only
296 # Example: "/mydnscachedir/dnscachelastupdate"
297 # Default: "dnscachelastupdate.txt"
298 #
299 DNSLastUpdateCacheFile="dnscachelastupdate.txt"
300
301
302 # You can specify specific IP addresses that should NOT be looked up in DNS.
303 # This option is used only if DNSLookup=1.
304 # Note: Use space between each value.
305 # Note: You can use regular expression values writing value with REGEX[value].
306 # Change : Effective for new updates only
307 # Example: "123.123.123.123 REGEX[^192\.168\.]"
308 # Default: ""
309 #
310 SkipDNSLookupFor=""
311
312
313 # The following two parameters allow you to protect a config file from being
314 # read by AWStats when called from a browser if web user has not been
315 # authenticated. Your AWStats program must be in a web protected "realm" (With
316 rizwank 1.1 # Apache, you can use .htaccess files to do so. With other web servers, see
317 # your server setup manual).
318 # Change : Effective immediatly
319 # Possible values: 0 or 1
320 # Default: 0
321 #
322 AllowAccessFromWebToAuthenticatedUsersOnly=0
323
324
325 # This parameter give the list of all authorized authenticated users to view
326 # statistics for this domain/config file. This parameter is used only if
327 # AllowAccessFromWebToAuthenticatedUsersOnly is set to 1.
328 # Change : Effective immediatly
329 # Example: "user1 user2"
330 # Example: "__REMOTE_USER__"
331 # Default: ""
332 #
333 AllowAccessFromWebToFollowingAuthenticatedUsers=""
334
335
336 # When this parameter is define to something, the IP address of the user that
337 rizwank 1.1 # read its statistics from a browser (when AWStats is used as a CGI) is
338 # checked and must match one of the IP address values or ranges.
339 # Change : Effective immediatly
340 # Example: "127.0.0.1 123.123.123.1-123.123.123.255"
341 # Default: ""
342 #
343 AllowAccessFromWebToFollowingIPAddresses=""
344
345
346 # If the "DirData" directory (see above) does not exists, AWStats return an
347 # error. However, you can ask AWStats to create it.
348 # This option can be used by some Web Hosting Providers that has defined a
349 # dynamic value for DirData (for example DirData="/home/__REMOTE_USER__") and
350 # don't want to have to create a new directory each time they add a new user.
351 # Change : Effective immediatly
352 # Possible values: 0 or 1
353 # Default: 0
354 #
355 CreateDirDataIfNotExists=0
356
357
358 rizwank 1.1 # You can choose in which format the Awstats history database is saved.
359 # Note: Using "xml" format make AWStats building database files three times
360 # larger than using "text" format.
361 # Change : Database format is switched after next update
362 # Possible values: text or xml
363 # Default: text
364 #
365 BuildHistoryFormat=text
366
367
368 # If you prefer having the report output pages be built as XML compliant pages
369 # instead of simple HTML pages, you can set this to 'xhtml' (May not works
370 # properly with old browsers).
371 # Change : Effective immediatly
372 # Possible values: html or xhtml
373 # Default: html
374 #
375 BuildReportFormat=html
376
377
378 # AWStats databases can be updated from command line of from a browser (when
379 rizwank 1.1 # used as a cgi program). So AWStats database files need write permission
380 # for both command line user and default web server user (nobody for Unix,
381 # IUSR_xxx for IIS/Windows,...).
382 # To avoid permission's problems between update process (run by an admin user)
383 # and CGI process (ran by a low level user), AWStats can save its database
384 # files with read and write permissions for everyone.
385 # By default, AWStats keep default user permissions on updated files. If you
386 # set AllowToUpdateStatsFromBrowser to 1, you can change this parameter to 1.
387 # Change : Effective for new updates only
388 # Possible values: 0 or 1
389 # Default: 0
390 #
391 SaveDatabaseFilesWithPermissionsForEveryone=0
392
393
394 # AWStats can purge log file, after analyzing it. Note that AWStats is able
395 # to detect new lines in a log file, to process only them, so you can launch
396 # AWStats as often as you want, even with this parameter to 0.
397 # With 0, no purge is made, so you must use a scheduled task or a web server
398 # that make this purge frequently.
399 # With 1, the purge of the log file is made each time AWStats update is ran.
400 rizwank 1.1 # This parameter doesn't work with IIS (This web server doesn't let its log
401 # file to be purged).
402 # Change : Effective for new updates only
403 # Possible values: 0 or 1
404 # Default: 0
405 #
406 PurgeLogFile=0
407
408
409 # When PurgeLogFile is setup to 1, AWStats will clean your log file after
410 # processing it. You can however keep an archive file (saved in "DirData") of
411 # all processed log records by setting this to 1 (For example if you want to
412 # use another log analyzer).
413 # This parameter is not used if PurgeLogFile=0
414 # Change : Effective for new updates only
415 # Possible values: 0 or 1
416 # Default: 0
417 #
418 ArchiveLogRecords=0
419
420
421 rizwank 1.1 # Each time you run the update process, AWStats overwrite the 'historic file'
422 # for the month (awstatsMMYYYY[.*].txt) with the updated one.
423 # When write errors occurs (IO, disk full,...), this historic file can be
424 # corrupted and must be deleted. Because this file contains information of all
425 # past processed log files, you will loose old stats if removed. So you can
426 # ask AWStats to save last non corrupted file in a .bak file. This file is
427 # stored in "DirData" directory with other 'historic files'.
428 # Change : Effective for new updates only
429 # Possible values: 0 or 1
430 # Default: 0
431 #
432 KeepBackupOfHistoricFiles=0
433
434
435 # Default index page name for your web server.
436 # Change : Effective for new updates only
437 # Example: "index.php index.html default.html"
438 # Default: "index.html"
439 #
440 DefaultFile="index.html"
441
442 rizwank 1.1
443 # Do not include access from clients that match following criteria.
444 # If your log file contains IP adresses in host field, you must enter here
445 # matching IP adresses criteria.
446 # If DNS lookup is already done in your log file, you must enter here hostname
447 # criteria, else enter ip address criteria.
448 # The opposite parameter of "SkipHosts" is "OnlyHosts".
449 # Note: Use space between each value. This parameter is not case sensitive.
450 # Note: You can use regular expression values writing value with REGEX[value].
451 # Change : Effective for new updates only
452 # Example: "127.0.0.1 REGEX[^192\.168\.] REGEX[^10\.]"
453 # Example: "localhost REGEX[^.*\.localdomain$]"
454 # Default: ""
455 #
456 SkipHosts=""
457
458
459 # Do not include access from clients with a user agent that match following
460 # criteria. If you want to exclude a robot, you should update the robots.pm
461 # file instead of this parameter.
462 # The opposite parameter of "SkipUserAgents" is "OnlyUserAgents".
463 rizwank 1.1 # Note: Use space between each value. This parameter is not case sensitive.
464 # Note: You can use regular expression values writing value with REGEX[value].
465 # Change : Effective for new updates only
466 # Example: "konqueror REGEX[ua_test_v\d\.\d]"
467 # Default: ""
468 #
469 SkipUserAgents=""
470
471
472 # Use SkipFiles to ignore access to URLs that match one of following entries.
473 # You can enter a list of not important URLs (like framed menus, hidden pages,
474 # etc...) to exclude them from statistics. You must enter here exact relative
475 # URL as found in log file, or a matching REGEX value.
476 # For example, to ignore /badpage.html, just add "/badpage.html". To ignore
477 # all pages in a particular directory, add "REGEX[^\/directorytoexclude]".
478 # The opposite parameter of "SkipFiles" is "OnlyFiles".
479 # Note: Use space between each value. This parameter is or not case sensitive
480 # depending on URLNotCaseSensitive parameter.
481 # Note: You can use regular expression values writing value with REGEX[value].
482 # Change : Effective for new updates only
483 # Example: "/badpage.html REGEX[^\/excludedirectory]"
484 rizwank 1.1 # Default: ""
485 #
486 SkipFiles=""
487
488
489 # Include in stats, only accesses from hosts that match one of following
490 # entries. For example, if you want AWStats to filter access to keep only
491 # stats for visits from particular hosts, you can add those hosts names in
492 # this parameter.
493 # If DNS lookup is already done in your log file, you must enter here hostname
494 # criteria, else enter ip address criteria.
495 # The opposite parameter of "OnlyHosts" is "SkipHosts".
496 # Note: Use space between each value. This parameter is not case sensitive.
497 # Note: You can use regular expression values writing value with REGEX[value].
498 # Change : Effective for new updates only
499 # Example: "127.0.0.1 REGEX[^192\.168\.] REGEX[^10\.]"
500 # Default: ""
501 #
502 OnlyHosts=""
503
504
505 rizwank 1.1 # Include in stats, only accesses from user agent that match one of following
506 # entries. For example, if you want AWStats to filter access to keep only
507 # stats for visits from particular browsers, you can add their user agents
508 # string in this parameter.
509 # The opposite parameter of "OnlyUserAgents" is "SkipUserAgents".
510 # Note: Use space between each value. This parameter is not case sensitive.
511 # Note: You can use regular expression values writing value with REGEX[value].
512 # Change : Effective for new updates only
513 # Example: "msie"
514 # Default: ""
515 #
516 OnlyUserAgents=""
517
518
519 # Include in stats, only accesses to URLs that match one of following entries.
520 # For example, if you want AWStats to filter access to keep only stats that
521 # match a particular string, like a particular directory, you can add this
522 # directory name in this parameter.
523 # The opposite parameter of "OnlyFiles" is "SkipFiles".
524 # Note: Use space between each value. This parameter is or not case sensitive
525 # depending on URLNotCaseSensitive parameter.
526 rizwank 1.1 # Note: You can use regular expression values writing value with REGEX[value].
527 # Change : Effective for new updates only
528 # Example: "REGEX[marketing_directory] REGEX[office\/.*\.(csv|sxw)$]"
529 # Default: ""
530 #
531 OnlyFiles=""
532
533
534 # Add here a list of kind of url (file extension) that must be counted as
535 # "Hit only" and not as a "Hit" and "Page/Download". You can set here all
536 # images extensions as they are hit downloaded that must be counted but they
537 # are not viewed pages. URLs with such extensions are not included in the TOP
538 # Pages/URL report.
539 # Note: If you want to exclude particular URLs from stats (No Pages and no
540 # Hits reported), you must use SkipFiles parameter.
541 # Change : Effective for new updates only
542 # Example: "css js class gif jpg jpeg png bmp ico zip arj gz z wav mp3 wma mpg"
543 # Example: ""
544 # Default: "css js class gif jpg jpeg png bmp ico"
545 #
546 NotPageList="css js class gif jpg jpeg png bmp ico swf"
547 rizwank 1.1
548
549 # By default, AWStats considers that records found in web log file are
550 # successful hits if HTTP code returned by server is a valid HTTP code (200
551 # and 304). Any other code are reported in HTTP status chart.
552 # Note that HTTP 'control codes', like redirection (302, 305) are not added by
553 # default in this list as they are not pages seen by a visitor but are
554 # protocol exchange codes to tell the browser to ask another page. Because
555 # this other page will be counted and seen with a 200 or 304 code, if you
556 # add such codes, you will have 2 pages viewed reported for only one in facts.
557 # Change : Effective for new updates only
558 # Example: "200 304 302 305"
559 # Default: "200 304"
560 #
561 ValidHTTPCodes="200 304"
562
563
564 # By default, AWStats considers that records found in mail log file are
565 # successful mail transfers if field that represent return code in analyzed
566 # log file match values defined by this parameter.
567 # Change : Effective for new updates only
568 rizwank 1.1 # Example: "1 250 200"
569 # Default: "1 250"
570 #
571 ValidSMTPCodes="1 250"
572
573
574 # Some web servers on some Operating systems (IIS-Windows) considers that a
575 # login with same value but different case are the same login. To tell AWStats
576 # to also considers them as one, set this parameter to 1.
577 # Change : Effective for new updates only
578 # Possible values: 0 or 1
579 # Default: 0
580 #
581 AuthenticatedUsersNotCaseSensitive=0
582
583
584 # Some web servers on some Operating systems (IIS-Windows) considers that two
585 # URLs with same value but different case are the same URL. To tell AWStats to
586 # also considers them as one, set this parameter to 1.
587 # Change : Effective for new updates only
588 # Possible values: 0 or 1
589 rizwank 1.1 # Default: 0
590 #
591 URLNotCaseSensitive=0
592
593
594 # Keep or remove the anchor string you can find in some URLs.
595 # Change : Effective for new updates only
596 # Possible values: 0 or 1
597 # Default: 0
598 #
599 URLWithAnchor=0
600
601
602 # In URL links, "?" char is used to add parameter's list in URLs. Syntax is:
603 # /mypage.html?param1=value1¶m2=value2
604 # However, some servers/sites use also others chars to isolate dynamic part of
605 # their URLs. You can complete this list with all such characters.
606 # Change : Effective for new updates only
607 # Example: "?;,"
608 # Default: "?;"
609 #
610 rizwank 1.1 URLQuerySeparators="?;"
611
612
613 # Keep or remove the query string to the URL in the statistics for individual
614 # pages. This is primarily used to differentiate between the URLs of dynamic
615 # pages. If set to 1, mypage.html?id=x and mypage.html?id=y are counted as two
616 # different pages.
617 # Warning, when set to 1, memory required to run AWStats is dramatically
618 # increased if you have a lot of changing URLs (for example URLs with a random
619 # id inside). Such web sites should not set this option to 1 or use seriously
620 # the next parameter URLWithQueryWithOnlyFollowingParameters (or eventually
621 # URLWithQueryWithoutFollowingParameters).
622 # Change : Effective for new updates only
623 # Possible values:
624 # 0 - URLs are cleaned from the query string (ie: "/mypage.html")
625 # 1 - Full URL with query string is used (ie: "/mypage.html?p=x&q=y")
626 # Default: 0
627 #
628 URLWithQuery=0
629
630
631 rizwank 1.1 # When URLWithQuery is on, you will get the full URL with all parameters in
632 # URL reports. But among thoose parameters, sometimes you don't need a
633 # particular parameter because it does not identify the page or because it's
634 # a random ID changing for each access even if URL points to same page. In
635 # such cases, it is higly recommanded to ask AWStats to keep only parameters
636 # you need (if you know them) before counting, manipulating and storing URL.
637 # Enter here list of wanted parameters. For example, with "param", one hit on
638 # /mypage.cgi?param=abc&id=Yo4UomP9d and /mypage.cgi?param=abc&id=Mu8fdxl3r
639 # will be reported as 2 hits on /mypage.cgi?param=abc
640 # This parameter is not used when URLWithQuery is 0 and can't be used with
641 # URLWithQueryWithoutFollowingParameters.
642 # Change : Effective for new updates only
643 # Example: "param"
644 # Default: ""
645 #
646 URLWithQueryWithOnlyFollowingParameters=""
647
648
649 # When URLWithQuery is on, you will get the full URL with all parameters in
650 # URL reports. But among thoose parameters, sometimes you don't need a
651 # particular parameter because it does not identify the page or because it's
652 rizwank 1.1 # a random ID changing for each access even if URL points to same page. In
653 # such cases, it is higly recommanded to ask AWStats to remove such parameters
654 # from the URL before counting, manipulating and storing URL. Enter here list
655 # of all non wanted parameters. For example if you enter "id", one hit on
656 # /mypage.cgi?param=abc&id=Yo4UomP9d and /mypage.cgi?param=abc&id=Mu8fdxl3r
657 # will be reported as 2 hits on /mypage.cgi?param=abc
658 # This parameter is not used when URLWithQuery is 0 and can't be used with
659 # URLWithQueryWithOnlyFollowingParameters.
660 # Change : Effective for new updates only
661 # Example: "PHPSESSID jsessionid"
662 # Default: ""
663 #
664 URLWithQueryWithoutFollowingParameters=""
665
666
667 # Keep or remove the query string to the referrer URL in the statistics for
668 # external referrer pages. This is used to differentiate between the URLs of
669 # dynamic referrer pages. If set to 1, mypage.html?id=x and mypage.html?id=y
670 # are counted as two different referrer pages.
671 # Change : Effective for new updates only
672 # Possible values:
673 rizwank 1.1 # 0 - Referrer URLs are cleaned from the query string (ie: "/mypage.html")
674 # 1 - Full URL with query string is used (ie: "/mypage.html?p=x&q=y")
675 # Default: 0
676 #
677 URLReferrerWithQuery=0
678
679
680 # AWStats can detect setup problems or show you important informations to have
681 # a better use. Keep this to 1, except if AWStats says you can change it.
682 # Change : Effective immediatly
683 # Possible values: 0 or 1
684 # Default: 1
685 #
686 WarningMessages=1
687
688
689 # When an error occurs, AWStats output a message related to errors. If you
690 # want (in most cases for security reasons) to have no error messages, you
691 # can set this parameter to your personalized generic message.
692 # Change : Effective immediatly
693 # Example: "An error occured. Contact your Administrator"
694 rizwank 1.1 # Default: ""
695 #
696 ErrorMessages=""
697
698
699 # AWStat can be run with debug=x parameter to ouput various informations
700 # to help in debugging or solving troubles. If you want (in most cases for
701 # security reasons) to disable debugging, set this parameter to 0.
702 # Change : Effective immediatly
703 # Possible values: 0 or 1
704 # Default: 1
705 #
706 DebugMessages=1
707
708
709 # To help you to detect if your log format is good, AWStats report an error
710 # if all the first NbOfLinesForCorruptedLog lines have a format that does not
711 # match the LogFormat parameter.
712 # However, some worm virus attack on your web server can result in a very high
713 # number of corrupted lines in your log. So if you experience awstats stop
714 # because of bad virus records at the beginning of your log file, you can
715 rizwank 1.1 # increase this parameter (very rare).
716 # Change : Effective for new updates only
717 # Default: 50
718 #
719 NbOfLinesForCorruptedLog=50
720
721
722 # For some particular integration needs, you may want to have CGI links to
723 # point to another script than awstats.pl.
724 # Use the name of this script in WrapperScript parameter.
725 # Change : Effective immediatly
726 # Example: "awstatslauncher.pl"
727 # Default: ""
728 #
729 WrapperScript=""
730
731
732 # DecodeUA must be set to 1 if you use Roxen web server. This server converts
733 # all spaces in user agent field into %20. This make the AWStats robots, os
734 # and browsers detection fail in some cases. Just change it to 1 if and only
735 # if your web server is Roxen.
736 rizwank 1.1 # Change : Effective for new updates only
737 # Possible values: 0 or 1
738 # Default: 0
739 #
740 DecodeUA=0
741
742
743 # MiscTrackerUrl can be used to make AWStats able to detect some miscellanous
744 # things, that can not be tracked on other way, like:
745 # - Javascript disabled
746 # - Java enabled
747 # - Screen size
748 # - Color depth
749 # - Macromedia Director plugin
750 # - Macromedia Shockwave plugin
751 # - Realplayer G2 plugin
752 # - QuickTime plugin
753 # - Mediaplayer plugin
754 # - Acrobat PDF plugin
755 # To enable all this features, you must copy the awstats_misc_tracker.js file
756 # into a /js/ directory stored in your web document root and add the following
757 rizwank 1.1 # HTML code at the end of your index page (but before </BODY>) :
758 #
759 # <script language=javascript src="/js/awstats_misc_tracker.js"></script>
760 # <noscript><img src="/js/awstats_misc_tracker.js?nojs=y" height=0 width=0 border=0 style="display: none"></noscript>
761 #
762 # If code is not added in index page, all those detection capabilities will be
763 # disabled. You must also check that ShowScreenSizeStats and ShowMiscStats
764 # parameters are set to 1 to make results appear in AWStats report page.
765 # If you want to use another directory than /js/, you must also change the
766 # awstatsmisctrackerurl variable into the awstats_misc_tracker.js file.
767 # Change : Effective for new updates only.
768 # Possible value: URL of javascript tracker file added in your HTML code.
769 # Default: "/js/awstats_misc_tracker.js"
770 #
771 MiscTrackerUrl="/js/awstats_misc_tracker.js"
772
773
774
775 #-----------------------------------------------------------------------------
776 # OPTIONAL ACCURACY SETUP SECTION (Not required but increase AWStats features)
777 #-----------------------------------------------------------------------------
778 rizwank 1.1
779 # Following values allows you to define accuracy of AWStats entities (robots,
780 # browsers, os, referers, file types) detection.
781 # It might be a good idea for large web sites or ISP that provides AWStats to
782 # high number of customers, to set this parameter to 1 (or 0), instead of 2.
783 # Possible values:
784 # 0 = No detection,
785 # 1 = Medium/Standard detection
786 # 2 = Full detection
787 # Change : Effective for new updates only
788 # Default: 2 (0 for LevelForWormsDetection)
789 #
790 LevelForBrowsersDetection=2 # 0 disables Browsers detection.
791 # 2 reduces AWStats speed by 2%
792 LevelForOSDetection=2 # 0 disables OS detection.
793 # 2 reduces AWStats speed by 3%
794 LevelForRefererAnalyze=2 # 0 disables Origin detection.
795 # 2 reduces AWStats speed by 14%
796 LevelForRobotsDetection=2 # 0 disables Robots detection.
797 # 2 reduces AWStats speed by 2.5%
798 LevelForSearchEnginesDetection=2 # 0 disables Search engines detection.
799 rizwank 1.1 # 2 reduces AWStats speed by 9%
800 LevelForKeywordsDetection=2 # 0 disables Keyphrases/Keywords detection.
801 # 2 reduces AWStats speed by 1%
802 LevelForFileTypesDetection=2 # 0 disables File types detection.
803 # 2 reduces AWStats speed by 1%
804 LevelForWormsDetection=2 # 0 disables Worms detection.
805 # 2 reduces AWStats speed by 15%
806
807
808
809 #-----------------------------------------------------------------------------
810 # OPTIONAL APPEARANCE SETUP SECTION (Not required but increase AWStats features)
811 #-----------------------------------------------------------------------------
812
813 # When you use AWStats as a CGI, you can have the reports shown in HTML frames.
814 # Frames are only available for report viewed dynamically. When you build
815 # pages from command line, this option is not used and no frames are built.
816 # Possible values: 0 or 1
817 # Default: 1
818 #
819 UseFramesWhenCGI=1
820 rizwank 1.1
821
822 # This parameter ask your browser to open detailed reports into a different
823 # window than the main page.
824 # Possible values:
825 # 0 - Open all in same browser window
826 # 1 - Open detailed reports in another window except if using frames
827 # 2 - Open always in a different window even if reports are framed
828 # Default: 1
829 #
830 DetailedReportsOnNewWindows=1
831
832
833 # You can add, in the HTML report page, a cache lifetime (in seconds) that
834 # will be returned to browser in HTTP header answer by server.
835 # This parameter is not used when report are built with -staticlinks option.
836 # Example: 3600
837 # Default: 0
838 #
839 Expires=0
840
841 rizwank 1.1
842 # To avoid too large web pages, you can ask AWStats to limit number of rows of
843 # all reported charts to this number when no other limit apply.
844 # Default: 1000
845 #
846 MaxRowsInHTMLOutput=1000
847
848
849 # Set your primary language (ISO-639-1 language codes).
850 # Possible value:
851 # Albanian=al, Bosnian=ba, Bulgarian=bg, Catalan=ca,
852 # Chinese (Taiwan)=tw, Chinese (Simpliefied)=cn, Czech=cz, Danish=dk,
853 # Dutch=nl, English=en, Estonian=et, Euskara=eu, Finnish=fi,
854 # French=fr, Galician=gl, German=de, Greek=gr, Hebrew=he, Hungarian=hu,
855 # Icelandic=is, Indonesian=id, Italian=it, Japanese=jp, Korean=kr,
856 # Latvian=lv, Norwegian (Nynorsk)=nn, Norwegian (Bokmal)=nb, Polish=pl,
857 # Portuguese=pt, Portuguese (Brazilian)=br, Romanian=ro, Russian=ru,
858 # Serbian=sr, Slovak=sk, Slovenian=si, Spanish=es, Swedish=se, Turkish=tr,
859 # Ukrainian=ua, Welsh=cy.
860 # First available language accepted by browser=auto
861 # Default: "auto"
862 rizwank 1.1 #
863 Lang="auto"
864
865
866 # Set the location of language files.
867 # Example: "/usr/share/awstats/lang"
868 # Default: "./lang" (means lang directory is in same location than awstats.pl)
869 #
870 DirLang="./lang"
871
872
873 # Show menu header with reports' links
874 # Possible values: 0 or 1
875 # Default: 1
876 #
877 ShowMenu=1
878
879
880 # You choose here which reports you want to see in the main page and what you
881 # want to see in those reports.
882 # Possible values:
883 rizwank 1.1 # 0 - Report is not shown at all
884 # 1 - Report is shown in main page with an entry in menu and default columns
885 # XYZ - Report shows column informations defined by code X,Y,Z...
886 # X,Y,Z... are code letters among the following:
887 # U = Unique visitors
888 # V = Visits
889 # P = Number of pages
890 # H = Number of hits (or mails)
891 # B = Bandwith (or total mail size for mail logs)
892 # L = Last access date
893 # E = Entry pages
894 # X = Exit pages
895 # C = Web compression (mod_gzip,mod_deflate)
896 # M = Average mail size (mail logs)
897 #
898
899 # Show monthly chart
900 # Context: Web, Streaming, Mail, Ftp
901 # Default: UVPHB, Possible column codes: UVPHB
902 ShowMonthStats=UVPHB
903
904 rizwank 1.1 # Show days of month chart
905 # Context: Web, Streaming, Mail, Ftp
906 # Default: VPHB, Possible column codes: VPHB
907 ShowDaysOfMonthStats=VPHB
908
909 # Show days of week chart
910 # Context: Web, Streaming, Mail, Ftp
911 # Default: PHB, Possible column codes: PHB
912 ShowDaysOfWeekStats=PHB
913
914 # Show hourly chart
915 # Context: Web, Streaming, Mail, Ftp
916 # Default: PHB, Possible column codes: PHB
917 ShowHoursStats=PHB
918
919 # Show domains/country chart
920 # Context: Web, Streaming, Mail, Ftp
921 # Default: PHB, Possible column codes: PHB
922 ShowDomainsStats=PHB
923
924 # Show hosts chart
925 rizwank 1.1 # Context: Web, Streaming, Mail, Ftp
926 # Default: PHBL, Possible column codes: PHBL
927 ShowHostsStats=PHBL
928
929 # Show authenticated users chart
930 # Context: Web, Streaming, Ftp
931 # Default: 0, Possible column codes: PHBL
932 ShowAuthenticatedUsers=0
933
934 # Show robots chart
935 # Context: Web, Streaming
936 # Default: HBL, Possible column codes: HBL
937 ShowRobotsStats=HBL
938
939 # Show worms chart
940 # Context: Web, Streaming
941 # Default: 0 (If set to 1, see also LevelForWormsDetection), Possible column codes: HBL
942 ShowWormsStats=0
943
944 # Show email senders chart (For use when analyzing mail log files)
945 # Context: Mail
946 rizwank 1.1 # Default: 0, Possible column codes: HBML
947 ShowEMailSenders=0
948
949 # Show email receivers chart (For use when analyzing mail log files)
950 # Context: Mail
951 # Default: 0, Possible column codes: HBML
952 ShowEMailReceivers=0
953
954 # Show session chart
955 # Context: Web, Streaming, Ftp
956 # Default: 1, Possible column codes: None
957 ShowSessionsStats=1
958
959 # Show pages-url chart.
960 # Context: Web, Streaming, Ftp
961 # Default: PBEX, Possible column codes: PBEX
962 ShowPagesStats=PBEX
963
964 # Show file types chart.
965 # Context: Web, Streaming, Ftp
966 # Default: HB, Possible column codes: HBC
967 rizwank 1.1 ShowFileTypesStats=HB
968
969 # Show file size chart (Not yet available)
970 # Context: Web, Streaming, Mail, Ftp
971 # Default: 1, Possible column codes: None
972 ShowFileSizesStats=0
973
974 # Show operating systems chart
975 # Context: Web, Streaming, Ftp
976 # Default: 1, Possible column codes: None
977 ShowOSStats=1
978
979 # Show browsers chart
980 # Context: Web, Streaming
981 # Default: 1, Possible column codes: None
982 ShowBrowsersStats=1
983
984 # Show screen size chart
985 # Context: Web, Streaming
986 # Default: 0 (If set to 1, see also MiscTrackerUrl), Possible column codes: None
987 ShowScreenSizeStats=0
988 rizwank 1.1
989 # Show origin chart
990 # Context: Web, Streaming
991 # Default: PH, Possible column codes: PH
992 ShowOriginStats=PH
993
994 # Show keyphrases chart
995 # Context: Web, Streaming
996 # Default: 1, Possible column codes: None
997 ShowKeyphrasesStats=1
998
999 # Show keywords chart
1000 # Context: Web, Streaming
1001 # Default: 1, Possible column codes: None
1002 ShowKeywordsStats=1
1003
1004 # Show misc chart
1005 # Context: Web, Streaming
1006 # Default: a (See also MiscTrackerUrl parameter), Possible column codes: anjdfrqwp
1007 ShowMiscStats=a
1008
1009 rizwank 1.1 # Show http errors chart
1010 # Context: Web, Streaming
1011 # Default: 1, Possible column codes: None
1012 ShowHTTPErrorsStats=1
1013
1014 # Show smtp errors chart (For use when analyzing mail log files)
1015 # Context: Mail
1016 # Default: 0, Possible column codes: None
1017 ShowSMTPErrorsStats=0
1018
1019 # Show the cluster report (Your LogFormat must contains the %cluster tag)
1020 # Context: Web, Streaming, Ftp
1021 # Default: 0, Possible column codes: PHB
1022 ShowClusterStats=0
1023
1024
1025 # Some graphical reports are followed by the data array of values.
1026 # If you don't want this array (to reduce report size for example), you can
1027 # set thoose options to 0.
1028 # Possible values: 0 or 1
1029 # Default: 1
1030 rizwank 1.1 #
1031 # Data array values for the ShowMonthStats report
1032 AddDataArrayMonthStats=1
1033 # Data array values for the ShowDaysOfMonthStats report
1034 AddDataArrayShowDaysOfMonthStats=1
1035 # Data array values for the ShowDaysOfWeekStats report
1036 AddDataArrayShowDaysOfWeekStats=1
1037 # Data array values for the ShowHoursStats report
1038 AddDataArrayShowHoursStats=1
1039
1040
1041 # In the Origin chart, you have stats on where your hits came from. You can
1042 # includes hits on pages that comes from pages of same sites in this chart.
1043 # Possible values: 0 or 1
1044 # Default: 0
1045 #
1046 IncludeInternalLinksInOriginSection=0
1047
1048
1049 # Following parameter can be used to choose maximum number of lines shown for
1050 # the particular following report.
1051 rizwank 1.1 #
1052 # Stats by countries/domains
1053 MaxNbOfDomain = 10
1054 MinHitDomain = 1
1055 # Stats by hosts
1056 MaxNbOfHostsShown = 10
1057 MinHitHost = 1
1058 # Stats by authenticated users
1059 MaxNbOfLoginShown = 10
1060 MinHitLogin = 1
1061 # Stats by robots
1062 MaxNbOfRobotShown = 10
1063 MinHitRobot = 1
1064 # Stats by pages
1065 MaxNbOfPageShown = 10
1066 MinHitFile = 1
1067 # Stats by OS
1068 MaxNbOfOsShown = 10
1069 MinHitOs = 1
1070 # Stats by browsers
1071 MaxNbOfBrowsersShown = 10
1072 rizwank 1.1 MinHitBrowser = 1
1073 # Stats by screen size
1074 MaxNbOfScreenSizesShown = 5
1075 MinHitScreenSize = 1
1076 # Stats by window size (following 2 parameters are not yet used)
1077 MaxNbOfWindowSizesShown = 5
1078 MinHitWindowSize = 1
1079 # Stats by referers
1080 MaxNbOfRefererShown = 10
1081 MinHitRefer = 1
1082 # Stats for keyphrases
1083 MaxNbOfKeyphrasesShown = 10
1084 MinHitKeyphrase = 1
1085 # Stats for keywords
1086 MaxNbOfKeywordsShown = 10
1087 MinHitKeyword = 1
1088 # Stats for sender or receiver emails
1089 MaxNbOfEMailsShown = 20
1090 MinHitEMail = 1
1091
1092
1093 rizwank 1.1 # Choose if you want the week report to start on sunday or monday
1094 # Possible values:
1095 # 0 - Week start on sunday
1096 # 1 - Week start on monday
1097 # Default: 1
1098 #
1099 FirstDayOfWeek=1
1100
1101
1102 # List of visible flags that links to other language translations.
1103 # See Lang parameter for list of allowed flag/language codes.
1104 # If you don't want any flag link, set ShowFlagLinks to "".
1105 # This parameter is used only if ShowMenu parameter is set to 1.
1106 # Possible values: "" or "language_codes_separated_by_space"
1107 # Example: "en es fr nl de"
1108 # Default: ""
1109 #
1110 ShowFlagLinks=""
1111
1112
1113 # Each URL, shown in stats report views, are links you can click.
1114 rizwank 1.1 # Possible values: 0 or 1
1115 # Default: 1
1116 #
1117 ShowLinksOnUrl=1
1118
1119
1120 # When AWStats build HTML links in its report pages, it starts thoose link
1121 # with "http://". However some links might be HTTPS links, so you can enter
1122 # here the root of all your HTTPS links. If all your site is a SSL web site,
1123 # just enter "/".
1124 # This parameter is not used if ShowLinksOnUrl is 0.
1125 # Example: "/shopping"
1126 # Example: "/"
1127 # Default: ""
1128 #
1129 UseHTTPSLinkForUrl=""
1130
1131
1132 # Maximum length of URL part shown on stats page (number of characters).
1133 # This affects only URL visible text, link still work.
1134 # Default: 64
1135 rizwank 1.1 #
1136 MaxLengthOfShownURL=64
1137
1138
1139 # You can enter HTML code that will be added at the top of AWStats reports.
1140 # Default: ""
1141 #
1142 HTMLHeadSection=""
1143
1144
1145 # You can enter HTML code that will be added at the end of AWStats reports.
1146 # Great to add advert ban.
1147 # Default: ""
1148 #
1149 HTMLEndSection=""
1150
1151
1152 # You can set Logo and LogoLink to use your own logo.
1153 # Logo must be the name of image file (must be in $DirIcons/other directory).
1154 # LogoLink is the expected URL when clicking on Logo.
1155 # Default: "awstats_logo6.png"
1156 rizwank 1.1 #
1157 Logo="awstats_logo6.png"
1158 LogoLink="http://awstats.sourceforge.net"
1159
1160
1161 # Value of maximum bar width/height for horizontal/vertical HTML graphics bar.
1162 # Default: 260/90
1163 #
1164 BarWidth = 260
1165 BarHeight = 90
1166
1167
1168 # You can ask AWStats to use a particular CSS (Cascading Style Sheet) to
1169 # change its look. To create a style sheet, you can use samples provided with
1170 # AWStats in wwwroot/css directory.
1171 # Example: "/awstatscss/awstats_bw.css"
1172 # Example: "/css/awstats_bw.css"
1173 # Default: ""
1174 #
1175 StyleSheet=""
1176
1177 rizwank 1.1
1178 # Those colors parameters can be used (if StyleSheet parameter is not used)
1179 # to change AWStats look.
1180 # Example: color_name="RRGGBB" # RRGGBB is Red Green Blue components in Hex
1181 #
1182 color_Background="FFFFFF" # Background color for main page (Default = "FFFFFF")
1183 color_TableBGTitle="CCCCDD" # Background color for table title (Default = "CCCCDD")
1184 color_TableTitle="000000" # Table title font color (Default = "000000")
1185 color_TableBG="CCCCDD" # Background color for table (Default = "CCCCDD")
1186 color_TableRowTitle="FFFFFF" # Table row title font color (Default = "FFFFFF")
1187 color_TableBGRowTitle="ECECEC" # Background color for row title (Default = "ECECEC")
1188 color_TableBorder="ECECEC" # Table border color (Default = "ECECEC")
1189 color_text="000000" # Color of text (Default = "000000")
1190 color_textpercent="606060" # Color of text for percent values (Default = "606060")
1191 color_titletext="000000" # Color of text title within colored Title Rows (Default = "000000")
1192 color_weekend="EAEAEA" # Color for week-end days (Default = "EAEAEA")
1193 color_link="0011BB" # Color of HTML links (Default = "0011BB")
1194 color_hover="605040" # Color of HTML on-mouseover links (Default = "605040")
1195 color_u="FFAA66" # Background color for number of unique visitors (Default = "FFAA66")
1196 color_v="F4F090" # Background color for number of visites (Default = "F4F090")
1197 color_p="4477DD" # Background color for number of pages (Default = "4477DD")
1198 rizwank 1.1 color_h="66DDEE" # Background color for number of hits (Default = "66DDEE")
1199 color_k="2EA495" # Background color for number of bytes (Default = "2EA495")
1200 color_s="8888DD" # Background color for number of search (Default = "8888DD")
1201 color_e="CEC2E8" # Background color for number of entry pages (Default = "CEC2E8")
1202 color_x="C1B2E2" # Background color for number of exit pages (Default = "C1B2E2")
1203
1204
1205
1206 #-----------------------------------------------------------------------------
1207 # PLUGINS
1208 #-----------------------------------------------------------------------------
1209
1210 # Add here all plugins file you want to load.
1211 # Plugin files must be .pm files stored in 'plugins' directory.
1212 # Uncomment LoadPlugin lines to enable a plugin after checking that perl
1213 # modules required by the plugin are installed.
1214
1215 # Plugin: Tooltips
1216 # Perl modules required: None
1217 # Add some tooltips help on HTML report pages.
1218 # Note that enabled this kind of help will increased HTML report pages size,
1219 rizwank 1.1 # so server load and bandwidth.
1220 #
1221 LoadPlugin="tooltips"
1222
1223 # Plugin: DecodeUTFKeys
1224 # Perl modules required: Encode and URI::Escape
1225 # Allow AWStats to show correctly (in language charset) keywords/keyphrases
1226 # strings even if they were UTF8 coded by the referer search engine.
1227 #
1228 #LoadPlugin="decodeutfkeys"
1229
1230 # Plugin: IPv6
1231 # Perl modules required: Net::IP and Net::DNS
1232 # This plugin gives AWStats capability to make reverse DNS lookup on IPv6
1233 # addresses.
1234 # Note: If you are interesting in having country report, you should use the
1235 # geoipfree or geoip plugin instead of enabled reverse DNS lookup.
1236 #
1237 #LoadPlugin="ipv6"
1238
1239 # Plugin: HashFiles
1240 rizwank 1.1 # Perl modules required: Storable
1241 # AWStats DNS cache files are read/saved as native hash files. This increase
1242 # DNS cache files loading speed, above all for very large web sites.
1243 #
1244 LoadPlugin="hashfiles"
1245
1246 # Plugin: GeoIP
1247 # Perl modules required: Geo::IP or Geo::IP::PurePerl (from Maxmind)
1248 # Country chart is built from an Internet IP-Country database.
1249 # This plugin is useless for intranet only log files.
1250 # Note: You must choose between using this plugin (need Perl Geo::IP module
1251 # from Maxmind, database more up to date) or the GeoIPfree plugin (need
1252 # Perl Geo::IPfree module, database less up to date).
1253 # This plugin reduces AWStats speed of 8% !
1254 #
1255 LoadPlugin="geoip GEOIP_STANDARD"
1256
1257 # Plugin: GeoIPfree
1258 # Perl modules required: Geo::IPfree version 0.2+ (from Graciliano M.P.)
1259 # Country chart is built from an Internet IP-Country database.
1260 # This plugin is useless for intranet only log files.
1261 rizwank 1.1 # Note: You must choose between using this plugin (need Perl Geo::IPfree
1262 # module, database less up to date) or the GeoIP plugin (need Perl Geo::IP
1263 # module from Maxmind, database more up to date).
1264 # Note: Activestate provide a corrupted version of Geo::IPfree 0.2 Perl
1265 # module, so install it from elsewhere (from www.cpan.org for example).
1266 # This plugin reduces AWStats speed of 10% !
1267 #
1268 #LoadPlugin="geoipfree"
1269
1270 # Plugin: GeoIP_Region_Maxmind
1271 # Perl modules required: Geo::IP (from Maxmind)
1272 # This plugin add a chart of hits by regions. Only regions for US and
1273 # Canada can be detected.
1274 # Note: This plugin need Maxmind GeoIP Perl module AND the region database.
1275 # Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
1276 # on Windows but it works great on Linux with default Perl.
1277 # You need to purchase a license from Maxmind to get/use the Region database.
1278 # This plugin reduces AWStats speed.
1279 #
1280 #LoadPlugin="geoip_region_maxmind GEOIP_STANDARD /pathto/GeoIPRegion.dat"
1281
1282 rizwank 1.1 # Plugin: GeoIP_City_Maxmind
1283 # Perl modules required: Geo::IP (from Maxmind)
1284 # This plugin add a chart of hits by cities.
1285 # Note: This plugin need Maxmind GeoIP Perl module AND the city database.
1286 # Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
1287 # on Windows but it works great on Linux with default Perl.
1288 # You need to purchase a license from Maxmind to get/use the City database.
1289 # This plugin reduces AWStats speed.
1290 #
1291 #LoadPlugin="geoip_city_maxmind GEOIP_STANDARD /pathto/GeoIPCity.dat"
1292
1293 # Plugin: GeoIP_ISP_Maxmind
1294 # Perl modules required: Geo::IP (from Maxmind)
1295 # This plugin add a chart of hits by ISP.
1296 # Note: This plugin need Maxmind GeoIP Perl module AND the ISP database.
1297 # Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
1298 # on Windows but it works great on Linux with default Perl.
1299 # You need to purchase a license from Maxmind to get/use the ISP database.
1300 # This plugin reduces AWStats speed.
1301 #
1302 #LoadPlugin="geoip_isp_maxmind GEOIP_STANDARD /pathto/GeoIPISP.dat"
1303 rizwank 1.1
1304 # Plugin: GeoIP_Org_Maxmind
1305 # Perl modules required: Geo::IP (from Maxmind)
1306 # This plugin add a chart of hits by Organization name
1307 # Note: This plugin need Maxmind GeoIP Perl module AND the Org database.
1308 # Note: I get some problem with Maxmind Geo::IP Perl module with ActiveState
1309 # on Windows but it works great on Linux with default Perl.
1310 # You need to purchase a license from Maxmind to get/use the Org database.
1311 # This plugin reduces AWStats speed.
1312 #
1313 #LoadPlugin="geoip_org_maxmind GEOIP_STANDARD /pathto/GeoIPOrg.dat"
1314
1315 # Plugin: UserInfo
1316 # Perl modules required: None
1317 # Add a text (Firtname, Lastname, Office Department, ...) in authenticated user
1318 # reports for each login value.
1319 # A text file called userinfo.myconfig.txt, with two fields (first is login,
1320 # second is text to show, separated by a tab char) must be created in DirData
1321 # directory.
1322 #
1323 #LoadPlugin="userinfo"
1324 rizwank 1.1
1325 # Plugin: HostInfo
1326 # Perl modules required: Net::XWhois
1327 # Add a column into host chart with a link to open a popup window that shows
1328 # info on host (like whois records).
1329 #
1330 #LoadPlugin="hostinfo"
1331
1332 # Plugin: ClusterInfo
1333 # Perl modules required: None
1334 # Add a text (for example a full hostname) in cluster reports for each cluster
1335 # number.
1336 # A text file called clusterinfo.myconfig.txt, with two fields (first is
1337 # cluster number, second is text to show) separated by a tab char. must be
1338 # created into DirData directory.
1339 # Note this plugin is useless if ShowClusterStats is set to 0 or if you don't
1340 # use a personalized log format that contains %cluster tag.
1341 #
1342 #LoadPlugin="clusterinfo"
1343
1344 # Plugin: UrlAliases
1345 rizwank 1.1 # Perl modules required: None
1346 # Add a text (Page title, description...) in URL reports before URL value.
1347 # A text file called urlalias.myconfig.txt, with two fields (first is URL,
1348 # second is text to show, separated by a tab char) must be created into
1349 # DirData directory.
1350 #
1351 #LoadPlugin="urlalias"
1352
1353 # Plugin: TimeHiRes
1354 # Perl modules required: Time::HiRes (if Perl < 5.8)
1355 # Time reported by -showsteps option is in millisecond. For debug purpose.
1356 #
1357 #LoadPlugin="timehires"
1358
1359 # Plugin: TimeZone
1360 # Perl modules required: Time::Local
1361 # Allow AWStats to correct a bad timezone for user of some IIS that use
1362 # GMT date in its log instead of local server time.
1363 # This module is useless for Apache and most IIS version.
1364 # This plugin reduces AWStats speed of 40% !!!!!!!
1365 #
1366 rizwank 1.1 #LoadPlugin="timezone +2"
1367
1368 # Plugin: Rawlog
1369 # Perl modules required: None
1370 # This plugin adds a form in AWStats main page to allow users to see raw
1371 # content of current log files. A filter is also available.
1372 #
1373 #LoadPlugin="rawlog"
1374
1375 # Plugin: GraphApplet
1376 # Perl modules required: None
1377 # Supported charts are built by a 3D graphic applet.
1378 #
1379 #LoadPlugin="graphapplet /awstatsclasses" # EXPERIMENTAL FEATURE
1380
1381
1382
1383 #-----------------------------------------------------------------------------
1384 # EXTRA SECTIONS
1385 #-----------------------------------------------------------------------------
1386
1387 rizwank 1.1 # You can define your own charts, you choose here what are rows and columns
1388 # keys. This feature is particularly usefull for marketing purpose, tracking
1389 # products orders for example.
1390 # For this, edit all parameters of Extra section. Each set of parameter is a
1391 # different chart. For several charts, duplicate section changing the number.
1392 # Note: Each Extra section reduces AWStats speed by 8%.
1393 #
1394 # WARNING: A wrong setup of Extra section might result in too large arrays
1395 # that will consume all your memory, making AWStats unusable after several
1396 # updates, so be sure to setup it correctly.
1397 # In most cases, you don't need this feature.
1398 #
1399 # ExtraSectionNameX is title of your personalized chart.
1400 # ExtraSectionCodeFilterX is list of codes the record code field must match.
1401 # Put an empty string for no test on code.
1402 # ExtraSectionConditionX are conditions you can use to count or not the hit,
1403 # Use one of the field condition (URL,QUERY_STRING,REFERER,UA,HOST,extraX)
1404 # and a regex to match, after a coma. Use "||" for "OR".
1405 # ExtraSectionFirstColumnTitleX is the first column title of the chart.
1406 # ExtraSectionFirstColumnValuesX is a string to tell AWStats which field to
1407 # extract value from (URL,QUERY_STRING,REFERER,UA,HOST,extraX)
1408 rizwank 1.1 # and how to extract the value (using regex syntax). Each different value
1409 # found will appear in first column of report on a different row. Be sure
1410 # that list of different possible values will not grow indefinitely.
1411 # ExtraSectionFirstColumnFormatX is the string used to write value.
1412 # ExtraSectionStatTypesX are things you want to count. You can use standard
1413 # code letters (P for pages,H for hits,B for bandwidth,L for last access).
1414 # ExtraSectionAddAverageRowX add a row at bottom of chart with average values.
1415 # ExtraSectionAddSumRowX add a row at bottom of chart with sum values.
1416 # MaxNbOfExtraX is maximum number of rows shown in chart.
1417 # MinHitExtraX is minimum number of hits required to be shown in chart.
1418 #
1419
1420 # Example to report the 20 products the most ordered by "order.cgi" script
1421 #ExtraSectionName1="Product orders"
1422 #ExtraSectionCodeFilter1="200 304"
1423 #ExtraSectionCondition1="URL,\/cgi\-bin\/order\.cgi||URL,\/cgi\-bin\/order2\.cgi"
1424 #ExtraSectionFirstColumnTitle1="Product ID"
1425 #ExtraSectionFirstColumnValues1="QUERY_STRING,productid=([^&]+)"
1426 #ExtraSectionFirstColumnFormat1="%s"
1427 #ExtraSectionStatTypes1=PL
1428 #ExtraSectionAddAverageRow1=0
1429 rizwank 1.1 #ExtraSectionAddSumRow1=1
1430 #MaxNbOfExtra1=20
1431 #MinHitExtra1=1
1432
1433
1434 # There is also a global parameter ExtraTrackedRowsLimit that limit the
1435 # number of possible rows an ExtraSection can report. This parameter is
1436 # here to protect too much memory use when you make a bad setup in your
1437 # ExtraSection. It applies to all ExtraSection independently meaning that
1438 # none ExtraSection can report more rows than value defined by ExtraTrackedRowsLimit.
1439 # If you know an ExtraSection will report more rows than its value, you should
1440 # increase this parameter or AWStats will stop with an error.
1441 # Example: 2000
1442 # Default: 500
1443 #
1444 ExtraTrackedRowsLimit=500
1445
1446
1447 #-----------------------------------------------------------------------------
1448 # INCLUDES
1449 #-----------------------------------------------------------------------------
1450 rizwank 1.1
1451 # You can include other config files using the directive with the name of the
1452 # config file.
1453 # This is particularly usefull for users who have a lot of virtual servers, so
1454 # a lot of config files and want to maintain common values in only one file.
1455 # Note that when a variable is defined both in a config file and in an
1456 # included file, AWStats will use the last value read for parameters that
1457 # contains one value and AWStats will concat all values from both files for
1458 # parameters that are lists of value.
1459 #
1460
1461 #Include ""
1462
|