[[PageOutline(2-5,Contents,pullout)]]

= Ohloh statistics widgets macro

== Description

[http://www.ohloh.net Ohloh] has some nice [https://www.ohloh.net/p/ohloh_widgets_macro/widgets widgets] which you can put on your site to show some statistics about your project. This plugin is a [trac: Trac] macro to make embedding these widgets in your Trac wiki easy and does not force you to lower Trac's security settings.

Also this macro has a special API so you can modify any Ohloh widget so it blends in better with your layout.

== Examples

Display a single widget by specifying your project id and the widget name, ie the Javascript file name without the '.js' suffix:
{{{
[[OhlohWidget(483602, project_basic_stats)]]
}}}

Also you can display a group of widgets together:
{{{
[[OhlohWidgetGroup(483602, project_basic_stats, project_factoids, project_users?style=green)]]
}}}
This has the advantage that all widgets are grouped in a div so you can style it easily.

== Screenshots

[[Image(wiki:OhlohWidgetsMacroPlugin:ohloh_widgets_macro.png)]]

Check the '''[http://www.schwarz.eu/opensource/projects/ohloh_widgets_macro/ online demo]''' to see the macro in action.


== Source

Actual development and bug tracking happens on '''[http://www.schwarz.eu/opensource/projects/ohloh_widgets_macro/ macro development site]'''. You can also find more information about the API to customize Ohloh plugins on that page.

The [http://oss.schwarz.eu/cgi-bin/hgwebdir.cgi/ohloh_widgets_macro source code] is in a hg repository under the very liberal [http://en.wikipedia.org/wiki/MIT_License MIT license].

== Author/Contributors

'''Author:''' [wiki:felix_schwarz] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''