Documentation

Bringing 30 years of systems engineering and diagnostic precision to the WordPress ecosystem. Building high-integrity form builder tools that perform exactly as promised.

System Documentation

Uncomplicated Forms is designed to be Self-Documenting. Every setting within the administration interface includes an intuitive [Help] toggle. Clicking these toggles provides context-sensitive instructions directly within the workflow.

Configuration Structure of the Settings Tabs

Basic Settings: Core admin data (Form Title, Admin Email, Success Messages).
Fields: The Field Engine. Drag-and-drop reordering and individual configuration.
Styles: Visual layout logic (Labels on top, horizontal alignment, CSS overrides).
Labels: Global front-end text overrides for standard fields and validation errors.
Security: Anti-spam logic (Honeypot, Akismet, Turnstile) and data privacy settings.
Advanced: Complex routing, Redirects, and API/Silent Remote Sending.
Tools: Diagnostic handshakes, Email tests, and Backup/Restore logic.

The Field Engine

💡 Architectural Logic Note

The vertical sequence of fields in the administration interface determines the visual layout on your website and the data sequence in notification emails. Field labels must be unique.

Field Types Reference

Core Field Types

  • Text & Textarea: Single or multi-line strings.
  • Choice Inputs: One option per line. For Checkboxes, use 1 or checked in the Default box to pre-select.
  • Validated Inputs: Email, URL, and Phone. Phone (US) reformats to (555) 555-5555.
  • File Attachment: Secure handler. Files are sent as attachments and purged from the server for security.
  • Date/Time/DOB: Uses native browser pickers. DOB uses a 120-year dropdown.

Pro Field Types PRO ONLY

  • Dropdown with “Other”: Dynamic write-in box if “Other” is selected.
  • Currency / Pricing: Formats input to two decimal places (e.g., 10.00).
  • Linear Scale & Star Rating: Feedback systems with customizable labels.
  • Incremental # (Ticket ID): Generates a unique, non-repeating ID per submission.
  • Page Break: Converts the form into a multi-step wizard.

Field Properties Reference

Property Technical Logic
Tag Internal ID used in templates. Blank = auto-generated from name.
Default Value Pre-fills inputs.

Email Verification: Email==Re-enter Email
Split Name: First Name==Last Name
Multi-Part Name: First==Middle==Last
Attributes Direct attribute injection (e.g., readonly="readonly").
Select Options One per line. Use value==Label for custom mapping.
Follow Previous Enables multi-column layouts by placing field on the same line as the previous element.
Conditional Logic PRO: Toggles visibility based on user input.

Architectural Standards

Uncomplicated Forms requires PHP 8.2+. We prioritize security and modern performance features over legacy compatibility.