Easy Ajax Contact 2.1 is a contact-form package for Joomla 4, 5, and 6 with AJAX submission, secure CAPTCHA options, submission storage, CSV export, auto-replies, webhooks, and a system shortcode for embedding forms in articles.

Version 2.1 builds on the 2.0 rebuild: native JavaScript, no jQuery, Web Asset Manager assets, and a flexible field builder with 25 field and content types.

Highlights

• Module field builder with presets
• Built-in CAPTCHA or Cloudflare Turnstile
• Administrator submissions inbox and CSV export
• Auto-reply tokens and post-submit redirects
• Signed JSON webhooks
• {easycontact id="123"} shortcode embeds

Requirements

• Joomla 4, 5, or 6
• PHP 8.1 or later recommended
• Working site mail for notifications and auto-replies

Install

1. Download pkg_easy_contact_2.1.0.zip.
2. Open System > Install > Extensions.
3. Upload and install the package.
4. Confirm System - Easy Contact Shortcode is enabled.
5. Open Content > Site Modules, create an Easy Ajax Contact module, configure it, assign it, and publish.
6. Clear Joomla and browser cache.

The package installs the module, the Easy Contact component, and the shortcode plugin together.

Use the module Form Fields subform to add, remove, and reorder fields. Each field supports type, label, required state, width, help text, default value, autocomplete, and upload controls where relevant.

Supported field types (25)

• Text: single-line text, textarea, email, phone, URL, search, password
• Values: number, range slider, date, time, date & time, month, week, colour picker
• Choices: checkbox group, radio group, dropdown, multi-select, consent checkbox
• Extra: file upload, hidden value, section heading, paragraph / instructions, divider

Presets

Import one of the ten built-in presets such as Simple Contact, Business Enquiry, Quote Request, Support Ticket, Job Application, Event Registration, Booking Request, Customer Feedback, Newsletter Signup, or Callback Request.

• Recipient: the address that receives form notifications.
• Subject and introduction text for the admin email.
• Auto-reply: optional confirmation email to the submitter.
• Tokens: use {all_fields}, {form_title}, and field labels such as {name} or {email}.
• Redirect URL: optional absolute HTTPS URL or site-relative path after a successful submission.

• CSRF token on every form
• Honeypot and minimum submit timing
• Per-module rate limiting
• Built-in session-bound single-use CAPTCHA
• Optional Cloudflare Turnstile
• Server-side required, email, URL, and upload validation
• Temporary upload cleanup after mail processing

Turnstile needs a site key and secret key in the module Security settings.

When Store Submissions is enabled, validated submissions are saved to the Easy Contact administrator component even if outbound mail fails.

• List, filter, open, mark read/unread, and delete submissions
• CSV export for spreadsheets and CRM imports
• Optional retention pruning in days
• No IP address or user-agent storage
• Uploaded files are not kept permanently; only file names are recorded

Open Components > Easy Contact in the administrator.

Enable Send Webhook in the module Webhook tab and provide an HTTPS endpoint. Each successful submission posts JSON with event, form title, module ID, submission ID, submitter, mail status, fields, files, site URL, and created timestamp.

Optional Webhook Secret adds an X-EasyContact-Signature header with an HMAC SHA-256 hash of the body. Webhook failures are fail-soft: the visitor still receives a success response, and the failure is logged against the stored submission when storage is enabled.

The system plugin embeds a published Easy Ajax Contact module by ID:

{easycontact id="213"}

{easycontact id="213" style="none"}

Use it in articles, Custom HTML modules, and other rendered site HTML. The plugin only renders published mod_easy_contact modules the visitor can access. Documentation examples inside <pre>, <code>, or form controls are left unchanged.

• Layout Style: Plain, Card, or Soft Panel
• Accent Colour and button text colour
• Button Width: auto, fixed pixels, or 100%
• Maximum Form Width
• Additional CSS for template-specific tweaks

Frontend markup uses accessible labels, live status messaging, visible focus, large touch targets, and reduced-motion support.

• Form does not submit

  • Check recipient email, CAPTCHA settings, CSRF session, and browser console errors. Confirm the AJAX URL is reachable.

• Shortcode still shows as text

  • Confirm System - Easy Contact Shortcode is enabled and the module ID is published. Clear cache.

• No inbox rows

  • Enable Store Submissions on the module and confirm Components > Easy Contact is installed.

• Webhook not arriving

  • Verify the URL, HTTPS endpoint, and signature secret. Check the submission error column and Joomla logs.

• Old assets remain

  • Clear Joomla and browser cache. Confirm assets load as easy-contact.css?2.1.0 and easy-contact.js?2.1.0.

• Does it require jQuery?

  • No. Version 2.1 uses native JavaScript.

• Can several forms appear on one page?

  • Yes. Each module instance has its own ID and settings. The same module ID should only appear once per page when embedded by shortcode.

• Where can I get help?

  • Visit support.joomlax.com. Include Joomla and PHP versions, page URL, module settings, and any console or log errors.