KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

emdash-plugin-social-embed

★ 3 Open GitHub ↗

EmDash CMS plugin for embedding social media posts by pasting a URL. Server-side oEmbed for 10 platforms. Designed by Marcus Shaw for Every Bit Texas. Coded by Claude Code.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# emdash-plugin-social-embed

Embed social media posts in [EmDash](https://emdashcms.com) Portable Text by pasting a URL. Fetches embed HTML server-side via oEmbed — no client-side API calls, and platform scripts only load on pages that actually contain that type of embed.

## Supported Platforms

| Platform | Credentials required |
|---|---|
| YouTube | None |
| Vimeo | None |
| Twitter / X | None |
| Spotify | None |
| TikTok | None |

## Installation

```bash
npm install emdash-plugin-social-embed
```

Register in `astro.config.mjs`:

```js
import { socialEmbedPlugin } from "emdash-plugin-social-embed";

emdash({
  plugins: [socialEmbedPlugin()],
})
```

> **Note:** This is a native (trusted) plugin. It must be added to `plugins: []`, not `sandboxed: []`. This is required because it ships Astro components for server-side rendering.

## Usage

In any Portable Text field in the EmDash editor, type `/` and choose **Social Embed**, then paste a post URL. The embed is fetched server-side via the plugin's own route — no runtime API calls in the browser.

## Performance

- oEmbed responses are cached at Cloudflare's edge for 24 hours (`cf.cacheTtl`)
- Platform scripts (Twitter widgets.js, TikTok embed.js) are only injected on pages that contain that type of embed
- YouTube, Vimeo, and Spotify produce pure iframes with no extra JavaScript

## License

MIT

emdash-plugin-social-embed

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README