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.
Configuration
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:
Configuring the Popular Content settings for the popular_content_view
In order to make use of the built in @@popular_content_view you will need to register an “awstats popular page”
If you need to find the “awstats popular page” you will need to provide the url from your awstats installation that provides the full list of Page URLs then follow the link to the “Full list” It will look something like this:
Add that url as the awstats_hitcounter url_of_popular_page value (see the image below).
Usage
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
The Popular Content Portlet
This add-on provides a “Popular Content Portlet”. It can either make use of the global settings or use settings specific to the portlet.
The portlet is used to present the most popular content on your website, based on awstats.
If you prefer to configure all settings in the context of the portlet, you will need to provide the url from your awstats installation that provides the full list of Page URLs then follow the link to the “Full list” It will look something like this:
Copy the url associated with that page, you’ll need it when adding the portlet.
Decide where in your site you want the portlet to be located and using the ‘manage portlets’ link add a new ‘Popular Content Portlet’. You’ll see a screen similar to this:
We recommend that you leave the “Read settings from the global registry” option selected, this has the effect of overriding the values of the settings highlighted in orange below. (The global registry is also used for the Popular content view).
Use the Blacklist to prevent particular URLs from showing up in popular content.
Use the White list to specify what content types are allowed in the portlet.
Contributors
David Bain, david@alteroo.com
Changelog
0.1.5
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
0.1.4
added support for hits (not just page views) [pigeonflight]
0.1.3
moved the stats viewlet to the top of the portal footer viewlet manager [pigeonflight]
0.1.2
fixed a problem with the way the path was retrieved [pigeonflight]
now counts downloaded attachments different from views [pigeonflight]
0.1.1
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]
0.1
Initial release. [pigeonflight]
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file collective.awstats_hitcounter-0.1.5.tar.gz.
File metadata
- Download URL: collective.awstats_hitcounter-0.1.5.tar.gz
- Upload date:
- Size: 27.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 735b013ac5e54e5bfbc1435f33fcfca54d7d688a5e0bf549b85eb50d1360ded7 |
|
| MD5 | aa2ed4e156474aa59f8251bc3963ddfd |
|
| BLAKE2b-256 | be1ac05a6696eacc61ed9f074ac744268b8b54d06ce2850b3929b380528deb10 |
