Forms help file

Installation, everyday use, troubleshooting, and technical reference for version 2.8.1.

Content & forms
On this page

Overview

Dprime Forms 2.0 ships a full visual form builder. Drop field types onto a canvas, click to configure, drag the right edge to set width, drag fields by their grip to reorder.

Embed forms anywhere with the shortcode [dp_form id="..."]. Submissions are stored in a dedicated database table with read or unread tracking, IP, referrer, and any uploaded files.

Seventeen field types

Before you start

  • WordPress 6.4 or newer
  • PHP 8.2 or newer

Installation

  1. Upload the plugin folder to /wp-content/plugins/.
  2. Activate Dprime Forms through the Plugins screen.
  3. Make sure Dprime Core is installed and your site is connected.
  4. Open Forms under the Dprime menu.
  5. Click New form. Drag field types from the left palette to the canvas. Save.
  6. Copy the shortcode from the top of the editor and paste it into a page or post.

Using the plugin

  • Basic: Text, Email, Phone, Number, URL, Date, Long text
  • Choice: Dropdown, Radio, Checkbox, Multi check
  • Layout: Heading (H2/H3/H4), Divider, HTML block
  • Advanced: File upload, Hidden, reCAPTCHA
  • Fields: visual builder with palette, canvas, and settings panel
  • Notifications: recipient, subject, body with tag pills
  • Messages: success message, validation message, submit button label
  • Style: CSS class reference for theming
  • Drag and drop reordering and width resize on the canvas
  • reCAPTCHA as a field type, placeable anywhere in the form (and limited to one per form)
  • File uploads stored in the WordPress media library with size and type validation
  • Server side validation per type (email format, URL format, numeric range)
  • Submissions table with form filter, pagination, read/unread state, referrer tracking
  • Tag pills click to insert into email body at cursor: {{form_name}}, {{all_fields}}, {{date}}, {{ip}}, {{referrer}}, plus every named field
  • Per form override for recipient, subject, body, success message

Shortcodes

Use these in the WordPress editor, a shortcode block, or a compatible page builder.

[dp_form]
[dprime_form]

Styling and CSS classes

These public-facing class hooks are present in the plugin styles. Add custom CSS only after checking the result on a staging site.

.dpf-checkbox-group.dpf-checkbox-item.dpf-checkbox-label.dpf-col.dpf-consent-label.dpf-consent-link.dpf-consent-text.dpf-divider.dpf-field.dpf-file.dpf-file-hint.dpf-form.dpf-heading.dpf-heading-h2.dpf-heading-h3.dpf-heading-h4.dpf-html.dpf-input.dpf-label.dpf-msg.dpf-msg-error.dpf-phone-code.dpf-phone-error.dpf-phone-num

Data and cleanup

  • 4 WordPress settings
  • Database table: your WordPress table prefix + dp_form_submissions
  • Uploaded files: wp-content/uploads
  • External service: Google reCAPTCHA

Retention: kept until the plugin is uninstalled. Uninstall policy: delete the plugin-owned data declared above.

Troubleshooting

  1. Confirm the required WordPress, PHP, and companion-plugin versions above.
  2. Save the plugin settings again, then repeat the exact action that failed.
  3. Clear page, object, and browser caches when the issue affects front-end output.
  4. Temporarily test with unrelated plugins disabled on a staging site to identify a conflict.
  5. If the problem remains, record the steps, visible error, and relevant logs before contacting support.

Frequently asked questions

Does this plugin upgrade existing forms from 1.x?

Yes. Existing forms saved in dpf_settings continue to work unchanged. Any field saved without a width setting is treated as full width. The shortcode [dp_form id="..."], the table dp_form_submissions, and every frontend CSS class are unchanged.

How does the resize handle work?

Hover any field on the canvas to see a thin blue handle on its right edge. Drag it left or right; the field snaps to the nearest of 1/4, 1/3, 1/2, 2/3, 3/4, or full. You can also use the width buttons in the right settings panel.

Can I have more than one reCAPTCHA on a form?

No. The reCAPTCHA field is unique per form. The builder blocks adding a second one. If you need spam protection on multiple forms, add one reCAPTCHA field to each form.

Where are uploaded files stored?

Standard WordPress uploads directory (wp-content/uploads/YYYY/MM/). Filenames are sanitised by WordPress's own upload pipeline. The file metadata (filename, URL, MIME type) is stored in the new files column of the submissions table as JSON.

Does it work with WP Mail SMTP?

Yes. The plugin uses standard wp_mail which is intercepted by any SMTP plugin you install.

Updates and access

An active individual or portfolio entitlement provides updates and support. After expiry, the installed local version remains, while update access, support, new activations, domain moves, and protected remote services stop.