| Current Path : /home/tools/awstats/docs/ |
FreeBSD hs32.drive.ne.jp 9.1-RELEASE FreeBSD 9.1-RELEASE #1: Wed Jan 14 12:18:08 JST 2015 root@hs32.drive.ne.jp:/sys/amd64/compile/hs32 amd64 |
| Current File : /home/tools/awstats/docs/awstats_extra.html |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta name="description" content="AWStats Documentation - Using the Extra Sections features">
<meta name="keywords" content="awstats, awstat, extra, section, sections, feature, features, report, extrasection">
<meta name="robots" content="index,follow">
<meta name="title" content="AWStats Documentation - Using the Extra Sections features">
<title>AWStats Documentation - Using the Extra Sections features</title>
<link rel="stylesheet" href="styles.css" type="text/css">
<!-- $Revision: 1.7 $ - $Author: eldy $ - $Date: 2003/09/22 03:59:19 $ -->
</head>
<body topmargin=10 leftmargin=5>
<table style="font: 10pt arial,helvetica,verdana" cellpadding=0 cellspacing=0 border=0 bgcolor=#FFFFFF width=100%>
<!-- Large -->
<tr style="font: 10pt arial,helvetica,verdana">
<td bgcolor=#9999cc align=center><a href="/"><img src="images/awstats_logo4.png" border=0></a></td>
<td bgcolor=#9999cc align=center>
<br>
<font style="font: 16pt arial,helvetica,sanserif" color=#EEEEFF><b>AWStats logfile analyzer 5.9 Documentation</b></font><br>
<br>
</td>
<td bgcolor=#9999cc align=center>
</td>
</tr>
</table>
<br><br><H1 style="font: 26px arial,helvetica,sanserif">Using the Extra Sections features</H1>
<br>
The AWStats Extra Sections features are powerfull setup options to allow you to add your own
report not provided by default with AWStats. You can use it to build special reports, like
number of sales for a particular product, marketing reports, counting for a particular
user or agent, etc...<br>
<br>You can define your own charts, you choose here what are rows and columns
<br>keys. This feature is particularly usefull for marketing purpose, tracking
<br>products orders for example.
<br>For this, edit all parameters of Extra section. Each set of parameter is a
<br>different chart. For several charts, duplicate section changing the number.
<br>Note: Each Extra section reduces AWStats speed by 8%.
<br>
<br>WARNING: A wrong setup of Extra section might result in too large arrays
<br>that will consume all your memory, making AWStats unusable after several
<br>updates, so be sure to setup it correctly.
<br>In most cases, you don't need this feature.
<br>
<br>ExtraSectionNameX is title of your personalized chart.
<br>ExtraSectionConditionalX are conditions on URL and/or QUERY_STRING and/or
<br> REFERER you can use to count or not the hit. Use "|" for "OR".
<br>ExtraSectionFirstColumnTitleX is the first column title of the chart.
<br>ExtraSectionFirstColumnValuesX is a Regex string to tell AWStats how to
<br> extract the value used for first column. Each different value found will
<br> be a different row. Be sure that list of different values is "limited" to
<br> avoid "not enough memory" problems !
<br>ExtraSectionFirstColumnFormatX is the string used to write value.
<br>ExtraSectionStatTypesX are things you want to count. You can use standard
<br> code letters (P for pages,H for hits,B for bandwidth,L for last access).
<br>ExtraSectionAddAverageRowX add a row at bottom of chart with average values.
<br>ExtraSectionAddSumRowX add a row at bottom of chart with sum values.
<br>MaxNbOfExtraX is maximum number of rows shown in chart.
<br>MinHitExtraX is minimum number of hits required to be shown in chart.
<br><br>
<b>You will find here examples of ExtraSection setup you can follow to build your own reports:</b>
<br>
<br>
<br><a name="productorders"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>Tracking Product orders</u></H2></a>
Image your web site is an e-store that sells 80 different products. Each of them has an id.
Each time, someone make an order for product 49, the order.cgi script is called with in URL
query parameter the id of the product, so you get in your log file a hit that looks like this:<br>
<i>GET /cgi-bin/order.cgi?productid=49&session=A0B1C2</i>
<br>
So this is an example on how to setup your ExtraSection, to track your product orders:<br>
<i>
ExtraSectionName1="Product orders"<br>
ExtraSectionCondition1="URL,/cgi-bin/order.cgi"<br>
ExtraSectionFirstColumnTitle1="Product ID"<br>
ExtraSectionFirstColumnValues1="QUERY_STRING,productid=([^&]+)"<br>
ExtraSectionFirstColumnFormat1="%s"<br>
ExtraSectionStatTypes1=PL<br>
ExtraSectionAddAverageRow1=0<br>
ExtraSectionAddSumRow1=1<br>
MaxNbOfExtra1=100<br>
MinHitExtra1=1<br>
</i>
<br>
<br>
<br><a name="bugzilla"><H2 style="font: 22px arial,helvetica,sanserif color: #606060"><u>Tracking Bugzilla most frequently viewed bugs</u></H2></a>
This is an example on how to setup your ExtraSection:<br>
<i>
ExtraSectionName1="Bugzilla: Most frequently viewed bugs"<br>
ExtraSectionCondition1="URL,/bugzilla/show_bug.cgi"<br>
ExtraSectionFirstColumnTitle1="Bug ID"<br>
ExtraSectionFirstColumnValues1="QUERY_STRING,id=([^&]+)"<br>
ExtraSectionFirstColumnFormat1="<a href='/bugzilla/show_bug.cgi?id=%s' target=new>%s</a>"<br>
ExtraSectionStatTypes1=PL<br>
ExtraSectionAddAverageRow=0<br>
ExtraSectionAddSumRow=1<br>
MaxNbOfExtra1=500<br>
MinHitExtra1=1<br>
</i>
<br>
<br>
<hr>
<script language=javascript>
var lastmod = new Date(document.lastModified);
if (lastmod.getDate() > 0) {
if (lastmod.getDate()<10) zerod="0"
else zerod="";
if (lastmod.getMonth()<9) zerom="0"
else zerom=""
year2kok=lastmod.getYear();
if (year2kok<100) year2kok+=2000;
if ((year2kok>=100) && (year2kok < 1970)) year2kok+=1900;
document.writeln("Last revision: "+year2kok+"-"+zerom+(lastmod.getMonth()+1)+"-"+zerod+lastmod.getDate());
}
</script>
</body>
</html>