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

== Bugs/Feature Requests == 

Existing bugs and feature requests for OhlohWidgetsMacroPlugin are 
[report:9?COMPONENT=OhlohWidgetsMacroPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=OhlohWidgetsMacroPlugin&owner=felix_schwarz new ticket].

== Download ==

Download the zipped source from [download:ohlohwidgetsmacroplugin here].

== Source ==

You can check out OhlohWidgetsMacroPlugin from [http://trac-hacks.org/svn/ohlohwidgetsmacroplugin here] using Subversion, or [source:ohlohwidgetsmacroplugin browse the source] with Trac.

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

== Recent Changes ==

[[ChangeLog(ohlohwidgetsmacroplugin, 3)]]

== Author/Contributors ==

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