Magento 2 Ai Registration Field Suite

Pending Registration Workflow

Navigate to Stores > Configuration > Ewebecommerce > Pending Registration.

5.1 Overview

The Pending Registration feature requires admin approval before new customers can access their accounts. This is useful for B2B stores, wholesale accounts, or any scenario requiring manual verification.

5.2 Configuration

General Settings

SettingDescription **Extension Enabled**Enable or disable the pending registration workflow **Customer Groups to Validate**Select which customer groups require manual approval. Unselected groups are auto-approved on registration

Events (Email Templates)

SettingDescription **Admin notification email template sender**Email identity for admin notifications **Admin notification email template**Template sent to admin when a new registration needs approval **New customer notification email template sender**Email identity for customer notifications **New customer notification email template**Template sent to customer confirming their registration is pending **Approved customer notification email template sender**Email identity for approval notifications **Approved customer notification email template**Template sent to customer when approved **Declined customer notification email template sender**Email identity for decline notifications **Declined customer notification email template**Template sent to customer when declined

Set any template to Disable to skip that notification.

Existing Users

SettingDescription **Make all users status**Set all existing customers to Pending or Approved **Set Status**Button to apply the selected status to all existing customers

This is useful when enabling the module for the first time on a store with existing customers.

!Description

5.3 Customer Status States

StatusValueDescription **Pending**0New registration awaiting admin approval. Customer cannot log in. **Approved**1Admin approved. Customer can log in and shop normally. **Declined**2Admin declined. Customer cannot log in. **Not Confirmed by Email**5Waiting for email confirmation (when Magento email confirmation is enabled)

5.4 Registration Flow

• 1. Customer submits registration form on the frontend
• 2. If the customer's group requires approval:

- Status is set to Pending

- Admin notification email is sent (if configured)

- Customer notification email is sent (if configured)

- Customer sees a message that their account requires approval

• 3. If the customer's group does NOT require approval:

- Status is set to Approved automatically

- Customer can log in immediately

Approve / Decline Actions

From the Pending Registration page or any customer grid view:

• Approve: Sets status to Approved and sends the approval email
• Decline: Sets status to Declined and sends the decline email

Customer Grid and Status Management

 Status Column in Customer Grid

The module adds a Status column to the customer grid at Customers > All Customers. The column supports:

• Filtering by status (Pending, Approved, Declined)
• Sorting by status
• Inline editing - click to change status directly from the grid

!Description

 Inline Status Editing

• 1. Select a customer row in the grid
• 2. Click the Status dropdown
• 3. Choose the new status (Pending, Approved, or Declined)
• 4. Click Save

The status is updated immediately and the appropriate email notification is sent.

!Description

5.5 Login Restriction

When a customer with Pending or Declined status tries to log in:

• Login is blocked
• An appropriate message is displayed:

- Pending: "Your account requires moderation"

- Declined: "Your registration has been declined"

• Customer is redirected to the login page
  
  

 Email Notifications

6.1 Email Templates

The module registers four email templates:

Template IDPurpose `eweb_pendingreg_events_admin_template`Admin notification for new pending registration `eweb_pendingreg_events_user_template`Customer notification for pending registration `eweb_pendingreg_events_approved_template`Customer notification when approved `eweb_pendingreg_events_declined_template`Customer notification when declined

6.2 Customizing Templates

You can customize email templates in two ways:

• 1. Magento Email Templates: Go to Marketing > Email Templates, create a new template based on the module defaults, and select it in the Pending Registration configuration.
• 2. Template Files: Edit the HTML files in view/adminhtml/email/:

- admin_template.html

- user_template.html

- approved_template.html

- declined_template.html

6.3 When Emails are Sent

EventAdmin EmailCustomer Email New registration (group requires approval)Admin notification sentPending notification sent Admin approves customer-Approval notification sent Admin declines customer-Decline notification sent Status changed via inline grid edit-Appropriate notification sent Status changed via customer edit form-Appropriate notification sent

AI-Powered Form Generator

The AI Form Generator panel appears below the Registration Settings on the form edit page.

1 How to Use

• 1. Enter a description of the form you need in the prompt box

- Example: "Business registration form with company name, VAT number, billing address, and industry type dropdown"

• 2. Select Captcha Type: Google reCAPTCHA v2 (recommended) or Google reCAPTCHA v3
• 3. Select Section Style:

- Smart grouping (AI decides) - AI determines optimal section grouping

- Compact - fewer sections, combined fields

- Detailed - one section per topic

• 4. Click Generate Form

The AI generates a complete form structure with appropriate sections, fields, field types, validation rules, and options. The generated form loads directly into the drag-and-drop builder where you can further customize it.

Generating Forms Using AI

Ai Doctors Registration Form Generated

Front End Doctors From Page

Supported Form Types

The AI recognizes and optimizes for these form types:

