Scrollytelling

Scrollytelling turns an idea into a single, scroll-driven web page — animated, cinematic, and fully editable. This plugin lets you drop your published stories into WordPress.

• Block — add the "Scrollytelling Story" block, paste a story URL, and choose how it appears.
• Shortcode — [scrollytelling url="https://my-story.scrollytelling.ai"].
• Auto-embed (oEmbed) — paste a story URL on its own line and it embeds automatically.
• Two display modes — inline (the story embeds in the page, with a fullscreen button) or a card (a poster that opens the full immersive story).
• Connect your account (optional) — add an API key to browse your own stories and insert them with a click, no copy-pasting URLs.

You create and publish stories at scrollytelling.ai; this plugin only displays already-published, public stories. Getting started (2 minutes)

1. Publish a story at scrollytelling.ai — every published story gets its own address, like https://my-story.scrollytelling.ai. You can copy it from your dashboard.
2. Open any post or page in the WordPress editor.
3. Click the + button (top left of the editor), search for "Scrollytelling Story", and add the block.
4. Paste your story URL into the block — the story appears right in the editor.
5. In the block settings (right sidebar), choose Inline (the story plays inside your page) or Card (a poster that opens the full story), and adjust the height.

Shortcuts: pasting a story URL on an empty line embeds it automatically, just like a YouTube link — or type /scrollytelling in the editor. In the Classic editor, use the shortcode below. Optional: connect your account under Settings → Scrollytelling with an API key (created at Scrollytelling → Settings → Connect WordPress) to insert stories from a picker instead of pasting URLs. The same settings page has a "How to embed" recap whenever you need it.

1.0.2

• New: getting-started guidance — a one-time welcome notice after activation, a "How to embed a story" guide on the settings page, and Settings / How-to-embed links on the Plugins screen.
• Inline embed height from the shortcode/block is now capped at 4000px, matching the settings limit.
• The settings height field now allows the full 200–4000px range.
• Uninstall also removes cached URL-verification transients.

1.0.1

• Settings page now loads its JavaScript with wp_enqueue_script() + wp_localize_script() instead of an inline script tag (WordPress.org review compliance).
• Inline iframes now render only for verified story URLs: *.scrollytelling.ai stories are allowed directly, custom-domain stories are confirmed against the Scrollytelling API (with caching); unverified URLs fall back to the link card.
• Hardened the card poster style against CSS injection via the thumbnail attribute.
• The account-status endpoint now requires administrator capability.
• Requires WordPress 6.6+ (the block uses the JSX runtime introduced in 6.6).

1.0.0

• Initial release: block, shortcode, oEmbed auto-embed, inline + card display modes, optional account connection.