Advanced Contact Form for Magento 2

What you get

Panth Advanced Contact Us — Magento 2 AJAX Contact Form with Custom Fields, Anti-Spam & Submission Grid

Replace Magento 2's default contact form with a conversion-optimized AJAX contact page. Vanilla JS (zero jQuery dependency) for native Luma speed, unlimited custom fields, 3-layer anti-spam (honeypot + time-based trap + IP rate limiting), full admin submission grid with status tracking, and transactional email notifications for both admin and customer.

Panth Advanced Contact Us transforms Magento 2's stock contact page into a feature-rich, modern, conversion-ready contact experience. Customers get an AJAX-submitted form (no page reloads) with real-time validation, a clean contact-info sidebar, and auto-prefill for logged-in users. Admins get a proper submission grid with New/Read/Replied status tracking instead of lost emails, plus three independent spam defences that stop bots without CAPTCHAs frustrating real customers.

Built on pure vanilla JavaScript for native Luma themes, fully MEQP compliant, and tested across Magento 2.4.4 — 2.4.8 with PHP 8.1 — 8.4.

Key Features

Modern Storefront Form

• Vanilla JavaScript AJAX submission — zero jQuery, zero page reload, native Luma speed
• Real-time client-side validation — required fields, email format, phone format
• Logged-in customer pre-fill — auto-populates name and email for authenticated users
• Contact info sidebar — display email, phone, address, and business hours alongside the form
• Configurable page title & success message — match your brand voice
• Toggleable phone & subject fields — with independent "required" flags

Unlimited Custom Fields

• 7 field types — text, textarea, select, radio, checkbox, email, tel
• Per-field configuration — label, placeholder, required status
• Options support — comma-separated choices for select / radio / checkbox fields
• JSON storage — custom field values stored as JSON in the submission record
• Admin view rendering — custom fields displayed cleanly in submission detail view and email notifications

3-Layer Anti-Spam

• Honeypot field — hidden input invisible to users but filled by bots
• Time-based trap — minimum fill-time threshold (default 2 seconds) rejects instant bot submissions
• IP rate limiting — configurable max submissions per IP per hour (default 5)
• No CAPTCHA friction — real customers never see a challenge, bots get silently rejected

Admin Submission Grid

• Dedicated submission grid — view all contact submissions under Panth Extensions → Contact Submissions
• Full filtering & sorting — by name, email, subject, status, and date
• 3-state status tracking — New (orange), Read (blue), Replied (green)
• Auto-mark-as-read — submissions flip to "Read" status when opened in admin
• Bulk actions — mass delete, mass status change
• Custom field display — view all custom field values in the submission detail page

Email Notifications

• Admin notification email — sent to configurable recipient on every submission
• Customer confirmation email — optional auto-reply to the customer
• Sender identity selection — general, sales, support, or custom sender
• Customizable templates — both admin and customer email templates editable via Marketing → Email Templates
• Reply-To set to customer — one-click reply from your mailbox

Quality & Security

• MEQP compliant — passes Adobe's Magento Extension Quality Program
• CSRF-protected — Magento form key validation on every submission
• XSS-safe output — all stored values escaped on render
• SQL-injection-safe — uses Magento's standard repository + collection pattern
• Luma theme optimized — works on stock Luma and any Luma child theme

Custom Fields

Add unlimited custom fields to capture exactly the data you need — subject dropdowns, inquiry-type radios, consent checkboxes, reference numbers, and more.

To add a custom field:

1. Go to Stores → Configuration → Panth Extensions → Advanced Contact Us → Form Fields → Custom Fields
2. Click Add to create a new row
3. Choose a Field Type — text, textarea, select, radio, checkbox, email, or tel
4. Set Label (e.g. Inquiry Type)
5. Set Placeholder (optional) for text-style fields
6. Toggle Required if the field must be filled
7. For select / radio / checkbox, enter Options as comma-separated values (e.g. Sales, Support, Billing, Partnership)
8. Click Save Config and run bin/magento cache:flush

