utilitees

AJAX Linktracker Documentation

• Installation
• Adding the javascript-snippet to your templates
• Usage
• Special IDs
• Display # of clicks in templates
• Click Statistics

Installation:

1. Upload the file linktracker.js anywhere to your site and remember the URL.
2. Upload the folder named linktracker and its content into the modules-folder of your EE system-directory.
3. Upload the file named lang.linktracker.php into the /language/english-folder of your EE system-directory.
4. In your Control Panel navigate to CP Home ›  Modules, find the AJAX Linktracker module and click Install.
5. Now you have access to the CP Interface of the module. It is here where you can view and reset the click-statistics.

Adding the javascript-snippet to your templates

On every page that may contain links that are to be tracked the java-script call needs to be included. Preferably somewhere at the bottom of the page. If you have a footer-template that may be a good place to put it.

Add the following code to the template/s in question:

Of course you need to replace the URL to the one where you uploaded your copy of linktracker.js.

Usage:

Now all you got to do is to add a unique id-attribute to any link that is supposed to be tracked. This may be links in entries as well as links you compose somehow in your templates with custom fields and the like. External links, internal links, links to files… it doesn’t matter as long as it has and id.

Example:

This link will show up under the Link ID holiday-photos in the click-statistics.

This link will not be tracked since there’s no id present.

Special IDs

There is a set of IDs that serve a special purpose. If the id starts with either vc1_, vc2_, vc3_ or vc4_ followed by a number it is assumed that the number is an entry_id of a weblog entry.

If a link with such an id is clicked it gets tracked like usual. Additionally the corresponding view_count variable of the weblog entry is incremented by one.

Example:

If this is clicked, view_count_two of the weblog-entry with the entry_id 93 gets incremented.

If this is clicked, view_count_four of the weblog-entry with the entry_id 115 gets incremented.

I think you get the point.

An application example for this is a link directory-type of site where you have a custom field for an outgoing URL. In a template you’d do something like:

Then you could use

to easily pull out a list of the most popular links in your directory.

Display # of clicks in templates

There’s also a tag that outputs the number of clicks for a given link_id if you don’t utilize the view_count approach. It’s a single tag that doesn’t have a closing element.

It only has one mandatory parameter which is the link_id=”“ to be displayed.

Click Statistics:

Under CP Home ›  Modules ›  AJAX Linktracker you’ll find a list of all Link IDs and their number of clicks. They only show up once they have been clicked for the first time.
To the right there is a Reset-link on every line that resets the counter for the respective Link ID.
If you click on a Link ID you get a detailed listing of every click for that ID.

Questions / bug reports

For general comments, brickbats & bouquets please use the form over here.

Name:

Email:

URL:

	Remember my personal information
	Notify me of follow-up comments?

Page 3 of 3 pages  <  1 2 3

User Talk