MOBIRISE Free Add-ons*

🧰 FormBuilder

📚 Overview

Drag-and-drop form generator for your PHP sites

FormBuilder lets you create forms visually, embed them anywhere, collect responses, and manage files—all with a simple admin UI.
Every submission is centralized in the admin and can be reviewed, searched, or exported.
You can edit the form at any time; updates take effect instantly on the visitor-facing form. It ships with:

• Builder UI (builder.php) with drag-and-drop blocks.
• Public renderer (render_public.php) and a PHP embed helper (embed_form.php).
• Responses inbox (responses.php) with filters, search, and pagination.
• Detail view (response_view.php) and PDF export, CSV export (response_pdf.php).
• Reply by email (response_reply.php) and admin notifications on new submissions.
• reCAPTCHA v2 auto-detection via a simple JSON file.
• File uploads with accept, multiple, max size, and max files limits.
• CSV export based on current filters (form, dates, search), generating a full dataset regardless of pagination.

🚀 Typical Workflow

1. Create a form in builder.php (drag blocks, set labels, names, required, responsive widths).
2. Click “Embed code” in the forms list (index.php) to get the public link and PHP embed snippet.
3. Publish by linking to the public page or including the PHP snippet in any of your pages.
4. Receive submissions; files are saved to /uploadform.
5. Get notified by email (admin notification) and review in responses.php.
6. Open details (response_view.php), export PDF, or reply by email.

🧱 Blocks & Properties (builder.php)

Available blocks: Text, Email, Number, Date, Textarea, Select, Radio, Checkbox, File, Title, and Divider. Each block supports:

• Label, Name (POST key), Placeholder, Required toggle.
• Responsive width via col / col-md / col-lg (Bootstrap grid).
• Select/Radio options (one per line).
• File: accept (e.g. .pdf,.jpg,image/*), multiple, max size (MB), max files.

🎯 Embed a Form in Your Website

Public page link:

https://yourdomain.com/forms/render_public.php?id=123

PHP embed helper (paste where the form should appear (to mobirise, create an HTML block and copy the generated code into your block)):

<?php
// 1) load the embed helper
require $_SERVER['DOCUMENT_ROOT'].'/forms/embed_form.php';

// 2) render your form where needed
echo fb_render_form(
  1, 
  [
    'include_bootstrap' => false, // false if you integrate it into a mobirise block and true if your page does not already include Bootstrap
    'show_title'        => false,
    'action'            => '/forms/submit_public.php',
    'return_url'        => $_SERVER['REQUEST_URI'] ?? ''
  ]
);

📎 File Uploads

File fields support multiple selection (optional), accept filters, max size (MB), and max files.
UX niceties include an “Add files” button (hidden for single-file fields) and a removable file list. Files are saved to /uploadform with sanitized names.

📥 Responses Inbox (responses.php)

Review submissions with search, date filters, form filter, and pagination. Attachments are listed with clickable badges; images show thumbnails in the detail view.

• Detail: open response_view.php for a clean, printable layout and a PDF export button.
• Reply: send an email from response_reply.php (From address = config.email_envoi).
• Delete: remove the submission if needed.

📧 Admin Email Notifications

On every successful submission, FormBuilder can send a notification to the admin email configured in config.email_envoi. The email includes a link to your admin login page (we build the base URL from config.site_url and append /login.php, so it works no matter which folder name you used).

• Subject: New form submission – [Form Name] #[ID]
• Body: highlights key fields and includes a “View response” link + “Admin login” link.

✅ Best Practices

• Use meaningful name keys; they become your POST keys and DB columns.
• Keep reCAPTCHA enabled for public forms receiving anonymous traffic.
• Set reasonable max size and max files for uploads; validate again server-side.
• Configure email_envoi and site_url in config for replies and notifications.
• Regularly export or back up responses if your site handles many submissions.