Submissions store all custom-field values as JSON in the panth_contact_submission table. The admin submission detail view renders each field with its label and value, and the admin notification email includes them in the message body.

Admin Submission Grid

Navigate to Panth Extensions → Contact Submissions in the admin sidebar.

Grid Columns

• ID — submission identifier
• Name — customer name
• Email — customer email (mailto link)
• Phone — customer phone (if supplied)
• Subject — subject line (if supplied)
• Status — colour-coded New / Read / Replied badge
• Submitted At — timestamp
• Action — view / delete

Status Lifecycle

Bulk Actions

• Delete — mass-delete selected submissions
• Change Status — mass-update status for follow-up workflow

Filter by any column, export to CSV / XML, and search across name, email, and subject.

Anti-Spam Protection

Panth Advanced Contact Us uses a silent, layered defence strategy — no CAPTCHA friction for real customers, but three independent bot-detection mechanisms:

Layer 1: Honeypot Field

A hidden input field (display:none via CSS) is added to the form. Real users never see it or fill it. Automated bots parse the HTML and fill every input — any non-empty honeypot value causes the submission to be rejected silently (the bot sees a "success" response but no record is created).

Layer 2: Time-Based Trap

When the form loads, a hidden timestamp is set. On submission, the server calculates elapsed time. If the form was submitted faster than the configured threshold (default 2 seconds), the submission is rejected — no human can read a form, type a name, email, and message in under 2 seconds.

Layer 3: IP Rate Limiting

The module tracks submission counts per IP address per rolling hour window. If an IP exceeds the configured threshold (default 5 / hour), further submissions return a friendly "too many requests" message. This stops distributed spam from a single source without locking out legitimate users.

All three layers can be independently enabled / disabled and tuned in configuration.

Email Notifications

Admin Notification

Sent to the configured Recipient Email on every successful submission. Contains:

• Submitter name, email, phone, subject
• Full message body
• All custom field values with labels
• Submission timestamp and ID
• Direct admin link to view the submission

The Reply-To header is set to the customer's email address, so clicking reply in your mailbox goes straight to the customer — no copy-paste needed.

Customer Confirmation (Optional)

When Send Customer Confirmation is enabled, the customer receives an auto-reply immediately after submission. Useful for:

• Confirming their message was received
• Setting expectations (e.g. "We reply within 24 business hours")
• Providing support phone / chat alternatives

Both templates are editable at Marketing → Email Templates — load the default, customize the HTML and text versions, and assign in the module's Email Settings.

Troubleshooting

For persistent issues, enable debug mode in Panth Extensions → Core Settings and check var/log/panth_advanced_contact_us.log.

Compatibility

Tested on:

• Magento 2.4.8-p4 with PHP 8.4
• Magento 2.4.7 with PHP 8.3
• Magento 2.4.6 with PHP 8.2
• Magento 2.4.4 with PHP 8.1

Installation

Composer Installation (Recommended)

composer require mage2kishan/module-advanced-contact-us
bin/magento module:enable Panth_Core Panth_AdvancedContactUs
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Panth_Core is pulled in automatically as a dependency.

Manual Installation via ZIP

1. Download the latest release from Packagist or the Adobe Commerce Marketplace
2. Extract to app/code/Panth/AdvancedContactUs/
3. Run the commands above starting from bin/magento module:enable

Verify Installation

bin/magento module:status Panth_AdvancedContactUs
# Expected: Module is enabled

Then visit the frontend /contact URL — you should see the new form. In admin, the new menu entry lives at Panth Extensions → Contact Submissions.

Configuration

All settings live at Stores → Configuration → Panth Extensions → Advanced Contact Us.

General

Contact Info Sidebar

Form Fields

Email Settings

Anti-Spam

License

Panth Advanced Contact Us is distributed under a proprietary license — see LICENSE.txt. Single-store use per installation; contact us for multi-store enterprise licensing.