From: eldy <>
Date: Sat, 14 Jun 2003 19:47:41 +0000 (+0000)
Subject: Updated documentation.
X-Git-Tag: AWSTATS_5_6_BETA~17
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0331d54285ff4b0af1acbbdb4830f0120db1630e;p=thirdparty%2FAWStats.git
Updated documentation.
---
diff --git a/README.TXT b/README.TXT
index ef1519fe..10cfe06e 100644
--- a/README.TXT
+++ b/README.TXT
@@ -42,13 +42,16 @@ I - 1) Features
* Hosts list, last visits and unresolved IP addresses list,
* Most viewed, entry and exit pages,
* File types,
- * Web compression statistics (for mod_gzip),
+ * Web compression statistics (for mod_gzip or mod_deflate),
* Browsers used (pages, hits, kb for each browser),
* OS used (pages, hits, KB for each OS),
* Visits of robots,
* Search engines, keyphrases and keywords used to find your site,
+ * HTTP errors (Page not found with last referer, ...),
* Other personalized reports,
- * HTTP errors (Page not found with last referer, ...).
+ * Screen size report,
+ * Ratio of Browsers that support: Java, Flash, RealG2 reader,
+ Quicktime reader, WMA reader, PDF reader
It supports the following features as well:
* Can analyze all log formats.
@@ -67,10 +70,10 @@ I - 1) Features
* Several languages,
* No need of rare perl libraries,
* Graphical one page or framed reports,
- * Look and colors can match your site design,
+ * Look and colors can match your site design, can use CSS,
* Help and tooltips on HTML reported pages,
* Easy to use (Just one configuration file to edit),
- * Free (GNU GPL), with sources (perl script),
+ * Free (GNU GPL), with sources (perl scripts),
* Available on all platforms.
@@ -93,7 +96,7 @@ I - 3) Files
docs/LICENSE GNU General Public Licence
docs/* AWStats documentation (setup/usage...)
tools/* Ohter provided tools
- wwwroot/cgi-bin/awstats.pl The main command line/CGI program
+ wwwroot/cgi-bin/awstats.pl The main CLI/CGI program
wwwroot/cgi-bin/awstats.model.conf An example of AWStats configure file
wwwroot/cgi-bin/lang Directory with languages files
wwwroot/cgi-bin/lib Directory with awstats reference info
@@ -104,6 +107,8 @@ I - 3) Files
wwwroot/icon/flags Directory with country flags icons
wwwroot/icon/os Directory with os icons
wwwroot/icon/other Directory with all others icons
+ wwwroot/css Samples of CSS files
+ wwwroot/js Javascript sources for "Misc" feature
diff --git a/docs/awstats.pdf b/docs/awstats.pdf
index 5f58e865..41c49a54 100644
Binary files a/docs/awstats.pdf and b/docs/awstats.pdf differ
diff --git a/docs/awstats_compare.html b/docs/awstats_compare.html
index 3fd42967..84c0951f 100644
--- a/docs/awstats_compare.html
+++ b/docs/awstats_compare.html
@@ -84,9 +84,11 @@
| Report file types | Yes | Yes | No | No |
| Report by file size | No | Yes | No | No |
| Report OS (nb detected) | Yes (32) | Yes (29) | No (0) | ? |
-| Report browsers (nb detected) | Yes (84*) | Yes (9*) | Yes (4*) | Yes (<20*) |
+| Report browsers (nb detected) | Yes (89*) | Yes (9*) | Yes (4*) | Yes (<20*) |
| Report details of browsers versions | Major and minor versions | Major versions only | Major an minor versions | Major and minor versions |
| Report screen sizes | Yes | No | No | Yes |
+| Report tech supported by browser for Java/Flash/PDF | Yes/Yes/Yes | No/No/No | No/No/No | No/No/No |
+| Report audio format supported by browser for Real/QuickTime/Mediaplayer | Yes/Yes/Yes | No/No/No | No/No/No | No/No/No |
| Report search engines used (nb detected) | Yes (99***) | Yes (24) | No (0) | Yes (<20 ***) |
@@ -96,13 +98,15 @@
| Report HTTP Errors | Yes
| Yes | Yes | No |
| Report 404 Errors | Nb + List last date/referer
| Nb only | Nb only | No |
-| Report 'Add to favorites' statistics | No
| No | No | No |
+| Report 'Add to favorites' statistics | Yes
| No | No | No |
Other personalized reports for miscellanous/marketing purpose | Yes
| No | No | No |
| Daily statistics | Yes | Yes | Yes | Yes |
| Monthly statistics | Yes | Yes | Yes | Yes |
| Yearly statistics | Yes | Yes | Yes | Yes |
Benchmark with no DNS lookup in lines/seconds (full features enabled, with XLF format, standard Perl 5.8, Athlon 1Ghz) | 4500**** | 39000**** | 12000**** | NA No program to run |
Benchmark with DNS lookup in lines/seconds (full features enabled, with XLF format, standard Perl 5.8, Athlon 1Ghz) | 80**** | 80**** | 80**** | NA No program to run |
+| Reuse of analyzed data | Easy (data=text files) | Very easy (data=XML) | No (binary database) | Not available |
+| Export statistics to PDF | No | Soon | No | No |
| Graphical statistics in one page / several / or frames | Yes/Yes/Yes | Yes/No/No | Yes/Yes/No | No/Yes/Yes |
diff --git a/docs/awstats_what.html b/docs/awstats_what.html
index 571083bb..c78ef4ae 100644
--- a/docs/awstats_what.html
+++ b/docs/awstats_what.html
@@ -42,27 +42,29 @@
* Visits duration and last visits,
* Authenticated users, and last authenticated visits,
* Days of week and rush hours (pages, hits, KB for each hour and day of week),
- * Domains/countries of hosts visitors (pages, hits, KB, 266 domains/countries detected),
+ * Domains/countries of hosts visitors (pages, hits, KB, 269 domains/countries detected),
* Hosts list, last visits and unresolved IP addresses list,
* Most viewed, entry and exit pages,
* Files type,
* Web compression statistics (for mod_gzip or mod_deflate),
- * Browsers used (pages, hits, KB for each browser, each version, 78 browsers: Web, Wap, Media browsers...),
- * OS used (pages, hits, KB for each OS, 31 OS detected),
+ * Browsers used (pages, hits, KB for each browser, each version, 89 browsers: Web, Wap, Media browsers...),
+ * OS used (pages, hits, KB for each OS, 32 OS detected),
* Visits of robots (307 robots detected),
- * Search engines, keyphrases and keywords used to find your site (The 90 most famous search engines are detected like yahoo, google, altavista, etc...),
+ * Search engines, keyphrases and keywords used to find your site (The 99 most famous search engines are detected like yahoo, google, altavista, etc...),
* HTTP errors (Page Not Found with last referrer, ...),
* Other personalized reports based on url, url parameters, referer field for miscellanous/marketing purpose,
- * Screen size (need to add a HTML code in index page).
+ * Screen size (need to add some HTML tags in index page).
+ * Ratio of Browsers with support of: Java, Flash, RealG2 reader, Quicktime reader, WMA reader, PDF reader (need to add some HTML tags in index page).
AWStats also supports the following features:
* Can analyze a lot of log formats: Apache NCSA combined log files (XLF/ELF) or common (CLF), IIS log files (W3C),
- WebStar native log files and other web, proxy or wap servers log files (but also ftp, syslog or mail log files). See AWStats F.A.Q. for examples.
+ WebStar native log files and other web, proxy, wap or streaming servers log files (but also ftp or mail log files). See AWStats F.A.Q. for examples.
* Works from command line and from a browser as a CGI (with dynamic filters capabilities for some charts),
* Update of statistics can be made from a web browser and not only from your scheduler,
* Unlimited log file size, support split log files (load balancing system),
* Support 'nearly sorted' log files even for entry and exit pages,
* Reverse DNS lookup before or during analysis, support DNS cache files,
+ * Country detection from IP location (geoip) or domain name.
* WhoIS links,
* A lot of options/filters and plugins can be used,
* Multi-named web sites supported (virtual servers, great for web-hosting providers),
@@ -71,10 +73,11 @@
* Several languages. See AWStats F.A.Q. for full list.
* No need of rare perl libraries. All basic perl interpreters can make AWStats working,
* Graphical and framed reports,
- * Look and colors can match your site design,
+ * Look and colors can match your site design, can use CSS,
* Help and tooltips on HTML reported pages,
* Easy to use (Just one configuration file to edit),
* Absolutely free (even for web hosting providers), with sources (GNU General Public License)
+ * Available on all platforms,
* AWStats has a XML Portable Application Description.
Requirements:
diff --git a/wwwroot/cgi-bin/awstats.pl b/wwwroot/cgi-bin/awstats.pl
index 771f8a15..bf7d89b5 100644
--- a/wwwroot/cgi-bin/awstats.pl
+++ b/wwwroot/cgi-bin/awstats.pl
@@ -225,7 +225,7 @@ use vars qw/
@PluginsToLoad
/;
@MiscListOrder=('AddToFavourites','JavaEnabled','DirectorSupport','FlashSupport','RealPlayerSupport','QuickTimeSupport','MediaPlayerSupport','PDFSupport');
-%MiscListCalc=('TotalMisc'=>'','AddToFavourites'=>'v','JavaEnabled'=>'hm','DirectorSupport'=>'hm','FlashSupport'=>'hm','RealPlayerSupport'=>'hm','QuickTimeSupport'=>'hm','MediaPlayerSupport'=>'hm','PDFSupport'=>'hm');
+%MiscListCalc=('TotalMisc'=>'','AddToFavourites'=>'u','JavaEnabled'=>'hm','DirectorSupport'=>'hm','FlashSupport'=>'hm','RealPlayerSupport'=>'hm','QuickTimeSupport'=>'hm','MediaPlayerSupport'=>'hm','PDFSupport'=>'hm');
@OSFamily=('win','mac');
@BrowsersFamily=('msie','netscape');
@SessionsRange=('0s-30s','30s-2mn','2mn-5mn','5mn-15mn','15mn-30mn','30mn-1h','1h+');
@@ -8835,14 +8835,23 @@ if (scalar keys %HTMLOutput) {
print "$Center
\n";
my $title="$Message[139]";
&tab_head("$title",19);
- print "| $Message[139] |   |
\n";
+ print "| $Message[139] | ";
+ print "  | ";
+ print "  | ";
+ print "
\n";
foreach my $key (@MiscListOrder) {
+ my $total=0;
+ my $p;
+ if ($MiscListCalc{$key} eq 'v') { $total=$TotalVisits; }
+ if ($MiscListCalc{$key} eq 'u') { $total=$TotalUnique; }
+ if ($MiscListCalc{$key} eq 'hm') { $total=$_misc_h{'TotalMisc'}||0; }
+ if ($total) { $p=int($_misc_h{$key}/$total*1000)/10; }
print "";
print "| $key | ";
- print "".int($_misc_h{$key}||0)." / ";
- if ($MiscListCalc{$key} eq 'v') { print $TotalVisits; }
- if ($MiscListCalc{$key} eq 'hm') { print $_misc_h{'TotalMisc'}; }
- print " | ";
+ if ($MiscListCalc{$key} eq 'v') { print "".int($_misc_h{$key}||0)." / $total $Message[12] | "; }
+ if ($MiscListCalc{$key} eq 'u') { print "".int($_misc_h{$key}||0)." / $total $Message[18] | "; }
+ if ($MiscListCalc{$key} eq 'hm') { print " | "; }
+ print "".($total?"$p %":" ")." | ";
print "
\n";
}
&tab_end;