PHPackages                             terminal42/contao-oembed - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. terminal42/contao-oembed

ActiveContao-bundle[Utility &amp; Helpers](/categories/utility)

terminal42/contao-oembed
========================

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

1.5.2(2w ago)11.1k1MITPHPPHP ^8.3CI passing

Since Jan 24Pushed 3mo ago3 watchersCompare

[ Source](https://github.com/terminal42/contao-oembed)[ Packagist](https://packagist.org/packages/terminal42/contao-oembed)[ GitHub Sponsors](https://github.com/terminal42)[ Fund](https://ko-fi.com/terminal42)[ RSS](/packages/terminal42-contao-oembed/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (26)Versions (22)Used By (0)

terminal42/contao-oembed
========================

[](#terminal42contao-oembed)

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

Features
--------

[](#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?
-----------------

[](#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
------------

[](#installation)

Choose the installation method that matches your workflow!

### Installation via Contao Manager

[](#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

[](#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
-------------

[](#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:

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

[](#license)

This bundle is released under the [MIT license](LICENSE)

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance87

Actively maintained with recent releases

Popularity21

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity87

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 83.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~182 days

Total

20

Last Release

20d ago

Major Versions

0.3.1 → 1.0.02020-07-02

PHP version history (7 changes)0.1PHP &gt;=5.4

0.2PHP ^5.4 || ^7.0

0.3.0PHP ^7.1

1.0.0PHP ^7.2

1.2.0PHP ^7.2 || ^8.0

1.2.2PHP ^7.4 || ^8.0

1.5.0PHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1073273?v=4)[Andreas Schempp](/maintainers/aschempp)[@aschempp](https://github.com/aschempp)

![](https://avatars.githubusercontent.com/u/481937?v=4)[Yanick Witschi](/maintainers/Toflar)[@Toflar](https://github.com/Toflar)

---

Top Contributors

[![aschempp](https://avatars.githubusercontent.com/u/1073273?v=4)](https://github.com/aschempp "aschempp (56 commits)")[![richardhj](https://avatars.githubusercontent.com/u/1284725?v=4)](https://github.com/richardhj "richardhj (10 commits)")[![zonky2](https://avatars.githubusercontent.com/u/1045318?v=4)](https://github.com/zonky2 "zonky2 (1 commits)")

---

Tags

facebookinstagramtiktoktwittertwittertimelineembedtweetinstagram post

### Embed Badge

![Health badge](/badges/terminal42-contao-oembed/health.svg)

```
[![Health](https://phpackages.com/badges/terminal42-contao-oembed/health.svg)](https://phpackages.com/packages/terminal42-contao-oembed)
```

###  Alternatives

[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M674](/packages/shopware-core)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M236](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1301.7M3.1k](/packages/contao-core-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k6.0M777](/packages/sylius-sylius)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.3M430](/packages/easycorp-easyadmin-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
