Updated documentation.

diff --git a/README.TXT b/README.TXT
index ef1519febaa2a9f53e89afa450c77048755dc60d..10cfe06e3eca1dee93ac22782e471e1b869c08f0 100644 (file)
--- 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 5f58e865f042c52a0bdc195e93bcce47ee4fd817..41c49a54cac1a4314d553d7483e8b7f23f740a9f 100644 (file)
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 3fd429670515f4311016a38a349c643686b2e5dc..84c0951ff731fdb1d00b3c59a09b885b0a1d5d06 100644 (file)
--- a/docs/awstats_compare.html
+++ b/docs/awstats_compare.html
@@ -84,9 +84,11 @@
 <tr align=center><td align=left>Report file types</td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td><td><font color=#660000>No</font></td><td><font color=#660000>No</font></td></tr>\r
 <tr align=center bgcolor=#DDDDDD><td align=left>Report by file size</td><td><font color=#660000>No</font></td><td><font color=#4444cc>Yes</font></td><td><font color=#660000>No</font></td><td><font color=#660000>No</font></td></tr>\r
 <tr align=center><td align=left>Report OS (nb detected)</td><td><font color=#4444cc>Yes (32)</font></td><td><font color=#4444cc>Yes</font><font color=#660000> (29)</font></td><td><font color=#660000>No (0)</font></td><td>?</td></tr>\r
-<tr align=center bgcolor=#DDDDDD><td align=left>Report browsers (nb detected)</td><td><font color=#4444cc>Yes (84*)</font></td><td><font color=#4444cc>Yes</font><font color=#660000> (9*)</font></td><td><font color=#4444cc>Yes</font><font color=#660000> (4*)</font></td><td><font color=#4444cc>Yes</font><font color=#660000> (<20*)</font></td></tr>\r
+<tr align=center bgcolor=#DDDDDD><td align=left>Report browsers (nb detected)</td><td><font color=#4444cc>Yes (89*)</font></td><td><font color=#4444cc>Yes</font><font color=#660000> (9*)</font></td><td><font color=#4444cc>Yes</font><font color=#660000> (4*)</font></td><td><font color=#4444cc>Yes</font><font color=#660000> (<20*)</font></td></tr>\r
 <tr align=center><td align=left>Report details of browsers versions</td><td><font color=#4444cc>Major and minor versions</font></td><td><font color=#660000>Major versions only</font></td><td><font color=#4444cc>Major an minor versions</font></td><td><font color=#4444cc>Major and minor versions</font></td></tr>\r
 <tr align=center bgcolor=#DDDDDD><td align=left>Report screen sizes</td><td><font color=#4444cc>Yes</font></td><td><font color=#660000>No</font></td><td><font color=#660000>No</font></td><td><font color=#4444cc>Yes</font></td></tr>\r
+<tr align=center><td align=left>Report tech supported by browser for Java/Flash/PDF</td><td><font color=#4444cc>Yes/Yes/Yes</font></td><td><font color=#660000>No/No/No</font></td><td><font color=#660000>No/No/No</font></td><td><font color=#660000>No/No/No</font></td></tr>
+<tr align=center bgcolor=#DDDDDD><td align=left>Report audio format supported by browser for Real/QuickTime/Mediaplayer</td><td><font color=#4444cc>Yes/Yes/Yes</font></td><td><font color=#660000>No/No/No</font></td><td><font color=#660000>No/No/No</font></td><td><font color=#660000>No/No/No</font></td></tr>
 \r
 <!-- Referrer -->\r
 <tr align=center><td align=left>Report search engines used (nb detected)</td><td><font color=#4444cc>Yes (99***)</font></td><td><font color=#4444cc>Yes </font><font color=#660000>(24)</font></td><td><font color=#660000>No (0)</font></td><td><font color=#4444cc>Yes</font><font color=#660000> (<20 ***)</font></td></tr>\r
@@ -96,13 +98,15 @@
 <!-- Misc -->\r
 <tr align=center bgcolor=#DDDDDD><td align=left>Report HTTP Errors</td><td><font color=#4444cc>Yes<br></font></td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td><td><font color=#660000>No</font></td></tr>\r
 <tr align=center><td align=left>Report 404 Errors</td><td><font color=#4444cc>Nb + List last date/referer<br></font></td><td><font color=#660000>Nb only</font></td><td><font color=#660000>Nb only</font></td><td><font color=#660000>No</font></td></tr>\r
