Before you install this plugin be aware that you must have modified SlimStat to track cities, as well as you will need a Google Map API Key for your own site.

The Google Map PHP API is a slightly modified version of Monte Ort’s creation here. I’ve modified it so that it retrieves using CURL instead of fopen since on some servers that has been disabled due to security. If you find you get errors using the one I included simply download Monte’s original.

This is what GMapped produces once you have been tracking cities for awhile. Since I had SlimStat installed for awhile there are some records in the database that do not contain coordinates to plot on the map, therefore it does not show all the records. It will show the same records as what is displayed when you view Paths.

To install simply extract the archive into the plugins directory and make a few changes to the index.php to include your Google Map API Key and to change the references to the browser icons if necessary.

You will also need to add the following to the /slimstat/_css.css file:


/* GMapped */
.gmapSidebarItem {
list-style: none;
border-bottom: 1px dotted #ccc;
background-color: #eee;
padding: 2px 2px 3px 3px;
}
#sidebar_mymap {
width: 200px;
height: 450px !important;
overflow : auto;
border-bottom: 1px solid #369;
}


After you’ve done all that you just need to wait for enough visitors to be logged with coordinates and you’re set.

Latest Version:

Download GMapped_v01.zip

Version History:

v0.1 – June 8, 2006

• Initial Release

Feedback, suggestions, bugs etc can be posted here or in the Google SlimStat Group

First of all although I had enabled recording of the user_agent string in my installation there was no real way of accessing that information easily. SlimStat is made to be simple and provide quick information at a glance which it does, but I wanted a way of viewing the sometimes vital extra information that SlimStat does not include.

Also when I viewed where the referrer’s were coming from the external link would open within the same window, which is a pain in the butt to then have to click back again.

Also with my modification to SlimStat to record cities as well as latitude and longitude, I wanted to view this city data not just in the details screen

As a result this is what I have come up with.

• Cities are displayed to the right of the country.
• External links are targeted to a new window (since I use tabbed browsing, a new tab)
• Hovering over the browser displays the user agent string, or clicking on it will “alert” you of the string

To use this plugin you will need to have modified your SlimStat to track cities. You can learn more about that here

Latest Version:

Download SuperPaths_v01.zip

Version History:

v0.1 – June 08, 2006

• Display cities
• Display user_agent string
• Load external links in new window

As usual feedback and suggestions are welcome and can be left here or in the SlimStat Google Group

The idea behind these modifications is to make as few changes as possible so future updates to slimstat are easily done. Otherwise they could have been implemented into the setup file etc. (perhaps in future releases Stephen might want to adopt the Maxmind database). Before you make any changes it is recommended that you backup your database. I take no responsibilty if something goes wrong.

First you'll need to add 3 additional fields to the table "slimstat" in your database. Add the following 3 after the country field. We will store the latitude and longitude to provide the coordinates for my plugin which will allow mapping of visitors.

city varchar(50), latitude varchar(12), longitude varchar(12)

We will also need to edit the following files (if you prefer you can download a zip of these modified files at the bottom of the page):

- i18n\en-us\index.php
- _config.php
- _details.php
- inc.stats.php

Depending on what language you are using you'll want to edit the appropriate index.php located in the language directory that you use.

i18n\en-us\index.php

Look for the following at line 135:

"country" => "Countries",

Now add below it:

"city" => "Cities",

_config.php

Look for the following at line 124:

"country" => true, // Countries

Now add below it:

"city" => true, // Cities

_details.php

Look for the following at line 268:

if ( $config->show_modules["country"] && SlimStat::is_ip_to_country_installed() && !isset( $filters["filter_country"] ) ) {
print SlimStat::render_module(
$config->i18n->module_titles["country"],
percentage_table( "country", $config->truncate, "", $filters )
);
}


Add directly below it this snippet:

if ( $config->show_modules["city"] && SlimStat::is_ip_to_country_installed() && !isset( $filters["filter_city"] ) ) {
print SlimStat::render_module(
$config->i18n->module_titles["city"],
percentage_table( "city", $config->truncate, "", $filters )
);
}


inc.stats.php

Find the line that has this:

$stat["country"] = SlimStat::my_esc( $this->_determine_country( $stat["remote_ip"] ) );

Now add this directly below it:


