README

TYPO3 extension that integrates Facebook Social Plugins as a content element with full configuration.

Requirements

• TYPO3 14.3+
• PHP 8.5+

Plugins

The extension provides a plugin that supports four Facebook Social Plugins:

• Share Button — Share any URL or the current page
• Page Plugin — Embed a Facebook page with configurable tabs, dimensions and display options
• Embedded Post — Embed a public Facebook post
• Embedded Video / Live Video Player — Embed a Facebook video or live stream

Installation

Install via Composer:

composer require refresj/facebook-socialplugins

Add the Site Set to your site configuration (config/sites/<your-site>/config.yaml):

dependencies:
    - refresj/facebook-socialplugins

Or add it as a dependency of your own Site Set.

Configuration

Settings are managed via Sites → Setup → Gear icon button (bottom right of your site) under the Facebook Social Plugins category.

These can also be set directly in TypoScript:

plugin.tx_facebooksocialplugins.settings {
    appId  = your-app-id
    locale = nl_NL
}

Facebook JavaScript SDK

The SDK is loaded automatically via TYPO3's AssetCollector. When multiple Facebook Social Plugin content elements are placed on the same page, the SDK is only loaded once.

The SDK version used is v25.0 (current stable).

Languages

The backend labels are available in English and Dutch. Translation files are located in Resources/Private/Language/.

License

GPL-2.0-or-later