Fomu user manual
Everything you need to build forms, take payments by Mobile Money, card and PayPal, and manage the entries that come in.
Contents
1. Getting started
What you need
- WordPress 6.0 or newer and PHP 7.4 or newer.
- An SSL certificate (your site address starts with
https://). Payment providers require it. - For Mobile Money: an M-Pesa Paybill or Till number with Daraja (Lipa na M-Pesa Online) access from Safaricom.
Install Fomu
- Download the Fomu zip using the link in your order email or from your account on easyclickon.com.
- In WordPress, go to Plugins → Add New → Upload Plugin, choose the zip and click Install Now.
- Click Activate. A new Fomu menu appears in the dashboard.
- Go to Fomu → Licence, paste your licence key and click Activate. This turns on one-click updates. See Licence and updates.
The Fomu menu
| Screen | What it’s for |
|---|---|
| All forms | Every form, with its shortcode, entry count and conversion rate. Edit, preview, duplicate, export or delete from here. |
| Add new | Start a form from a template or from blank. |
| Entries | Everything people have submitted. A red bubble shows unread entries. |
| Reports | Charts and totals for each form. |
| Settings | Site-wide keys: payments, CAPTCHA, Mailchimp, HubSpot, saved drafts. |
| Import / export | Move forms between sites as a file. |
| Licence | Your licence key, plan and update status. |
| White-label & clients | Wakala plan only. See White-label and client mode. |
2. Your first form
- Go to Fomu → Add new.
- Pick a template: Blank, Contact, Project quote calculator, Event registration, Feedback survey or Job application. Templates are fully editable, so start with the closest one.
- Give the form a title at the top of the builder.
- Drag fields from the left-hand panel onto the canvas, or click a field to add it after the one you have selected. The panel groups fields into Common fields, User information, Advanced, Miscellaneous fields and Layout fields, and the search box finds any field by name. Drag fields on the canvas to reorder them.
- Click any field on the canvas to edit its label, options and settings in the right-hand panel.
- Click Save. The form is ready to add to a page (see Adding a form to a page).
The builder tabs
Shortcuts: Ctrl + S save, Ctrl + Z undo, Ctrl + Shift + Z or Ctrl + Y redo, Ctrl + D duplicate the selected field, Delete remove it, and the arrow keys move it up or down (Cmd instead of Ctrl on a Mac).
3. Fields
Fomu has 27 field types, plus 10 ready-made User information fields: 37 fields in all. The builder shows them in five groups.
| Group | Fields |
|---|---|
| Common fields | Single line, Paragraph, Number, Dropdown, Radio buttons, Checkboxes, Date, Time, File upload (drag and drop) |
| User information | Full name, First name, Last name, Email, Phone, Company, Job title, Street address, Town / city, Postcode, Country, Date of birth, Website |
| Advanced | Star rating, Slider, Switch, Image choice, Signature, Calculation |
| Miscellaneous fields | Consent, Declaration, Hidden, Text / HTML, Summary |
| Layout fields | Section, Heading, Divider, Page break |
Sections
A Section is a titled box that holds other fields, for example “CCTV experience” or “Next of kin”. Add it from Layout fields and it arrives with an End of section line. Drag fields between the section title and that line to put them inside; fields inside show a coloured edge on the canvas.
- Style: box with border, shaded with an accent line, or title and line only.
- Logic: conditional logic on a section shows or hides everything inside it. Hidden fields are skipped by validation and not saved.
- Deleting a section removes its End of section line too; the fields inside stay on the form.
Repeatable sections
Tick Let people add more (repeatable) on a section for things like previous jobs, referees or children. Visitors then see a button such as + Add a previous job that adds another copy of the section’s fields.
- Button text: what the button says.
- Most copies: the limit, including the first. The button disappears when it is reached. Each copy after the first has a Remove link.
- Every copy is checked like the first, and saved as its own numbered row (“Previous job 1”, “Previous job 2”) in the entry, emails, CSV export and print.
- File uploads, signatures, calculations and hidden fields aren’t repeated, so keep them outside repeatable sections.
Declaration
Use a Declaration (Miscellaneous fields) at the end of applications and agreements. It shows your wording in a box (long statements scroll), then an I confirm tick box.
- Declaration statement: your wording. HTML is allowed for paragraphs, lists and links.
- Tick box text: for example “I confirm that the information I have given is true and complete.”
- Ask them to type their full name to sign and Show and record today’s date: both on by default.
- The entry records, for example, “Agreed — signed by Ann Wanjiru — 5 November 2026”. The date is the day the form was sent, and a declaration can’t be changed when you edit an entry. For a drawn signature, add a Signature field after it.
Showing answers back: live answers and the Summary
Live answers. In a Heading or Text / HTML field, choose an answer from Insert an answer (or type its merge tag, for example {field:f_role}). Visitors see what they typed or chose as they fill in the form, for example “You’re applying for CCTV Operator“. Choices show their label, stars show “4 / 5”, and dates are written out.
Summary. Add Summary from Miscellaneous fields to list the visitor’s answers so they can check them before sending. For a review page, add a Page break called “Review” and put the Summary on that last step.
- Answers to show: tick the ones to list, or leave all unticked to show every answered field.
- Edit links: answers are grouped by step, each with an Edit link that jumps back to it.
- Repeatable sections are listed copy by copy. Unanswered fields and fields hidden by logic are left out.
Ready-made User information fields
Full name, First name, Last name, Company, Job title, Street address, Town / city, Postcode, Country and Date of birth arrive already set up: the label is filled in, First name and Last name (and Town / city and Postcode) sit side by side at half width, and Browser autofill is set so visitors’ browsers can fill them in from their saved details. Country is a dropdown listing every country, so people pick theirs instead of typing it. They are ordinary Single line, Dropdown or Date fields underneath, so you can change any setting, for example reordering the countries with Bulk edit to put the ones you use most at the top.
Field settings
- Label, Description and Placeholder: what people see. The description (help text) shows under the label and above the input, so people read it before they type. On Consent fields it sits under the tick box.
- Required: the form can’t be sent without it. Add a Custom error message if you like.
- Width: full, 2/3, 1/2, 1/3 or 1/4, so fields can sit side by side. On phones they stack.
- Allowed dates (Date fields): any date, today only (filled in with today’s date and locked, so it can’t be changed), today or later, future dates only (from tomorrow), today or earlier, past dates only, or a custom range in days from today.
- Default value and Fill from URL parameter: pre-fill a field, for example
?plan=studioin the link. - Browser autofill (Advanced tab, on Single line, Email, Phone, Website, Date and Dropdown fields): tells browsers what the field is for, such as First name, Postcode or Country, so they can fill it in. Leave it on Automatic for Email, Phone and Website.
- Min length / Max length, Input mask, Prefix / Suffix (for example
KESor%). - Options: for choice fields. Use Bulk edit to paste a list. Each option can carry a Calc value used in calculations, and one can be selected by default.
- File upload: Allowed types, Max size (MB) and Max files. Files are checked by their real type, and executable files are always blocked.
- Field ID: used in formulas and merge tags, for example
{field:f_email}. - CSS class: for your own styling.
4. Conditional logic
Show or hide a field, or a whole step, depending on earlier answers.
- Select the field (or the Page break that starts a step).
- Open Conditional logic in the right-hand panel and choose Show or Hide.
- Choose whether all or any of the rules must match.
- Add rules: pick a field, a comparison (is, is not, contains, greater than, less than, is empty, is not empty) and a value.
Fields with logic show a small logic icon on the canvas. Hidden fields are never required, and their answers aren’t saved.
Example: show “Company name” only when “I am enquiring as” is “A business”.
5. Calculations
A Calculation field shows a live total as people fill in the form, for quotes, bookings, scores and deposits.
Writing a formula
Refer to other fields by their Field ID in curly brackets. Choice fields use the Calc value of the selected option, and checkboxes add up every ticked option.
{f_package} + {f_extras} * {f_quantity}
round( {f_total} * 0.3, 0 )
if( {f_rush} == 1, {f_total} * 1.2, {f_total} )
| You can use | |
|---|---|
| Operators | + - * / % ^ and brackets |
| Comparisons | == != > < >= <= |
| Functions | min max round floor ceil abs sqrt if(condition, then, else) |
The builder tells you whether the formula looks good, and points out unknown fields. Set Decimal places, a Prefix such as £ or KES, or hide the field to calculate silently.
Totals are worked out again on the server when the form is sent, so nobody can change a price in their browser.
6. Multi-step forms
- Drag a Page break where each new step should begin.
- Give each Page break a step title. Name the first step under Settings → Multi-step → First step title.
- Choose a Progress style: numbered steps or a percentage bar. Change the Back / Next text if you like.
Each step is checked before people can move on. Add conditional logic to a Page break to skip a whole step.
7. Form settings
After submission
Show a Confirmation message (merge tags allowed) or send people to a Redirect URL. Change the Submit button text here too.
Restrictions
- Entry limit: close the form after a number of entries, for example for event places.
- Only logged-in users can submit, with a Login message for visitors.
- Switch the form off with the Accepting submissions toggle, and set a Closed message.
Schedule
Set Opens and Closes dates and times. Before opening, people see the Not open yet message (use {open_date} to show the date).
Save and continue later
Adds a link so people can finish later. They get a private resume link by email, and you get a notification with their answers so far, so you can follow up. Both emails are editable. You can allow this for logged-in users only (their draft reopens automatically) and set how many days drafts are kept under Fomu → Settings → General.
Spam protection
Every form has a hidden honeypot and a Minimum fill time. For more protection, add Cloudflare Turnstile (recommended), reCAPTCHA v2 or reCAPTCHA v3 keys under Fomu → Settings → CAPTCHA, then switch on CAPTCHA in the form.
8. Emails and merge tags
Admin notification
Sent to you for every entry. Set Send to (several addresses separated by commas), Subject and Message, a Reply-to (usually the person’s email field) and whether to attach uploaded files.
Confirmation to the person
An automatic reply. Pick Their email field, then write the subject and message. Under Sender, set the From name.
Merge tags
Click Copy merge tag next to a field, or type one of these:
| Tag | Becomes |
|---|---|
{all_fields} | A table of every answer |
{field:f_email} | One answer, by Field ID |
{form_title} {entry_id} {date} | Form name, entry number, date sent |
{site_name} {site_url} {page_url} | Your site, and the page the form was on |
{payment_amount} {payment_status} {payment_method} {payment_ref} | Payment details, including the M-Pesa receipt number |
{user_name} {user_email} | The logged-in user, when there is one |
Emails not arriving? WordPress sends mail through your host, which is often filtered as spam. Install an SMTP plugin (for example WP Mail SMTP) and connect it to your email provider.
9. Payments
Connect each payment method once under Fomu → Settings → Payments, then switch payments on per form.
Mobile Money (M-Pesa)
Fomu uses Lipa na M-Pesa Online (STK push): the customer gets a PIN prompt on their phone, and the money goes straight into your Paybill or Till.
- Create an app on the Safaricom Daraja portal and request Lipa na M-Pesa Online for your shortcode.
- In Fomu → Settings → Payments → M-Pesa, choose the Environment: Sandbox (testing) first, then Production.
- Choose the Account type: Paybill, or Buy Goods (till number). For a till, also enter the Till number.
- Enter the Business short code, Lipa na M-Pesa passkey, Consumer key and Consumer secret from Daraja. For Paybill, set an Account reference.
- The Callback URL is shown on the same screen. If Daraja asks for it, copy it from there.
- Click Save settings.
M-Pesa only takes Kenyan shillings, so set the form’s currency to KES. The customer’s phone number comes from a Phone field on the form, and Fomu accepts 07…, 01…, +254… or 254… formats.
Card payments (Stripe)
- In your Stripe dashboard, copy your Secret key.
- Add a webhook pointing to the address shown in Fomu’s Stripe settings, and copy its Webhook signing secret.
- Paste both into Fomu → Settings → Payments → Stripe. Cards, Apple Pay and Google Pay all work through Stripe Checkout.
PayPal
Create a REST app in the PayPal developer dashboard and paste its Client ID and Secret into Fomu → Settings → Payments → PayPal. Use Sandbox mode to test, then Live.
Taking a payment in a form
- Open the form’s Payments tab and switch on Take a payment.
- Choose where the Amount comes from: a fixed Price, a Calculation field, a Number field or a choice field.
- Set the Currency (the site default comes from Settings).
- Tick the Payment methods to offer. Methods that aren’t set up in Settings are marked “Not set up”.
- Under After payment, choose whether emails and integrations wait until the payment is confirmed (recommended).
Payments are confirmed directly between the provider and your site, and the amount is checked against the form. If a payment is cancelled or fails, the person’s answers are kept and they can try again. In Entries, use the Paid and Awaiting payment views, or mark an entry as paid by hand.
10. Integrations
Mailchimp
Add your Mailchimp API key under Fomu → Settings → Integrations. In the form’s Integrations tab, click Load audiences, choose an Audience, match the email, first name and last name fields, and add Tags. Use Only if ticked with a Consent field so only people who agree are added.
HubSpot
Add a HubSpot private app token in Settings, then match the Email, First name, Last name, Phone and Company fields. Contacts are created or updated by email.
Webhook (Zapier, Make, n8n and others)
Switch on Webhook and paste the Endpoint URL. Every entry is sent as JSON, which you can pass to Google Sheets, Slack, a CRM or your own system.
11. Styling
- Colours: accent, text, background, field and border colours, with ready-made Presets.
- Shape & type: Corner radius, Font size, Max width, Labels (top, left or hidden), Input style (outline, filled or underline) and button alignment.
- Custom CSS: your CSS applies to this form only.
On the Msingi theme, forms still using Fomu’s default colours automatically pick up your brand colours. Change a form’s colours on its Style tab to override that.
12. Adding a form to a page
Copy the code from the form’s Embed tab or from Fomu → All forms.
| Where | How |
|---|---|
| Block editor | Add the Fomu block and choose the form. You see a live preview. |
| Elementor | Add a Shortcode widget and paste [eco_fomu id="1"]. |
| Anywhere else | Paste the shortcode: [eco_fomu id="1"]. Add title="yes" to show the form title. |
| Popup | [eco_fomu id="1" popup="yes" button="Get a quote"] shows a button that opens the form. |
13. Entries
Fomu → Entries lists every submission. Choose a form at the top to see its own columns.
- Views: All, Unread, Starred, Paid and Awaiting payment. Search finds any answer.
- Open an entry to see every answer, uploads, the signature, payment details and where it was sent from.
- Edit answers and payment status. Totals are recalculated and every change is logged.
- Bulk actions: mark as read or unread, star, delete, or Print / Save as PDF.
- Export CSV: opens cleanly in Excel and Google Sheets.
Print or save as PDF
Print one entry from its screen, tick several and use the bulk action, or use Save all as PDF for a whole form. In the print window, choose Save as PDF as the printer. Steps become section headings, and signatures and images are included.
A single entry’s PDF is named after the person who filled it in, for example DJ Dubwise booking & quote – Ann Wanjiru. Fomu takes the name from a Full name field, First name and Last name, or a field labelled Name. Forms without one use the entry number instead, for example “Entry 2”. Several entries are saved as, for example, “… – 5 entries”.
14. Reports
Fomu → Reports shows, for each form, entries per day or month, a chart for every question, averages for ratings and numbers, and a payment breakdown. All forms shows each form’s views and conversion rate.
15. Licence and updates
Fomu works fully on every plan, with or without an active licence. An active licence adds one-click updates and support.
| Plan | Websites | Extras |
|---|---|---|
| Starter | 1 | – |
| Studio | 5 | – |
| Wakala | Unlimited | White-label and client mode |
Activate
Your key is in your order email and under My Account → Licences on easyclickon.com. It looks like ECO-XXXX-XXXX-XXXX-XXXX. Paste it into Fomu → Licence and click Activate.
Move to another site
On the old site, open Fomu → Licence and click Deactivate on this site. That frees the slot for the new site.
Renew
Licences cover 12 months of updates and support, with no automatic renewal. Click Renew next to your licence in My Account → Licences. Your existing key gets another 12 months, and renewing early keeps the time you have left. To change plan, buy the new plan, deactivate the old key and activate the new one.
16. White-label and client mode
These come with the Wakala plan, under Fomu → White-label & clients.
White-label
Switch on white-label mode to replace “Fomu” across the dashboard with your own Plugin name, Author / agency, Author website, Logo, Footer text and Plugins screen description. Tick Hide these settings so only you can see the Licence and White-label screens.
Client mode
Switch on client mode to give clients their own login that shows entries and nothing else. Add a user under Users → Add New with the Form client role. Clients can view, star and print entries, and you choose whether they can also export to CSV and see Reports. They can’t edit forms or settings.
17. Troubleshooting
The M-Pesa PIN prompt doesn’t arrive
Check the phone number is a Safaricom line and the Environment matches your keys (sandbox keys only work in Sandbox). Make sure your site uses https and isn’t in maintenance mode, because Safaricom has to reach the Callback URL. If the callback is delayed, Fomu checks the payment status itself shortly afterwards.
Entries show “Awaiting payment” after paying
The provider couldn’t reach your site to confirm. For Stripe, check the webhook address and signing secret. For M-Pesa, check the Callback URL is reachable. You can mark an entry as paid from its screen once you’ve checked the payment with your provider.
The total looks wrong
Check each choice option has a Calc value, the formula uses the right Field IDs, and the builder says “Formula looks good”. Hidden fields count as empty.
The form doesn’t show on the page
Check the shortcode’s id matches the form on All forms, the form is accepting submissions, and its schedule has opened. If you use a caching plugin, clear its cache.
“No updates available” but a new version is out
Open Fomu → Licence and click Check licence & updates. An expired licence stops updates until you renew.
Still stuck? Contact ECO Design Studio with your site address and what you were doing when it went wrong.
18. For developers
Filters
ecof_field_types, ecof_render_field_{type}, ecof_validate_field, ecof_validation_errors, ecof_is_spam, ecof_entry_data, ecof_submission_response, ecof_webhook_payload
Actions
add_action( 'ecof_after_submission', function ( $entry_id, $data, $form ) {
// Runs after every entry is saved.
}, 10, 3 );
add_action( 'ecof_payment_completed', function ( $entry_id ) {
// Runs when a payment is confirmed.
} );
JavaScript
document.addEventListener( 'ecof:submitted', function ( e ) {
// e.target is the form wrapper, e.g. send a Google Analytics event.
} );
