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