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

= Trac Facebook Plugins =

== Description ==

Simple Trac wiki macro's for [http://facebook.com Facebook] [http://developers.facebook.com/plugins plugins].

== Bugs/Feature Requests == 

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

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

== Download ==

Download the zipped source from [http://github.com/collab-project/trac-facebook-plugins/archives/master here].

== Source ==

You can check out TracFacebookPluginsMacro from [http://github.com/collab-project/trac-facebook-plugins here] using [http://git-scm.com Git], or [http://github.com/collab-project/trac-facebook-plugins browse the source].

== Example ==

=== Like Button ===
The [http://developers.facebook.com/docs/reference/plugins/like Like button] lets
users share pages from your site back to their [http://facebook.com Facebook]
profile with one click.

Screenshot:

[[Image(like.png)]]

Examples:
{{{
[[LikeButton]]                                   # current page
[[LikeButton(http://google.com)]]                # google.com with default layout
[[LikeButton(http://google.com,button)]]         # button layout
[[LikeButton(http://google.com,box)]]            # box layout
}}}

=== Like Box ===
The [http://developers.facebook.com/docs/reference/plugins/like-box Like box] is a social plugin
that enables [http://facebook.com Facebook] Page owners to attract and gain Likes from their own website.

Screenshot:

[[Image(likebox.png)]]

Examples:
{{{
[[LikeBox]]                                                         # current Trac page
[[LikeBox(http://www.facebook.com/sonicyouth)]]                     # Sonic Youth fanpage on Facebook without stream/header
[[LikeBox(http://www.facebook.com/sonicyouth,stream)]]              # with stream
[[LikeBox(http://www.facebook.com/sonicyouth,header)]]              # with header
[[LikeBox(http://www.facebook.com/sonicyouth,full)]]                # with stream and header
}}}

=== Activity Feed ===

The [http://developers.facebook.com/docs/reference/plugins/activity Activity Feed]
plugins displays the most interesting recent [http://facebook.com Facebook] activity
taking place on your site.

Screenshot:

[[Image(activity.png)]]

Examples:
{{{
[[ActivityFeed]]                                 # current Trac page
[[ActivityFeed(http://google.com)]]              # google.com with recommendations
[[ActivityFeed(http://google.com,false)]]        # without recommendations
}}}

== Recent Changes ==

[[ChangeLog(tracfacebookpluginsmacro, 3)]]

== Author/Contributors ==

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