Skip to content

thomasguillot/blockshot

Repository files navigation

Blockshot

License: GPL-2.0

Experimental -- This plugin is a work-in-progress and may break. Use at your own risk.

A WordPress plugin that lets you create block art using Gutenberg blocks and export the result as a high-quality JPG or PNG image. Design social media graphics, banners, thumbnails, or any visual content directly inside the WordPress editor.

Requirements

  • WordPress 6.9+
  • PHP 8.1+
  • A block theme (e.g. Twenty Twenty-Five)

Features

  • Private CPT — Blockshot posts are only accessible to administrators. Hidden from search, feeds, sitemaps, and public queries.
  • Canvas block — A resizable artboard that constrains your design.
  • Export Canvas — Click the camera button on the frontend or use the "Export Canvas" button in the editor to download your canvas as PNG or JPG.
  • Settings — Choose export format (PNG/JPG), quality (for JPG), and pixel scale (1x–4x).
  • Minimal template — Blockshot posts render on a blank page (no header, footer, or nav) so the exported image is clean.

Installation

  1. Clone or copy this repository into wp-content/plugins/blockshot.
  2. Install dependencies and build:
cd wp-content/plugins/blockshot
npm install
npm run build
  1. Activate the plugin in Plugins → Installed Plugins.

Development

Start the watcher for live rebuilds while editing JS/SCSS:

npm start

Build for production:

npm run build

How It Works

  1. Go to Blockshot → Add New in the admin.
  2. The editor pre-loads a single Canvas block. Add any Gutenberg blocks inside it (images, text, shapes, groups, etc.).
  3. Adjust export format, quality, and scale in the Canvas block sidebar.
  4. Export your design:
    • From the editor: In the Canvas block sidebar, click "Export Canvas".
    • From the frontend: Visit the blockshot single page while logged in as admin and click the camera button in the bottom-right corner.

License

This plugin is licensed under the GNU General Public License v2.0 or later. See LICENSE for the full text.

About

A WordPress plugin that lets you create block art using Gutenberg blocks and export the result as a JPG or PNG image. Design social media graphics, banners, thumbnails, or any visual content directly inside the WordPress editor.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors