====== Logger Plugin ======

---- plugin ----
description: This plugin logs every request into a CSV file
author     : Jens Brokfeld
email      : geofreak.de@gmail.com
type       : action
lastupdate : 2021-01-10
compatible : Binky, Ponder Stibbons, Hrun, Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather
depends    : 
conflicts  : 
similar    : 
tags       : logging

downloadurl: https://github.com/brokfeld/dokuwiki-plugin-logger/archive/master.zip
bugtracker : https://github.com/brokfeld/dokuwiki-plugin-logger/issues
sourcerepo : https://github.com/brokfeld/dokuwiki-plugin-logger/
donationurl: 

screenshot_img : 

----

===== Description =====

This plugin logs every request of DokuWiki. It logs the date, time, ip, username, pc name, query string and user agent.

===== Usage =====

Install and activate the plugin and it will be logging every request.

All logs will be written to the following CSV file:
<code>
dokuwiki/data/media/admin/logs/<CURRENT_YEAR>.csv
</code>

**For example:** \\
You can download the CSV file of the year 2021 with the following query string:
<code>
dokuwiki/lib/exe/fetch.php?media=admin:logs:2021.csv
</code>

You can link the CSV file into a page with the following syntax:
<code>
{{:admin:logs:2021.csv|}}
</code>

:!: Finally, you have to restrict access of the namespace "admin". :!:

===== Settings =====

You can exclude some namespaces from logging.

Insert a semicolon separated list of all namespaces into the field ''plugin»logger»ns_exclude'' like:
  tasks:john:;admin:;bugs:


===== Installation =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.