matomowp/matomo-clickheat
2
0
Fork 0
Code Pull requests Releases Activity
Matomo click heatmaps (GPL) - not ported from 2.x
36 commits 1 branch 0 tags 559 KiB
PHP 89.1%
JavaScript 6.8%
CSS 1.4%
SCSS 1.4%
Perl 0.8%
Other 0.5%
Go to file
Alexander Yakovlev 9ecbcfe29d log clicks (as a Matomo plugin)
2018-12-10 00:54:08 +07:00
lang custom report WIP, declared a 1.0.0 version 2018-12-06 22:28:59 +07:00
libs log clicks (as a Matomo plugin) 2018-12-10 00:54:08 +07:00
Reports WIP embed heatmap 2018-12-09 00:19:19 +07:00
screenshots rewrite README.me to explain 2015-04-22 23:44:13 +09:00
templates WIP embed heatmap 2018-12-09 00:19:19 +07:00
.eslintrc.yml edit clickheat.js to do POSTs and GETs in JSON 2018-12-07 20:12:46 +07:00
.gitignore WIP embed heatmap 2018-12-09 00:19:19 +07:00
.htaccess README.md for install instructions, use .htaccess 2018-12-06 21:32:44 +07:00
API.php custom report WIP, declared a 1.0.0 version 2018-12-06 22:28:59 +07:00
CHANGELOG.md custom report WIP, declared a 1.0.0 version 2018-12-06 22:28:59 +07:00
ClickHeat.php custom report WIP, declared a 1.0.0 version 2018-12-06 22:28:59 +07:00
clickheat_config.php exec bit and readmes 2018-12-06 20:07:21 +07:00
Controller.php display in menu 2018-12-06 23:03:02 +07:00
Gulpfile.js WIP embed heatmap 2018-12-09 00:19:19 +07:00
LICENSE project says GPLv3, so license file should be v3 2018-12-06 20:57:05 +07:00
package.json WIP embed heatmap 2018-12-09 00:19:19 +07:00
plugin.json custom report WIP, declared a 1.0.0 version 2018-12-06 22:28:59 +07:00
README.md exec bit and readmes 2018-12-06 20:07:21 +07:00
yarn.lock WIP embed heatmap 2018-12-09 00:19:19 +07:00

README.md

Piwik ClickHeat Plugin

Description

ClickHeat is a visual heatmap of clicks on a HTML page, showing hot and cold click zones. This plugin based on Dugwood's ClickHeat version 1.14. It is an OpenSource software, released under GPL licence, and free of charge.

Plugin not consider the IIS. Sorry. We are waiting patches for IIS.

Installation

Install it via Piwik Marketplace.

This plugin installer will make directories:

  • yourpiwik/tmp/cache/clickheat/cache
  • yourpiwik/tmp/cache/clickheat/logs.

This plugin uses a different tracker. Please click on the link "JavaScript" and put the special Javascript codes into your website.

FAQ

What exactly is included in this feature ?

  • pick up a siteid
  • pick up a period
  • pick up a browser type
  • pick up a specific web page

And what functions are not included in this feature ?

  • remove special addresses defined on the control panel.
  • remove special browsers defined on the control panel.
  • filters based on added segmentation

Where is the coordinate information from the browser ?

ClickHeat plugin uses text files to record the coordinate data of each browser in directory: yourpiwik/tmp/cache/clickheat/logs.

What is "click.php returned a status code 403" ?

You have to perform the upgrade immediately to version 0.1.5. I forgot to put .htaccess.

After installing the plugin, Piwik Administration area shows "page not found 404 error".

This plugin doesn't consider the IIS. Sorry. And please delete the ClickHeat plugin (yourpiwik/plugins/ClickHeat) manually via FTP or Explorer. We are waiting patches for IIS.

Does it withstands high traffics ?

This plugin uses minimal text to record data and file based logging. And when click.php is called from a special Javascript for cgi, just append text on end of the each file. And when you analyze the click data and make a heatmap, plugin will create cached heatmap as png image file.

Therefore, we expect the plugin light works, but we don't know what load it has under Piwik 2.x. So we are very glad, when you inform us about your situation.

Please see the link Performance and optimization about system resources. If you want performance, you need to avoid to use a cgi, that is possible. It method is explained on the link.

New click data were added, but not updated heatmap. Why ?

Plugin places heatmap images in the cache directory: yourpiwik/tmp/cache/clickheat/cache. Therefore when you suddenly met with such probrem, you can delete cache files, but do not delete cache directory.

Showed a heatmap, but not overlay a heatmap to the target web page. Why ?

Check that your website does not set the HTTP header X-FRAME-OPTIONS to SAMEORIGIN as this will prevent this plugin from iframing your website for the heatmap report. Please see Page Overlay Troubleshooting, that is same problem.

How do I enable logging ?

Logging prepared for click.php. To debug it further please enable tracker debug mode in config.ini.php:

[Tracker]
debug=1

You can see the log in yourpiwik/tmp/logs/piwik.log.

License

GPL v3 or later

Support

Please direct any feedback to yamachan@piwikjapan.org.