Skip to main content

Grabs hit counts from awstats and returns as json formatted data

Project description

Grabs hits, views and popular content based on awstats data and presents this information in the context of your Plone site. Provides a “Popular Content” portlet for displaying popular content from awstats.

Installation & Usage

Add collective.awstats_hitcounter to your buildout and re-run bin/buildout

Then install on your plone site under “Site Setup” > “Add-ons”

Once this is installed you know have the facility to dynamically pull in a counter.


After installation configure your awstats url. You can do so by going to Site Setup > Awstats HitCounter Settings.

Set the absolute url to look similar to this:


Sometimes you want to make sure things are working. The following can be done on a non-production server.


Launch the instance with the env var DUMP_RAW_AWSTATS_URLS as follows:

DUMP_RAW_AWSTATS_URLS=1 bin/instance fg

This tells the system to skip comparing awstats values to the site catalog. Effectively you’ll just get a ‘raw’ dump of the URLs returned from AWSTATS. This is very useful for troubleshooting and diagnosing if scraping is working at all.


collective.awstats_hitcounter adds a viewlet with the id ‘awstats_hitcounter’ which pulls in the stats from awstats.

Add this javascript at the bottom of pages where you want the counter to show:

$("#awstats_hitcounter").load(window.location.pathname + "/@@awstats_hitcounter_view")

The screenshot below illustrates the expected behaviour


  • add on listens for the existence of the env var DUMP_RAW_AWSTATS_URLS, useful for testing and troubleshooting
  • @@popular_content_view can now be configured to say how many items should show on the page. This setting is managed in the registry. The default value is 150.


  • added a popular content view
  • added a popular content portlet
  • added a content type whitelist to the portlet
  • added a url black list to the portlet
  • added an option to filter out direct downloads from the portlet


  • added support for hits (not just page views) [pigeonflight]


  • moved the stats viewlet to the top of the portal footer viewlet manager [pigeonflight]


  • fixed a problem with the way the path was retrieved [pigeonflight]
  • now counts downloaded attachments different from views [pigeonflight]


  • moved the hitcounter viewlet to the viewlets.IPortalFooter
  • added custom app.js which asynchronously pulls stats from the ‘awstats_hitcounter_view’
  • the stats view now returns the content type, creation date and number of views [pigeonflight]
  • update to use BeautifulSoup for scraping awstats [pigeonflight]


  • Initial release. [pigeonflight]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

collective.awstats_hitcounter- (31.4 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page