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.4.3(8mo ago)11.0k1MITPHPPHP ^7.4 || ^8.0

Since Jan 24Pushed 8mo 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 1mo ago

READMEChangelogDependencies (5)Versions (18)Used By (0)

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

[](#terminal42contao-oembed)

A Contao 4 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

46

—

FairBetter than 93% of packages

Maintenance58

Moderate activity, may be stable

Popularity20

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity77

Established project with proven stability

 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 ~195 days

Recently: every ~240 days

Total

17

Last Release

267d ago

Major Versions

0.3.1 → 1.0.02020-07-02

PHP version history (6 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

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

[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

22.8k69.3k](/packages/grumpydictator-firefly-iii)[symfony/ai-agent

PHP library for building agentic applications.

30536.7k44](/packages/symfony-ai-agent)[pdir/social-feed-bundle

Social feed extension for Contao CMS

1414.8k](/packages/pdir-social-feed-bundle)[jedkirby/tweet-entity-linker

Convert Twitter API Tweet entities such as URLs, Hashtags and User Mentions into their respective HTML entities.

102.7k](/packages/jedkirby-tweet-entity-linker)[numero2/contao-storelocator

Contao Plugin for managing stores (or in common address data) and providing a frontend-search based on geo data

121.5k](/packages/numero2-contao-storelocator)

PHPackages © 2026

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