An extension for phpBB that allows the user to embed content from allowed sites using a [media] BBCode, or from simply posting a supported URL in plain text.

1. Download the latest release.
2. Unzip the downloaded release and copy it to the ext directory of your phpBB board.
3. Navigate in the ACP to Customise -> Manage extensions.
4. Look for phpBB Media Embed PlugIn under the Disabled Extensions list, and click its Enable link.
5. Configuration settings are in the ACP at Posting -> Media Embed.

1. Navigate in the ACP to Customise -> Extension Management -> Extensions.
2. Look for phpBB Media Embed PlugIn under the Enabled Extensions list, and click its Disable link.
3. To permanently uninstall, click Delete Data and then delete the /ext/phpbb/mediaembed directory.

A note about existing BBCodes with the same name as a media site ID name (i.e. youtube): If you already have one of these, then your existing BBCode will take precedence over the one in this plugin. You may continue using your existing BBCode and this plugin will ignore any links from that site.

You can delete the existing BBCode if you want this plugin to handle links from that site instead. After you delete your old BBCode you must go to Media Embed -> Manage Sites and enable the site.

Note that by deleting the old BBCode your old posts may no longer render the videos and will display the deleted BBCode tags as text. Experiment with this on a local offline backup of your board first.

A full list of supported media sites can be found here.

• Important: Only official release versions validated by the phpBB Extensions Team should be installed on a live forum. Pre-release (beta, RC) versions downloaded from this repository are only to be used for testing on offline/development forums and are not officially supported.
• Report bugs and other issues to our Issue Tracker.
• Support requests should be posted and discussed in the Support forum at phpBB.com.

Translations should be posted to the translations topic at phpBB.com. We accept pull requests for translation corrections, but we do not accept pull requests for new translations.

Please fork this repository and submit a pull request to contribute to phpBB Media Embed PlugIn

phpBB 3 uses the MediaEmbed definitions bundled with s9e/text-formatter 2.11.5 as a baseline. This extension applies a generated PHP-array delta from a newer TextFormatter release. phpBB 4 uses its current TextFormatter definitions and skips this delta. YAML files in collection/sites remain manually authored custom definitions and are applied last.

Update the generated delta from a tagged TextFormatter release:

php scripts/update_mediaembed_sites.php --target=2.19.3

Verify the committed output against its pinned releases:

php scripts/update_mediaembed_sites.php --check

Minimal field patches needed for compatibility with phpBB's older TextFormatter belong in collection/compatibility_sites.php; never copy whole definitions there or edit collection/generated/upstream_sites.php. Both files expose autoloadable collection classes. Tests compile every generated definition with phpBB's bundled TextFormatter and reject unsupported upstream helper dependencies. Removed upstream definitions are removed from phpBB 3's available collection too.

Scheduled workflow checks new TextFormatter releases and opens a generated pull request. Pull-request tests remain required: media definitions control remote scraping and iframe output, so updates must not merge without review.

GNU General Public License v2