Jump to content
Nick Belane

File Download tracking/counting

Recommended Posts

I am new to processwire and I just want to track the amount of downloads of different pdf-files. I only want to see in the backend how many times user downloaded different pdf-files from my website.

Thats all. :-)

I do NOT need something like this:


Thanx in advance


Share this post

Link to post
Share on other sites

Thank you.

hm, probably.. :-) But I don't get it. I have a template with different fields.

One field (type: file) is named "downloads". In this field I stored different pdfs.

But where do I have to put the code in your post?

I only want to show the number of downloads in the backend. Not in the frontend/ website.

Share this post

Link to post
Share on other sites

To track how many times a file has been downloaded, the basic process is the following:

  1. Have a field to store this information.
  2. Increment this counter each time someone downloads a file.

Sorry for being so generic, but to be more specific, it would be helpful to have more information:

  • Do you need to track the number of downloads separately for each file?
  • Do you need to track the number of downloads separately for each user?
  • How are files downloaded?

It would also help to be more concrete about your use case (what type of site you are building, what type of files your users are downloading on which type of page), so that we can make a concrete example to help you  :)

Share this post

Link to post
Share on other sites

Thanks for your answer!

  • Yes, I want to know the number of downloads for a few pdfs (separately for each file)
  • No, I don't need to track separately for each user.

This is the site and the page "downloads":


There is one template with different fields.

One field (type:file, name:downloads) contains all the pdf-files of the page.

The body-field contains the links and the copy-text.
Something like that:

<p>Muster-Baubeschreibung für Asphaltarbeiten<br>
(Stand: 01/16)<br>
<a class="pdf" href="/site/assets/files/1020/muster-baubeschreibung_asphalt-16-1.pdf" target="_blank">Muster-Baubeschreibung Asphalt 16-1</a></p>

The following would be easier and more dynamic, but not so flexible for my customer:

$liste =" ";
$liste .="<ul>";
$pdf_files = $page->downloads;
foreach($pdf_files as $pdf_file) {
    $liste .="<li>{$pdf_file->description}<br><a href='{$pdf_file->url}' class='pdf'>{$pdf_file->name}</a></li>";
$liste .="</ul>";
echo $liste;

The best solution for us would be something like that in the backend:

file-a.pdf  (321)

file-b.pdf  (222)

file-c.pdf  (123)

Danke für die Geduld! ;-)

Grüße Nick

Share this post

Link to post
Share on other sites

That's why your excluded workflow (flexible downloads) is called flexible.... ;)

First solution ("your no-way please not" one) switch to a one file approach in combination with a PageTable Field to add more than one file....and use the flexible downloads solution. It could be done just with some thinking - setup some fields - setup templates for the single document and the overview - some code - finished

Second solution adapt the core modul itself and change it - this is not the easy part if your a not familiar with creating or changing PW (core) modules.

Some impression how the first/easy solution could end (even easy to use for the client):


Regards mr-fan

  • Like 2

Share this post

Link to post
Share on other sites


There's just no way to track a download count without additional fields. And as soon as you need additional fields related to files you either resort to using PageTables or ImageExtra, with the first one being the more flexible solution.

  • Like 1

Share this post

Link to post
Share on other sites

Thank you mr-fan!

It looks pretty cool..I think I dive into the first/ "easy" solution :-)

But I can't find a PageTable Field in my Version...(2.7.2)

Share this post

Link to post
Share on other sites

It is a core module, but you have to install it. It's in Modules > Core > FieldType > Profields: Page Table, and you click on Install.

  • Like 3

Share this post

Link to post
Share on other sites

But I can't find a PageTable Field in my Version...(2.7.2)

ESRCH beat me to it.  :lol:

  • Like 1

Share this post

Link to post
Share on other sites

