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

= Use Facebook plugins within Trac

== Description

These are a few simple Trac wiki macros for [https://developers.facebook.com/docs/plugins/page-plugin Facebook plugins].

=== Like Button

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

Screenshot:

[[Image(like.png)]]

Examples:
{{{
[[LikeButton]]                                   # current Trac 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 Facebook Page owners to attract and gain Likes from their own website.

Screenshot:

[[Image(likebox.png)]]

Examples:
{{{
[[LikeBox(sonicyouth)]]                     # Sonic Youth fanpage on Facebook without stream/header
[[LikeBox(sonicyouth,stream)]]              # with stream only
[[LikeBox(sonicyouth,header)]]              # with header only
[[LikeBox(sonicyouth,full)]]                # with both stream and header
}}}

=== Activity Feed

The [http://developers.facebook.com/docs/reference/plugins/activity Activity Feed] plugins displays the most interesting recent 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
}}}

=== Recommendations

The [http://developers.facebook.com/docs/reference/plugins/recommendations Recommendations] plugin shows personalized Facebook recommendations to your users.

Screenshot:

[[Image(recommendations.png)]]

Examples:
{{{
[[Recommendations]]                                 # current page
[[Recommendations(http://python.org)]]              # python.org
}}}

== Bugs/Feature Requests

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

If you have any issues, create a 
[/newticket?component=TracFacebookPluginsMacro new ticket].

[[TicketQuery(component=TracFacebookPluginsMacro&group=type,format=progress)]]

== Download

Download the compressed 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].

== Recent Changes

[[ChangeLog(tracfacebookpluginsmacro, 3)]]

== Author/Contributors

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