CINXE.COM

<!DOCTYPE html> <html lang="en" dir="ltr" class="no-js"> <head> <meta charset="utf-8" /> <title>plugin:logstats [DokuWiki]</title> <meta name="generator" content="DokuWiki"/> <meta name="theme-color" content="#008800"/> <meta name="robots" content="index,follow"/> <meta name="keywords" content="plugin,logstats"/> <link rel="search" type="application/opensearchdescription+xml" href="/lib/exe/opensearch.php" title="DokuWiki"/> <link rel="start" href="/"/> <link rel="contents" href="/plugin:logstats?do=index" title="Sitemap"/> <link rel="manifest" href="/lib/exe/manifest.php"/> <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/feed.php"/> <link rel="alternate" type="application/rss+xml" title="Current namespace" href="/feed.php?mode=list&ns=plugin"/> <link rel="edit" title="Edit this page" href="/plugin:logstats?do=edit"/> <link rel="alternate" type="text/html" title="Plain HTML" href="/_export/xhtml/plugin:logstats"/> <link rel="alternate" type="text/plain" title="Wiki Markup" href="/_export/raw/plugin:logstats"/> <link rel="canonical" href="https://www.dokuwiki.org/plugin:logstats"/> <link rel="stylesheet" href="/lib/exe/css.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e"/> <script >var NS='plugin';var JSINFO = {"plugins":{"edittable":{"default columnwidth":""}},"id":"plugin:logstats","namespace":"plugin","ACT":"show","useHeadingNavigation":0,"useHeadingContent":0};(function(H){H.className=H.className.replace(/\bno-js\b/,'js')})(document.documentElement);</script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.4/jquery.min.js" defer="defer"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.13.2/jquery-ui.min.js" defer="defer"></script> <script src="/lib/exe/js.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e&lang=en" defer="defer"></script> <meta name="viewport" content="width=device-width,initial-scale=1" /> <link rel="shortcut icon" href="/lib/tpl/dokuwiki/images/favicon.ico" /> <link rel="apple-touch-icon" href="/lib/tpl/dokuwiki/images/apple-touch-icon.png" /> <meta name="verify-v1" content="OVxl3gsCv2MhZqh1cBQyl0JytWXSwXMjyvwc+4w3WtA=" /> <meta name="google-site-verification" content="YhTVK69hW94ZXUtc2zSLPxTkZKbZIn0zK67mz5WQB-E" />  <script async src="https://www.googletagmanager.com/gtag/js?id=UA-83791-1"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-83791-1', { 'anonymize_ip': true }); </script> </head> <body> <div id="dokuwiki__site"><div id="dokuwiki__top" class="site dokuwiki mode_show tpl_dokuwiki showSidebar hasSidebar">  <header id="dokuwiki__header"><div class="pad group"> <div class="headings group"> <ul class="a11y skip"> <li><a href="#dokuwiki__content">skip to content</a></li> </ul> <h1 class="logo"><a href="/start" accesskey="h" title="Home [h]"><img src="/lib/tpl/dokuwiki/images/logo.png" width="64" height="64" alt="" /><span>DokuWiki</span></a></h1> <p class="claim">It's better when it's simple</p> </div> <div class="tools group">  <div id="dokuwiki__usertools"> <h3 class="a11y">User Tools</h3> <ul> <li class="action login"><a href="/plugin:logstats?do=login&sectok=" title="Log In" rel="nofollow"><span>Log In</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M10 17.25V14H3v-4h7V6.75L15.25 12 10 17.25M8 2h9a2 2 0 0 1 2 2v16a2 2 0 0 1-2 2H8a2 2 0 0 1-2-2v-4h2v4h9V4H8v4H6V4a2 2 0 0 1 2-2z"/></svg></a></li> </ul> </div>  <div id="dokuwiki__sitetools"> <h3 class="a11y">Site Tools</h3> <form action="/start" method="get" role="search" class="search doku_form" id="dw__search" accept-charset="utf-8"><input type="hidden" name="do" value="search" /><input type="hidden" name="id" value="plugin:logstats" /><div class="no"><input name="q" type="text" class="edit" title="[F]" accesskey="f" placeholder="Search" autocomplete="on" id="qsearch__in" value="" /><button value="1" type="submit" title="Search">Search</button><div id="qsearch__out" class="ajax_qsearch JSpopup"></div></div></form> <div class="mobileTools"> <form action="/doku.php" method="get" accept-charset="utf-8"><div class="no"><input type="hidden" name="id" value="plugin:logstats" /><select name="do" class="edit quickselect" title="Tools"><option value="">Tools</option><optgroup label="Page Tools"><option value="edit">Edit this page</option><option value="revisions">Old revisions</option><option value="backlink">Backlinks</option></optgroup><optgroup label="Site Tools"><option value="recent">Recent Changes</option><option value="media">Media Manager</option><option value="index">Sitemap</option></optgroup><optgroup label="User Tools"><option value="login">Log In</option></optgroup></select><button type="submit">></button></div></form> </div> <ul> <li class="action recent"><a href="/plugin:logstats?do=recent" title="Recent Changes [r]" rel="nofollow" accesskey="r">Recent Changes</a></li><li class="action media"><a href="/plugin:logstats?do=media&ns=plugin" title="Media Manager" rel="nofollow">Media Manager</a></li><li class="action index"><a href="/plugin:logstats?do=index" title="Sitemap [x]" rel="nofollow" accesskey="x">Sitemap</a></li> </ul> </div> </div>  <div class="breadcrumbs"> <div class="trace"><span class="bchead">Trace:</span> <span class="bcsep">•</span> <span class="curid"><bdi><a href="/plugin:logstats" class="breadcrumbs" title="plugin:logstats">logstats</a></bdi></span></div> </div> <hr class="a11y" /> </div></header> <div class="wrapper group">  <nav id="dokuwiki__aside" aria-label="Sidebar"><div class="pad aside include group"> <h3 class="toggle">Sidebar</h3> <div class="content"><div class="group"> <p> <strong>Learn about DokuWiki</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/features" class="wikilink1" title="features" data-wiki-id="features">Features</a> & <a href="/blogroll" class="wikilink1" title="blogroll" data-wiki-id="blogroll">reviews</a> </div> </li> <li class="level1"><div class="li"> <a href="/install" class="wikilink1" title="install" data-wiki-id="install">Installation guide</a></div> </li> <li class="level1"><div class="li"> <a href="/manual" class="wikilink1" title="manual" data-wiki-id="manual">User manual</a> & <a href="/wiki:syntax" class="wikilink1" title="wiki:syntax" data-wiki-id="wiki:syntax">syntax</a></div> </li> <li class="level1"><div class="li"> <a href="/changes" class="wikilink1" title="changes" data-wiki-id="changes">Release notes</a></div> </li> <li class="level1"><div class="li"> <a href="/faq" class="wikilink1" title="faq" data-wiki-id="faq">FAQ</a></div> </li> </ul> <p> <strong>Advanced Use</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/extensions" class="wikilink1" title="extensions" data-wiki-id="extensions">Extensions</a></div> </li> <li class="level1"><div class="li"> <a href="/development" class="wikilink1" title="development" data-wiki-id="development">Development manual</a></div> </li> </ul> <p> <strong>Corporate Use</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/faq:support" class="wikilink1" title="faq:support" data-wiki-id="faq:support">Get support</a></div> </li> <li class="level1"><div class="li"> <a href="/donate" class="wikilink1" title="donate" data-wiki-id="donate">Donations</a></div> </li> </ul> <p> <strong>Our Community</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/teams:getting_involved" class="wikilink1" title="teams:getting_involved" data-wiki-id="teams:getting_involved">Get involved</a></div> </li> <li class="level1"><div class="li"> <a href="/dokuinstall" class="wikilink1" title="dokuinstall" data-wiki-id="dokuinstall">Users</a></div> </li> <li class="level1"><div class="li"> <a href="http://forum.dokuwiki.org" class="urlextern" title="http://forum.dokuwiki.org">User forum</a></div> </li> <li class="level1"><div class="li"> <a href="/mailinglist" class="wikilink1" title="mailinglist" data-wiki-id="mailinglist">Development mailinglist</a></div> </li> </ul> <hr /> <p> Follow us on <a href="https://phpc.social/@dokuwiki" class="urlextern" title="https://phpc.social/@dokuwiki">Mastodon</a> and other <a href="/social" class="wikilink1" title="social" data-wiki-id="social">social networks</a>. </p> <p> <a href="/privacy" class="wikilink1" title="privacy" data-wiki-id="privacy">Our Privacy Policy</a> </p> </div></div> </div></nav>  <main id="dokuwiki__content"><div class="pad group"> <div class="pageId"><span>plugin:logstats</span></div> <div class="page group">   <div id="dw__toc" class="dw__toc"> <h3 class="toggle">Table of Contents</h3> <div> <ul class="toc"> <li class="level1"><div class="li"><a href="#log_statistics_plugin">Log Statistics Plugin</a></div> <ul class="toc"> <li class="level2"><div class="li"><a href="#installation">Installation</a></div> <ul class="toc"> <li class="level3"><div class="li"><a href="#changes">Changes</a></div></li> </ul> </li> <li class="level2"><div class="li"><a href="#configuration_and_settings">Configuration and Settings</a></div> <ul class="toc"> <li class="level3"><div class="li"><a href="#log_file_location">Log File Location</a></div></li> <li class="level3"><div class="li"><a href="#banned_ips">Banned IPs</a></div></li> <li class="level3"><div class="li"><a href="#banned_users">Banned Users</a></div></li> <li class="level3"><div class="li"><a href="#banned_user_agents_for_bots">Banned User Agents (for bots)</a></div></li> </ul> </li> <li class="level2"><div class="li"><a href="#known_limitations">Known Limitations</a></div> <ul class="toc"> <li class="level3"><div class="li"><a href="#problem_when_log_file_increases_above_64_mb">Problem when log file increases above 64 MB:</a></div></li> </ul> </li> <li class="level2"><div class="li"><a href="#suggestions">Suggestions</a></div></li> </ul></li> </ul> </div> </div>  <h1 class="sectionedit1" id="log_statistics_plugin">Log Statistics Plugin</h1> <div class="level1"> <div class="pluginrepo_entry"><div class="usageInfo"><div class="compatibility"><p class="label">Compatible with DokuWiki</p><div class="versions"><ul><li class="yes">2024-02-06 "Kaos" <strong><span>yes</span></strong></li><li class="">2023-04-04 "Jack Jackrum" <strong><span>unknown</span></strong></li><li class="yes">2022-07-31 "Igor" <strong><span>yes</span></strong></li><li class="">2020-07-29 "Hogfather" <strong><span>unknown</span></strong></li></ul></div></div><ul class="actions"><li><a class="download" href="https://github.com/cosmocode/dokuwiki-plugin-logstats/zipball/master">Download</a></li><li><a class="bugs" href="https://github.com/cosmocode/dokuwiki-plugin-logstats/issues">Report bugs</a></li></ul><div class="clearer"></div></div><div class="mainInfo"><p class="description"><a class="media" href="/plugins"><img alt="plugin" class="medialeft" src="/lib/plugins/pluginrepo/images/dwplugin.png" width="60" height="60" /></a> This plugin provides a log file (NCSA combined i.e. like Apache) of all access to DokuWiki pages</p></div><div class="metaInfo"><dl><dt>Last updated on</dt><dd>2016-07-06</dd><dt>Provides</dt><dd><a href="/plugins?plugintype=4#extension__table" class="wikilink1" title="List all Action plugins">Action</a></dd><dt>Repository</dt><dd><a class="urlextern" href="https://github.com/cosmocode/dokuwiki-plugin-logstats/">Source</a></dd></dl></div><div class="moreInfo"><p class="similar">Similar to <a href="/plugin:directions" class="wikilink1" title="plugin:directions" data-wiki-id="plugin:directions">directions</a>, <a href="/plugin:statistics" class="wikilink1" title="plugin:statistics" data-wiki-id="plugin:statistics">statistics</a></p><p class="tags">Tagged with <a href="/plugins?plugintag=logging#extension__table" class="wikilink1" title="List all plugins with this tag">logging</a>, <a href="/plugins?plugintag=statistics#extension__table" class="wikilink1" title="List all plugins with this tag">statistics</a></p></div><div class="authorInfo"><strong>By <a href="mailto:dokuwiki%20%5Bat%5D%20cosmocode%20%5Bdot%5D%20de" class="mail" title="dokuwiki [at] cosmocode [dot] de">Andreas Gohr</a></strong><ul><li><a href="/plugin:csv" class="wikilink1" title="plugin:csv" data-wiki-id="plugin:csv">csv</a></li> <li><a href="/plugin:clearhistory" class="wikilink1" title="plugin:clearhistory" data-wiki-id="plugin:clearhistory">clearhistory</a></li> <li><a href="/plugin:preview" class="wikilink1" title="plugin:preview" data-wiki-id="plugin:preview">preview</a></li> <li><a href="/plugin:explain" class="wikilink1" title="plugin:explain" data-wiki-id="plugin:explain">explain</a></li> <li><a href="/plugin:oiddelegate" class="wikilink1" title="plugin:oiddelegate" data-wiki-id="plugin:oiddelegate">oiddelegate</a></li> <li><a href="/plugin:labeled" class="wikilink1" title="plugin:labeled" data-wiki-id="plugin:labeled">labeled</a></li> <li><a href="/plugin:slider" class="wikilink1" title="plugin:slider" data-wiki-id="plugin:slider">slider</a></li> <li><a href="/plugin:groupusers" class="wikilink1" title="plugin:groupusers" data-wiki-id="plugin:groupusers">groupusers</a></li> <li><a href="/plugin:navi" class="wikilink1" title="plugin:navi" data-wiki-id="plugin:navi">navi</a></li> <li><a href="/plugin:aclinfo" class="wikilink1" title="plugin:aclinfo" data-wiki-id="plugin:aclinfo">aclinfo</a></li> <li>and 126 more</li></ul></div></div> <p> This plugin was initially written by <a href="mailto:jean%20%5Bdash%5D%20francois%20%5Bdot%5D%20lalande%20%5Bat%5D%20ensi%20%5Bdash%5D%20bourges%20%5Bdot%5D%20fr" class="mail" title="jean [dash] francois [dot] lalande [at] ensi [dash] bourges [dot] fr">Jean-François Lalande</a> based on some <a href="/tips:logging" class="wikilink1" title="tips:logging" data-wiki-id="tips:logging">code</a> by Matthias Grimm. </p> <p> The logstats plugin provides a log file (NCSA combined i.e. like apache) of all accesses to DokuWiki pages and media files. This way this file can be used to generate various statistics about the dokuwiki's usage. </p> <p> The logfile can be analyzed using popular web analytics software or within DokuWiki through the <a href="/plugin:statdisplay" class="wikilink1" title="plugin:statdisplay" data-wiki-id="plugin:statdisplay">statdisplay plugin</a>. </p> <p> <a href="https://www.cosmocode.de/en/open-source/dokuwiki-plugins/" class="media" title="https://www.cosmocode.de/en/open-source/dokuwiki-plugins/"><img src="/lib/exe/fetch.php?cache=recache&tok=a307b5&media=https%3A%2F%2Fwww.cosmocode.de%2Fstatic%2Fimg%2Fdokuwiki%2Fdwplugins.png" class="mediaright" loading="lazy" title="A CosmoCode Plugin" alt="A CosmoCode Plugin" /></a> </p> </div> <div class="secedit editbutton_section editbutton_1"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Log Statistics Plugin] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="log_statistics_plugin" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1-1355" /><button type="submit" title="Log Statistics Plugin">Edit</button></div></form></div> <h2 class="sectionedit2" id="installation">Installation</h2> <div class="level2"> <p> Search and install the plugin using the <a href="/plugin:extension" class="wikilink1" title="plugin:extension" data-wiki-id="plugin:extension">Extension Manager</a>. Refer to <a href="/plugins" class="wikilink1" title="plugins" data-wiki-id="plugins">Plugins</a> on how to install plugins manually. </p> </div> <div class="secedit editbutton_section editbutton_2"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Installation] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="installation" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1356-1520" /><button type="submit" title="Installation">Edit</button></div></form></div> <h3 class="sectionedit3" id="changes">Changes</h3> <div class="level3"> <ul class="rss"><li><div class="li"><a href="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/3a717b43f3a59d3297b23f3e8392822d66200f31" class="urlextern" title="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/3a717b43f3a59d3297b23f3e8392822d66200f31">Merge pull request #12 from dokuwiki-translate/lang_update_33</a> (2025-03-25 08:41)</div></li><li><div class="li"><a href="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/b239c21eefcc0053268cef7236deebe4b577545c" class="urlextern" title="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/b239c21eefcc0053268cef7236deebe4b577545c">Merge pull request #26 from dokuwiki-translate/lang_update_565_167682…</a> (2025-03-25 08:37)</div></li><li><div class="li"><a href="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/b094c17f35d5de3fe04b8ec1151f44b8bfb23013" class="urlextern" title="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/b094c17f35d5de3fe04b8ec1151f44b8bfb23013">translation update</a> (2023-02-19 16:40)</div></li><li><div class="li"><a href="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/b3c529f89c3ba809f34c978a284cf30b50973c4d" class="urlextern" title="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/b3c529f89c3ba809f34c978a284cf30b50973c4d">Merge pull request #24 from dokuwiki-translate/lang_update_135_160062…</a> (2020-09-21 10:45)</div></li><li><div class="li"><a href="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/3707fddcd9a2731db1443ace82afd7be610436bc" class="urlextern" title="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/3707fddcd9a2731db1443ace82afd7be610436bc">translation update</a> (2020-09-20 19:15)</div></li><li><div class="li"><a href="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/18b8b0abc425b9c05f7b5c80eab2df75a251a230" class="urlextern" title="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/18b8b0abc425b9c05f7b5c80eab2df75a251a230">Merge pull request #23 from dokuwiki-translate/lang_update_45_1590184941</a> (2020-09-02 21:24)</div></li><li><div class="li"><a href="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/917ba79473ad788fb6649fd5b34f82d8af242984" class="urlextern" title="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/917ba79473ad788fb6649fd5b34f82d8af242984">translation update</a> (2020-05-23 00:05)</div></li><li><div class="li"><a href="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/4510efbfa814931b600ced1954227b5fb5c035d0" class="urlextern" title="https://github.com/cosmocode/dokuwiki-plugin-logstats/commit/4510efbfa814931b600ced1954227b5fb5c035d0">Merge pull request #22 from dokuwiki-translate/lang_update_1184_15513…</a> (2019-02-28 16:25)</div></li></ul> </div> <div class="secedit editbutton_section editbutton_3"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Changes] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="changes" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1521-1627" /><button type="submit" title="Changes">Edit</button></div></form></div> <h2 class="sectionedit4" id="configuration_and_settings">Configuration and Settings</h2> <div class="level2"> <p> The configuration of this plugin can be managed directly in DokuWiki (see Configuration link in admin interface).<br/> For others parameters edit the file lib/plugins/logstats/conf/dafault.php </p> </div> <div class="secedit editbutton_section editbutton_4"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Configuration and Settings] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="configuration_and_settings" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1628-1858" /><button type="submit" title="Configuration and Settings">Edit</button></div></form></div> <h3 class="sectionedit5" id="log_file_location">Log File Location</h3> <div class="level3"> <p> You can change the filename of the log file using the <code>$conf['plugin']['logstats']['accesslog']</code> variable. When a relative file name is given (which is by default), it is relative to the <code>data/meta/</code> directory. </p> <pre class="code php"><span class="re0">$conf</span><span class="br0">[</span><span class="st_h">'plugin'</span><span class="br0">]</span><span class="br0">[</span><span class="st_h">'logstats'</span><span class="br0">]</span><span class="br0">[</span><span class="st_h">'accesslog'</span><span class="br0">]</span> <span class="sy0">=</span> <span class="st0">"access.log"</span><span class="sy0">;</span></pre> </div> <div class="secedit editbutton_section editbutton_5"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Log File Location] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="log_file_location" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1859-2180" /><button type="submit" title="Log File Location">Edit</button></div></form></div> <h3 class="sectionedit6" id="banned_ips">Banned IPs</h3> <div class="level3"> <p> You can ban some IP from being logged (for example your own IP). To do this, use the variable <code>$conf['plugin']['logstats']['banned_ip']</code> which is a string containing all the banned IP addresses, separated by a comma. </p> <pre class="code php"><span class="re0">$conf</span><span class="br0">[</span><span class="st_h">'plugin'</span><span class="br0">]</span><span class="br0">[</span><span class="st_h">'logstats'</span><span class="br0">]</span><span class="br0">[</span><span class="st_h">'banned_ip'</span><span class="br0">]</span> <span class="sy0">=</span> <span class="st0">"127.0.0.1,192.168.0.1,192.168.0.2"</span><span class="sy0">;</span></pre> </div> <div class="secedit editbutton_section editbutton_6"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Banned IPs] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="banned_ips" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="2181-2523" /><button type="submit" title="Banned IPs">Edit</button></div></form></div> <h3 class="sectionedit7" id="banned_users">Banned Users</h3> <div class="level3"> <p> You can ban some users (logged into DokuWiki) from being logged. To do this, use the variable <code>$conf['plugin']['logstats']['banned_users']</code> which is a string containing all the banned users, separated by a comma. </p> <pre class="code php"><span class="re0">$conf</span><span class="br0">[</span><span class="st_h">'plugin'</span><span class="br0">]</span><span class="br0">[</span><span class="st_h">'logstats'</span><span class="br0">]</span><span class="br0">[</span><span class="st_h">'banned_users'</span><span class="br0">]</span> <span class="sy0">=</span> <span class="st0">"bob,alice,gugu"</span><span class="sy0">;</span></pre> </div> <div class="secedit editbutton_section editbutton_7"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Banned Users] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="banned_users" /><input type="hidden" name="codeblockOffset" value="2" /><input type="hidden" name="range" value="2524-2847" /><button type="submit" title="Banned Users">Edit</button></div></form></div> <h3 class="sectionedit8" id="banned_user_agents_for_bots">Banned User Agents (for bots)</h3> <div class="level3"> <p> You can ban some user agents. It useful for bots agents like google bot. To do this, use the variable <code>$conf['plugin']['logstats']['banned_agents']</code> which is a string containing all the banned agent strings, separated by a comma. </p> <pre class="code php"><span class="re0">$conf</span><span class="br0">[</span><span class="st_h">'plugin'</span><span class="br0">]</span><span class="br0">[</span><span class="st_h">'logstats'</span><span class="br0">]</span><span class="br0">[</span><span class="st_h">'banned_agents'</span><span class="br0">]</span> <span class="sy0">=</span> <span class="st0">"Googlebot,HooWWWer"</span><span class="sy0">;</span></pre> </div> <div class="secedit editbutton_section editbutton_8"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Banned User Agents (for bots)] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="banned_user_agents_for_bots" /><input type="hidden" name="codeblockOffset" value="3" /><input type="hidden" name="range" value="2848-3210" /><button type="submit" title="Banned User Agents (for bots)">Edit</button></div></form></div> <h2 class="sectionedit9" id="known_limitations">Known Limitations</h2> <div class="level2"> <p> Unlike your webserver, this plugin will not log any accesses to DokuWiki's own files (<abbr title="Cascading Style Sheets">CSS</abbr>, images, scripts, etc). Only content, that means wiki pages and media files are logged. </p> <p> Logging might have some slight impact on the performance as each request will create a disk write. </p> </div> <div class="secedit editbutton_section editbutton_9"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Known Limitations] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="known_limitations" /><input type="hidden" name="codeblockOffset" value="4" /><input type="hidden" name="range" value="3211-3520" /><button type="submit" title="Known Limitations">Edit</button></div></form></div> <h3 class="sectionedit10" id="problem_when_log_file_increases_above_64_mb">Problem when log file increases above 64 MB:</h3> <div class="level3"> <p> If the size to access.log file is bigger than 64 <abbr title="Megabyte">MB</abbr>, the following message was printed in the server log and dokuwiki was out of service: </p> <pre class="code">FastCGI: "...doku.php" aborted: incomplete headers (0 bytes) received from server after 4 sec</pre> <p> My dokuwiki is hosted by strato (“PowerWeb Basic” Packet). I have no chance to change anything in the php configuration. I've spent a lot of time trying to figure out what the problem was. It would be nice to have a better error indication, or even better, to add a file limitation field to the plugin configuration and to archive the file once the size limit is reached. </p> </div> <div class="secedit editbutton_section editbutton_10"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Problem when log file increases above 64 MB:] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="problem_when_log_file_increases_above_64_mb" /><input type="hidden" name="codeblockOffset" value="4" /><input type="hidden" name="range" value="3521-4196" /><button type="submit" title="Problem when log file increases above 64 MB:">Edit</button></div></form></div> <h2 class="sectionedit11" id="suggestions">Suggestions</h2> <div class="level2"> <p> Is it possible to perform the tool with annual logs file ? eg. </p> <pre class="code php"><span class="re0">$conf</span><span class="br0">[</span><span class="st_h">'plugin'</span><span class="br0">]</span><span class="br0">[</span><span class="st_h">'logstats'</span><span class="br0">]</span><span class="br0">[</span><span class="st_h">'accesslog'</span><span class="br0">]</span> <span class="sy0">=</span> <span class="st0">"access.log"</span><span class="sy0">;</span></pre> <p> could create <code>2014.access.log</code> if the current year is 2014, <code>2015.access.log</code> if the current year is 2015 </p> </div> <div class="secedit editbutton_section editbutton_11"><form class="button btn_secedit" method="post" action="/plugin:logstats"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1720528047" /><input type="hidden" name="summary" value="[Suggestions] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="suggestions" /><input type="hidden" name="codeblockOffset" value="5" /><input type="hidden" name="range" value="4197-" /><button type="submit" title="Suggestions">Edit</button></div></form></div>  </div> <div class="docInfo"><bdi>plugin/logstats.txt</bdi> · Last modified: <time datetime="2024-07-09T14:27:27+0200">2024-07-09 14:27</time> by <bdi>hillschmidt</bdi></div> <hr class="a11y" /> </div></main>  <nav id="dokuwiki__pagetools" aria-labelledby="dokuwiki__pagetools__heading"> <h3 class="a11y" id="dokuwiki__pagetools__heading">Page Tools</h3> <div class="tools"> <ul> <li class="edit"><a href="/plugin:logstats?do=edit" title="Edit this page [e]" rel="nofollow" accesskey="e"><span>Edit this page</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25z"/></svg></a></li><li class="revs"><a href="/plugin:logstats?do=revisions" title="Old revisions [o]" rel="nofollow" accesskey="o"><span>Old revisions</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M11 7v5.11l4.71 2.79.79-1.28-4-2.37V7m0-5C8.97 2 5.91 3.92 4.27 6.77L2 4.5V11h6.5L5.75 8.25C6.96 5.73 9.5 4 12.5 4a7.5 7.5 0 0 1 7.5 7.5 7.5 7.5 0 0 1-7.5 7.5c-3.27 0-6.03-2.09-7.06-5h-2.1c1.1 4.03 4.77 7 9.16 7 5.24 0 9.5-4.25 9.5-9.5A9.5 9.5 0 0 0 12.5 2z"/></svg></a></li><li class="backlink"><a href="/plugin:logstats?do=backlink" title="Backlinks" rel="nofollow"><span>Backlinks</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M10.59 13.41c.41.39.41 1.03 0 1.42-.39.39-1.03.39-1.42 0a5.003 5.003 0 0 1 0-7.07l3.54-3.54a5.003 5.003 0 0 1 7.07 0 5.003 5.003 0 0 1 0 7.07l-1.49 1.49c.01-.82-.12-1.64-.4-2.42l.47-.48a2.982 2.982 0 0 0 0-4.24 2.982 2.982 0 0 0-4.24 0l-3.53 3.53a2.982 2.982 0 0 0 0 4.24m2.82-4.24c.39-.39 1.03-.39 1.42 0a5.003 5.003 0 0 1 0 7.07l-3.54 3.54a5.003 5.003 0 0 1-7.07 0 5.003 5.003 0 0 1 0-7.07l1.49-1.49c-.01.82.12 1.64.4 2.43l-.47.47a2.982 2.982 0 0 0 0 4.24 2.982 2.982 0 0 0 4.24 0l3.53-3.53a2.982 2.982 0 0 0 0-4.24.973.973 0 0 1 0-1.42z"/></svg></a></li><li class="top"><a href="#dokuwiki__top" title="Back to top [t]" rel="nofollow" accesskey="t"><span>Back to top</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"/></svg></a></li> </ul> </div> </nav> </div>  <footer id="dokuwiki__footer"><div class="pad"> <div class="license">Except where otherwise noted, content on this wiki is licensed under the following license: <bdi><a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en" rel="license" class="urlextern">CC Attribution-Share Alike 4.0 International</a></bdi></div> <div class="buttons"> <a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en" rel="license"><img src="/lib/images/license/button/cc-by-sa.png" alt="CC Attribution-Share Alike 4.0 International" /></a> <a href="https://www.dokuwiki.org/donate" title="Donate" ><img src="/lib/tpl/dokuwiki/images/button-donate.gif" width="80" height="15" alt="Donate" /></a> <a href="https://php.net" title="Powered by PHP" ><img src="/lib/tpl/dokuwiki/images/button-php.gif" width="80" height="15" alt="Powered by PHP" /></a> <a href="//validator.w3.org/check/referer" title="Valid HTML5" ><img src="/lib/tpl/dokuwiki/images/button-html5.png" width="80" height="15" alt="Valid HTML5" /></a> <a href="//jigsaw.w3.org/css-validator/check/referer?profile=css3" title="Valid CSS" ><img src="/lib/tpl/dokuwiki/images/button-css.png" width="80" height="15" alt="Valid CSS" /></a> <a href="https://dokuwiki.org/" title="Driven by DokuWiki" ><img src="/lib/tpl/dokuwiki/images/button-dw.png" width="80" height="15" alt="Driven by DokuWiki" /></a> </div> <div style="margin-top: 2em; font-size:90%" class="dokuwiki"><div style="float:right"><a href="http://www.splitbrain.org/personal#imprint" style="float:right; text-decoration: none; color:#333">Imprint</a></div></div> <style type="text/css"> @media screen { body { padding-top: 30px; } #global__header { position: absolute; top: 0; left: 0; text-align: left; vertical-align: middle; line-height: 1.5; background-color: #333; box-shadow: 0 0 8px rgba(0,0,0,0.5); width: 100%; margin: 0; padding: 5px 20px; -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; white-space: nowrap; overflow: hidden; } #global__header h2 { position: absolute; left: -99999em; top: 0; overflow: hidden; display: inline; } #global__header ul, #global__header li { margin: 0; padding: 0; list-style: none; display: inline; line-height: 1.5; } #global__header a { color: #bbb; text-decoration: none; margin-right: 20px; font-size: 14px; font-weight: normal; } #global__header a:hover, #global__header a:active, #global__header a:focus { color: #fff; text-decoration: underline; } #global__header form { float: right; margin: 0 0 0 20px; } #global__header input { background-color: #333; background-image: none; border: 1px solid #bbb; color: #fff; box-shadow: none; border-radius: 2px; margin: 0; line-height: normal; padding: 1px 0 1px 0; height: auto; } #global__header input.button { border: none; color: #bbb; } #global__header input.button:hover, #global__header input.button:active, #global__header input.button:focus { color: #fff; text-decoration: underline; } } /* /@media */ @media only screen and (min-width: 601px) { /* changes specific for www.dokuwiki.org */ #dokuwiki__header { padding-top: 3em; } #dokuwiki__usertools { top: 3em; } /* changes specific for bugs.dokuwiki.org */ div#container div#showtask { top: 40px; } } /* /@media */ @media only screen and (max-width: 600px) { body { padding-top: 0; } #global__header { position: static; white-space: normal; overflow: auto; } #global__header form { float: none; display: block; margin: 0 0 .4em; } } /* /@media */ @media print { #global__header { display: none; } } /* /@media */ </style> <div id="global__header"> <h2>Global DokuWiki Links</h2> <form method="get" action="https://search.dokuwiki.org/" target="_top"> <input type="text" name="q" title="Search all DokuWiki sites at once" class="input" /> <input type="submit" title="Search all DokuWiki sites at once" value="Search" class="button" /> </form> <ul> <li><a href="https://download.dokuwiki.org" title="Download the latest release" target="_top">Download</a></li> <li><a href="https://www.dokuwiki.org" title="Read the DokuWiki documentation" target="_top">Wiki</a></li> <li><a href="https://forum.dokuwiki.org" title="Ask questions in the DokuWiki forum" target="_top">Forum</a></li> <li><a href="https://irc.dokuwiki.org" title="Check IRC chat logs or join the chat" target="_top">IRC</a></li> <li><a href="https://github.com/splitbrain/dokuwiki/issues" title="Report and track bugs" target="_top">Bugs</a></li> <li><a href="https://translate.dokuwiki.org/" title="Help translating the DokuWiki interface" target="_top">Translate</a></li> <li><a href="https://github.com/splitbrain/dokuwiki" title="Access the most recent git commits" target="_top">Git</a></li> <li><a href="https://xref.dokuwiki.org/reference/dokuwiki/" title="Cross-Reference of the DokuWiki source code" target="_top">XRef</a></li> <li><a href="https://codesearch.dokuwiki.org/" title="Search through the sources of DokuWiki, plugins and templates" target="_top">Code Search</a></li> </ul> </div>  </div></footer> </div></div> <div class="no"><img src="/lib/exe/taskrunner.php?id=plugin%3Alogstats&1742991362" width="2" height="1" alt="" /></div> <div id="screen__mode" class="no"></div></body> </html>