Blog Times Plugin - blojsom 3.0 - Confluence

Availability

BlogTimes Plugin v0.2 is available at Blojsom3 Plugins download page.

Description

Blog Times Plugin generates a graph image summary of the blog entries' posting times with configurable colors and sizes.

Installation and Setup

Place blogtimesplugin-x.y.jar in /WEB-INF/lib/ directory.

Add the following to /WEB-INF/classes/blojsom-plugins.xml file.

<bean id="blogtimes" class="com.mbledug.blojsom.plugin.blogtimes.BlogTimesPlugin" init-method="init" destroy-method="destroy">
    <constructor-arg>
        <ref bean="fetcher"/>
    </constructor-arg>
</bean>

Add the following to /WEB-INF/web.xml file.

<servlet>
    <servlet-name>BlogTimes</servlet-name>
    <servlet-class>com.mbledug.blojsom.plugin.blogtimes.BlogTimesServlet</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>BlogTimes</servlet-name>
    <url-pattern>/blogtimes</url-pattern>
</servlet-mapping>

Modify HTML plugin chain from Blojsom administration menu plugins->mappings
Add "blogtimes" to one of the flavor-based plugin chains. You can place it anywhere within the chain, for example:

html	..., blogtimes, ...

Configure Blog Times properties from Blojsom administration menu weblog settings->properties->set property

Property	Sample Value	Description
blogtimes-image-background-color	ffffff	Hex RGB color for the background of the whole image
blogtimes-bar-border-color	000000	Hex RGB color for the border of the bar image
blogtimes-bar-background-color	ebebeb	Hex RGB color for the background of the bar image
blogtimes-bar-timeline-color	666666	Hex RGB color for the time lines
blogtimes-bar-timeinterval-color	333333	Hex RGB color for the time interval markers
blogtimes-font-color	000000	Hex RGB color for the time unit numbers
blogtimes-bar-height	15	Bar image height in pixels
blogtimes-bar-width	350	Bar image width in pixels
blogtimes-num-latest-entries	100	The number of latest entries' dates to draw on the graph. If not specified or invalid, the value will be set to default 50.

On environment without display make sure the following property is set:

-Djava.awt.headless=true

Usage

Display Blog Times image.
E.g. for asual theme, add the code below to asual.vm template.

<img src="#BlogBaseURL()/blogtimes?flavor=hour-of-day" alt="Blog Times Graph"/>

Available flavours: hour-of-day, minute-of-hour, and second-of-minute.

Demo

Melbourne Photoblog