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

= Ohloh 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 software is about 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.

== Example ==
Display a single widget by specifying your project id and the widget name (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.

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.

== Source ==

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].

== Recent Changes ==

[[ChangeLog(ohlohwidgetsmacroplugin, 3)]]

== Author/Contributors ==

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