if (file_exists(realpath( dirname( __FILE__ ) )."/GeoLiteCity.dat")){
include(realpath( dirname( __FILE__ ) )."/geoipcity.inc");
$gi = geoip_open(realpath( dirname( __FILE__ ) )."/GeoLiteCity.dat",GEOIP_STANDARD);
$record = geoip_record_by_addr($gi, $stat["remote_ip"]);
$stat["city"] = $record->city;
if (empty($stat["city"])) {
$stat["city"] = "Unknown";
}
$stat["latitude"] = $record->latitude;
$stat["longitude"] = $record->longitude;
geoip_close($gi);
} else {
$stat["city"] = "Unknown";
$stat["latitude"] = "Unknown";
$stat["longitude"] = "Unknown";
}

That's it for the files, what you will need to do next is obtain the database that has the cities from Maxmind located here:

Download GeoLiteCity.dat.gz

You will also need to obtain the php API files from here: Maxmind PHP API

The files you will need are:
geoip.inc
geoipcity.inc
geoipregionvars.php

Once you have all those files you'll want to extract GeoLiteCity.dat file from the zip archive and along with the 3 api files upload them to the /slimstat directory

Okay that's it now it'll start recording the cities. The database also contains the province/state however I figure that isn't necessary since we want to keep the database and SlimStat as Slim and quick as possible, besides the latitude & longitude more than help us figure out where it is located

If you want to be able to view the city information in the "Paths" be sure to get my updated plugin. Also if you wish to have the locations plotted onto a map get my GMapped plugin

Here are all the modified files in an archive. Keep in mind if you have modified your SlimStat install you're probably safer off making the changes manually as these files may overwrite any changes you have made. Again backup everything first.

Download slimstat_cities.zip

Quick rundown/history of SlimStat: Shaun Inman creates ShortStat (which becomes the basis of Mint). Stephen Wettone evolved ShortStat into something equally simple yet more powerful (in my opinion) named SlimStat.

I found that the free ip-to-country database from webhosting.info is updated on a fairly consistent basis. I also noticed that I was still getting a few “Unknown” countries listed in my stats.

So what I’ve done is simply taken the code from the original setup file and placed it into the menu system to allow for easy updating of the ip-to-country file.

Screenshots:

As of version 1.0 what you will initially see upon accessing the CountryUpdate plugin page is a quick status as to the latest version of the ip-to-country database available from webhosting.info compared to the date of your database revision you are using on your site. The main important information is whether your installation is designated “Fresh” or “Stale”. If it is stale you can simply select “Automatic” which will automatically retrieve from the webhosting.info server the appropriate file and insert it into your database. (this process can take a few minutes). An alternative is if you happen to like to go through each step manually, you can go and download the database, and manually upload it in either csv or zip format (zip is the wiser choice as it is a smaller size and quicker upload).

This is the old initial screen prior to v1.0. It is simply a form that allows you to upload the ip-to-country.csv file. There is no upload status indicator, so please be patient when you’re uploading as this file is rather large (if you’re uploading the csv file).

After the file is completed uploading it will then run through the familiar screen of importing the records required to convert the ip addresses to a country. * Please note it is a known issue that for some users it will simply run through the entire process of importing the records before presenting you with this final screen at once *.

In order for this plugin to work, you must have opted to use the ip-to-country database when you initially installed SlimStat

Installation is extremely easy, simply download the file and unzip the contents into the SlimStat plugin directory. Instructions are also included in the zip file.

Upgrade Information:

v1.0 to v1.1 – you will only need to overwrite the index.php file in your installation.
v0.5 to v1.0 – you will only need to overwrite the index.php file in your installation.
v0.1 to v1.0 – you will need to overwrite all files.

Latest Version:

Download CountryUpdate Version 1.1

Version History:

v1.1 – Dec 9, 2006

• Minor Update To Ensure Compatibility with PHP 4 & 5

v1.0 – Jun 26, 2006

• First full version number 1.0 WOOHOO!
• Enlarged “Freshness” Indicator
• Automatic vs Manual options of updating database
• Fully Automatic requiring no user intervention: retrieves file remotely from webhosting.info, unzips file, inserts data into database.

v0.5 – May 16, 2006

• Ability to upload the Zip file as well as extracted CSV file
• Status of whether webhosting.info has updated the ip-to-country.csv.zip file

v0.1 – Apr 02, 2006

• ability to update ip-to-country database
• initial release

Feedback and Suggestions are welcome and can be left here or in the SlimStat Google Group.