• Business / B2B Registration
• Medical / Healthcare
• Education / Student
• Freelancer / Agency
• Real Estate
• NGO / Non-profit
• Financial / Insurance
• Retail / E-commerce
• General Registration
  

  Field Types, Default Fields, and Validation

2.1 25 Built-in Default Fields

The module ships with 25 ready-to-use default fields that map directly to Magento core customer and address attributes. These fields can be added to any form via the drag-and-drop builder with a single click.

Customer Profile Fields

#FieldDescription 1**Name Prefix**Customer name prefix (Mr., Mrs., Dr., etc.) 2**Middle Name/Initial**Customer middle name or initial 3**Name Suffix**Customer name suffix (Jr., Sr., III, etc.) 4**Date of Birth**Customer date of birth with date picker 5**Tax/VAT Number**Tax or VAT identification number 6**Gender**Customer gender selection 7**Group**Customer group assignment

Billing Address Fields

#FieldDescription 8**Billing Company**Billing company name 9**Billing Telephone**Billing phone number 10**Billing Street Address**Billing street address 11**Billing City**Billing city 12**Billing Country**Billing country with dropdown selector 13**Billing State/Province**Billing state/province with dynamic region dropdown 14**Billing Zip/Postal Code**Billing ZIP or postal code 15**Billing Fax**Billing fax number

Shipping Address Fields

#FieldDescription 16**Shipping Company**Shipping company name 17**Shipping Telephone**Shipping phone number 18**Shipping Street Address**Shipping street address 19**Shipping City**Shipping city 20**Shipping Country**Shipping country with dropdown selector 21**Shipping State/Province**Shipping state/province with dynamic region dropdown 22**Shipping Zip/Postal Code**Shipping ZIP or postal code 23**Shipping Fax**Shipping fax number

Additional Default Fields

#FieldDescription 24**Newsletter Subscription**Sign up for newsletter checkbox 25**Mp SMTP is synced**SMTP synchronization status field

2.2 12 Custom Field Types

In addition to the 25 default fields, you can create custom fields using any of these 12 field types:

TypeDescriptionOptions Support **Text**Single-line text inputNo **Password**Password input (hidden characters)No **Textarea**Multi-line text inputNo **Select**Dropdown selectYes **Multiselect**Multiple selection dropdownYes **Radio**Radio button groupYes **Checkbox**Multiple checkboxesYes **Listbox**Multi-option listYes **Date**Date picker inputNo **File**File upload with MIME validationNo **Static Text**Display-only text (not an input)No **Captcha**Security verification (5 captcha types available)No

2.3 Validation Rules

RuleDescription **validate-email**Email address format **validate-name**Name format **validate-digits**Numeric digits only **validate-money**Currency format **validate-phone-number**Phone number format **validate-date**Date format **validate-zip**ZIP / postal code format

Captcha and Security Verification

The module supports 5 captcha types to protect registration forms from spam and bot submissions.

1 Supported Captcha Types

#Captcha TypeDescription 1**Alikon mod**Image-based captcha with distorted text 2**Captcha Form**Form-based captcha with challenge question 3**SecurImage**Secure image captcha with audio accessibility support 4**Google reCAPTCHA v2**"I'm not a robot" checkbox (requires Google reCAPTCHA keys in module config) 5**Google reCAPTCHA v3**Invisible score-based verification (requires Google reCAPTCHA keys in module config)

3.1 Google reCAPTCHA Configuration

• 1. Navigate to Stores > Configuration > Ewebecommerce > Registration Field Suite > Google reCAPTCHA (Storefront)
• 2. Enter your Site Key and Secret Key for v2 and/or v3
• 3. Save Configuration

All keys are stored encrypted. Server-side verification is performed on form submission via Google's siteverify API.

3.2 Adding Captcha to a Form

• 1. In the form builder, add a section (e.g., "Security Verification")
• 2. Add a Captcha field type to a cell
• 3. Select one of the 5 captcha types from the dropdown
• 4. For Google reCAPTCHA v2/v3, ensure API keys are configured in module settings

3.3 How Google reCAPTCHA Works

• reCAPTCHA v2: Displays the "I'm not a robot" checkbox. User must interact with it before submitting.
• reCAPTCHA v3: Invisible to the user. Runs in the background and assigns a risk score. No user interaction required.

Registration is blocked if captcha verification fails.

Custom Form URLs and Display

4.1 Custom URL Keys

Each form can have a custom URL key. For example:

• Default: yourstore.com/customer/account/create
• B2B: yourstore.com/b2b-registrations
• Doctors: yourstore.com/doctors-registration

The module includes a custom router (FormRouter) that maps these URL keys to the registration controller with the appropriate form key.

4.2 Login Page Integration

When Show Button on Login Page is enabled for a form:

• A registration button appears in the "New Customers" section of the login page
• The button text is customizable (e.g., "Register B2B Account")
• Multiple forms can each show their own button on the login page

4.3 Header Link Integration

When Enable Top Link in Header is enabled:

• A registration link appears in the site header
• The link text is customizable
• Clicking the link navigates to that form's registration page