Difference between revisions of "Click Counter III"

From TNG_Wiki
Jump to navigation Jump to search
Line 25: Line 25:
 
<!-- [http://ccount.degryse-moeys.net/click.php?id=58 ClickCounterIIv1.3.zip] Bart's Click Counter link -->
 
<!-- [http://ccount.degryse-moeys.net/click.php?id=58 ClickCounterIIv1.3.zip] Bart's Click Counter link -->
 
<!-- [http://ccount.degryse-moeys.net/index.php?action=stats&groupid=10  See download statistics] site offline 2019-01-29 -->
 
<!-- [http://ccount.degryse-moeys.net/index.php?action=stats&groupid=10  See download statistics] site offline 2019-01-29 -->
 +
 +
[[[File:Counting_sessions]]
  
 
<br clear="both" />
 
<br clear="both" />

Revision as of 13:23, 30 August 2020

Restricted Downloads of Click Counter III are restricted to logged in users. If you do not have a user account on the TNG Wiki use the Request Account link to request a user account Restricted
Caution If you have trouble downloading with Google Chrome, Vivaldi, Brave or other Chromium based browser, try using a right-click and select Open in new Window, then F5, or use another browser such as Firefox


Caution


Click Counter II
Summary Download Manager
Validation The mod is XHTML compliant.Valid-xhtml10.png
Mod Updated 31 May 2019
Download link
version 3.0
TNG All
Download stats See download statistics
Author(s) Bart 'Roebie' Degryse (no longer online)
Code now supported by Rick Bisbee
Homepage Click Counter III
Mod Support Support for Click_Counter_III
Contact Developer
Latest Mod 3.0
Min TNG V n/a
Max TNG V m/a
Files modified
Related Mods
Notes


[[[File:Counting_sessions]]


Description

Click Counter is a copyrighted, standalone program written by Bart "Roebie" Degryse to detect and save the number of hits on selected website links. TNG mod developers have used it for years to track the number of times their mods are downloaded. The idea is to prioritize maintenance efforts against those mods that are most widely used.

Sadly, Bart suffered a tragic accident several years ago and no longer has an Internet presence. His original program cannot be downloaded from his now-defunct website anymore.

TNG mod developers began offering mods for Click Counter to add additional features like 1) optionally restrict downloads from the TNGWiki to users logged into their wiki accounts, 2) send email notification to the mod developer when one of their mods is downloaded and 3) optionally show geo-location information about the download.

Bart's Click Counter and these mods have been very popular. However, mods are inherently kludgy -- often axes where scalpels are needed. To repair and maintain them, someone has take the time to study the original Click Counter program, understand how the mod code works and then devote considerable time to get everything running correctly again.

Click Counter III integrates the best of the Click Counter II mods into Bart's original program to make it more efficient, bug-free and maintainable going forward. Click Counter III is independent of TNG -- it can be run without even having TNG installed. TNG upgrades should not require revision to Click Counter III.

Please note that Bart Degryse's copyright still covers all versions of Click Counter including this one. Take time to read it carefully. Our hope is that Bart recovers from his injuries soon and returns to the TNG community.

Feature List

  • Count all hits or unique hits
  • Works for regular links as well as download links
  • Password protected admin panel
  • Links can be grouped
  • Statistics per group, per link, per selection of groups or per selection of links
  • Inline statistics
  • Graphical display of number of downloads
  • Database can be stored outside the webroot
  • Downloadable files can be stored outside the webroot
  • Downloads can optionally send email notification to mod developer(s) Redcheck.png new
  • Download links can add cc addresses to email notification Redcheck.png new
  • Email configuration file can be stored outside the webroot Redcheck.png new
  • Email can use TNG config.php file for configuration Redcheck.png new
  • Email notifications can optionally provide geo-location of download Redcheck.png new
  • Extensive documentation
  • Some of the core files can be shared between Click Counter III instances

Requirements

  • A working web server with PHP
  • Enough patience to read the manual.

New Installation

  1. Download the Click Counter III zip file as shown in the summary in the upper right corner of the page.
  2. Extract the 'ccount' folder from the download zip file to your desktop.
  3. Change the name of the folder if you want it named differently.
  4. Inside the folder, click on readme.htm to display the manual in your default browser.
  5. Edit settings.php with values applicable to your website. See the installation chapter in the manual on how to do this.
  6. Upload the click count folder to your website where it can be accessed with a URL.
  7. If you already have a Click Counter database (ccount.db) from a previous installation, copy it into this folder.
  8. If your settings are correct, you can start using Click Counter III by navigating your browser to the Click Count folder, for example, https://www.example.com/ccount
  9. If you get errors or a white screen, go back to your settings, read the applicable area of the manual and make sure you have set them correctly.
  10. Read 'Using Click Counter III' and 'Counting downloads' chapters of the manual for how to use it.

Upgrading to Click Counter III

  1. Use your Click Counter Control Panel to save a copy of your database to your desktop or to another safe location.
  2. Uninstall your Mod Manager mods for Click Counter II.
  3. Rename your website's current Click Counter folder to protect its contents.
  4. Follow the Installation instructions above to add a new Click Counter III folder to your website.
  5. Copy your database backup file (ccount.db) to your new Click Count III folder, overwriting the empty file there.
  6. Do not copy your old settings.php file because the new settings are different. Using your old settings.php will likely cause errors or a white screen. Instead, open them side by side and copy your old settings values to the new settings.php file.
  7. After Click Counter III is up and running you can delete your old CC II folder if you want.

Tip: If you store your database file (ccount.db) outside your Click Counter III folder, it will be protected from being overwritten in future upgrades. Just be sure to point $settings['database'] to its new location.

Screenshots

Click Counter III screenshot of a group of links This image shows the Compact Person Media group. In this group are the three zip files that have been made available so far. You can see how many times each version has been downloaded, when they were added and what their unique id is. You also see the X, O and E buttons for deleting, reseting and editing each link.
To add a new link you have to provide a name and an url for the link. If you want you can also choose the group from the dropdown list. As you can see there is also extra information on each form field. Click Counter III adding a link
Click Counter III link statistics The Click Counter II admin panel also provides some statistics on the links you've created: their number, the total number of clicks, the avarage per link and the link with the most clicks.
Adding a new group with the Click Counter II admin panel is as easy as can be: just provide a group name. Click Counter III adding a group
Click Counter III group statistics The group statistics list all existing groups, their unique id and the number of links in each group. You also see the X and E buttons for deleting and editing each link.
Click Counter III backup and restore
Click Counter III statistics per group Click Counter III can show you statistics per group     
or you can show several groups at once. Click Counter III statistics multiple groups
Click Counter III statistics per link And the same for the individual links: statistics per link...
or statistics for a selection of links, even from multiple groups. Click Counter III statistics multiple links
Click Counter III inline statistics And finally you can have inline statistics.

Revision History

Version Release Date Contents
v3.0 28 Aug 2020 Initial release

Sites Using This Add-on

Please add your site to the table if you use this modification.

URL User Note Mod-Version TNG-Version User-language
A Bisbee Family History Rick Bisbee A must-have for mod developers v3.0 12.3 English
Our Roy and Boucher Families Ken Roy Worked with Rick Bisbee to test this replacement of Bart's Click Counter II and Jeff Robison Click Counter II Email Notify v3.9 12.3 English, French