Installatiemanager Opnameformulier

This plugin allows you to integrate intake forms from Installatiemanager directly in your WordPress site.
You can select the fields you want to show in the form, and the data will be sent to Installatiemanager automatically
upon submission. Installatiemanager creates a new intake record for each submission.

Usage

Block editor

The quickest way to add a form is with the Gutenberg block editor. Edit any post or page,
add the “Installatiemanager opnameformulier” block, and open the block settings panel on the right.

1. Enter the assist key you received from Installatiemanager.
2. The plugin fetches the available fields for that key from the Installatiemanager API.
3. Click a field in the “Available fields” column to move it to “Selected fields”.
4. Use the arrow buttons to change the order of the selected fields.
5. Save or publish the post. The form will appear on the front end.

When a visitor submits the form, the data is sent to Installatiemanager and a new intake record
is created automatically.

Reusable form configurations

If you want to embed the same form in multiple places, or if you are using the Classic Editor or
a page builder, you can create a reusable form configuration first.

1. Go to “IM formulieren” in the WordPress admin menu and click “Voeg formulier toe”.
2. Give the configuration a recognisable title.
3. Enter the assist key and select the fields, just like in the block editor.
4. Click “Bijwerken” to save. The post ID is shown in the URL bar (e.g. post=42).

Shortcode

Once you have saved a form configuration, you can embed it anywhere using the shortcode:

[installatiemanager_opnameformulier id=”42″]

Replace 42 with the post ID of the form configuration you want to display. The shortcode works
in the Classic Editor, in any text widget, and in page builders that support shortcodes.

reCAPTCHA (optional)

To protect your forms against spam and bots, you can enable reCAPTCHA under
Settings > Opnameformulier. The plugin uses an invisible reCAPTCHA v3 check on every
submission. If the v3 score is too low, a visible v2 checkbox challenge is shown as a fallback.

To set this up:

1. Register your site at https://www.google.com/recaptcha/admin and create two key pairs:
   one for reCAPTCHA v3 and one for reCAPTCHA v2 (“I am not a robot” checkbox).
2. Enter all four keys (two site keys, two secret keys) under Settings > Opnameformulier.
3. Optionally adjust the v3 score threshold (default: 0.5). Submissions scoring below
   the threshold will be shown the v2 checkbox instead of being rejected outright.

All verification happens server-side through a WordPress proxy. reCAPTCHA secret keys are
never exposed to the browser.

Download and activate the plugin in WordPress.

1.0.0

• Added reusable form configurations as a custom post type (IM formulieren)
• Added shortcode [installatiemanager_opnameformulier id=”42″] to embed forms in the Classic Editor and page builders
• Form submissions now go through a WordPress proxy endpoint, resolving browser CORS restrictions
• Added inline spinner and success/error message on form submission instead of opening a new tab
• Added reCAPTCHA v3 (invisible) with reCAPTCHA v2 checkbox fallback
• Improved block editor UI: field list now shows a loading spinner and error state while fetching
• Changing the assist key in the editor now clears the previous field selection immediately
• Fixed PHP warning when block attributes are missing on initial render
• Fixed post meta not persisting when saving a form configuration
• Security: post meta can now only be edited by users with the edit_posts capability

0.1.5

• Communicate with the production backend, not the test backend

0.1.4

• Fixed bug due to PHP 8.0+ syntax

0.1.3

• Fixed the build process

0.1.2

• Added and normalized css classes for styling

0.1.1

• Fixed descriptions

0.1.0

• Initial submission