Plugins / Forms / Docs

Dprime Forms v2.4.0 Pro

Drag and drop contact forms with seventeen field types, arrangeable field widths, backend submission storage, email notifications, file uploads, and reCAPTCHA.

Installation

  1. Make sure Dprime Core is installed and your site is connected to an active Dprime subscription.
  2. Download Dprime Forms from my.dprime.au and install via Plugins > Add New > Upload Plugin.
  3. Activate the plugin.
  4. Open Dprime > Forms and click New form.

Using the builder

The form editor has four inner tabs. The form name input and shortcode pill are pinned at the top so they are always visible as you scroll.

TabPurpose
FieldsVisual builder: palette on the left, canvas in the middle, settings panel on the right
NotificationsRecipient email, name, subject, and body with tag pill insertion
MessagesSuccess message, validation message, and submit button label
StyleCSS class reference for every frontend class

To add a field: drag a type from the left palette onto the canvas. The field is inserted at the Y position of the drop, not appended to the end. Click any field to select it and see its options in the right panel. Drag the grip handle (dots icon) to reorder. Click X on the header to delete.

Field types

CategoryTypes
BasicText, Email, Phone, Number, URL, Date, Long text
ChoiceDropdown, Radio, Checkbox, Multi check
LayoutHeading (H2/H3/H4), Divider, HTML block
AdvancedFile upload, Hidden, reCAPTCHA

Field widths

Every field can be sized at full, 3/4, 2/3, 1/2, 1/3, or 1/4 width. Two ways to change it: hover the field and drag the thin blue handle on its right edge (snaps to the nearest fraction), or click a width button in the right settings panel. Fields with smaller widths sit side by side on the same row. On screens narrower than 640px every field collapses to full width regardless.

Notifications

Set the recipient, subject, and body on the Notifications tab. Click any tag pill to insert a dynamic value at the current cursor position in the body.

TagExpands to
{{form_name}}The form's name
{{all_fields}}A styled HTML table of every submitted field
{{date}}Submission timestamp in the site's date format
{{ip}}Submitter's IP address
{{referrer}}Page URL the visitor submitted from
{{field_name}}Any individual field's value by its field name

Each form can override the global recipient, subject, body, and success message. Leave a field blank to fall back to the global Settings default.

reCAPTCHA

  1. Go to Google reCAPTCHA admin and register your site for reCAPTCHA v2 (I am not a robot).
  2. Copy the site key and secret key into the Settings tab in Dprime Forms.
  3. In each form where you want spam protection, drag the reCAPTCHA field type onto the canvas. One per form.
If a reCAPTCHA field is added but no site key is configured, admin users see a warning. Visitors see nothing and the form still submits.

Submissions

Every submission is stored in the wp_dp_form_submissions table with an ID, form ID, timestamp, IP, referrer, field values as JSON, and file metadata as JSON. Browse submissions from the Submissions tab, filter by form, and mark entries read or unread. Uploaded files appear as clickable links in the detail view.

Uninstalling (not just deactivating) drops the submissions table and deletes the settings option. Uploaded files in wp-content/uploads are left in place.

FAQ

Do my 1.x forms still work?

Yes. Existing forms in dpf_settings load unchanged. Fields without a width setting are treated as full width. The shortcode tag, AJAX action, and all frontend CSS classes are preserved.

Emails are not arriving.

WordPress's default wp_mail lands in spam on most hosts. Install a transactional email plugin like FluentSMTP or WP Mail SMTP. The plugin uses standard wp_mail so any SMTP plugin is picked up automatically.

File uploads are failing silently.

Check the field's max size setting and the server's upload_max_filesize and post_max_size PHP settings. The server limits cap the field limit.

Can I embed the same form on multiple pages?

Yes. Copy the shortcode from the editor top bar and paste it into any page or post. Each shortcode instance is independent and submits to the same form record.

Override classes

/* Form wrapper */
.dpf-wrap             { }
.dpf-form             { }

/* Row and column layout */
.dpf-row              { /* flex row holding field columns */ }
.dpf-col              { /* each field column */ }
.dpf-w-full           { } .dpf-w-half          { }
.dpf-w-third          { } .dpf-w-twothird      { }
.dpf-w-quarter        { } .dpf-w-threequarter  { }

/* Field wrappers */
.dpf-field-{name}     { /* e.g. .dpf-field-email */ }
.dpf-label-{name}     { }
.dpf-input-{name}     { }

/* Submit and feedback */
.dpf-submit           { }
.dpf-success          { }
.dpf-msg-error        { }

/* Admin: builder UI */
.dp-fm-canvas         { }
.dp-fm-palette-item   { }
.dp-fm-field-card     { }
.dp-fm-settings-panel { }