The Facebook Social plugins for Rails 3 consist of:
- Helper::View
- Helper::Script
- Helper::OpenGraph - see opengraph
The Helper::View contains methods for inserting the HTML5 <div> elements for Facebook social plugins
The Helper::Script contains methods for inserting <script> snippets for Facebook integration, such as displaying the Social plugins with the Facebook layout/styling applied etc.
Currently the following Social plugins are included in this gem
- Root
- Activity Feed
- Comments
- Facepile
- Like Box
- Like Button
- Live Stream
- Login Button
- Recommendations Box
- Registration
- Send Button
- Subscribe Button
See detailed usage instructions on the wiki
- async_init_script(app_id, domain, options = {})
- facebook_script(locale = :en)
The async_init_script requires the Facebook app_id, fx '753632322' and the domain name of the app, fx 'www.example.com'. You can also specify the channel file (will default to channel file in vendor/assets of this gem)
- fb_async_init_script(app_id, domain)
- fb_channel_script(locale = :en_US)
- fb_login_click_react(options, &block)
- fb_login_react(options, &block)
- fb_onlogin_react(options, &block)
- fb_onlogin_redirect_to(path, options)
-
fb_logout_click_react(options, &block)
-
fb_logout_react(options, &block)
-
fb_onlogout_react(options, &block)
-
fb_onlogout_redirect_to(path, options)
-
fb_login_and_react(options = {:selector => '#fb_login_and_reload'})
-
fb_logout_and_redirect_to(path, options = {:ready => false})
Convenience method to generate all header/meta tags for Facebook Open Graph
-
open_graph_meta(name, namespace, app_id, object_type, options = {})
-
<head>tag helper* -
og_header(name, namespace)
-
<meta>tag helpers* -
og_type(app_id, object_type)
-
og_title(title)
-
og_image(image_url)
-
og_url(href)
-
og_desc(desc)
-
fb_app_id(app_id)
-
fb_analytics(app_id) # Facebook analytics meta tag
-
fb_activity(namespace, action) # Open Graph action to perform
-
fb_onlogout(script) # setup FB event handler to trigger on FB logout
-
fb_onlogout_redirect_to(path) # setup FB event handler to trigger on FB logout and redirect
Currently the following Social plugins are included in this gem
- Root
- Activity Feed
- Comments
- Facepile
- Like Box
- Like Button
- Live Stream
- Login Button
- Recommendations Box
- Registration
- Send Button
- Subscribe Button
View methods exposed:
- fb_root
- fb_activity options = {}
- fb_add_to_timeline options = {}
- fb_comments options = {}
- fb_facepile options = {}
- fb_like_box (options= {}
- fb_like_button options = {}
- fb_live_stream options = {}
- fb_login_button options = {}
- fb_recommendations_box options = {}
- fb_registration options = {}
- fb_send_button options = {}
- fb_subscribe_button options = {}
Note: You don't have to worry about dashed or underscored properties. Conversions will be handled automatically. The Facebook Social plugins API is (sadly) not very consistent when it comes to attribute names.
Extras:
- fb_logout_button(options = {}) # renders logout button (english only)
Logout button options: html: (html options for anchor tag) size: 'small' or 'large' (size of logout button img)
- Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
- Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
- Fork the project.
- Start a feature/bugfix branch.
- Commit and push until you are happy with your contribution.
- Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
- Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
Copyright (c) 2012 Kristian Mandrup. See LICENSE.txt for further details.