Plugin Availability The XPath and XPath Search plugins are available in the blojsom add-on bundle. This is a separate download from the blojsom.war file.

Description

After downloading the blojsom add-on bundle, copy the blojsom-addon-plugins-{version}.jar and commons-jxpath-1.1 file into your /WEB-INF/lib directory.

The XPath and XPathSearch plugin allow you to search your blog using XPath queries. The XPath plugin differs from the XPathSearch plugin in that a different URL parameter is used for the XPathSearch plugin. The XPath Search plugin is an extension of the Simple Search plugin in that if a query starts with a leading '/', then the plugin assumes an XPath syntax is being used, otherwise the search is handled by the Simple Search plugin.

Installation and Setup

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

xpath=org.blojsom.plugin.trackback.XPathPlugin

xpath-search=org.blojsom.plugin.xpath.XPathSearchPlugin

You may then add "xpath" or "xpath-search" to one of the flavor-based plugin chains. If you are using the XPath Search plugin to replace the Simple Search plugin, then replace the Simple Search plugin short name (usually "simple-search) with the XPath Search plugin short name. These plugin chains can be found in the individual user's plugin.properties file. For example:

html.blojsom-plugin-chain=..., xpath, ...

Usage and URL Parameters

URL parameters

The following table describes the URL parameters that affect the output of the XPath and XPath Search plugin.

URL parameter	Accepted values	Usage
xpath	XPath query	Used to search blog entries if using the XPath plugin.
query	XPath query	Same as the Simple Search plugin if using the XPath Search plugin.