https://github.com/wpzoom/wpzoom-forms
WPZOOM Forms is a simple, user-friendly contact form plugin for WordPress that utilizes Gutenberg blocks for easy form building and customization.
https://github.com/wpzoom/wpzoom-forms
wordpress wordpress-plugin
Last synced: 16 days ago
JSON representation
WPZOOM Forms is a simple, user-friendly contact form plugin for WordPress that utilizes Gutenberg blocks for easy form building and customization.
- Host: GitHub
- URL: https://github.com/wpzoom/wpzoom-forms
- Owner: wpzoom
- Created: 2020-09-09T21:28:00.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2026-05-20T15:32:58.000Z (27 days ago)
- Last Synced: 2026-05-20T15:37:52.319Z (27 days ago)
- Topics: wordpress, wordpress-plugin
- Language: PHP
- Homepage: https://www.wpzoom.com/plugins/wpzoom-forms/
- Size: 4.54 MB
- Stars: 0
- Watchers: 3
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# WPZOOM Forms
A simple, user-friendly contact form plugin for WordPress with a dedicated drag-and-drop builder. Build beautiful, responsive forms in minutes, then embed them anywhere — as a block, an Elementor widget, or a shortcode.
[](https://wordpress.org/plugins/wpzoom-forms/)
[](https://wordpress.org/plugins/wpzoom-forms/)
[](https://wordpress.org/plugins/wpzoom-forms/)
[](https://www.gnu.org/licenses/gpl-2.0.html)
## Features
### Free Features
- **Dedicated Drag-and-Drop Builder** - Build and manage forms in a standalone WPZOOM Forms admin screen, independent of the block editor
- **Embed Anywhere** - Block, Elementor widget, or shortcode
- **Ready-to-Use Templates** - Contact, feedback, appointment forms and more
- **Advanced Spam Protection**:
- Google reCAPTCHA (v2 and v3)
- Akismet anti-spam
- Cloudflare Turnstile
- Honeypot
- **Email Notifications** - Instant alerts on submissions
- **Submission Management** - Submissions saved in WordPress, exportable via Tools > Export
- **Date Picker Field** - For bookings and appointments
- **Multi Checkboxes** - Multiple selection options
- **Predefined Lists** - Countries and US states
### PRO Features
- AI Form Generator
- Mailchimp integration
- Custom email notifications with a visual editor
- AJAX form submissions (no page reload)
- File upload fields (PDF, images)
- Time Picker, GDPR consent, Hidden, and Number fields
- Conditional logic
- Import/export forms and CSV submission export
- Duplicate forms
- 20+ PRO templates
- Premium support
### Included Templates
- Contact Form
- Advanced Form with Full Address
- Wedding Invitation
- Quote Request Form
- Feedback Form
- Appointment Form
## Installation
### From WordPress.org
1. Go to **Plugins > Add New** in your WordPress admin
2. Search for "WPZOOM Forms"
3. Click **Install Now** and then **Activate**
### Manual Installation
1. Download the plugin from [WordPress.org](https://wordpress.org/plugins/wpzoom-forms/)
2. Upload to `/wp-content/plugins/wpzoom-forms/`
3. Activate through the **Plugins** menu
### From GitHub
```bash
cd wp-content/plugins
git clone https://github.com/wpzoom/wpzoom-forms.git
```
## Usage
### Creating a Form
1. Go to **WPZOOM Forms** in your WordPress admin
2. Click **Add New** to open the drag-and-drop builder
3. Choose a template or start from scratch
4. Drag in fields and arrange your layout
5. Configure notifications and form settings
6. Save your form
### Embedding Forms
#### Using Shortcode
Copy the shortcode from your form and paste anywhere:
```
[wpzf_form id="123"]
```
#### Using Block
1. Edit any page or post
2. Add the **WPZOOM Form** block
3. Select your form from the dropdown
#### Using Elementor
1. Edit page with Elementor
2. Search for WPZOOM Forms widget
3. Drag and drop, then select your form
### Viewing Submissions
1. Go to **WPZOOM Forms > Submissions**
2. Filter by form if needed
3. Export submissions via **Tools > Export**
### Spam Protection Setup
#### Google reCAPTCHA
1. Go to **WPZOOM Forms > Settings**
2. Enter your reCAPTCHA site key and secret key
3. Choose v2 or v3
#### Cloudflare Turnstile
1. Go to **WPZOOM Forms > Settings**
2. Enter your Turnstile site key and secret key
#### Akismet
1. Install and activate the Akismet plugin
2. Connect with your API key
3. Protection is automatic
## Development
### Prerequisites
- Node.js (v14 or later)
- npm (v6 or later)
### Setup
```bash
# Clone the repository
git clone https://github.com/wpzoom/wpzoom-forms.git
cd wpzoom-forms
# Install dependencies
npm install
```
### Build Commands
```bash
# Start development mode (watch + rebuild on change)
npm run start
# Build all assets for production
npm run build
```
> Tip: if a source change doesn't appear after a build, clear the cache with `rm -rf node_modules/.cache && npm run build`.
### Plugin Structure
```
wpzoom-forms/
├── classes/ # PHP classes (builder page, REST API, renderer, schema, migration, submissions…)
├── src/ # JavaScript/SCSS source (builder app, form block, fields)
├── build/ # Compiled assets (from `npm run build`)
├── elementor/ # Elementor widget integration
├── templates/ # Predefined form templates
├── languages/ # Translations
└── wpzoom-forms.php # Main plugin file
```
### Performance Notes
The plugin is optimized to:
- Load JavaScript only on pages with forms
- Load block editor dependencies only in admin
- Load field-specific assets (datepicker) only when needed
- Minify all frontend JavaScript
### Settings
Important plugin settings that affect performance:
1. "Load plugin assets globally" - Only enable if using forms with page builders
2. "Load default styling for forms" - Can be disabled if your theme handles form styling
## Requirements
- WordPress 6.5 or higher
- PHP 7.4 or higher
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## Bugs
If you find an issue, let us know [here](https://github.com/wpzoom/wpzoom-forms/issues)!
## Support
This is a developer's portal for WPZOOM Forms and should _not_ be used for support. Please visit the [support page](https://wordpress.org/support/plugin/wpzoom-forms/) on WordPress.org if you need to submit a support request.
## License
This plugin is licensed under the [GPL v2 or later](https://www.gnu.org/licenses/gpl-2.0.html).
---
**Links:** [WordPress.org](https://wordpress.org/plugins/wpzoom-forms/) | [WPZOOM](https://www.wpzoom.com/) | [Documentation](https://www.wpzoom.com/documentation/wpzoom-forms/) | [GitHub](https://github.com/wpzoom/wpzoom-forms)