worldwide open-source software

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Statdisplay Plugin ======

---- plugin ----
description: Отображает различные статистические данные и столбчатые диаграммы, рассчитанные с использованием файла журнала всех доступов к страницам DokuWiki.
author     : Andreas Gohr
email      : gohr@cosmocode.de
type       : syntax, CLI
lastupdate : 2022-12-12
compatible : Greebo, Hogfather, Igor
depends    : 
conflicts  : 
similar    : statistics, stats
tags       : statistics chart
downloadurl: https://github.com/cosmocode/dokuwiki-plugin-statdisplay/archive/master.zip
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-statdisplay
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-statdisplay/issues
donationurl: 
----

[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ https://www.cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]

Плагин statdisplay отображает различную статистику, вычисленную с использованием файла журнала (NCSA combined, т.е. как Apache) всех доступов к страницам DokuWiki. Файл журнала может быть прочитан из файла журнала Apache или, если он недоступен, сгенерирован с помощью плагина [[logstats]]. 

:!: Вся сгенерированная статистика использует только чистый PHP, а для рендеринга графиков необходимо расширение GD PHP . (Имейте в виду, что это конкретное расширение PHP может быть недоступно у вашего провайдера веб-хостинга.)

Примечание: это полная переработка плагина, изначально написанного [[jean-francois.lalande@ensi-bourges.fr|Jean-Françcois Lalande]]. Все ранее проанализированные данные будут проанализированы снова.

===== Установка =====

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] чтобы узнать, как установить плагины вручную.

===== Log Analysis =====

Once installed and configured through the Configuration Manager, it will automatically start to analyze the log file. To limit the time and memory consumption of the log analysis, this is done in chunks of a maximum number of lines per run. The log file analysis is triggered through DokuWiki's [[:taskrunner]] mechanism - there is no need to trigger anything manually.

Note: it is important to adjust the number of lines to analyze in the config through the lines parameter. If your wiki has many accesses, the default of 500 may be too low to effectively analyze your logs.

==== Command Line Interface ====

The command line interface allows you to quickly catch up with an existing log file. Run it like this in your DokuWiki directory:

    $> ./bin/plugin.php statdisplay parse --lines 4000

Increasing the number of lines analysed at once can increase the effectiveness when running from command line. When the parameter is not given the one from the config is used.

You can also use the CLI to completely reindex your log file (this throws away all previously analyzed data).

    $> ./bin/plugin.php statdisplay parse --clear --lines 4000


===== Limitations =====

The plugin tries to limit it's memory usage as far as possible. The log file is only read line-by-line. However all aggregated data is held inside a single memory structure. If you have a lot of accesses, or are running the plugin over a very long period of time, you may need to increase the memory size limit in your php.ini file.

==== Update frequency ====

The chunksize that is read is determined by the number in the configuration. This also determinates that the plugin waits for about this number of accesses before another chunk is read. You may want to raise this number for wikis with many active users or lower it for wikis with few active users.

===== Syntax =====

To show the result of the log analysis one or more syntax commands need to be used on a wiki page.

The general syntax asks for a command optionally followed by a ''graph'' parameter and/or ''month_year'' keyword after question mark. If no month is given, the current month is used. Below are all supported syntaxes shown, but not all graph/nograph month/nomonth combinations are shown.

If you want to see non-cached, most current data on the page, it is recommended to add a ''%%~~NOCACHE~~%%'' macro to the page.

==== Analysis Progress ====

Displays a simple progress bar to show how much of the log file was already analysed.

  {{statdisplay>progress bar}}

==== Access Summary ====

Gives a summary table over all accesses that were ever logged:

  {{statdisplay>all}}

{{ :plugin:statdisplay:2012-12-04-161900_649x177_scrot.png?nolink |}}

Get the summary as a line graph:

  {{statdisplay>all?graph}}

{{ :plugin:statdisplay:2012-12-04-161918_594x270_scrot.png?nolink |}}

Limit the graph to a time intervall:

  {{statdisplay>all?graph Jan_2011 Dec_2012}}

==== Month Overview ====

Give detailed summary table on the accesses during a month.

  {{statdisplay>one month}}

Limit the table to a specific month:

  {{statdisplay>one month?Oct_2011}}

{{ :plugin:statdisplay:2012-12-04-162802_349x567_scrot.png?nolink |}}

==== Daily Accesses ====

Show the accesses of each day in the current month:

  {{statdisplay>month by day}} 

{{ :plugin:statdisplay:2012-12-04-162902_584x619_scrot.png?nolink |}}

Show the daily accesses as graph:

  {{statdisplay>month by day?graph Oct_2011}}

{{ :plugin:statdisplay:2012-12-04-163549_579x249_scrot.png?nolink |}}

==== Hourly Accesses ====

Show how accesses were spread over the different times of the day during the month:

  {{statdisplay>month by hour}}

Graph of a particular month by hour:

  {{statdisplay>month by hour?graph Oct_2011}}

{{ :plugin:statdisplay:2012-12-04-163604_574x233_scrot.png?nolink |}}

==== Top Referrers ====

Show where people came from this month:

  {{statdisplay>top referers}} 

==== Top Entry-Pages ====

Show on which pages users arrived first this month:

  {{statdisplay>top entries}}

==== Top URLs ====

Show the most popular pages in your site this month:

  {{statdisplay>top urls}}

==== Top Browsers ====

Show the most used browsers this month:

  {{statdisplay>user agents}}


==== Traffic by User ====

This is a bit more special. It lists the authenticated users that created the most traffic on your site during the last 7 days:

  {{statdisplay>traffic by user}}

To show the top 10 users as a graph use this. The workday average is shown as a red line.

  {{statdisplay>traffic by user?graph}}

=====Дополнения и Файлы=====
  * [[gitea>VladPolskiy/dokuwiki-plugin-statdisplay/archive/master.zip|Загрузить]]
  * {{ :plugin:dokuwiki-plugin-statdisplay-master_1_.zip |}}
  * [[world>]][[https://www.dokuwiki.org/plugin:statdisplay|Ссылка на оригинальную статью]]