Skip to content

webguyjeff/block-forms

Repository files navigation

Block Forms

Gutenberg-powered form builder for creating flexible contact and custom forms directly in the WordPress block editor.


✨ Features

  • Build forms visually using the block editor (Gutenberg)
  • Add and arrange fields as blocks
  • Lightweight and flexible compared to traditional form builders
  • Designed to integrate naturally with WordPress editing workflows
  • Ideal for contact forms, simple data capture, and custom layouts
  • Email sending of submissions
  • Submission storage as posts
  • Input validation
  • Spam protection

📦 Installation

WordPress

  1. Upload the plugin to /wp-content/plugins/
  2. Activate the plugin via the WordPress admin
  3. Open the block editor and search for “Form” or related blocks

🚀 Usage

WordPress

  1. Open a page or post in the block editor
  2. Insert the Form block
  3. Add fields (text, email, textarea, etc.) as inner blocks
  4. Configure labels and settings as needed
  5. Publish and start collecting submissions

Use cases:

  • Contact forms
  • Simple enquiry forms
  • Custom inline forms within content

⚙️ Configuration

  • Configure form fields directly within the block editor
  • Adjust labels, placeholders, and required fields
  • Control layout using standard block editor tools

🧱 Blocks / Components

  • Form Block — Container for building a form
  • Field Blocks — Input elements such as text, email, textarea, etc.
  • Submit Button — Handles form submission (built into form block)

🎨 Styling

  • Inherits styles from your active theme
  • Fully compatible with block editor design tools
  • Build in style presets for quick styling

📸 Screenshots

...coming soon!


🛣 Roadmap

  • Additional field types
  • Microsoft account email sending
  • Enhanced spam protection (e.g. CAPTCHA or equivilent)
  • Form templates

🤝 Contributing

Contributions, issues, and feature requests are welcome.

If you’d like to contribute:

  1. Fork the repo
  2. Create a feature branch
  3. Submit a pull request

🐛 Issues

If you find a bug, please open an issue with:

  • Steps to reproduce
  • Expected behaviour
  • Screenshots (if relevant)

📄 License

This project is licensed under the GNU General Public License v3.0.


👤 Author

Built and maintained by webguyjeff


About

Gutenberg-powered form builder for creating flexible contact and custom forms in WordPress.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors