About this plugin
Init Embed Posts lets you embed WordPress content externally – with beautiful cards, real-time REST API data, and zero friction.
Instead of using iframes or clunky oEmbed, this plugin gives you clean <div> + <script> snippets, which load the post or product dynamically using WordPress REST API. Designed for speed, style, and full control – using pure JavaScript and smart caching.
Prefer working in the Block Editor? The Embed Button block does exactly what the [init_embed_code] shortcode does – no shortcode needed if you’d rather insert it visually, with a live preview right in the editor.
9+), the same data used to render the cards.
This plugin is part of the Init Plugin Suite — a collection of minimalist, fast, and developer-focused tools for WordPress.
com/brokensmile2103/init-embed-posts
Features:
- Embed any public post or WooCommerce product
- Works anywhere: raw HTML, CMS, blog, landing page…
- Block Editor block: “Embed Button”, equivalent to [init_embed_code], with a live preview in the editor
- Abilities API (WordPress 6.9+): read-only get-embed-data ability for post/product embed data, discoverable via wp_get_abilities() and the wp-abilities/v1 REST namespace
- Beautiful card layout:
- Site name + favicon
- Title, excerpt, date (for posts)
- Featured image, horizontal gallery (optional)
- Product name, price, sale price with strikethrough
- “Add to cart” styled button (optional)
- Auto dark mode, adapts to embedding site
- Hover effects and modern UI
- Skeleton loader while waiting for data
- JS-only, no iframe, no jQuery, no dependency
- Lazy-loads embed cards as they scroll into view
- Auto-detects embeds inserted dynamically after page load (AJAX/SPA)
- Modal UI to generate personalized embed code
- Smart <script> switching:
- init-embed.js for posts
- init-embed-product.js for Woo products
- Embed attributes:
- data-theme="light|dark|auto" – force or auto-detect theme
- data-image, data-featured, data-cart – control content
- Cached REST API (1 year, revalidated via ETag when the post/product is updated)
- Price range display for WooCommerce variable products
- Configurable gallery image limit and default embed theme (Settings page)
- Developer filters to customize data and HTML
What’s New in Version 2.0.0
- Block Editor support: new “Embed Button” block, equivalent to the [init_embed_code] shortcode, with a live editor preview — optional, the shortcode still works exactly as before
- Abilities API support (WordPress 6.9+): new read-only init-embed-posts/get-embed-data ability for post/product embed data — optional and fully backward-compatible on older WordPress versions
- Requires at least raised from 5.5 to 6.9 to support the Abilities API. Requires PHP remains 7.4
See full details in the changelog below.
Abilities API (WordPress 6.9+)
9 and above, Init Embed Posts registers one read-only ability under the init-embed-posts category:
- init-embed-posts/get-embed-data — returns embed data (title, excerpt, thumbnail, images, and — for WooCommerce products — price) for a published post or product, given an id and type ( post or product )
This is discoverable and executable via PHP ( wp_get_abilities() ), and — for sites that opt into exposing it — the wp-abilities/v1 REST namespace, using the exact same data as the REST endpoints below. 9, it silently does nothing and the rest of the plugin is unaffected.
Filters for Developers
These filters give you full control over how data is rendered and returned.
JS config override (highest priority):
-
InitPluginSuiteEmbedPostsConfig
g. via wp_add_inline_script in a theme) to override embed UI settings in JS, taking priority over the plugin’s Settings page. Currently supports:
- theme – "light", "dark", or "auto". Overrides the “Default embed theme” setting for the embed code generator button/modal.
Example:
InitPluginSuiteEmbedPostsConfig = { theme: ‘dark’ };
REST response filters:
-
init_plugin_suite_embed_posts_rest_response
Modify REST API response for posts.
-
init_plugin_suite_embed_products_rest_response
Modify REST API response for Woo products.
-
init_plugin_suite_embed_posts_view_count_keys
Customize the list of post meta keys used to detect view count. Supports array of meta keys, ordered by priority.
-
init_plugin_suite_embed_posts_gallery_limit
Override the gallery image limit (defaults to the Settings page value, 1–10) used for both post and product embeds.
Excerpt filters:
-
init_plugin_suite_embed_posts_excerpt
Customize excerpt for posts.
-
init_plugin_suite_embed_products_excerpt
Customize excerpt for products.
Image control:
-
init_plugin_suite_embed_posts_images
Filter image list for embedded post.
-
init_plugin_suite_embed_products_images
Filter image list for embedded product.
-
init_plugin_suite_embed_posts_extracted_images
Filter raw image URLs extracted from post content.
Favicon:
-
init_plugin_suite_embed_posts_favicon_url
Override favicon for posts.
-
init_plugin_suite_embed_products_favicon_url
Override favicon for products.
HTML output filters:
- init_plugin_suite_embed_posts_shortcode_html
Customize HTML output of the [init_embed_code] shortcode. Allows complete control over button markup, styling, and attributes.
Auto-insert locations:
- init_embed_insert_locations
, after title, before content, etc).
License
This plugin is licensed under the GPLv2 or later.
You are free to use, modify, and distribute it under the same license.