OpenGraph Fallback Embed

وەسف

OpenGraph Fallback Embed adds a custom Gutenberg block and an auto-embed fallback that renders rich link cards using OpenGraph metadata from any URL.

Features:

  • OpenGraph Embed block — Paste any URL to embed it as a styled card showing the page’s title, description, image, and site name.
  • Auto-embed fallback — When WordPress can’t find an oEmbed provider for a URL pasted on its own line, this plugin automatically fetches the page’s OpenGraph tags and renders a card instead of a plain link.
  • Graceful degradation — Falls back to Twitter Card meta tags, then to HTML <title> and <meta name="description"> when OpenGraph tags are missing.
  • Transient caching — Fetched metadata is cached for 7 days to minimise external requests.

Development

The source code for this plugin, including unminified JavaScript and CSS, is available on GitHub:

OpenGraph Fallback Embed on GitHub

The plugin uses @wordpress/scripts for building. Source files are in the src/ directory. See the repository README for build instructions.

سکرین شۆتەکان

  • A URL with no oEmbed provider shows as a plain link by default.
  • With OpenGraph Fallback Embed active, the same URL renders as a rich card with title, description, and image.
  • The OpenGraph Embed block in the editor with a live preview.

بڵۆکەکان

ئەم پێوەکراوە 1 بڵۆک دابین دەکات.

  • OpenGraph Embed Embed any page as a rich link card using its OpenGraph tags.

پهد

What happens if a URL has no OpenGraph tags?

The plugin falls back to Twitter Card meta tags, then to the page’s <title> and <meta name="description">. If none of these are available, the original WordPress output is preserved.

Does this override existing embed providers?

No. This plugin only activates when WordPress has no other embed handler for the URL.

Can I customise the card appearance?

The card uses the .og-fallback-embed CSS class. You can override styles in your theme.

پێداچوونەوەکان

هیچ پێداچوونەوەیەک نەنووسراوە بۆ ئەم پێوەکراوە.

بەشداربووان و گەشەپێدەران

“OpenGraph Fallback Embed” نەرمەواڵەیەکی سەرچاوە کراوەیە. ئەم کەسانەی خوارەوە بەشدارییان تێدا کردووە.

بەشداربووان

“OpenGraph Fallback Embed” وەرگێڕدراوە بۆ 1 زمان. سوپاسی وەرگێڕەکان دەکەین بۆ بەشداریکردنیان.

“OpenGraph Fallback Embed” وەربگێڕە بۆ زمانەکەی خۆت.

دەتەوێت بەشداربیت لە گەشەپێدان؟

گەڕان لە کۆدەکەدا بکە، سەیری تەمارگەی (SVN) بکە، یان بەشداربە لە ڕووداوتۆماری گەشەپێدان لە ڕێگەی (RSS).

ڕووداوتۆمارگەریی گۆڕین

1.3.7

  • Added screenshots, and tweaked readme.txt.

1.3.6

  • Removed a dev file from the plugin zip.

1.3.5

  • Add source code repository link to readme.
  • Use plugin-specific prefix for transient cache keys.

1.3.4

  • Tweak the plugin header.

1.3.3

  • Remove one more file from the plugin zip.

1.3.2

  • Fix the block version number not being bumped in the last release.

1.3.1

  • Remove some unnecessary files from the plugin zip file.

1.3.0

  • Add support for falling back to OG tags when the Embed block fails.

1.2.0

  • Add custom Gutenberg block for manual OpenGraph embeds.
  • Add REST API endpoint for editor previews.
  • Improve fallback chain: OG Twitter Card HTML meta.

1.1.0

  • Add transient caching for fetched metadata.

1.0.0

  • Initial release with auto-embed fallback.