Availability

The Blog Statistics plugin can be downloaded from the blojsom plugins download page.

Description

Allows a blog owner to embed statistical information about their blog. It provides the author with the following, number of posts for month X, average number of posts per month, average words per post, total number of blog posts, most active time period (with user defined granularity), trackback and comment statistics.

Installation and Setup

Place the blog-statistics-plugin-1.0.jar in blojsom's /WEB-INF/lib directory.

In your global /WEB-INF/plugin.properties file, add the following line:

blog-statistics=com.richardspackmann.blojsom.plugin.statistics.BlogStatisticsPlugin

You may then add "blog-statistics" to one of the flavor-based plugin chains. These plugin chains can be found in the individual user's plugin.properties file. For example:

html.blojsom-plugin-chain=...,blog-statistics,...

The Blog Statistics plugin has its own configuration file, blogstatistics.properties, that is referenced in /WEB-INF/web.xml.

<init-param>
    <param-name>plugin-blogstatistics</param-name>
    <param-value>blogstatistics.properties</param-value>
</init-param>

The blogstatistics.properties file will be located in the respective /WEB-INF/(blog-id) directories and has a number of configurable parameters:

# Set to -1 if you do not wish to restrict a maximum number of entries
# If you set this value, then only monthly statistics will be available
max-entries-to-query=-1

enable-wordcount=true

enable-trackbacks-stats=false

enable-comments-stats=false

# This field will enable/disable the hourly stats functionality
enable-hourly-stats=true

# This field defines the number of hourly divisions the day should be broken up
# into. If this field is 3 for example, the there will be three divisions of
# eight hours a piece in the following segments:
#                    00:00-07:59, 08:00-15:59, 16:00-12:59
# Valid entries for this field are the following:
#                               2, 3, 4, 6, 8, 24
# Note that the larger the number of divisions, the finer the accuracy and the
# higher the calculation overhead.
number-of-hourly-divisions=8

Usage and URL Parameters

The included "temp-blog-statistics.jsp" illustrates how to use the Blog Statistics plugin.