Pipeline Forms — Documentation

Guide to installing, setting up and using Pipeline Forms 1.0.1 for WordPress.

Contents

1. Installation

Requirements: WordPress 6.2 or newer and PHP 7.4 or newer.

  1. In WordPress, go to Plugins → Add New → Upload Plugin and choose the plugin zip (or copy the pipeline-forms folder to /wp-content/plugins/).
  2. Click Activate. A Pipeline Forms menu appears in the dashboard with All Forms, Add New, Entries and Settings.

Only one Pipeline Forms plugin can be active at a time. If another one is already active, the second shows a notice and does nothing until you deactivate one of them. Forms and entries are kept.

2. Getting started

  1. Go to Pipeline Forms → Add New and choose a template: Blank Form, Simple Contact Form, Newsletter Signup or Quote Request.
  2. In the builder, add fields from the palette, click a field to edit it in the inspector, and drag fields (or use the up and down buttons) to reorder them.
  3. Use the Settings, Notification and Confirmation tabs to set what happens on submit.
  4. Click Save, then place the form on a page (see below).

3. Fields

The plugin has 12 field types: single line text, paragraph text, dropdown, multiple choice, checkboxes, numbers, hidden field, name, email, phone, website / URL and consent. Every field can be marked required and has a label, placeholder, description, default value and custom CSS classes. Number fields can have a minimum, maximum and step; text and paragraph fields a maximum length; name fields a simple or first/last format. The consent field shows a checkbox with text you write (links allowed).

4. Form settings

5. Email notification and confirmation

On the Notification tab the form sends one email to the addresses you list (default: the site admin email) each time it is submitted. You can set the subject and message and choose an Email field as the Reply-To address so you can reply to the visitor directly. Emails are sent with WordPress's own mail function; if your host's mail is unreliable, use an SMTP plugin. Each entry shows whether the send attempt succeeded.

Merge tags you can use: {all_fields}, {form_name}, {entry_id}, {admin_email}, {site_name}, {site_url}, {date}, {ip}, {page_url} and {field:ID} (a single field by its ID). {ip} is empty if you turned off IP storage.

On the Confirmation tab choose either a message shown after submitting or a redirect to a URL you enter.

6. Showing a form on a page

Forms submit with AJAX and also work without JavaScript.

7. Entries

Under Pipeline Forms → Entries you can filter by form and date, search the entries, open an entry to see its answers, delete entries one at a time or in bulk, and export CSV. The CSV export button appears when a single form is selected; it exports that form's complete entries that match the current search and dates, with the columns Entry ID, Date (UTC), Status, IP, Source URL and one column per field. Cells that start with =, +, - or @ are prefixed with an apostrophe so spreadsheets do not run them as formulas.

Deleting a form also deletes its entries.

8. Spam protection

9. Settings

Under Pipeline Forms → Settings:

10. Privacy and personal data

Everything the plugin collects is stored in your WordPress database. It does not send submissions anywhere. This is what is stored and how long it stays:

DataStored on your siteSent toHow it is removed
EntriesThe answers to your form; the entry date; the visitor's IP address (if IP storage is on); the browser user agent (first 255 characters); the address of the page the form was on (only if it is on your own site); the WordPress user ID if the visitor was logged in, otherwise 0; a status; read and star flags; a record of the notification send attempt.Nobody. The notification email goes to the addresses you set.You delete entries under Entries, or delete the form. Entries are never deleted automatically; there is no retention period.
Rate-limit counterA temporary counter under a hash of IP address and site salt, which expires after the rate-limit window.NobodyExpires by itself; also removed on uninstall.
No built-in privacy tools. The plugin does not add to the WordPress personal data export or erase tools and does not add text to your privacy policy. To answer a request about a person, search the entries for them (for example by email address), open or export the entries, and delete them. The user agent and the source address are stored with the entry and are shown in neither the entry list nor the CSV export. Copies of the notification email stay in the mailboxes that received it.

If you turn on a captcha, mention it in your own privacy policy (see External Services). Turn off IP storage under Settings if you do not want the IP address kept.

11. Uninstalling

Deactivating or deleting the plugin keeps your forms and entries unless Delete all forms, entries and settings when the plugin is deleted was ticked under Settings before deleting. With that option ticked, deleting the plugin removes all forms, the entries and entry-meta tables and the settings. Temporary counters and the per-user notice flag are always removed on delete.

12. Troubleshooting

Emails do not arrive

WordPress sends mail through your host's mail function, which is often unreliable. Install an SMTP plugin. Open the entry to see whether the send attempt succeeded.

“Your session expired” on submit

The page may be cached for a long time. Reload the page and try again, or exclude the page from full-page caching.

“That was a bit too fast”

The visitor submitted before the minimum time passed. Lower or remove the minimum under Settings.

13. External Services & Data

Pipeline Forms does not contact any outside service on its own and does not track visitors. It makes no requests to 007aj.com. Links to 007aj.com in the admin screens only open when you click them.

ServiceUsed forWhat is sentTerms and privacy
Google reCAPTCHA v2Optional captcha. Off unless you choose it under Settings and switch it on for a form.The visitor's browser loads https://www.google.com/recaptcha/api.js. When the form is submitted, your server sends your secret key, the visitor's response token and the visitor's IP address to https://www.google.com/recaptcha/api/siteverify.Terms · Privacy
hCaptchaOptional captcha. Off unless you choose it under Settings and switch it on for a form.The visitor's browser loads https://js.hcaptcha.com/1/api.js. When the form is submitted, your server sends your secret key, the visitor's response token and the visitor's IP address to https://api.hcaptcha.com/siteverify.Terms · Privacy

The plugin sets no cookies. 007AJ's own Terms and Privacy pages are linked in the footer.

14. Support

Email admin@007aj.com. Please include the plugin version (shown under Plugins) and what you expected to happen.

Looking for multi-step forms, conditional logic, file uploads, payments, integrations or popups? They are in the separate plugin Pipeline Forms Suite; its documentation is at /pipeline-forms-suite/docs.

← Back to Pipeline Forms