The Forms Builder allows administrators to create and manage custom forms for use across the website. These forms are fully configurable and can be used for general data collection or specific workflows such as user registration. The system supports two core registration types: one for Parents/Adults and one for Juniors. Both form types can be tailored to suit the requirements of your organisation.
Creating a New Form
To begin, navigate to the Forms Builder section within the dashboard and select "Create Form." Each form contains two primary sections: the General tab and the Fields tab. These tabs help define the behaviour, layout, and inputs of the form.
General Tab
Within the General tab, administrators are required to provide a name for the form. A URL-friendly slug will be generated automatically, which is used to reference the form on the frontend. This slug must be unique.
An optional description field allows for a short summary or explanation of the form’s purpose. This description can be displayed to users on the frontend, above the form itself.
You will also find two key checkboxes in this tab:
- The first is "Is Parent Registration Form". Enabling this will automatically include standard user fields such as email, name, and password. When this option is selected, form submissions are processed as new user registrations and are saved directly into the users table.
- The second is "Is Children Registration Form". When enabled, this option will register the individual as a junior user, typically linked to a parent account. It also includes the standard user fields and stores the submission in the users table.
If neither of these checkboxes is selected, the form functions as a general-purpose submission form, and the data is stored in a designated submissions table.
Fields Tab
The Fields tab is used to build the structure of your form. Administrators can add an unlimited number of fields and reorder them as needed. Each field includes a label, internal name, and a specified input type. Supported input types include text, textarea, email, number, password, select dropdowns, radio buttons, checkboxes, date pickers, and file uploads.
For fields that accept multiple options—such as select, radio, and checkbox inputs—you can define custom choices by specifying both a label and a corresponding value.
Each field supports optional attributes such as placeholder text, tooltips, and descriptive text. A required toggle is also available to enforce mandatory responses. For file uploads, administrators may restrict acceptable file types, such as allowing only images or PDFs.
This configuration process gives you complete control over the presentation and validation of the form, ensuring only the necessary data is captured.
Registration Form Behaviour
When a form is marked as a Parent or Children registration form, it will bypass the standard submission table and instead create a new user account. Email, password, and other core fields are handled automatically. Additional fields configured in the Fields tab may be stored in user metadata or a separate profile structure, depending on implementation.
It is important not to manually add email or password fields to these forms, as they are already handled internally by the system.
General Forms
Forms that are not marked for registration can be used for a variety of purposes, such as contact enquiries, event signups, surveys, or internal feedback. These submissions are stored in a designated table and can be viewed or exported from within the admin dashboard.
Best Practices
When building forms, keep labels clear and concise. Use placeholder text and tooltips to guide the user experience. Mark important fields as required to ensure data completeness. Where possible, group related fields logically for improved usability.
For file uploads, be sure to specify the types of files you are willing to accept. This not only improves the user experience but also enhances security and storage efficiency.
Summary
The Forms Builder provides a flexible and powerful way to create both general-purpose forms and user registration workflows. By leveraging the built-in features for field configuration, validation, and user registration, administrators can quickly deploy custom forms that meet the exact needs of their club or organisation.
If your form is intended for website registration, always ensure the correct registration type is selected. For all other forms, use the field builder to structure your data capture process effectively.