<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE lire:report-spec PUBLIC
  "-//LogReport.ORG//DTD Lire Report Specification Markup Language V2.0//EN"
  "http://www.logreport.org/LRSML/2.0/lrsml.dtd">
<lire:report-spec xmlns:lire="http://www.logreport.org/LRSML/"
 superservice="www" id="top-referers-by-page">

 <lire:title>Top Referring Pages By Requested Page WWW Report</lire:title>

 <lire:description>
  <para>This report shows the top referring pages for the top
   requested page.
  </para>
 </lire:description>

 <lire:param-spec>

  <lire:param name="page_to_show" type="int" default="10">
   <lire:description>
    <para>This parameter controls the number of requested pages to
     display.
    </para>
   </lire:description>
  </lire:param>

  <lire:param name="referer_to_show" type="int" default="5">
   <lire:description>
    <para>This parameter controls the number of referring pages to show
     for each requested page.
    </para>
   </lire:description>
  </lire:param>

  <lire:param name="not_page_re" type="string" default="(png|gif|jpg|css|jpeg)$">
   <lire:description>
    <para>This parameter contains a regular expression which is used
     to filter out images.
    </para>
   </lire:description>
  </lire:param>

  <lire:param name="referer_exclusion" type="string" default="^-$">
   <lire:description>
    <para>This parameter can be used to exclude referers from the
     report. For example, it can be used to exclude internal links by
     setting it to "^http://www.yourdomain.com/$". It defaults to
     "^-$" which excludes all records for which the referer wasn't
     specified.
    </para>
   </lire:description>
  </lire:param>

 </lire:param-spec>

 <lire:display-spec>
  <lire:title>Top Referring Pages By Requested Page, Top
  $referer_to_show Referrers, Top
  $page_to_show Pages</lire:title>
 </lire:display-spec>

 <lire:filter-spec>
  <lire:and>
   <lire:not>
    <lire:match value="$requested_page" re="$not_page_re"
     case-sensitive="0"/>
   </lire:not>
   <lire:not>
    <lire:match case-sensitive="no" value="$referer"
     re="$referer_exclusion"/>
   </lire:not>
  </lire:and>   
 </lire:filter-spec>

 <lire:report-calc-spec>
  <lire:group sort="-requests_total" limit="$page_to_show">
   <lire:field name="requested_page"/>

   <lire:group sort="-requests_total" limit="$referer_to_show">
    <lire:field name="referer"/>

    <lire:count name="requests_total" label="Requests"/>
    <lire:count name="requests_ratio" ratio="table" label="% Total"/>
    <lire:count name="requets_group_ratio" ratio="group" label="% Group"/>
   </lire:group>

  </lire:group>

 </lire:report-calc-spec>

</lire:report-spec>

<!-- 
Keep this comment at the end of the file
Local variables:
mode: xml
-->
