Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



5 Commits

Repository files navigation


A Piwik plugin for YOURLS


  • Logs all requests with Piwik
  • Tracks IP and custom variables
  • Lets you disable local tracking/stats
  • Includes "Don't Log Bots" from OZH


  • PHP 5.3
  • PiwikTracker.php from your Piwik installation



  • Pull the files to <yourls_root>/user/plugins/piwik
  • Place PiwikTracker.php into the <yourls_root>/user/plugins/piwik/libs/Piwik folder
  • Activate the plugin in the admin zone of YOURLS
  • Go to the plugin page and fill in the required fields

If you want better alert messages, you need to apply this change to your YOURLS installation.


  • Create a test "website" and use that at the beginning until you find the right way to log your hits
  • Create or assign an admin auth token to that site
  • Visit some of your links
  • Check the hits on the "Visitors in real-time" widget


If you're not happy with the way hits are tracked, just change the way the plugin does it by editing:

	// This shows up in the visitor logs and identify the source of the data
	$pt->setCustomVariable(1, 'App', 'Piwik plugin for YOURLS', 'visit');

	// Some useful variables
	$pt->setCustomVariable(2, 'Domain landed', $domain_landed, 'page');
	$pt->setCustomVariable(3, 'Keyword', $keyword, 'page');

	// Track the visit in Piwik
	$title = yourls_get_keyword_title($keyword);

	// The destination URL will show up as an outlink
	@$pt->doTrackAction($destination, 'link');

in plugin.php, function "itfs_piwik_log_request"



Copyright 2012 - interfaSys sàrl -

Licensed under the GNU Affero General Public License, version 3 (AGPLv3) (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


No releases published


No packages published