=== EmbedBlocks ===
Contributors: embedblocks
Tags: oembed, embed, embeds, iframely, cards
Requires at least: 6.2
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 0.3.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn any URL into a responsive embed or summary card — rich media for WordPress from 1,900+ providers.

== Description ==

EmbedBlocks extends WordPress's built-in oEmbed flow with rich media from 1,900+ providers — video, audio, posts, and more — plus clean preview cards for everything else.

Paste a URL on its own line, add the EmbedBlocks block, or use the `[embedblock]` shortcode, and it becomes a responsive, cached embed that stays current as providers change their markup.

**Features**

* Responsive embeds for 1,900+ providers via oEmbed (YouTube, Vimeo, X, Spotify, TikTok, and the long tail).
* Summary cards (OpenGraph) for any URL that isn't natively embeddable.
* Works with pasted URLs (autoembed), a dedicated Gutenberg block, and the `[embedblock]` shortcode.
* Responsive + lazy-loaded, with cached responses (WordPress transients + your worker's cache).
* Fast, cached, and responsive on any theme.

== Installation ==

1. Create an API key in your EmbedBlocks dashboard at embedblocks.com.
2. Upload the plugin under **Plugins → Add New → Upload Plugin**, or copy the `embedblocks` folder to `wp-content/plugins/`.
3. Activate it, then go to **Settings → EmbedBlocks** and enter your **API base URL** and **API key**.
4. Paste a URL on its own line in a post, add the **EmbedBlocks** block, or use `[embedblock url="..."]`.

== Frequently Asked Questions ==

= Do I need an account? =
Yes — the plugin connects to the EmbedBlocks service with an API key. Create one at embedblocks.com.

= What happens if I deactivate the plugin? =
It extends the standard oEmbed mechanism, so nothing breaks. Links WordPress natively supports keep embedding; the rest become plain links.

= Which URLs are supported? =
Anything with an oEmbed endpoint (discovered automatically) plus a curated provider registry. Everything else gets an OpenGraph summary card.

== Changelog ==

= 0.3.2 =
* Fix: very long titles or URLs in preview cards now wrap instead of overflowing the card.

= 0.3.1 =
* Fix: "Refresh embed" now refreshes the same cache entry the block renders, for every URL.

= 0.3.0 =
* Embeds serve a last-good copy and refresh in the background, so page renders never wait on the API.
* New "Refresh embed" button in the block editor and "Clear embed cache" in settings.

= 0.2.3 =
* Click-to-play: defer video players until the visitor clicks, for faster pages.

= 0.2.2 =
* Inline Instagram & X embeds (no API token needed).
* Fix card styling bleeding host-theme link colors/underlines on hover.

= 0.2.1 =
* Removed the API base URL setting (defaults to embedblocks.com; override with the EMBEDBLOCKS_API_BASE constant).

= 0.2.0 =
* Self-updates automatically (no more manual zip uploads).
* New "Isolate embeds" option: render video & rich embeds in a sandboxed iframe.

= 0.1.0 =
* Initial release: oEmbed integration, summary cards, Gutenberg block, `[embedblock]` shortcode, settings page.
