This plugin was distributed previously as part of the McKessonApsWikiPlugins package, now as part of the CeryleWikiPlugins. This documentation is updated for the new version as appropriate.

!! Description

The __~TickerPlugin__ is a simple plugin that will display the current price of a stock on a page.  e.g.

The current price of IBM on the NYSE is
\\[[{INSERT org.ceryle.wiki.plugin.ticker.TickerPlugin symbol=IBM}]

It is possible to shorten the plugin syntax for the examples above to [[{Ticker symbol=IBM}] and [[{Ticker symbol=IBM.BA] if you add {{org.ceryle.wiki.plugin}} to the {{jspwiki.plugin.searchPath}} property in your jspwiki.properties.

With the shortened syntax, the current price of IBM on the NYSE is
\\[[{Ticker symbol=IBM}],

and on the Buenos Aires exchange its: 
\\[[{Ticker symbol=IBM.BA}]

would display as...

The current price of IBM on the NYSE is: [IBM:79.95|http://finance.yahoo.com/q?s=IBM&d=t], and on the Buenos Aires exchange its: [IBM.BA:25.003|http://finance.yahoo.com/q?s=IBM.BA&d=t]

!! Design Notes

Uses Yahoo Finance as its source.

* Supported stock exchanges: [http://finance.yahoo.com/sd]
* Info about Yahoo spreadsheet format: [http://biz.yahoo.com/f/q.html#spreadsheet]

!! Parameters

Only the {{symbol}} parameter is required, and it can have values like __{{IBM}}__ or __{{IBM.BA}}__ where the dot suffix indicates the exchange (ala Yahoo).

While it may be desirable to have a {{format}} parameter that would allow Day/Week/Quarter/Year Hi/Lo/Close/Current values to be displayed, this is not currently implemented. An outlink to the Yahoo site for the full current quote details is sufficient.

!! Status/Notes

Included in the McKessonApsWikiPlugins jar. -- JohnVolkar\\
Now included in the CeryleWikiPlugins.jar. -- MurrayAltheim