WP-Click-Track 0.5.1

Requires at least: 2.7
Tested up to: 2.8stable
Stable tag: 2.8

Tracks link clicks from hrefs in posts and pages.

Description

The click tracker works in 2 modes:
1. Scans posts and rewrites them to include a tracking element.
2. Enables users to create stand alone trackable links that can be embedded in posts or offsite.

Click Tracker Admin

Click Tracker Admin

Features

Automatically converts links in posts, pages and sidebar to allow for tracking.
Extensive reporting area:

  • Link Report
    Link Report

    Link Report

  • Daily Report
    Daily Report

    Daily Report

  • Admin Widget
    Admin Widget

    Admin Widget

Usage

The click tracker works in 2 modes:
1. Scans posts and rewrites them to include a tracking element
2. Enables users to create stand alone trackable links that can be embedded in posts or offsite.
Links should include a title paramater in the href to have the reference name be automatically created. Ex:
<a href=”http://url.com” title=”Link Title”>link copy</a>

Links without a title attribute will have a default name created.

Future Releases

  • advanced reporting
  • localization
  • export data

Changelog

0.5.1

  • Modification: Added Miscellaneous Settings (Sarah Mod)
  • Modification: Changed admin widget date range to match WordPress.com Stats widget
  • Bug fix: Fixed ‘label’ in configure page form

0.5

  • Modification: Added ignore IP address for click tracking
  • Modification: Added link statistics reset
  • Modification: Changed graphs to Open Flash Chart
  • Modification: Added additional line chart vectors to display unique clicks
  • Modification: Added link parsing of next and prev template tags
  • Modification: Added link parsing of categories in posts/pages as well as sidebar widget
  • Modification: Added link parsing of tags links template
  • Modification: Improved title extraction to reduce No Name Given auto-label
  • Modification: Added global history and report page
  • Bug fix: Click graph date descrepancy issue
  • Bug fix: Added bypass for external links being double tracked when entered in page
  • Bug fix: Fixed backwards tracking flags
  • Bug fix: Changed admin widget ordering to list most clicked to least click

0.4.2

  • Modification: Admin widget links to click admin

0.4.1

  • Improvement: Added admin widget
  • Bug fix: Fixed “Division by zero” bus

0.4

  • Improvement: Added configuration page
  • Improvement: Added “Add Link” mod. Admins can create standalone links for placement on external sites.
  • Improvement:Added “Edit Link” mod for editing names or stored links.
  • Improvement:Enable or disable individual parsing sections
  • Improvement:Enable or disable individual parsing sections
  • Improvement:Moved google api js call to only fire on click track pages (was slowing down some areas of the admin).
  • Bug fix: fixed spelling of days of week
  • Bug fix:fixed pathing issue for tracking call (Logan and Gary’s Bug)
  • Bug fix:fixed comment body parsing (wasn’t grabbing links)
  • Bug fix:fixed memory issues (FINALLY :)

0.3

  • Improvement: Added Indexes on tables for better performance
  • Improvement: Updated Install system
  • Improvement: Added pie charts for clicks by day and hour
  • Bug fix: hour click report formatting
  • Bug fix: blank link haunting
  • Bug fix: option saving

0.2.1

  • Bug fix: include usage of both quotes (”) and single-quotes (’) for attributes
  • added parsing / tracking of Archive links
  • added parsing / tracking of Bookmark links
  • added parsing / tracking of Comment Author URL links
  • fixed option updates

0.2

  • Add report area– List of referrers– Clicks by day– Clicks by hour– View individual clicks
  • Manage Google Analytics Wordpress Plugin incompatibility
  • Add upgrade notification

0.1.1

  • Bug fix js Image() issue

0.1

  • Initial Release

Bugs

  • admin panel doesn’t keep state
  • Incompatibility with Google Analytics Wordpress Plugin with Track Outbound enabled

Installation

  1. Create backup.
  2. Upload the zip file to the `/wp-content/plugins/` directory
  3. Unzip
  4. Activate the plugin through the ‘Plugins’ menu in WordPress

Please let me know any bugs, improvements, comments, suggestions.

Download Click Tracker

