Fillable Forms - WordPress Plugin

A free, accessible WordPress plugin for creating fillable forms that users can complete online, print, download as PDF, and email. Built specifically for charities and organizations serving people with health conditions and disabilities.

✨ Features

For Administrators

• Easy Form Builder: Intuitive drag-and-drop interface for creating custom forms
• Multiple Field Types:
  • Text (single-line)
  • Textarea (multi-line)
  • Select (dropdown)
  • Radio buttons (single choice)
  • Checkboxes (multiple choice)
  • Date picker (mobile-friendly)
• Simple Integration: Use shortcodes to embed forms anywhere on your site
• No Database Storage: Privacy-first approach - no user data stored on server

For Users

• Accessible Design: WCAG 2.1 AA compliant with full keyboard navigation and screen reader support
• Mobile-Friendly: Fully responsive design that works on all devices
• Download as PDF: Generate PDFs client-side for offline use
• Email Forms: Send completed forms via email client
• Print Support: Browser-based printing with optimized print styles
• Auto-Save: Automatic saving to browser local storage
• Privacy-First: All data stays in the user's browser

🚀 Installation

Method 1: Manual Installation (Recommended)

1. Download the latest release or clone this repository:

   git clone https://github.com/odgy8/wp-fillable-forms.git

2. Upload the wp-fillable-forms folder to your WordPress plugins directory:

   /wp-content/plugins/

3. Log in to your WordPress admin panel

4. Navigate to Plugins → Installed Plugins

5. Find Fillable Forms and click Activate

Method 2: WordPress Admin Upload

1. Download the plugin as a ZIP file
2. Go to Plugins → Add New → Upload Plugin
3. Choose the ZIP file and click Install Now
4. Click Activate Plugin

📖 Usage

Creating Your First Form

1. In WordPress admin, go to Fillable Forms → Add New Form

2. Enter a form title (e.g., "Health Assessment Form")

3. Add fields by clicking the field type buttons:

   • Text: For short answers (name, email, etc.)
   • Textarea: For longer responses (medical history, notes)
   • Select: For dropdown menus with predefined options
   • Radio: For single-choice questions
   • Checkbox: For multiple-choice questions
   • Date: For date selection with mobile-friendly picker

4. Configure each field:

   • Enter a clear, descriptive label
   • For select, radio, and checkbox fields, add custom options
   • Drag fields to reorder them

5. Click Save Form

6. Copy the generated shortcode (e.g., [fillable_form id="123"])

Displaying a Form on Your Site

Using the Classic Editor

1. Edit the page or post where you want the form
2. Paste the shortcode directly into the content
3. Publish or update

Using Gutenberg (Block Editor)

1. Edit your page or post
2. Add a Shortcode block
3. Paste your shortcode: [fillable_form id="123"]
4. Publish or update

Using Elementor (or other page builders)

1. Edit your page with the page builder
2. Add a Shortcode widget
3. Paste your shortcode
4. Update the page

User Experience

When users visit your form, they can:

1. Fill Out: Complete all form fields
2. Auto-Save: Data automatically saves to their browser
3. Clear: Reset all fields with confirmation
4. Download PDF: Generate a PDF of the completed form
5. Email: Send the form via their email client
6. Print: Use browser print for physical copies

🎯 Use Cases

• Healthcare Forms: Patient intake forms, health assessments, symptom trackers
• Charity Applications: Support request forms, volunteer applications
• Accessibility Services: Needs assessment forms, accommodation requests
• General Purpose: Any form where users need to fill out, save, and share data offline

🔒 Privacy & Security

• No Server-Side Storage: Form responses are NOT saved to your WordPress database
• Client-Side Only: All data stays in the user's browser (local storage)
• GDPR Friendly: No personal data collected or stored by the plugin
• Privacy Notice: Clear messaging to users about data handling
• Open Source: Fully auditable code

🛠️ Technical Details

Requirements

• WordPress 5.0 or higher
• PHP 7.2 or higher
• Modern web browser with JavaScript enabled

External Libraries (Loaded from CDN)

• Flatpickr (v4.6.13): Mobile-friendly date picker
• jsPDF (v2.5.1): Client-side PDF generation

Browser Support

• Chrome/Edge (latest)
• Firefox (latest)
• Safari (latest)
• Mobile browsers (iOS Safari, Chrome Mobile)

File Structure

wp-fillable-forms/
├── fillable-forms.php          # Main plugin file
├── includes/
│   ├── admin-list.php          # Admin forms list
│   ├── form-builder.php        # Form builder interface
│   └── form-display.php        # Frontend form display
├── assets/
│   ├── css/
│   │   ├── admin.css           # Admin styles
│   │   └── frontend.css        # Frontend styles
│   └── js/
│       ├── admin.js            # Form builder JS
│       └── frontend.js         # Form interaction & PDF generation
├── README.md
└── .gitignore

🎨 Customization

Styling

The plugin uses CSS classes you can target for custom styling:

/* Main container */
.fillable-form-container { }

/* Form fields */
.fillable-form-field { }
.fillable-form-input { }
.fillable-form-textarea { }
.fillable-form-select { }

/* Buttons */
.fillable-form-btn { }
.fillable-form-btn-primary { }
.fillable-form-btn-secondary { }

Add custom CSS in Appearance → Customize → Additional CSS

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development Setup

1. Clone the repository
2. Make your changes
3. Test thoroughly with WordPress locally
4. Submit a PR with a clear description

Reporting Issues

Found a bug? Please open an issue with:

• WordPress version
• PHP version
• Browser and version
• Steps to reproduce
• Expected vs actual behavior

📄 License

This project is licensed under the GPL v2 or later - see the LICENSE file for details.

👏 Credits

Developed for Astriid - Supporting people with long-term and serious health conditions.

Built with accessibility and user privacy as top priorities.

💬 Support

• Issues: GitHub Issues
• Documentation: This README

🗺️ Roadmap

Future enhancements under consideration:

• Form submission storage (optional)
• Email notifications to admins
• Conditional logic for fields
• Multi-page forms
• Form templates library
• Custom email templates
• Export form responses (if storage added)

---

Made with ❤️ for accessibility and privacy