Main Documentation Update

PageMotor Forms Plugin Documentation 📝

Welcome to the comprehensive guide for PageMotor Forms – your gateway to creating beautiful, functional forms without the complexity!

The Story Behind PageMotor Forms 🌟

Picture this: You’re building a website and need a contact form. Not just any form, but one that seamlessly integrates with your PageMotor theme, respects your design choices, and just works. That’s exactly why this plugin exists.

After years of wrestling with bloated form plugins and their CSS nightmares, I decided to create something different – a forms solution that truly understands the PageMotor way of doing things.

What Makes This Special? ✨

GDPR Compliance Module (New!)

Full GDPR compliance with rights management, consent tracking, and automated information blocks.

Dynamic SCSS Integration

The plugin generates dynamic SCSS on the fly, properly utilising PageMotor theme variables for perfect design integration.

Visual Form Builder

The visual builder interface lets you see your form structure at a glance (drag-and-drop functionality coming soon).

AJAX Submissions

Your visitors stay right where they are – forms can submit smoothly in the background when AJAX is enabled.

Conditional Logic

Show additional fields based on user selections with the conditional field system.

Database Storage & Email Notifications

Every submission is safely stored (if you want it to be), and you’ll get instant email notifications with improved deliverability.

Updated Documentation Section

Deep PageMotor Integration 🔌

The plugin now integrates with PageMotor’s native form tools when available:

  • Standardized Form Markup – Automatically uses PageMotor’s form rendering tools
  • Proper Text Sanitization – All output is properly sanitized using PageMotor’s text tools
  • Theme Consistency – Forms inherit PageMotor’s standardized markup patterns
  • Fallback Support – Maintains compatibility with older PageMotor versions

Technical Integration Details

The plugin checks for $motor->tools->form availability and automatically converts your pipe-delimited field configurations to PageMotor’s standardized format. This ensures:

  • Consistent markup across all PageMotor installations
  • Proper HTML entity handling in all contexts
  • Native theme integration
  • Future-proof compatibility

Installation & Setup 🚀

Step 1: Upload the Plugin

Place the plugin folder in your /user-content/plugins/ directory. PageMotor will automatically recognise it.

Step 2: Configure Site-Wide Options

Navigate to your PageMotor admin and find the Forms plugin settings:

Notification Email: your@email.com
Save Entries: yes (recommended)
Form Accent Color: #007cba (optional)
Enable GDPR Module: yes/no
Company Name (for GDPR): Your Company Name
Privacy Policy URL: /privacy-policy
Data Protection URL: /data-protection

Step 3: Add Your First Form

When editing a page, add a new box and select “PM Forms” from the available box types.

Building Your Forms 🛠️

Field Types Available 📋

  • Text Input – Standard single-line text field
  • Email – Built-in validation for email format
  • Phone (tel) – Mobile-optimised numeric input
  • Dropdown (select) – Predefined option selection
  • Radio Buttons – Single-choice with all options visible
  • Checkboxes – Multiple selections or yes/no choices
  • Textarea – Multi-line text input
  • Consent – GDPR-compliant consent checkboxes with link support

Manual Configuration

The fields configuration uses a simple pipe-delimited format:

type|name|label|options|condition

Examples:

text|name|Your Name
email|email|Email Address
select|interest|Area of Interest|Sales,Support,Partnership
textarea|message|Your Message
consent|privacy_consent|Privacy Agreement|I agree to the [privacy policy](/privacy)

GDPR Compliance Features 🔒

Enabling GDPR Module

  1. Set “Enable GDPR Module” to “yes” in plugin settings
  2. Configure company name and policy URLs
  3. Enable GDPR features on individual forms

GDPR Rights Management

When enabled, forms automatically include:

  • Rights selection checkboxes (rectification, forgotten, portability, object, access, other)
  • Dynamic information blocks explaining each right
  • Mandatory consent checkbox
  • Automated compliance tracking

Consent Field Type

The consent field supports markdown-style links:

consent|terms|Terms Agreement|I agree to the [terms](/terms) and [privacy policy](/privacy)

Styling Your Forms 🎨

Dynamic SCSS Integration

The plugin generates dynamic styles that fully integrate with PageMotor variables:

  • Spacing: $x1 through $x6
  • Colours: $color1 through $color5
  • Font sizes: $f1 through $f6
  • Custom accent colour support
  • GDPR-specific styling classes

CSS Classes

  • .pm-form-wrapper – Main container
  • .pm-form – Form element
  • .pm-form-field – Field containers
  • .pm-field-consent – Consent checkboxes
  • .pm-field-gdpr-rights – GDPR rights section
  • .pm-gdpr-info – GDPR information blocks
  • .pm-form-success – Success messages
  • .pm-form-error – Error states

Email Notifications 📧

Enhanced email system includes:

  • SPF-compliant From addresses
  • Reply-To header for user emails
  • GDPR rights tracking in notifications
  • Improved deliverability headers
  • Error logging for debugging

What’s Next? 🔮

  • Functional drag-and-drop – Complete the visual builder
  • File uploads – Attachment support
  • Multi-step forms – Complex workflows
  • Form templates – Quick-start common forms
  • Entry management – View submissions in admin
  • Export capabilities – CSV/Excel downloads with GDPR compliance

 

 

Made with ❤️ for the PageMotor community