DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
EXT: Facebook: Social Plugins¶
Created: | 2010-02-18T17:33:18 |
---|---|
Changed by: | Nitin Sewtahalsing |
Changed: | 2011-06-15T15:40:20.090000000 |
Classification: | facebook_socialplugins |
Description: | 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 ---- |
Keywords: | facebook, social plugins, social network, social media, refresj, nitin |
Author: | Nitin Sewtahalsing |
Email: | nitin@refresj.nl |
Info 4: | |
Language: | en |
EXT: Facebook: Social Plugins - facebook_socialplugins
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 <#__RefHeading__782_1165795171>`_
`Users manual 4 <#__RefHeading__788_1165795171>`_
`Configuration 5 <#__RefHeading__796_1165795171>`_
Social Plugin: Activity Feed 5
Social Plugin: Recommendations 7
`ChangeLog 8 <#__RefHeading__808_1165795171>`_
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.
appID¶
Property
appID
Data type
string
Description
Facebook App-ID
Default
language¶
Property
language
Data type
string
Description
The language of the plugin: Use like: en_US, nl_NL, etc.
Default
en_US
templateFile¶
Property
templateFile
Data type
string
Description
Template file to use
Default
EXT:facebook_socialplugins/pi1/template.html
Setup¶
General settings¶
plugin.tx_facebooksocialplugins_pi1.
staticTemplateCheck¶
Property
staticTemplateCheck
Data type
boolean
Description
Check if static template is included
Default
1
appID¶
Property
appID
Data type
string
Description
Facebook App-ID
Default
{$plugin.tx_facebooksocialplugins.appID}
language¶
Property
language
Data type
string
Description
The language of the plugin: Use like: en_US, nl_NL, etc.
Default
{$plugin.tx_facebooksocialplugins.language}
templateFile¶
Property
templateFile
Data type
string
Description
Template file to use
Default
{$plugin.tx_facebooksocialplugins.templateFile}
type_form¶
Property
type_form
Data type
string
Description
Which social plugin.
Possible values: activity_feed, comments, facepile, like_button, like_box, live_stream, login_button, recommendations
Default
Social Plugin: Comments¶
- http://developers.facebook.com/docs/reference/plugins/comments
- plugin.tx_facebooksocialplugins_pi1.comments
b_unique_id¶
Property
b_unique_id
Data type
int
Description
Unique ID
Default
b_number¶
Property
b_number
Data type
int
Description
Number of comments
Default
10
b_width¶
Property
b_width
Data type
int
Description
Width of the plugin
Default
450
b_publish_feed¶
Property
b_publish_feed
Data type
boolean
Description
Publish feed
Default
1
Social Plugin: Facepile¶
- http://developers.facebook.com/docs/reference/plugins/facepile
- plugin.tx_facebooksocialplugins_pi1.facepile
c_url¶
Property
c_url
Data type
string
Description
URL
Default
c_num_rows¶
Property
c_num_rows
Data type
int
Description
Number of rows
Default
10
c_width¶
Property
c_width
Data type
int
Description
Width of the plugin
Default
450
Social Plugin: Like Button¶
- http://developers.facebook.com/docs/reference/plugins/like
- plugin.tx_facebooksocialplugins_pi1.like_button
d_show_in_iframe¶
Property
d_show_in_iframe
Data type
string
Description
Show in iFrame (not recommended!)
Default
0
d_url¶
Property
d_url
Data type
int
Description
URL to Like
Default
d_layout_style¶
Property
d_layout_style
Data type
int
Description
Layout Style.
Possible values: standard, button_count, box_count
Default
standard
d_show_faces¶
Property
d_show_faces
Data type
boolean
Description
Show Faces
Default
0
d_width¶
Property
d_width
Data type
int
Description
Width of the plugin
Default
450
d_height¶
Property
d_height
Data type
int
Description
Height of the plugin
Default
100
d_verb¶
Property
d_verb
Data type
string
Description
Verb to display.
Possible values: like, recommend
Default
like
d_font¶
Property
d_font
Data type
string
Description
Font of the plugin.
Possible values: arial, lucida+grande, segoe+ui, tahoma, trebuchet+ms, verdana
Default
arial
d_color_scheme¶
Property
d_color_scheme
Data type
string
Description
Color scheme of the plugin.
Possible values: light, dark
Default
light
d_og_title¶
Property
d_og_title
Data type
string
Description
Open Graph - Title
Default
d_og_type¶
Property
d_og_type
Data type
string
Description
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
Default
d_og_url¶
Property
d_og_url
Data type
string
Description
Open Graph - URL
Default
d_og_image_url¶
Property
d_og_image_url
Data type
string
Description
Open Graph - Image URL
Default
d_og_sitename¶
Property
d_og_sitename
Data type
string
Description
Open Graph - Sitename
Default
d_og_description¶
Property
d_og_description
Data type
string
Description
Open Graph - Description
Default
Social Plugin: Like Box¶
- http://developers.facebook.com/docs/reference/plugins/like-box
- plugin.tx_facebooksocialplugins_pi1.like_box
e_show_in_iframe¶
Property
e_show_in_iframe
Data type
boolean
Description
Show in iFrame (not recommended!)
Default
0
e_page_url¶
Property
e_page_url
Data type
string
Description
Facebook Page URL
Default
e_width¶
Property
e_width
Data type
int
Description
Width of the plugin
Default
300
e_height¶
Property
e_height
Data type
int
Description
Height of the plugin
Default
300
e_show_faces¶
Property
e_show_faces
Data type
boolean
Description
Show faces
Default
1
e_show_stream¶
Property
e_show_stream
Data type
boolean
Description
Show stream
Default
1
e_show_header¶
Property
e_show_header
Data type
boolean
Description
Show header in the box
Default
1
Social Plugin: Live Stream¶
- http://developers.facebook.com/docs/reference/plugins/live-stream
- plugin.tx_facebooksocialplugins_pi1.live_stream
f_show_in_iframe¶
Property
f_show_in_iframe
Data type
boolean
Description
Show in iFrame (not recommended!)
Default
0
f_width¶
Property
f_width
Data type
int
Description
Width of the plugin
Default
400
f_height¶
Property
f_height
Data type
int
Description
Height of the plugin
Default
500
f_xid¶
Property
f_xid
Data type
string
Description
XID: If you have multiple live stream boxes on the same page, specify a unique XID for each
Default
f_attr_url¶
Property
f_attr_url
Data type
string
Description
Via Attribution URL
Default
f_post_to_friends¶
Property
f_post_to_friends
Data type
boolean
Description
Always post to friends
Default
0
Social Plugin: Login Button¶
- http://developers.facebook.com/docs/reference/plugins/login
- plugin.tx_facebooksocialplugins_pi1.login_button
g_show_faces¶
Property
g_show_faces
Data type
boolean
Description
Show faces
Default
0
g_width¶
Property
g_width
Data type
int
Description
Width of the plugin
Default
400
g_max_rows¶
Property
g_max_rows
Data type
int
Description
Max rows
Default
1
Social Plugin: Recommendations¶
- `http://developers.facebook.com/docs/reference/plugins/recommendations <http://developers.facebook.com/docs/reference/plugins/recommendations >`_
- plugin.tx_facebooksocialplugins_pi1.live_stream
h_show_in_iframe¶
Property
h_show_in_iframe
Data type
boolean
Description
Show in iFrame (not recommended!)
Default
0
h_domain¶
Property
h_domain
Data type
string
Description
Domain
Default
h_width¶
Property
h_width
Data type
int
Description
Width of the plugin
Default
300
h_height¶
Property
h_height
Data type
int
Description
Height of the plugin
Default
300
h_show_header¶
Property
h_show_header
Data type
string
Description
Show header in the box
Default
1
h_color_scheme¶
Property
h_color_scheme
Data type
string
Description
Color scheme of the plugin.
Possible values: light, dark
Default
light
h_font¶
Property
h_font
Data type
string
Description
Font of the plugin.
Possible values: arial, lucida+grande, segoe+ui, tahoma, trebuchet+ms, verdana
Default
arial
h_border¶
Property
h_border
Data type
string
Description
Border Color (hex value)
Default
ChangeLog¶
1.0.0¶
Version
1.0.0
Changes
First release
1.0.1¶
Version
1.0.1
Changes
Small bugfixes
1.0.2¶
Version
1.0.2
Changes
Small bugfixes
1.1.0¶
Version
1.1.0
Changes
Code rewriting, bugfixes
1.1.1¶
Version
1.1.1
Changes
Small bugfixes
1.1.2¶
1.2.0¶
Version
1.2.0
Changes
Several bugfixes. Some plugins now have the iFrame version (not recommended)
1.2.1¶
Version
1.2.1
Changes
Small bugfixes
1.2.2¶
Version
1.2.2
Changes
Manual added
1.2.3¶
1.2.4¶
Version
1.2.4
Changes
Fixed bug 11090 and 10617: http://forge.typo3.org/projects/extension- facebook_socialplugins/
2.0.0¶
Version
2.0.0
Changes
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.
8
Social Plugin: Activity Feed¶
a_show_in_iframe¶
Property
a_show_in_iframe
Data type
boolean
Description
Show in iFrame (not recommended!)
Default
0
a_domain¶
Property
a_domain
Data type
string
Description
Domain
Default
a_width¶
Property
a_width
Data type
int
Description
Width of the plugin
Default
300
a_height¶
Property
a_height
Data type
int
Description
Height of the plugin
Default
300
a_show_header¶
Property
a_show_header
Data type
boolean
Description
Show header in the box
Default
1
a_color_scheme¶
Property
a_color_scheme
Data type
string
Description
Color scheme of the plugin.
Possible values: light, dark
Default
light
a_font¶
Property
a_font
Data type
string
Description
Font of the plugin.
Possible values: arial, lucida+grande, segoe+ui, tahoma, trebuchet+ms, verdana
Default
arial
a_border¶
Property
a_border
Data type
string
Description
Border Color (hex value)
Default