-<tr align=center bgcolor=#DDDDDD><td align=left>Report 'Add to favorites' statistics</td><td><font color=#660000>No<br></font></td><td><font color=#660000>No</font></td><td><font color=#660000>No</font></td><td><font color=#660000>No</font></td></tr>\r
+<tr align=center bgcolor=#DDDDDD><td align=left>Report 'Add to favorites' statistics</td><td><font color=#4444cc>Yes<br></font></td><td><font color=#660000>No</font></td><td><font color=#660000>No</font></td><td><font color=#660000>No</font></td></tr>\r
 <tr align=center><td align=left>Other personalized reports for<br>miscellanous/marketing purpose</td><td><font color=#4444cc>Yes<br></font></td><td><font color=#660000>No</font></td><td><font color=#660000>No</font></td><td><font color=#660000>No</font></td></tr>\r
 <tr align=center bgcolor=#DDDDDD><td align=left>Daily statistics </td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td></tr>\r
 <tr align=center><td align=left>Monthly statistics </td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td></tr>\r
 <tr align=center bgcolor=#DDDDDD><td align=left>Yearly statistics </td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td><td><font color=#4444cc>Yes</font></td></tr>\r
 <tr align=center><td align=left>Benchmark with no DNS lookup in lines/seconds<br>(full features enabled, with XLF format, standard Perl 5.8, Athlon 1Ghz)</td><td><font color=#660000>4500****</font></td><td><font color=#4444cc>39000****</font></td><td><font color=#660000>12000****</font></td><td>NA<br>No program to run</td></tr>\r
 <tr align=center bgcolor=#DDDDDD><td align=left>Benchmark with DNS lookup in lines/seconds<br>(full features enabled, with XLF format, standard Perl 5.8, Athlon 1Ghz)</td><td><font color=#4444cc>80****</font></td><td><font color=#4444cc>80****</font></td><td><font color=#4444cc>80****</font></td><td>NA<br>No program to run</td></tr>\r
+<tr align=center><td align=left>Reuse of analyzed data</td><td><font color=#4444cc>Easy (data=text files)</font></td><td><font color=#4444cc>Very easy (data=XML)</font></td><td><font color=#660000>No (binary database)</font></td><td><font color=#660000>Not available</font></td></tr>\r
+<tr align=center bgcolor=#DDDDDD><td align=left>Export statistics to PDF</td><td><font color=#660000>No</font></td><td><font color=#660000>Soon</font></td><td><font color=#660000>No</font></td><td><font color=#660000>No</font></td></tr>\r
 <tr align=center><td align=left>Graphical statistics in one page / several / or frames</td><td><font color=#4444cc>Yes/Yes/Yes</font></td><td><font color=#4444cc>Yes</font>/<font color=#660000>No/No</font></td><td><font color=#4444cc>Yes/Yes</font>/<font color=#660000>No</font></td><td><font color=#660000>No</font>/<font color=#4444cc>Yes/Yes</font></td></tr>\r
 \r
 </table>\r

diff --git a/docs/awstats_what.html b/docs/awstats_what.html
index 571083bb499844bba48fd3335c4df54cd2f9172d..c78ef4aef95808ff23bf65c70873b017d9b9c562 100644 (file)
--- a/docs/awstats_what.html
+++ b/docs/awstats_what.html
@@ -42,27 +42,29 @@
        * <u>Visits duration</u> and last visits,<br>\r
        * <u>Authenticated users</u>, and last authenticated visits,<br>\r
        * <u>Days of week</u> and <u>rush hours</u> (pages, hits, KB for each hour and day of week),<br>\r
