Count Active Users On Your Web Site
By Pablo Varando

Have you ever wanted to display a count of how many people are on your web site at any given moment? This tutorial will demonstrate to you how to achieve just that. It will count your web site's active sessions and allow you to display them to your visitors.

The first thing we need to do is check the Application.UsersInfo Structure to see if it already
exists or else lets create it. This is achieved in the "
Application.cfm" after your <cfapplication> tag.

<cflock timeout="15" scope="APPLICATION" type="EXCLUSIVE"
    <cfif NOT isDefined(
          <cfset Application.UsersInfo = StructNew()>

Ok now we need an unique variable to so we can reference the Structure for this particular user, 
so I'm going to use cfid, you can use the IP or anything you like but try to make unique. 

<cflock name="#CreateUUID()#" timeout="15" type="EXCLUSIVE">
      <cfset user_cfid = Evaluate(CFID)>
      <cfset user_time = Now()>

Ok now let's check if the user its already counted or if it exists on the structure, this is why we
need an unique ID, else let's add it, we have a new users online. 

<cflock scope="APPLICATION" type="EXCLUSIVE" timeout="15">
 <cfif NOT StructKeyExists(Application.UsersInfo, user_cfid)>
  <cfset temp = StructInsert(Application.UsersInfo, user_cfid, user_time)>

Ok now, we have to create a way to delete them so they don't stay in the list forever, I'm
going to use a 10 minutes difference, to expire the user, remember this code should be in
your application.cfm or included in your application.cfm, we are going to use the DateDiff to
find out if the structure should be deleted.

<cflock scope="APPLICATION" type="EXCLUSIVE" timeout="15">
 <cfloop collection=
"#Application.UsersInfo#" item="itmUser">
"n", StructFind(Application.UsersInfo, itmUser), Now())) GT 10
    <cfset StructDelete(Application.UsersInfo, itmUser)>

Please note the the GT 10 can be any value you choose. Simply make is any number and that is the lenght back it will go to retrieve users using the application. Next let me show you how to count the structure to get the display value for the web site.

Create the the page that displays the users count: Call is "users_count.cfm".

Simply us this piece of code where you want to show how many users are currently connected to your website.

<cflock scope="APPLICATION" type="EXCLUSIVE" timeout="10">
Total Active Sessions : #StructCount(Application.UsersInfo)#

Now wherever you want to display the count, simply include the file as follows:
<cfinclude template="users_count.cfm">

That's it, you have now counted visitors sessions and are able to display them to the visitors of your site.

About This Tutorial
Author: Pablo Varando
Skill Level: Advanced 
Platforms Tested: CF5
Total Views: 156,004
Submission Date: August 25, 2002
Last Update Date: June 05, 2009
All Tutorials By This Autor: 47
Discuss This Tutorial
  • I did find this code not too long ago, that is similar to Pablo's code, but I found it was easier to modify to get the user name. if (NOT IsDefined("Application.SessionTracker") OR NOT IsStruct(Application.SessionTracker)) { Application.SessionTracker = StructNew(); } UserInfo = CGI.REMOTE_ADDR; if (IsDefined("Cookie.CGCoreFullName") AND Len(Trim(Cookie.CGCoreFullName))) { UserInfo = Cookie.CGCoreFullName & " on " & CGI.REMOTE_ADDR; ModBy = Cookie.CGCoreFullName; } dummy = StructInsert(Application.SessionTracker, UserInfo, Now(), true);

    Live Session-Tracker Report

    User (by IP-address) Session-Status
    #aUser# inactive since #inactiveSince# mins

    #StructCount(APPLICATION.SessionTracker)# Users online This gets the users ip address, so I just grabbed the username from my users table where the ip address (#aUser#) = users.last_ip. I then just looped that query inside the 'Output of Current User' section. It worked great, the only other thing I had to change was the timeout time. I actually started using minutes rather than hours.

  • I am getting an error when I run this code The value class coldfusion.runtime.Array could not be converted to a date.

  • Why did you make the cflock name #createuuid()#?

  • I agree with Sean, adding who is logged into the system would be cool. (I am using the CFlogin framework)

  • How might I track the users name and display that as well? THe Code works great as is, but adding a name listing would be interesting as well!


Website Designed and Developed by Pablo Varando.