twentyfourhoursmedia/views-work

plugin for handling pageviews

2.2.0 2024-03-11 19:31 UTC

Requires

• php: ^8.0
• craftcms/cms: ^5.0.0-alpha || ^4.0.0.1
• jaybizzle/crawler-detect: ^1.2

proprietary

• 24hoursmedia

• cms
• Craft
• craftcms
• craft-plugin
• views work
• views-work

README

Views work 2.x is compatible with Craft CMS version 4.0 or higher.

Please view the full documentation at io.24hoursmedia.com!

• Track pageviews by day, week, month or grand total
• View popular entries in a widget
• Get popular entries and pageviews on the front-end in twig
• Uses a signed tracking image to register only real page views

Usage

Show a beacon 1px x 1px image to register a pageview:

{# render the image for registration #}
{{ entry | views_work_image }}

Get popular items:

{% set entries = craft.entries.section('articles').orderByPopular('week', 1).limit(10) %} %}

{# show this weeks views (also supported: today, thisMonth, total) #}
{{ entries.viewsWork.thisWeek }}

Resetting view counters

Some view counters need to be periodically reset (such as the daily and weekly counters). You can either do this with a special url (provided in the control panel), or by setting up a cron job or using a special url.

Resetting views with a cron job

Execute this cron at an approprate time, i.e. once every day at 00:01 pm.
It resets the daily, weekly and monthly view counters.

The cron checks wether it is the first day of the week or month before resetting monthly or weekly views.

./craft views-work/default/reset-views

Screenshots

Brought to you by 24hoursmedia

Logo by https://www.iconfinder.com/ReactiveDoodlesApp