101 Comments

  1. Eric Lamb says:

    Hi Andy

    WP-Click-Track doesn’t do this by default; it tracks all links equally and there is no differentiation between visitor clicks and member clicks.

    I’d imagine this would be a simple mod but I’ve never done any work with the user system of wordpress so I don’t know for sure. I will look into though.

    Sorry, but I don’t know of any plugin like this one; which is why I wrote it :)

    Eric

  2. Voya says:

    Just as a suggestion

    - Add option which will enable the links not to be tracked when someone is logged in. I believe the tracking will be made better. Anyways, a great plugin.

    Cheers,
    Voya

  3. Kai Wang says:

    Hello there,

    Very awesome plugin. Thank you very much.
    I just installed the plugin and added some links. When I clicked on “List Links”, I’m prompted with this warning message:

    Warning: Division by zero in /homepages/19/d272381798/htdocs/wp-content/plugins/wp-click-track/admin.inc.php on line 740
    No Links Found

    I was also prompted with a message saying that I have Google Analytics plugin for WP and was told to disable it. I don’t have that plugin but click “disable” regardless.

    I would like to know if there’s something I did wrong and how I can get it to work.

    Thank you,
    Kai

  4. Eric Lamb says:

    Hi Kai,

    It looks like you are might be using an older version of the plugin (this is an old/resolved issue) or you upgraded recently (which your post didn’t sound like).

    In either case, you should be able to just go to the click track settings (in your WP admin) and set the defaults under Admin Limits.

    Sorry for the issues man.

    Eric

  5. uzoma says:

    good to see your plugin, hope it works and will be ideal for web users like me, I hope this will enable me track users to my website

  6. Blondie says:

    I am having a problem with the plugin, is it possible to delete a link that you have created yourself? I can’t seem to find a delete button…

  7. Eric Lamb says:

    Blondie,

    I didn’t build that in just yet; there didn’t seem to be much use for it since the tracked links are created automatically once they are clicked on.

    Since it’s now possible to create standalone links the system should allow the deletion though. This feature will be in the next release, 0.5, which I’m currently working on. It should be out by the end of the month (early July at the latest).

    Eric

  8. Blondie says:

    Coolness nice to see that the plugin is under development :)

  9. Carlo says:

    Hi Eric
    I’ve tried your fantastic plugin, but in Wordpress 2.8 there is a problem: it won’t work.

    Plugin could not be activated because it triggered a fatal error.
    … plugins\wp-click-track\click-tracker.php on line 728

    Is it update to Wordpress 2.8 ?
    Bye!

  10. Eric Lamb says:

    Hi Carlo,

    That’s weird man; I just installed the plugin on a 2.8 install and it activated fine. Can you confirm you’ve installed the latest version (0.4.2)? If you installed through the WP plugin manager you should…

    Eric

  11. Carlo says:

    Hi Eric,
    thanks for your response, I confirm latest version 0.4.2, I’ve tried to install via WP plugin manager and direct upload. The WP installation was made on localhost WAMP on Windows Vista, this can be a problem?

  12. Eric Lamb says:

    Carlo,

    I don’t think WAMP would be a problem; I’ve tested the tracker on both IIS7, Apache 2 and Lighttpd and all came through good.

    Can you confirm you have “short_open_tag” set to true in the php.ini? This is a bug that’s fixed in the upcoming 0.5 release but, off the top of my head, this setting being disabled could be the issue.

    Your issue is odd because click-tracker.php only contains 727 lines but your error is on line 728…

    Eric

  13. Carlo says:

    HI Eric,
    short_open_tag was the problem, it was setting on Off, when I put to On and restart WAMPServer, the plugin was activated fine… now all seems to work perfectly! Soon I will write a review on this amazing plugin, on my blog.

    Thanks. Best regards

  14. Alex says:

    Hello Eric.

    Thanks for the plugin. It is truly awesome.

    I have a problem though and I was wondering if you can help. I installed the plugin, but I don’t see any tracking code on the links. I have plenty of links on my blog. Some are with title, some without. But it installed the tracking code on just two links out of many. Take a look: http://www.alexonlinux.com/ram-content-lost-after-shutdown-not-exactly
    The only two links that has tracking code on them are links to “Interesting blogs” on the sidebar. But these are by far not the only links on the page. Some, link menu links, have title. What’s wrong?

    Thanks!
    Alex.

    • Eric Lamb says:

      In version 0.4.2 the tracking is mostly relegated to the links in the posts, comments and a couple of the widgets.

      I checked the source and there is tracking code on the two links in the post you linked. I clicked on both of them; can you confirm the link was recorded?

      I will be releasing 0.5 in the next couple days which adds tracking to nearly everything so you should have full coverage soon.

      Eric

      • Alex says:

        You’re right. I can see the clicks. Sorry about that. I guess I expected too much too early. I’ll be expecting 0.5.
        In the meantime, I spotted one more thing that may concern you. If you take a look at the front page of the website – http://www.alexonlinux.com. Open its source and check out line 319:

        This article explains how to implement performance critical reference counting in C/C++ program, using atomic variables and gcc. Enjoy it.
        Read the article here.

        This is seems to be broken. Am I right?

      • Alex says:

        Oh, sorry for flooding. I forgot that WP understands html in comments per se. Please take a look at the html of my previous comment to see what I mean.

        • Eric Lamb says:

          Wow! That link is just plain WRONG man; my condolences.

          Can you post the raw HTML (or email it to me) so I can see what the original looks like?

          I’m thinking the format of the link is screwing with the parser in some unanticipated way.

          Thanks,
          Eric

  15. Alex says:

    While we’re working to resolve an issue I reported earlier, I’d like to ask you to implement two features that I think may be very useful.

    1. At the moment, the plug-in takes the name of the link from ‘title’ element of the ‘a’ tag. I suggest that the name should come from the link text itself. At least on my blog, most of the links has no title. This leaves them anonymous. Because of that it is very difficult to find out where each link points to.

    2. I’d like to know how many times visitors has clicked on certain link that appears on different pages. For instance, I may be promoting a content with a link on the sidebar. In this case, I’d like to know how many people clicked on that promotion link, not from each URL, but overall.

    I have some ideas how to implement both of these. If you’d like to hear, let me know and I’ll email you.

    Thanks.

    • Eric Lamb says:

      Hi Alex,

      Item 1 is in the upcoming 0.5 release. I noticed that a lot of people weren’t using title tags (though you REALLY should) so it was a definite issue.

      I’m not clear on what you have in mind for item 2. Can you elaborate?

      Thanks for the advice,
      Eric

      • Alex says:

        Lets say I have a blog with three posts and a page called ’subscribe’. I placed a link to subscribe page on the sidebar and it appears on each and every blog post (this is not something hypothetical – I did it on my blog).

        I’d like to be able to track clicks on subscribe link not only from each post, but also the overall number of clicks. I.e. I would like to know how many clicks occurred from post 1 and also, I would like to know how many overall clicks occurred.

        Tracking clicks from single post will allow me to see how that particular post good at redirecting traffic to subscribe page. Tracking overall clicks will allow me to track how good the overall campaign.

        • Eric Lamb says:

          Alex,

          I think you’re looking for the referrer list.

          When you’re looking at an individual link in the reporting you get a list of how many clicks came from individual URLs. This allows you to correlate the link to different locations. Right now it doesn’t list the actual blog page but that could be something for a future release.

          Does that help?

          Eric

  16. kuld33p says:

    Its really a nice post. I appreciate your efforts.

  17. Jacob Share says:

    Sounds like a plugin I’d enjoy using, but I have some questions:

    Is it compatible with WPMU?

    Does it have an uninstall feature that will remove all the tracking elements one by one and the database tables?

    Does it work with WP Super Cache and other caching plugins?

    • Eric Lamb says:

      I haven’t tested the plugin against WPMU so I’m not really sure what issues could come up (I would think there wouldn’t be any). If you try would you please let me know how it goes?

      It’s funny you ask about the uninstall; it used to remove all the tables when uninstalled. Now, it doesn’t because when you upgrade a plugin, Wordpress first uninstalls it so users lost data when upgrading.

      The plugin does work with WP Super Cache and I can’t imagine why it wouldn’t work with other caching plugins.

      • Jacob Share says:

        The main compatibility issue with WPMU is the database naming convention is different. If your plugin assumes any part of the database prefix, it’s not compatible for now.

        I don’t get what you said about the plugin upgrades; if I understood correctly, that would mean you lose your data with every upgrade.

        Regarding the uninstall, I actually care less about removing your db tables (that can be done manually), but I wouldn’t want to have to remove the tracking elements one by one by hand. Any plans for an uninstall mechanism to do those deletions automatically?

        • Eric Lamb says:

          The plugin uses the “$wpdb->prefix” variable for table prefixes so you should be good on that. No hard coded prefixes here.

          You’re correct about the plugin upgrades. Previously, for one version only, the upgrade dropped the tables. This wasn’t good, since users lost all the history, but that has since been fixed. Now you have to manually remove the tables.

          The tracking mechanism is dynamically added on the page view side so the tracking element isn’t there until someone is looking at the post. The tracking is only added and never saved. There is nothing to remove; by hand or otherwise.

  18. Hi Eric,

    I hope I am not just overlooking something obvious, but two days ago I installed version 0.5 (on WP v. 2.8) and I have no clicks recorded (I know there have been clicks). If I check the “list links” it says there are no links. There are TONS of links on my blog, both in posts, as well as sidebars, pages and such. Is there something else I need to do to get it to “see” the links? Thanks for the help and the plugin is amazing (or will be once I get it going!).

    Best,
    Sarah

    • Eric Lamb says:

      Hi Sarah,

      Sorry for the delay in getting back to you; I’m just slammed with work right now.

      I’ve taken a look at your site and it looks like your blog is a little misconfigured (I think). The click tracker uses the settings data to determine the URL for the tracking “ping” and it looks like yours is wrong.

      Your site is:
      http://www.unplugyourkids.com/

      But your “siteurl” value is set to:
      http://www.unplugyourkids.com/blog

      It should be:
      http://www.unplugyourkids.com/

      You can change this under Settings->General in the WordPress admin.

      Please let me know if you have any further issues.

      Eric

      • Thanks for the help Eric. I guess this is going to require moving some Wordpress files around to avoid messing things up. I have the WP files in one directory and the blog in another hence the two different URLs. This is more than I can manage at the moment, but I’ll do it when I’ve got some time.

        Alternatively, is there any way I can specify “www.unplugyourkids.com/blog” instead as the address for Click Tracker to find links? This might be easier (and safer!) than trying to move my whole blog contents. Thanks again for the help!

        ~Sarah

        • Eric Lamb says:

          Hi Sarah,

          I have updated the plugin to allow the over-ride for the siteurl system variable for the click tracker.

          First, update your plugin to the latest 0.5.1 version
          Next, go to the Configure page and at the bottom is a text field for entering the correct URL.

          Be careful to enter a proper URL (http://yourwebsite.com); the system doesn’t validate it (yet) so it’ll accept anything.

          Let me know if you have any other needs/requests.

          Eric

  19. DL says:

    Hi Eric,
    I have the same problem as Sarah. I am looking forward to hearing what I can do to fix it :) and then begin using it because it sounds like a great plugin! Thank you!!
    DL

    • Eric Lamb says:

      DL,

      You didn’t put a link to your site so I couldn’t take a look. Can you please send me a link so I can troubleshoot?

      You also might want to take a look at Sarah’s issue and check you’re not set up the same way.

      Eric

      • DL says:

        Hi,
        I just checked my settings and the url is matching in my general settings so, I am not sure that is the problem. Thanks for checking for me :)

        • Eric Lamb says:

          DL,

          I went to your site and I can’t find any evidence the plugin is activated. I have confirmed the files are on your server but there’s nothing in your site’s HTML (there should be some javascript in there).

          Can you confirm the plugin is activated? Also, what version of php and WordPress are you using?

          Thanks,
          Eric

  20. DL says:

    WP 8.1 and PHP 5.2.6 I just reactivated the plugin after updating it to version 0.5.1

  21. Eric Lamb says:

    WP 8.1? The latest out is 2.8; can you please confirm this?

    I just went to your site and clicked on a couple links and have verified the site is placing the tracking cookie. Can you confirm this in your click tracker reporting?

    Also, you might want to clear your sites cache. The tracking code isn’t on a few of the pages but this is more than likely due to the cache.

    • DL says:

      Eric,
      I am sorry it is 2.8 I am so use to being 2.7.1 :) I just cleared the cache and it seems that
      The click tracker graph isn’t showing up any clicks :( but I do see that their were links clicked which seems to be working now. :) Does the graph only update every so often or is there something I can do to make it work? Thank you so much for your help in this!!!
      DL

  22. Eric Lamb says:

    The graphs are generated in real-time but on the first day it’ll be tough to notice a difference unless there are a ton of links. Give it about a day and hit me up if you’re not seeing any difference.

    • DL says:

      Ok will do! Thanks! I’ll actually let it run til Monday since it’s a holiday weekend starting tomorrow. So I will let you know then. Thanks for your help Can’t wait to see how this works out for me!
      DL :)

  23. Dave C says:

    I’ve never been able to make this work properly as there seems to be a memory issue.

    PHP Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 48016622 bytes) in t\wp-content\plugins\wp-click-track\click-tracker.php on line 159

    I’ve set my php.ini to absurd amounts of memory and it still happens.

    URL is here: http://www.tiredofit.ca/index.php/equipment/

  24. Carl W says:

    Create plugin fits a gap in the Wordpress.com stats.

    Any chance of the wordpress site address, eg. http://fred.com/ being removed from the display of the destination link and the destination link being displayed to be longer? I have long links on my site and the important bit is too far right to be displayed.

    Thanks.

Leave a Reply