A Piwik plugin for YOURLS
Switch branches/tags
Nothing to show
Clone or download
interfaSys
interfaSys Style fix
Latest commit f378ffc Oct 29, 2012
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
css Initial commit Oct 29, 2012
js Initial commit Oct 29, 2012
themes/default Initial commit Oct 29, 2012
README.md Style fix Oct 29, 2012
plugin.php Initial commit Oct 29, 2012

README.md

PIWIK-YOURLS

A Piwik plugin for YOURLS

Features

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

Requirements

  • PHP 5.3
  • PiwikTracker.php from your Piwik installation

Setup

YOURLS

  • 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.

Piwik

  • 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

Modifications

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);
	@$pt->doTrackPageView($title);

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

in plugin.php, function "itfs_piwik_log_request"

Inspiration

License

Copyright 2012 - interfaSys sàrl - www.interfasys.ch

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

http://www.gnu.org/licenses/agpl-3.0.html

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.