Download the PHP package bnomei/kirby3-pageviewcounter without Composer
On this page you can find all versions of the php package bnomei/kirby3-pageviewcounter. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package kirby3-pageviewcounter
Kirby Pageview Counter
Track Page view count and last visited timestamp
Installation
- unzip master.zip as folder
site/plugins/kirby3-pageviewcounter
or git submodule add https://github.com/bnomei/kirby3-pageviewcounter.git site/plugins/kirby3-pageviewcounter
orcomposer require bnomei/kirby3-pageviewcounter
Usage
Echo the tracking a 1px x 1px
-image or adding css anywhere in your template. Both techniques will increment the counter but technically they track in a different way.
A) via image, tracking scroll below first fold
B) via css, tracking mouse hover on body
How it works
The tracking image will be moved below the fold and trigger the counter with native lazy loading on first user scroll. Why? To avoid most of the bots. It will also work for cached pages using the pages cache (even when cached static).
SQLite database (default)
To view the tracked count and timestamp this plugin provides two optional fields.
in your page blueprint
[!TIP] Kirby has day.js built in which you can use to format your date output.
You do not have to add anything to you config files. But you could make some changes to the defaults, like the path to the sqlite file if you wanted to.
site/config/config.php
Page Fields (alternative)
If you do not want to store your tracked counts in a sqlite file then add kirby text or hidden fields to your blueprint. I usually have blueprints for them and extend them in my target pages blueprints. like this...
site/blueprints/fields/viewcount.yml
site/blueprints/fields/lastvisited.yml
in your page blueprint
site/config/config.php
[!WARNING] Be warned that Page Fields might not work well for concurrent requests.
Settings
bnomei.pageviewcounter. | Default | Description |
---|---|---|
field.counter | fn() |
callback. returns instance of sqlite or field counter class |
field.ignore-panel-users | true |
boolean. if true will not increment count if session is by a panel user. |
field.sqlite.file | fn() |
callback. returns filepath to sqlite file |
field.field.count | viewcount |
string. name of field in page blueprint |
field.field.timestamp | lastvisited |
string. name of field in page blueprint |
botDetection.CrawlerDetect | true |
check for crawlers (~10ms) |
botDetection.DeviceDetector | true |
check for bots (~40ms) |
Disclaimer
This plugin is provided "as is" with no guarantee. Use it at your own risk and always test it yourself before using it in a production environment. If you find any issues, please create a new issue.
License
It is discouraged to use this plugin in any project that promotes racism, sexism, homophobia, animal abuse, violence or any other form of hate speech.
All versions of kirby3-pageviewcounter with dependencies
getkirby/composer-installer Version ^1.2
jaybizzle/crawler-detect Version ^1.2
matomo/device-detector Version ^6.1