WP Manifestindependent plugin directory
manifest / forms / groundswell-wordpress

Groundswell for WordPress

Groundswell WordPress Plugin - Embed petitions, collect signatures, and create campaigns

by Groundswell · github.com/cloudwelder/groundswell-wordpress · website

★ 0stars
5release downloads
0forks

Install

The author publishes release zips, so WP-CLI can install straight from GitHub:

wp plugin install https://github.com/cloudwelder/groundswell-wordpress/releases/download/v1.0.0/groundswell.zip
Readme github.com/cloudwelder/groundswell-wordpress ↗

Official WordPress plugin for Groundswell - the open petition platform.

Features

  • Embed Petitions - Display any Groundswell petition on your WordPress site
  • Gutenberg Blocks - Native block editor support for embedding petitions
  • Shortcodes - Classic editor support via [groundswell_petition id="123"]
  • Signature Collection - Let visitors sign petitions directly from your site
  • Create Petitions - Allow users to create new petitions (requires API key)
  • Petition Lists - Display filterable lists of petitions by category or persona

Requirements

  • WordPress 6.4 or higher
  • PHP 8.1 or higher

Installation

From GitHub Releases (Recommended)

  1. Download the latest groundswell.zip from Releases
  2. In WordPress admin, go to Plugins → Add New → Upload Plugin
  3. Choose the downloaded zip file and click Install Now
  4. Activate the plugin

Manual Installation

  1. Download or clone this repository
  2. Run npm install && npm run build to compile assets
  3. Copy the groundswell/ folder to wp-content/plugins/
  4. Activate the plugin in WordPress admin

Configuration

  1. Go to Settings → Groundswell in your WordPress admin
  2. Enter your API key (get one at groundswell.petitions.io/account/api-keys)
  3. Configure display settings (theme, cache TTL)

Usage

Gutenberg Blocks

The plugin provides three blocks in the editor:

  • Groundswell Petition - Embed a single petition with signature form
  • Groundswell Petition List - Display a grid of petitions
  • Groundswell Create Petition - Embed the petition creation form

Shortcodes

[groundswell_petition id="123"]
[groundswell_petition_list category="environment" limit="6"]
[groundswell_create_petition]

Development

# Install dependencies
npm install
composer install

# Start development build (watch mode)
npm run start

# Production build
npm run build

# Build distributable zip
npm run build:zip

# Run tests
npm run test:unit
composer test
npm run test:e2e

License

GPL-2.0-or-later - see LICENSE for details.

Releases

1 release. Each count is every asset in that release; expand a row for the breakdown.

Tag
Published
Assets
Downloads
v1.0.0 latest
Feb 12, 2026 7mo ago
groundswell.zip
5