This is an old revision of the document!
Table of Contents
Access Counter and Popularity Plugin
Compatible with DokuWiki
Greebo, 2018-04-22
Export the number of those who visited a specified page in your wiki today, yesterday, or in whole period. You can also show the list of the popularity according to the log data taken by the plugin. This plugin is ported from those of PukiWiki (with som
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Similar to top
このページを日本語でご覧頂けます。(This page is also available in Japanese.)
I’m not a native English speaker, so this page may contain some mistakes in English sentences.
Summary
This plugin shows the number of people who visited specified pages.
You can also show the list of popular pages of today, yesterday, and whole period.
Installation
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Examples/Usage
Please add ~~NOCACHE~~
macro to the page you'll use this plugin, because the data will be changed in real time and the page shouldn't be cached.
Access Counter
The most simple example is:
{{counter}} person(s) visited this page until now.
Then exported like 15 person(s) visited this page until now.
(if there are 15 visitors that have been visited the page).
Also, you can enter like this:
This page has been accessed for: Today: {{counter|today}} / Yesterday: {{counter|yesterday}} Until now: {{counter|total}}
The other example is this:
{{counter|total| person visited this page till now.| people visited this page till now.}}
Then exported like 1 person visited this page till now.
(if there is 1 user), and 12 people visited this page till now.
(if there are 12 users).
Popular Pages
The pages which the access counter plugin is active will be listed. If you want the popular plugin check all pages, you will put the counter plugin in sidebars or templates.
The most simple example is:
{{POPULAR}}
Then you'll see the list of the most accessed 10 pages till now, like this:
You can change the parameters:
{{POPULAR 45 today}} {{POPULAR 20 yesterday blacklist1|blacklist2}}
See the plugin working
See the plugin in action here (sorry but this page is available only in Japanese).
Syntax
{{counter|argument|message A|message B}}
- argument:
today
,yesterday
, ortotal
(default) - message A: texts following the number (when the number is 0 or 1)
- message B: texts following the number (when the number is 2 or more)
{{POPULAR number argument blacklist}}
- number: the number of items that will be shown
- argument:
today
,yesterday
, orallperiod
(default) - blacklist: pages that will not be shown in the list (divide by
|
)
Configuration and Settings
You can change the following setting by using the Configuration Manager.
Option | Description | Value Type | Default Value |
---|---|---|---|
timezone | Timezone used to judge changing of the day (if empty, the timezone set to the server will be used. You can specify one of IDs in List of Supported Timezones" at PHP Manual | string | 2) |
Localization
Error messages and the description of configuration can be shown in:
- English
- Japanese
Development
Change Log
- 2018-07-02
- Initial release
Known Bugs and Issues
Currently none
ToDo and Wishlist
I'll do my best if you think this leaves something to be desired
Contact Me
If you find some problems in this plugin, you can make issue topics on the GitHub page, or if you wanna contact me for other things, you can contact me by:
- My Twitter (Japanese account but English acceptable)