terminal42/contao-oembed

Embed a Tweet, a Twitter Timeline or an Instagram Post on your Contao website.

1.4.2 2024-08-13 10:07 UTC

Requires

• php: ^7.4 || ^8.0
• ext-json: *
• contao/core-bundle: ^4.9
• psr/log: ^1.0 || ^2.0 || ^3.0
• symfony/http-client: ^4.4 || ^5.0 || ^6.0

Requires (Dev)

• contao/manager-plugin: ^2.0
• terminal42/contao-build-tools: dev-main

Conflicts

• contao/manager-plugin: <2.0 || >=3.0

MIT

• terminal42 gmbh

• twitter
• timeline
• embed
• tweet
• instagram post

README

A Contao 4 bundle that provides several oEmbed widgets (Twitter, Instagram) for a website.

Features

This bundle provides content elements that can be added to your website.

1. Single Tweet
   A new content element to embed a single tweet.

2. Twitter user timeline
   A new content element to embed a user's timeline.

3. Instagram post
   Embed an Instagram post into your website.

4. Facbeook page / post / video
   Embed a Facebook post, page or video into your website.

5. TikTok video
   Embed a TikTok video into your website.

6. Podigee Podcast
   Embed a Podigee Potcast into your website.

How does it work?

You provide a link to a tweet or post, the extension will fetch and output the embed code by the oEmbed provider.

Installation

Choose the installation method that matches your workflow!

Installation via Contao Manager

Search for terminal42/contao-oembed in the Contao Manager and add it to your installation. Finally, update the packages.

Manual installation

Add a composer dependency for this bundle. Therefore, change in the project root and run the following:

composer require terminal42/contao-oembed

Depending on your environment, the command can differ, i.e. starting with php composer.phar … if you do not have composer installed globally.

Then, update the database via the Contao install tool.

Configuration

The Facebook API requires an access key to fetch oEmbed for Facebook or Instagram content.

You need to register your Contao installation as an app on facebook and create a app token according to the documentation: https://developers.facebook.com/docs/facebook-login/access-tokens#apptokens

The app token (or client token) can be set in the bundle configuration:

// config/config.yml
terminal42_oembed:
    facebook_token: 'xxxx|xxxx'

WARNING: If you do not configure a Facebook token, the extension will use a generic app authentication that is controlled by terminal42 and has request limits set by Facebook upon which we have no influence. The API token can be invalidated at any time without notice by terminal42 or Facebook.

License

This bundle is released under the MIT license