If you are using Google analytics you could easily use it to track your downloads and have nice statistics and setup conversion goals and so on. You would only have to change your template code. No extra fields... easier than it may sound from the docs: https://developers.google.com/analytics/devguides/collection/gajs/eventTrackerGuide#setting-up-event-tracking

  • Like 3

Share this post

Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now

  • Recently Browsing   0 members

    No registered users viewing this page.

  • Similar Content

    • By David Karich
      The Page Hit Counter module for ProcessWire implements a simple page view counter in backend. Page views of visitors are automatically tracked on defined templates, with monitoring of multiple page views. This gives you a quick overview of how many visitors have read a news or a blog post, for example, without first having to open complex tools such as Google Analytics. This module quickly provides simple information, e.g. for editors. Or, for example, to sort certain news by most page views. For example for "Trending Topics".

      Works with ProCache and AdBlockers. With a lightweight tracking code of only ~320 bytes (gzipped). And no code changes necessary! In addition GDPR compliant, since no personal data or IP addresses are stored. Only session cookies are stored without information. 
      In addition, there are some options, for example filtering IP addresses (for CronJobs) and filtering bots, spiders and crawlers. You can also configure the lifetime of the session cookies. Repeated page views are not counted during this period. It is also possible to exclude certain roles from tracking. For example, logged in editors who work on a page are not counted as page views.

      Sort by hits and access page views (hit value)
      Each trackable template has an additional field called phits. For example, you want to output all news sorted by the number of page views.
      // It is assumed that the template, e.g. with the name "news", has been configured for tracking. $news = $pages->find("template=news, sort=-phits"); To output the page views of a tracked page, use:
      echo $page->phits; Example: Reset counter per API
      $modules->get("PageHitCounter")->resetPageViews("template=whatever", false); Example: Tracking a page hit via API and jQuery
      If you want to track a template that does not represent a full page to automatically inject a tracking script, you can define allowed API templates in the module that you can track. Below is an example of how you can track a click on news tag using jQuery. This will allow you to find out which keywords are clicked the most. For example, you can sort and display a tag cloud by the number of hits. Suppose your keywords have the template "news_tag". The template "news_tag" was also configured in the Page Hit Counter Module as a trackable API template.
      Example PHP output of keywords / tags:
      // Required: the data attribute "data-pid" with the ID of the template to be tracked. echo $pages->find("template=news_tag, sort=-phits")->each("<a href='{url}' class='news_tag' data-pid='{id}'>{title}</a>"); Example Tracking Script with jQuery:
      /** * Required: Data attribute "data-pid" with the ID of the news tag template * Required: Send the POST request to the URL "location.pathname.replace(/\/?$/, '/') + 'phcv1'" * Required: The POST parameter "pid" with the ID of the template */ $(function(){ if($('a.news_tag').length > 0) { $('a.news_tag').each(function(){ var tPID = $(this).data("pid"); if(tPID) { $(this).on("click", function(){ $.post(location.pathname.replace(/\/?$/, '/') + 'phcv1', {pid: tPID}); }); } }); } }); So simply every click on a tag is counted. Including all checks as for automatic tracking. Like Bot Filtering, Session Lifetime, etc.
      Notice: Tracking with URL segments
      If the option "Allow URL Segments" is activated on a template, the hits are only counted if the base URL of the page is called. If you want the hit to be counted even when a segment is requested, you MUST configure the segments in the template configuration. How to do this can be found here. If you use dynamic segments, configure them as RegEx. There is currently no other option. The problem is that the Page Hit Counter hooked into the PageNotFound process. If URL segments are allowed but not defined, a 404 is never triggered. This means that the Page Hit Counter cannot be called.
      Background: This module is the result of a customer requirement, where the editors are overwhelmed with analytics or no tracking tools were allowed to be used. However, a way had to be found to at least count page views in a simple form for evaluations. Furthermore, by using ProCache, a way had to be found to count views of a page without clearing the cache.
      Automatic Page View Tracking Lightweight tracking code, only ~320 bytes (gzipped) No code or frontend changes necessary Works with ProCache! Even if no PHP is executed on the cached page, the tracking works Works with browser AdBlockers No cache triggers (for example, ProCache) are triggered. The cache remains persistent GDPR compliant, session-based cookie only, no personal information Filtering of IPs and bots possible Exclude certain roles from tracking Ability to reset Page Views Works with all admin themes Counter database is created as write-optimized InnoDB API to track events for templates that are not viewable No dependencies on libraries, pure VanillaJS (Automatic tracking script) Works in all modern browsers Pages are sortable by hits Cons
      Only for ProcessWire version 3.0.80 or higher (Requires wireCount()) Only for PHP version 5.6.x or higher No support for Internet Explorer <= version 9 (Because of XMLHttpRequest()) No historical data, just simple summation (Because of GDPR) Segment URLs can only be counted if the segments are defined Planned Features / ToDos
      API access to hit values Since version 1.2.1 Possibility to sort the pages by hits (Request by @Zeka) Since version 1.2.0 Don't track logged in users with certain roles (Request by @wbmnfktr) Since version 1.1.0 Possibility to reset the counter for certain pages or templates (Request by @wbmnfktr) Since version 1.1.0 Better bot filter Since version 1.1.0 Disable session lifetime, don't store cookies to track every page view (Request by @matjazp) Since version 1.2.1 Option to hide the counter in the page tree (Request by @matjazp) Since version 1.2.1 Option to hide the counter in the page tree on certain templates Since version 1.2.1 API to track events for templates that are not viewable Since version 1.2.2 Changelog
      Bug-Fix: Set the counter of a cloned page to 0 Enhancement: The function for resetting counters is now available in the module as a public function to reset counters via own scripts on the API side (Request by @VeiJari) Enhancement: Documentation improvement API reset 1.2.5
      Bug-Fix: When counting 404 hits, cookies are no longer set. The session lifetime is deactivated for the 404 page Enhancement: Documentation improvement regarding URL segments 1.2.4
      Bug-Fix: Resetting the counters on system pages (e.g. 404) does not work (Reported by wbmnfktr) Bug-Fix: Tracking endpoint is logged as 404 if module "Jumplinks" is installed (Reported by wbmnfktr) Enhancement: Corrected few typos (Merged from Sergio #6 – THX!) 1.2.3
      Bug-Fix: Tracking script triggers 404 if pages are configured without slash (#3) Reported by @maxf5 Enhancement: Reduction of the tracking script size if it's gzipped (~320 bytes) Enhancement: Documentation improvement Enhancement: Corrected few typos 1.2.2
      New feature: API to track events for templates that are not viewable Enhancement: Documentation improvement 1.2.1
      API access to hit values Use $page->phits Bug-Fix: No tracking on welcomepage (Reported by wbmnfktr; Thx to matjazp) Bug-Fix: Tracking script path on subfolders (Reported by matjazp) Bug-Fix: Tracking on pages with status "hidden" Enhancement: Change database engine to InnoDB for phits field Enhancement: Option to disable session lifetime set session lifetime to 0, no cookies Enhancement: Better installation check Enhancement: AJAX Request asyncron Enhancement: Reduction of the tracking script size by ~20% Enhancement: Option to hide the counter in the page tree You can output the counter with the field name "phits" Enhancement: Option to hide the counter in the page tree on certain templates Enhancement: Option for activate general IP validation Enhancement: Reduction of tracking overhead up to ~30ms Enhancement: Better bot list for detection 1.2.0
      New feature: Sort pages by hits – New field phits Migrate old counter data to new field 1.1.0
      New feature: Exclude tracking of certain roles New feature: Reset Page Views Better bot filter and detection 1.0.0
      Initial release Notes
      By default, the page views are stored as INT in the database. This allows a maximum counter value of 4.2 billion views (4,294,967,295) per page. If you need more, change the type to BIGINT directly in the database. But I recommend to use Google Analytics or similar tools if you have such a large number of users.
      Download GitHub: ProcessWire Page Hit Counter (Version 1.2.6)
      PW Module Directory: ProcessWire Page Hit Counter (Version 1.2.6)
      Install via ProcessWire (Classname): PageHitCounter
      Update information
      If you have used version 1.2.1 from the DEV branch, please replace it completely with the new master version.
    • By quickjeff
      Hi Guys, I have seen some other threads that talk about this but nothing recent nor in line with what I need. 
      I have basically created a page in which I am tracking the number of views. I update the counter which is tied to a field I added to the page's template that I am tracking. The field is hidden from the website admin and only used for this data. 
      However, now I need to track it on a daily basis. I am thinking of keeping track of all time view total for 30 days and perhaps saving that and allowing the user to see the page views of last 7 days, each day as a number and then 30 days of data. This way if I want to build in reporting functionality I can. 
      What I need help with adding a date to the page_views field but also, knowing how many page_views for today, yesterday, day before etc. 
      Here is what I have so far and its working. Now I need to associate a date with every day. NOT every update of the page_views field. 
      if (!$user->hasRole('superuser')) { $page->page_views += 1; $page->of(false); $page->save('page_views'); $page->of(true); } echo $page->page_views; Any guidance, help, suggestions is absolutely appreciated. 
    • By Sabrina
      I would like to start tracking my website visitors with Leady software. Searched the forum for similar discussion yet did not find the right answer. Could you please tell me how can I add their javascript to my website? Is there any step by step guide available?
      Any help appreciated. 
    • By reed
      Hey folks, I did some digging to see if I could find anything on this, but I couldn't turn up anything.
      Does any one have a recommendation on how to track the terms that users enter in my site search?
      Thanks for any thoughts!
    • By cstevensjr
      SomeDay Tool

      I'm working on a series of restricted collaborative websites that are geared towards me working with my clients.  It's a mashup of CRM, Project/Task Management, Tracking, Documentation and Configuration Control features.  Everything is controlled by PW Roles.  It's a tool that allows me to have a great deal of transparency with those I work with.  The objective is to easily know the who, what, when, where and how of whatever is being worked on.  I call it a Collaborative Resource Management System (CRMS) which has the nickname of SomeDay.

      I currently have one of these websites for each of my important clients and an additional one to keep track of my internal work. They all use the inherent native power of PW to produce specialized status reports. The websites intentionally incorporates the front-end and back-end of the PW platform.

      There is a lot of information stored within this type of website, what I like to call an Information Portal. You are able to easily query a status and get a good view of what's going on. 
      This is a long-term ongoing project and I will update this post as more features/capabilities are added.
      Meanwhile, here are a few pictures of the CRMS Tool:
      Figure 1-3 (The SomeDay Tool for one of my clients)

      Figure 1 (Login courtesy of Adrian's Protected Mode Module)

      Figure 2, Homepage is a summary of all information

      Figure 3, Each item can be clicked on to get to detailed information
      Figures 4-7 (My internal SomeDay Tool website)

      Figure 4, (Login)

      Figure 5, Homepage Summary for my internal work

      Figure 6 , Homepage Summary

      Figure 7, FlagPages showing Bookmarks
      Figures 8-11 (Looking at a Task)

      Figure 8, Front-end view

      Figure 9, Back-end view (editing)

      Figure 10, Place for adding Priority or Statuses

      Figure 11, Private Tab only available to selected PW Roles
      Figures 12 and 13 (Site Structure)

      Figure 12, CRMS structural flow

      Figure 13, Tasks and Sub-Tasks can be added to Projects
      Figures 14-16 (Customized Reports)

      Figure 14, Review all items based on what type of work it is

      Figure 15, Review items based on their status

      Figure 16, Listing of all items with a status category of Active
      That's it for now.
  • Create New...