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

= Trac Facebook Plugins

== Description

Simple Trac wiki macros 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 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].

== Example

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

== Recent Changes

[[ChangeLog(tracfacebookpluginsmacro, 3)]]

== Author/Contributors

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