FP FormPing Documentation
Open Dashboard

03 — Embedding · Takeover

Use the form you already have.

Already wired up a Contact Form 7, WPForms, or plain HTML form? Takeover lets FormPing capture submissions without rebuilding anything. The widget watches for the submit, reads the field values, and forwards them — your existing markup, your existing styles.

The snippet

<script src="https://widget.formping.ch/widget.js"
        data-token="YOUR_TOKEN_HERE"
        data-form="form.contact"
        defer></script>

data-form takes a CSS selector pointing at your existing <form> element. The widget will:

  1. Wait for the form to exist (it retries up to 10 times over ~5 seconds for late-rendered forms).
  2. Intercept the submit event.
  3. Read every named field value.
  4. Run smart field detection to identify name, email, phone, and message.
  5. Forward the submission to FormPing.
  6. Optionally let the original form continue submitting too, if you want both.

Smart field detection

Takeover doesn't need you to rename your fields. It looks at the label, name, id, and placeholder of each input and matches against multilingual patterns in English, German, French, Spanish, Italian, and Portuguese to figure out what each field means. Examples it recognizes:

i

Detection is best-effort. If a field doesn't match any pattern, it's still included in the submission under its original name attribute — you'll just see it in the Inbox under that key instead of a friendly label.

Filtering metadata fields

Hidden fields used for tracking (e.g. _wpnonce, utm_source, g-recaptcha-response) are automatically filtered out so they don't pollute your inbox. Anything starting with an underscore or matching a known tracking parameter is skipped.

Compatible plugins

Takeover works with any plugin that produces a real <form> element:

!

Plugins that don't render a real <form> tag (some block-based builders) aren't supported by Takeover. Use a Script Tag or iFrame embed instead.

When to use