Tag Archive for ‘Tiny Stats’

Hacking Mint to Recognize Modern Operating Systems

Despite Shaun Inman’s announcement late last year that he was suspending sales and support for Mint, I’ve continued to use the software to track visitor statistics on Initial Charge. In the eight years since I first installed Mint on my server, I haven’t found anything that offers the same level of simplicity, clean design, and overall peace of mind about where my stats data is stored.

I’ll continue to keep my eye out for alternatives, but nothing’s unseated Mint yet. Piwik and Tiny Stats came close. But no one I know that has tried Piwik has stuck with it and when I tried Tiny Stats, I ran across a few bugs that soured the experience for me. I’ll probably move to something new eventually, but I don’t foresee that happening anytime soon.

UserAgent 007 on iPhone

With my continued use of Mint, there is one bit of code that will have to be updated regularly — the list of recognized operating systems in the User Agent 007 pepper. For those who are unfamiliar with Mint, the software has support for plugins, called “Pepper”, that can enhance the core software’s features. User Agent 007 keeps track of what browser and operating systems your visitors are using, as well as the display resolution and whether or not they have Flash installed (which is far less useful in 2017 than it was in 2007).

In order for UserAgent 007 to recognize operating systems newer than Windows 8 and Mountain Lion — which were added in the last update — you’ll have to edit the class.php file located in mint/pepper/shauninman/useragent007/. I highly suggest making a backup of this file just in case something goes wrong.

Windows Versions Array in UserAgent 007

Within class.php, you’ll want to look for an array that tells Mint how to determine what version of Windows the visitor is using. If you’ve never edited this file before, the top entry in the array should be Windows 8. To add support for Windows 8.1 and Windows 10, simply add the following two items above the Windows NT 6.2 entry, just as I’ve done in the image above.

'Windows NT 10.0' => '10',
'Windows NT 6.3' => '8.1',

macOS Versions Array in UserAgent 007

Scrolling down a bit further within class.php, you should find an array with versions of macOS listed. The last one should be Mountain Lion. To add support for newer versions of macOS, be sure to add a comma after the Mountain Lion entry and add the following five items, just as I’ve done in the image above.

'10.9' => 'Mavericks',
'10.10' => 'Yosemite',
'10.11' => 'El Capitan',
'10.12' => 'Sierra',
'10.13' => 'High Sierra'

Unfortunately, this doesn’t retroactively change the statistics that have already been recorded. But eventually, the “Unknown” listing will be replaced in your short-term platform stats with properly identified operating system names. And without officially released updates to the UserAgent 007 pepper, as long as you’re still using Mint, this process will have to be repeated as new operating systems are released with the correct version number and OS name. But this will certainly add some longevity to Mint for us users who aren’t ready to move on just yet.