Skip to main content

Plugin User Guide

ReactPress 4.0 plugins extend server-side logic (Hooks), similar to WordPress plugins, but without modifying theme code.

Theme = presentation · Plugin = logic

Operations in Admin

Plugin management

  1. Plugins → Available to browse the catalog
  2. InstallEnable
  3. Click the plugin name for Settings (form generated from plugin.json settings.schema)

Built-in plugins

IDNameCapability
hello-worldAuto-summaryGenerates summary field when publishing posts
seoSEO enhancementSlug, keywords, meta description; Admin editor slot
image-optimizerImage optimizationAnalyze media library history and batch WebP conversion

SEO plugin

When enabled, the post editor shows an SEO panel:

  • Meta title / description
  • Keywords
  • URL slug (works with post slug)

Use with theme SSR and site SEO settings.

hello-world (auto-summary)

Generates summary at article.beforePublish Hook — useful for long posts without a manual summary.

image-optimizer

  1. Enable the plugin
  2. Open plugin settings and run scan
  3. Confirm batch optimization; see plugin docs for original-file policy

CLI install (Monorepo)

pnpm run build:plugins # compile official plugins
reactpress plugin install hello-world # requires Monorepo / full CLI

4.0 global CLI users should prefer Admin.

Plugins vs Webhooks

TypeTriggerUse case
Plugin HookIn-process, synchronous, can mutate dataSummary, SEO, validation
WebhookOutbound HTTP, asyncSlack, CI, external CMS

Configure Webhooks in Settings → Webhook; they complement plugins.

Develop custom plugins

See Plugin development guide and repo plugins/README.md.