EXT: Facebook: Social Plugins

Extension Key: facebook_socialplugins

Language: en

Keywords: facebook, social plugins, social network, social media, refresj, nitin

Copyright 2000-2010, Nitin Sewtahalsing, <nitin@refresj.nl>, www.refresj.nl

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.org

Table of Contents

EXT: Facebook: Social Plugins	1

Introduction	3

What does it do?	3

TYPO3 Forge	3

Screenshots	3

Users manual	4

Configuration	5

Constants	5

Setup	5

General settings	5

Social Plugin: Activity Feed	5

Social Plugin: Comments	5

Social Plugin: Facepile	6

Social Plugin: Like Button	6

Social Plugin: Like Box	6

Social Plugin: Live Stream	7

Social Plugin: Login Button	7

Social Plugin: Recommendations	7

ChangeLog	8

Introduction

What does it do?

Social plugins let you see what your friends have liked, commented on or shared on sites across the web. All social plugins are extensions of Facebook and are specifically designed so none of your data is shared with the sites on which they appear.

All social plugins from Facebook: Activity Feed, Comments, Facepile, Like Button, Like Box, Live Stream, Login Button and Recommendations. All with the JavaScript SDK. Like Button with Open Graph metatags.

Fully configurable with TypoScript.

Demo at: http://nitinsewtahalsing.nl/typo3-extensies/facebook-social-plugins.html

TYPO3 Forge

If you have any bug/feature reports, please add it on TYPO3 Forge:

http://forge.typo3.org/projects/show/extension-facebook_socialplugins

Screenshots

Users manual

Create a new Facebook App here: http://www.facebook.com/developers/createapp.php

Copy the App-ID and insert it as a constant. Like: plugin.tx_facebooksocialplugins.appID = 123456789012345

Include the static template in your ts template

Insert the plugin

Configuration

There are 2 ways to use this plugin:
1. The original insert plugin way (The TS setup for the social plugins will not be used).
2. TypoScript, see options below:

Constants

plugin.tx_facebooksocialplugins.

Property:	Data type:	Description:	Default:
appID	string	Facebook App-ID	
language	string	The language of the plugin: Use like: en_US, nl_NL, etc.	en_US
templateFile	string	Template file to use	EXT:facebook_socialplugins/pi1/template.html

Setup

General settings

plugin.tx_facebooksocialplugins_pi1.

Property:	Data type:	Description:	Default:
staticTemplateCheck	boolean	Check if static template is included	1
appID	string	Facebook App-ID	{$plugin.tx_facebooksocialplugins.appID}
language	string	The language of the plugin: Use like: en_US, nl_NL, etc.	{$plugin.tx_facebooksocialplugins.language}
templateFile	string	Template file to use	{$plugin.tx_facebooksocialplugins.templateFile}
type_form	string	Which social plugin. Possible values: activity_feed, comments, facepile, like_button, like_box, live_stream, login_button, recommendations	

Social Plugin: Activity Feed

http://developers.facebook.com/docs/reference/plugins/activity

plugin.tx_facebooksocialplugins_pi1.activity_feed

Property:	Data type:	Description:	Default:
a_show_in_iframe	boolean	Show in iFrame (not recommended!)	0
a_domain	string	Domain	
a_width	int	Width of the plugin	300
a_height	int	Height of the plugin	300
a_show_header	boolean	Show header in the box	1
a_color_scheme	string	Color scheme of the plugin. Possible values: light, dark	light
a_font	string	Font of the plugin. Possible values: arial, lucida+grande, segoe+ui, tahoma, trebuchet+ms, verdana	arial
a_border	string	Border Color (hex value)	

Social Plugin: Comments

http://developers.facebook.com/docs/reference/plugins/comments

plugin.tx_facebooksocialplugins_pi1.comments

Property:	Data type:	Description:	Default:
b_unique_id	int	Unique ID	
b_number	int	Number of comments	10
b_width	int	Width of the plugin	450
b_publish_feed	boolean	Publish feed	1

Social Plugin: Facepile

http://developers.facebook.com/docs/reference/plugins/facepile

plugin.tx_facebooksocialplugins_pi1.facepile

Property:	Data type:	Description:	Default:
c_url	string	URL	
c_num_rows	int	Number of rows	10
c_width	int	Width of the plugin	450

Social Plugin: Like Button

http://developers.facebook.com/docs/reference/plugins/like

plugin.tx_facebooksocialplugins_pi1.like_button

