Contributors: Automattic

Tags: polls, forms, surveys, gutenberg, block

Requires at least: 6.0

Requires PHP: 5.6.20

Tested up to: 6.9

Stable tag: 1.4.5

License: GPLv2 or later

License URI: http://www.gnu.org/licenses/gpl-2.0.html

The Crowdsignal Forms plugin allows you to create and manage polls right from within the block editor.

The Crowdsignal Forms plugin allows you to create and manage polls right from within the block editor. Creating polls is as simple and as fast as writing a bullet point list. No embed blocks and no copy pasting needed anymore.

Customize the look and feel of your polls to match your brand, and pick your favorite color. The poll block supports the styling of your theme by default, and from there you can customize the styling of your polls the way you want.

With Crowdsignal’s results page you can view all responses as they come in. See the geo-locations of your voters and analyze IP addresses for any suspicious voting behavior. See advanced stats and analytics for understanding your audience.

Analyze your results and then export them in a number of different formats.

Set close dates for polls, create polls with single or multiple choice answers, choose whether to show your readers the poll results or keep them private.

You can create an unlimited number of polls with a free Crowdsignal account and your first 2,500 signals are free. A signal is a response you get to a poll. If you are on a free plan, you still have full access to the first 2,500 signals. Any further responses you collect will still be recorded but if you upgrade you will get access to our unlocked reports to see them. You’ll also get access to a range of features not available to free users.

The easiest way to install this plugin is through the "Add New Plugins" page on your site.

1. Go to the Plugins page and click "Add New".
2. Type "Crowdsignal Forms" in the search box and press return.
3. Click the "Install Now" button.

Once installed you must connect your site to Crowdsignal.com

1. Activate the plugin and you will be brought to the Getting Started page.
2. Click "Let's get started" to open a popup that will allow you to login or create a new Crowdsignal account.
3. You'll be presented with an API key to use so press Connect and you'll be brought back to your own site.
4. The popup will disappear and the message, "You’re ready to start using Crowdsignal!" will be shown.
5. Happy polling! Create a post and add a new "poll" block!

We’re starting with just the Crowdsignal poll block but more blocks are coming soon.

Crowdsignal is built by Automattic, the company behind WordPress.com, WooCommerce, Tumblr and more. We’re here to stay!

Automattic is a distributed team working from all around the world, so it’s always business hours for our more than 250 gazillion Happiness Engineers. Check out our support documentation, the support forum or reach out to us anytime and we'll be happy to help.

Compare our simple and affordable plans or take a product tour to learn more.

Poll block:

Vote block:

Customizable NPS block:

Applause block and custom colors:

Feedback Button block:

• Node.js 18.13.0 (see .nvmrc)
• pnpm 9+
• PHP 8.1+
• Composer
• Docker (for local WordPress environment)

# Install dependencies
pnpm install
composer install

# Build the plugin
pnpm build

A Docker-based WordPress environment is provided for development and testing.

# Build and start containers (creates docker/.env from default.env if needed)
make docker_build
make docker_up

The local WordPress site will be available at http://localhost:8000/

Default credentials (see docker/default.env):

• Username: wordpress
• Password: wordpress

Other useful commands:

make docker_sh        # Shell into WordPress container
make docker_stop      # Stop containers
make docker_down      # Stop and remove containers
make phpunit          # Run PHP unit tests
make phpcs            # Run PHP CodeSniffer

pnpm build            # Full production build
pnpm run build:poll   # Build specific block
pnpm run build:styles # Compile SCSS only

pnpm test             # Run JavaScript tests
make phpunit          # Run PHP tests (requires Docker)

pnpm run lint:js      # ESLint
pnpm run lint:styles  # Stylelint
./vendor/bin/phpcs    # PHP CodeSniffer

See the changelog for full history