-       * <u>Domains/countries</u> of hosts visitors (pages, hits, KB, <font color=#221188>266 domains/countries detected</font>),<br>\r
+       * <u>Domains/countries</u> of hosts visitors (pages, hits, KB, <font color=#221188>269 domains/countries detected</font>),<br>\r
        * <u>Hosts list</u>, last visits and unresolved IP addresses list,<br>\r
        * <u>Most viewed</u>, <u>entry</u> and <u>exit</u> pages,<br>\r
        * <u>Files type</u>,<br>\r
        * <u>Web compression statistics</u> (for mod_gzip or mod_deflate),<br>\r
-       * <u>Browsers</u> used (pages, hits, KB for each browser, each version, <font color=#221188>78 browsers</font>: Web, Wap, Media browsers...),<br>\r
-       * <u>OS used</u> (pages, hits, KB for each OS, <font color=#221188>31 OS detected</font>),<br>\r
+       * <u>Browsers</u> used (pages, hits, KB for each browser, each version, <font color=#221188>89 browsers</font>: Web, Wap, Media browsers...),<br>\r
+       * <u>OS used</u> (pages, hits, KB for each OS, <font color=#221188>32 OS detected</font>),<br>\r
        * <u>Visits of robots</u> (<font color=#221188>307 robots detected</font>),<br>\r
-       * <u>Search engines</u>, <u>keyphrases</u> and <u>keywords</u> used to find your site (<font color=#221188>The 90 most famous search engines are detected like yahoo, google, altavista, etc...</font>),<br>\r
+       * <u>Search engines</u>, <u>keyphrases</u> and <u>keywords</u> used to find your site (<font color=#221188>The 99 most famous search engines are detected like yahoo, google, altavista, etc...</font>),<br>\r
        * <u>HTTP errors</u> (Page Not Found with last referrer, ...),<br>\r
        * <u>Other personalized reports</u> based on url, url parameters, referer field for miscellanous/marketing purpose,<br>\r
-       * <u>Screen size</u> (need to add a HTML code in index page).<br>\r
+       * <u>Screen size</u> (need to add some HTML tags in index page).<br>\r
+       * Ratio of Browsers with support of: <u>Java, Flash, RealG2 reader, Quicktime reader, WMA reader, PDF reader</u> (need to add some HTML tags in index page).<br>\r
 <br>\r
        <b>AWStats also supports the following features</b>:<br>\r
        * Can analyze a lot of log formats: Apache NCSA combined log files (XLF/ELF) or common (CLF), IIS log files (W3C),\r
-         WebStar native log files and other web, proxy or wap servers log files (but also ftp, syslog or mail log files). See <a href="awstats_faq.html#LOGFORMAT">AWStats F.A.Q.</a> for examples.<br>\r
+         WebStar native log files and other web, proxy, wap or streaming servers log files (but also ftp or mail log files). See <a href="docs/awstats_faq.html#LOGFORMAT">AWStats F.A.Q.</a> for examples.<br>
        * Works from command line and from a browser as a CGI (with dynamic filters capabilities for some charts),<br>\r
        * Update of statistics can be made from a web browser and not only from your scheduler,<br>\r
        * Unlimited log file size, support split log files (load balancing system),<br>\r
        * Support 'nearly sorted' log files even for entry and exit pages,<br>\r
        * Reverse DNS lookup before or during analysis, support DNS cache files,<br>\r
+       * Country detection from IP location (geoip) or domain name.<br>
        * WhoIS links,<br>\r
        * A lot of options/filters and plugins can be used,<br>\r
        * Multi-named web sites supported (virtual servers, great for web-hosting providers),<br>\r
@@ -71,10 +73,11 @@
        * Several languages. See <a href="awstats_faq.html#LANG">AWStats F.A.Q.</a> for full list.<br>\r
        * No need of rare perl libraries. All basic perl interpreters can make AWStats working,<br>\r
        * Graphical and framed reports,<br>\r
-       * Look and colors can match your site design,<br>\r
+       * Look and colors can match your site design, can use CSS,<br>\r
        * Help and tooltips on HTML reported pages,<br>\r
        * Easy to use (Just one configuration file to edit),<br>\r
     * Absolutely free (even for web hosting providers), with sources (<a href="awstats_license.html">GNU General Public License</a>)<br>\r
+       * Available on all platforms,<br>
        * AWStats has a <a href="awstats.xml" target=_newawstats>XML Portable Application Description</a>.<br>\r
 <br>\r
        <b>Requirements</b>:<br>\r

diff --git a/wwwroot/cgi-bin/awstats.pl b/wwwroot/cgi-bin/awstats.pl
index 771f8a15800c0cf43859e039ce39c9eb0f16920f..bf7d89b5bbc48729cfd6ab3e7b25dafb073297ef 100644 (file)
--- 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<a name=\"MISC\">&nbsp;</a><BR>\n";
                        my $title="$Message[139]";
                        &tab_head("$title",19);
-                       print "<TR bgcolor=\"#$color_TableBGRowTitle\"><TH>$Message[139]</TH><TH width=80>&nbsp</TH></TR>\n";
+                       print "<TR bgcolor=\"#$color_TableBGRowTitle\"><TH>$Message[139]</TH>";
+                       print "<TH width=100>&nbsp</TH>";
+                       print "<TH width=80>&nbsp</TH>";
+                       print "</TR>\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 "<TR>";
                                print "<TD CLASS=AWS>$key</TD>";
-                               print "<TD>".int($_misc_h{$key}||0)." / ";
-                               if ($MiscListCalc{$key} eq 'v') { print $TotalVisits; }
-                               if ($MiscListCalc{$key} eq 'hm') { print $_misc_h{'TotalMisc'}; }
-                               print "</TD>";
+                               if ($MiscListCalc{$key} eq 'v') { print "<TD>".int($_misc_h{$key}||0)." / $total $Message[12]</TD>"; }
+                               if ($MiscListCalc{$key} eq 'u') { print "<TD>".int($_misc_h{$key}||0)." / $total $Message[18]</TD>"; }
+                               if ($MiscListCalc{$key} eq 'hm') { print "<TD>&nbsp;</TD>"; }
+                               print "<TD>".($total?"$p %":"&nbsp;")."</TD>";
                                print "</TR>\n";
                        }
                        &tab_end;