humanmade/hm-flourish-block

Embed Flourish visualisations and stories.

Maintainers

Details

github.com/humanmade/hm-flourish-embed-block

Source

Issues

Installs: 8

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

Language:JavaScript

Type:wordpress-plugin

pkg:composer/humanmade/hm-flourish-block

1.1.1 2026-02-20 11:39 UTC

GPL-2.0-or-later 70886eb99e4133de6d3145233b2fa90c07a6fef6

  • Human Made

This package is auto-updated.

Last update: 2026-02-20 11:41:47 UTC

README

A WordPress block plugin for embedding Flourish data visualizations.

Setup

  1. Install dependencies:
npm install
  1. Build the block:
npm run build
  1. For development with automatic rebuilds:
npm start

Project Structure

  • src/index.js - Main entry point, registers the block with the editor
  • src/style.scss - Frontend styles for the block
  • src/editor.scss - Editor-only styles
  • inc/blocks.php - PHP block registration and render callback
  • inc/namespace.php - Plugin namespace and hook setup
  • build/ - Compiled assets (generated by npm build)

How It Works

  • The block is registered as a dynamic block, meaning it's rendered server-side by PHP
  • The editor shows a placeholder since save() => null
  • The Flourish embed script is registered and enqueued only once via wp_register_script() and wp_enqueue_script() to avoid duplicates
  • The render callback outputs the Flourish embed HTML with the specified visualization ID