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

img-1 img-2 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>`_

What does it do? 3

TYPO3 Forge 3

Screenshots 3

`Users manual 4 <#__RefHeading__788_1165795171>`_

`Configuration 5 <#__RefHeading__796_1165795171>`_

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 <#__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

img-3

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: 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

Social Plugin: 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
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
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
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
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
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
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

Version

1.1.2

Changes

Fixed Bug 9970 (IE Bug): http://forge.typo3.org/issues/9970

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

Version

1.2.3

Changes

Fixed bug 10361: http://forge.typo3.org/issues/10361

1.2.4

Version

1.2.4

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.

img-2 8