Property:	Data type:	Description:	Default:
d_show_in_iframe	string	Show in iFrame (not recommended!)	0
d_url	int	URL to Like	
d_layout_style	int	Layout Style. Possible values: standard, button_count, box_count	standard
d_show_faces	boolean	Show Faces	0
d_width	int	Width of the plugin	450
d_height	int	Height of the plugin	100
d_verb	string	Verb to display. Possible values: like, recommend	like
d_font	string	Font of the plugin. Possible values: arial, lucida+grande, segoe+ui, tahoma, trebuchet+ms, verdana	arial
d_color_scheme	string	Color scheme of the plugin. Possible values: light, dark	light
d_og_title	string	Open Graph - Title	
d_og_type	string	Open Graph - Type Possible values: activity, sport, bar, company, cafe, hotel, restaurant, cause, sports_league, sports_team, band, government, non_profit, school, university, actor, athlete, author, director, musician, politician, public_figure, city, country, landmark, state_province, album, book, drink, food, game, product, song, movie, tv_show, blog, website, article	
d_og_url	string	Open Graph - URL	
d_og_image_url	string	Open Graph - Image URL	
d_og_sitename	string	Open Graph - Sitename	
d_og_description	string	Open Graph - Description	

Social Plugin: Like Box

http://developers.facebook.com/docs/reference/plugins/like-box

plugin.tx_facebooksocialplugins_pi1.like_box

Property:	Data type:	Description:	Default:
e_show_in_iframe	boolean	Show in iFrame (not recommended!)	0
e_page_url	string	Facebook Page URL	
e_width	int	Width of the plugin	300
e_height	int	Height of the plugin	300
e_show_faces	boolean	Show faces	1
e_show_stream	boolean	Show stream	1
e_show_header	boolean	Show header in the box	1

Social Plugin: Live Stream

http://developers.facebook.com/docs/reference/plugins/live-stream

plugin.tx_facebooksocialplugins_pi1.live_stream

Property:	Data type:	Description:	Default:
f_show_in_iframe	boolean	Show in iFrame (not recommended!)	0
f_width	int	Width of the plugin	400
f_height	int	Height of the plugin	500
f_xid	string	XID: If you have multiple live stream boxes on the same page, specify a unique XID for each	
f_attr_url	string	Via Attribution URL	
f_post_to_friends	boolean	Always post to friends	0

Social Plugin: Login Button

http://developers.facebook.com/docs/reference/plugins/login

plugin.tx_facebooksocialplugins_pi1.login_button

Property:	Data type:	Description:	Default:
g_show_faces	boolean	Show faces	0
g_width	int	Width of the plugin	400
g_max_rows	int	Max rows	1

Social Plugin: Recommendations

http://developers.facebook.com/docs/reference/plugins/recommendations

plugin.tx_facebooksocialplugins_pi1.live_stream

Property:	Data type:	Description:	Default:
h_show_in_iframe	boolean	Show in iFrame (not recommended!)	0
h_domain	string	Domain	
h_width	int	Width of the plugin	300
h_height	int	Height of the plugin	300
h_show_header	string	Show header in the box	1
h_color_scheme	string	Color scheme of the plugin. Possible values: light, dark	light
h_font	string	Font of the plugin. Possible values: arial, lucida+grande, segoe+ui, tahoma, trebuchet+ms, verdana	arial
h_border	string	Border Color (hex value)	

ChangeLog

Version	Changes:
1.0.0	First release
1.0.1	Small bugfixes
1.0.2	Small bugfixes
1.1.0	Code rewriting, bugfixes
1.1.1	Small bugfixes
1.1.2	Fixed Bug 9970 (IE Bug): http://forge.typo3.org/issues/9970
1.2.0	Several bugfixes. Some plugins now have the iFrame version (not recommended)
1.2.1	Small bugfixes
1.2.2	Manual added
1.2.3	Fixed bug 10361: http://forge.typo3.org/issues/10361
1.2.4	Fixed bug 11090 and 10617: http://forge.typo3.org/projects/extension-facebook_socialplugins/
2.0.0	Major rewrite of the plugin: Facebook JavaScript Code included only once Load Facebook JavaScript at the end of the page for better performance Completely customizable via TypoScript Static template instead of ext_typoscript_setup.txt (deprecated TYPO3 core function) Icon for new content element wizard Link to Facebook Manual in Flexform and static TypoScript template Dutch and German translation added Open Graph for Like Button added Added new options for several plugins Updated manual Removed: Deprecated options on several plugins Removed: Configuration via Extension Manager (bad for multiple websites within one TYPO3 installation) Removed: Language configuration via FlexForm (now possible via TypoScript constants) Special thanks to Peter Kraume for rewriting the plugin.

EXT: Facebook: Social Plugins - facebook_socialplugins	ChangeLog

8

EXT: Facebook: Social Plugins

facebook_socialplugins

facebook social plugins social network social media refresj nitin

The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists.
If your manual is NOT in english, see next tab "language"
----
forEditors (use this for editors / german "Redakteure")
forAdmins (use this for Administrators)
forDevelopers (use this for Developers)
forBeginners (manuals covering TYPO3 basics)
forIntermediates (manuals going into more depth)
forAdvanced (covering the most advanced TYPO3 topics)
see more: http://wiki.typo3.org/doc_template#tags
----

Nitin Sewtahalsing

2010-02-18T17:33:18