Get Started

Easy Ajax Contact is a powerful and flexible Joomla module that allows you to create professional contact forms with AJAX functionality, extensive field types, form presets, file uploads, and complete style control. Perfect for contact pages, lead generation, support forms, and any scenario requiring user input.

Key Highlights:

• Full Joomla 4, 5 & 6 Compatibility
• 23 Pre-Built Form Presets
• 20+ Field Types
• File Upload with Secure Storage
• Complete Style Control
• Two-Column Layout Support
• Professional HTML Email Templates
• Built-in CAPTCHA Protection
• Multiple Instance Support
• Fully Responsive Design

Downloading the Extension

Email: After you purchase the extension from our store, you will receive an email containing a link to download the extension.

Store: Alternatively, you can download the extension from the "Downloads" section in our store. If you are a new user, you need to create an account using the same email address you used for the purchase.

Click to download the extension package from your account.

System Requirements

• Joomla Version: 4.x, 5.x, or 6.x
• PHP Version: 8.0 or higher

Installing the Extension

To install the extension, log in to the backend of your Joomla website.

• For Joomla 4/5/6: Go to System > Install > Extensions. You can either drag and drop or browse for the file to install.

A success message will be displayed once the installation is complete. The module will appear in Content > Site Modules.

Enabling the Module

After installation, navigate to Extensions > Modules, search for "Easy Ajax Contact", and click on it to enable and configure the module.

Access the module settings by navigating to Extensions > Modules, and find Easy Ajax Contact in the list.

General Settings

• Form Heading: Enter a heading for your contact form (optional). This appears above the form fields.
• Form Width: Set the maximum width of the form container (e.g., 400px, 100%, 90%). Default: 400px

Email Settings

• Recipient Email: Enter the email address where form submissions will be sent. Default: xyz@yourmail.com
• Email Subject: Enter the subject line for form submission emails. Default: New email from Easy Ajax Contact Form
• Email Body: Enter introductory text that appears at the top of the email. This text appears before the form data table.

Form Presets

• Form Presets: Select from 23 pre-built form templates including Contact Forms, Job Applications, Event Registrations, Support Tickets, Quote Requests, and more.
• Apply Preset: Click "Apply Preset" to populate your form with all fields from the selected template. You can then customize the fields as needed.
• Reset & Apply: Clears all existing fields and applies the selected preset.
• Remove All: Removes all form fields to start fresh.

Adding Form Fields

• Add Fields: Click the "Add" button to add new form fields. You can add unlimited fields to your form.
• Field Types: Choose from 20+ field types including text, textarea, email, phone, URL, number, date, time, datetime-local, range, color, password, search, file, hidden, checkbox, radio, dropdown, and multiselect.
• Field Configuration: Configure each field with label, type, placeholder, validation, validation message, and type-specific options (min, max, step, file types, etc.).

Customize the visual appearance of your contact form with comprehensive styling options.

Layout Options

• Form Layout: Choose between single-column or two-column layouts. Two-column layout displays fields side-by-side on larger screens.
• Two Column Breakpoint: Set the screen width breakpoint where two-column layout switches to single-column (e.g., 768px). Default: 768px

Form Styling

• Form Background Color: Set the background color of the form container. Default: #ffffff
• Form Padding: Set padding around the form (e.g., 20px). Default: 0
• Form Border Radius: Set border radius for rounded corners (e.g., 5px). Default: 0
• Form Spacing: Set spacing between form groups/fields (e.g., 10px). Default: 10px

Label Styling

• Label Color: Set the text color for form labels. Default: #333333
• Label Font Size: Set font size for labels (e.g., 14px, 1em). Leave empty for default.
• Label Font Weight: Set font weight (normal, bold, or numeric 100-900). Default: bold

Field Styling

• Field Background Color: Set background color for input fields. Default: #ffffff
• Field Border Color: Set border color for input fields. Default: #BEBEBE
• Field Border Radius: Set border radius for input fields (e.g., 0.25rem). Default: 0.25rem
• Field Padding: Set padding inside input fields (e.g., 7px). Default: 7px
• Field Focus Color: Set border color when fields are focused. Default: #88D5E9

Button Styling

• Button Color: Set background color for submit button. Default: #0078E7
• Button Text Color: Set text color for submit button. Default: #ffffff
• Button Width: Set width of submit button (e.g., 100%, 200px). Default: 100%
• Submit Button Icon: Choose to display a FontAwesome icon on the submit button. Options: No Icon, Default Icon (Paper Plane), or Custom Icon.
• Custom Icon Class: Enter FontAwesome icon class for custom icon (e.g., fa-check, fa-send). Requires "Custom Icon" option above.

Available Field Types

The module supports 20+ field types, each with specific configuration options:

• Text: Single-line text input with placeholder support
• Textarea: Multi-line text input for longer content
• Email: Email input with HTML5 email validation
• Phone: Phone number input with tel type
• URL: Website URL input with URL validation
• Number: Numeric input with min, max, and step options
• Date: Date picker with min/max date support
• Time: Time picker input
• Date & Time: Combined date and time picker
• Range Slider: Slider input with min, max, step, and live value display
• Color Picker: Color selection input
• Password: Password input with hidden characters
• Search: Search input field
• File Upload: File upload with type restrictions and size limits
• Hidden: Hidden field for storing values
• Checkbox: Multiple checkbox options
• Radio: Single selection from multiple options
• Dropdown: Single selection dropdown menu
• Multiselect: Multiple selection dropdown

Field Configuration

• Label: Field label displayed to users
• Field Type: Select the field type from dropdown
• Placeholder: Placeholder text shown in empty fields (for applicable types)
• Options: For checkbox, radio, dropdown, and multiselect fields, enter options in format: value=label=selected (comma-separated)
• Min/Max Values: For number, date, time, datetime-local, and range fields
• Step: Increment value for number and range fields
• Accept File Types: For file fields, specify allowed file extensions (e.g., .pdf,.doc,.jpg)
• Validation: Mark field as required
• Validation Message: Custom error message for required fields

File Upload Configuration

• File Field Type: Select "File Upload" as the field type
• Accept File Types: Specify allowed file extensions (e.g., .pdf,.doc,.docx,.jpg,.png). Separate multiple types with commas.
• Validation: Mark file upload as required if needed
• Validation Message: Custom error message if file is required but not uploaded

File Upload Features

• Secure Storage: Files are uploaded to /media/mod_easy_contact/uploads/ directory with proper security (.htaccess protection)
• Unique Filenames: Each uploaded file receives a unique filename to prevent conflicts (format: file_{uniqid}_{timestamp}.{extension})
• File Size Limit: Maximum file size is 10MB per file (configurable)
• Type Validation: Only files matching the specified file types are accepted
• Download Links: Uploaded files are included in email notifications with secure download links
• Secure Access: File downloads are handled via com_ajax for secure access control

Email Integration

• Uploaded files appear in email notifications as clickable download links
• File links include original filename and file size
• Download URLs are secure and validated before allowing access
• Files remain accessible via email links until manually removed

Customize all text labels and messages displayed in the form.

Button & Messages

• Submit Button: Text displayed on the submit button. Default: Submit
• Success Message: Message displayed after successful form submission. Default: Email sent successfully
• Failure Message: Message displayed if email sending fails. Default: Failed to send email

CAPTCHA Settings

• Captcha Message: Message displayed when CAPTCHA is required. Default: Captcha is required
• Captcha Label: Label text for the CAPTCHA field. Default: CAPTCHA Label
• Wrong Captcha Text: Message displayed when incorrect CAPTCHA is entered. Default: The captcha you have entered is wrong.
• Captcha Change Text: Tooltip text for CAPTCHA reload button. Default: Not readable? Change text.

Multilingual Support

• All text fields support multilingual content
• Use Joomla's language overrides for translations
• Form labels and messages can be customized per language

Advanced Configuration

• Additional CSS: Add custom CSS rules to further customize the form appearance. These styles will be applied in addition to the default module styles. Useful for advanced styling and theme integration.

Module Assignment

• Module Position: Choose a position where you want the module to appear (e.g., position-7, contact, content-top)
• Menu Assignment: Ensure the module is assigned to the desired menu items under the Menu Assignment tab
• Module Status: Set the status to Published to make the module visible on the frontend
• Access Level: Set the access level to control who can see the module (Public, Registered, Special, etc.)

Multiple Instances

• You can create multiple instances of the module on the same page
• Each instance operates independently with its own configuration
• Perfect for pages requiring multiple contact forms or different form types
• Each instance has unique IDs and namespaces to prevent conflicts

Key Features

• 23 Form Presets: Choose from professionally designed form templates including Contact Forms, Job Applications, Event Registrations, Support Tickets, Quote Requests, and more
• 20+ Field Types: Support for text, textarea, email, phone, URL, number, date, time, datetime-local, range, color, password, search, file, hidden, checkbox, radio, dropdown, and multiselect
• File Upload Support: Secure file uploads with type validation, size limits, and download links in emails
• Complete Style Control: Customize form background, padding, border radius, spacing, label styling, field styling, and button appearance
• Two-Column Layout: Choose between single-column or two-column layouts with customizable breakpoints
• Professional HTML Emails: Beautiful HTML email templates with structured data display and file download links
• AJAX Form Submission: Forms submit without page reload for smooth user experience
• Built-in CAPTCHA: Image-based CAPTCHA protection with easy reload functionality
• Multiple Instance Support: Create unlimited form instances on the same page
• Client-Side Validation: Real-time validation using jQuery Validate with custom error messages
• Fully Responsive Design: Forms adapt beautifully to smartphones, tablets, and desktop screens
• FontAwesome Icons: Customizable submit button icons with FontAwesome integration
• Joomla 4, 5 & 6 Compatible: Full support for all modern Joomla versions
• Modern WebAssetManager: Uses Joomla's native asset management for optimal performance
• Cross-Browser Compatible: Works perfectly across all modern browsers
• Enhanced Security: Built with security best practices including input sanitization, XSS prevention, and secure file handling

• How do I add fields to my form?

  • Click the "Add" button in the Form Settings fieldset to add new fields. Configure each field with label, type, validation, and type-specific options.

• Can I use form presets?

  • Yes, select a preset from the dropdown and click "Apply Preset" to instantly populate your form with all fields. You can then customize the fields as needed.

• How do file uploads work?

  • Files are uploaded securely to the server with unique filenames. Download links are included in email notifications. Files are stored in /media/mod_easy_contact/uploads/ directory.

• Can I have multiple forms on the same page?

  • Yes, you can create multiple module instances and assign them to the same page. Each instance operates independently with its own configuration.

• How do I customize the form appearance?

  • Use the Styling Settings to customize colors, spacing, fonts, and layout. You can also add custom CSS in the Advanced Settings for complete control.

• Can I use a two-column layout?

  • Yes, select "Two Columns" in Form Layout and set a breakpoint. Fields will display side-by-side on larger screens and stack on mobile devices.

• How do I configure file upload fields?

  • Select "File Upload" as field type, specify allowed file types in "Accept File Types" (e.g., .pdf,.doc,.jpg), and set validation if required.

• What field types are available?

  • The module supports 20+ field types including text, textarea, email, phone, URL, number, date, time, datetime-local, range, color, password, search, file, hidden, checkbox, radio, dropdown, and multiselect.

• How does CAPTCHA work?

  • The module includes a built-in image-based CAPTCHA system. Users enter the displayed code to verify they are human. CAPTCHA can be reloaded using the reload icon.

• Can I customize email content?

  • Yes, customize the email subject and body text in Email Settings. Form data is automatically included in a structured table format.

• Is the form responsive?

  • Yes, forms are fully responsive and adapt to different screen sizes. Two-column layouts automatically switch to single-column on mobile devices.

• How do I add validation to fields?

  • Enable "Validation" for any field and enter a custom "Validation Message". Required fields will show error messages if left empty.

• Form Not Displaying: Check that the module is published, assigned to the correct menu items or pages, and that the module position exists in your template. Verify module access levels match your user's access level.
• Fields Not Showing: Ensure you have added at least one form field using the "Add" button. Check that fields are properly configured with labels.
• Emails Not Sending: Check the Recipient Email setting. Ensure your Joomla site's email configuration is correctly set up. Check spam folder. On localhost, emails are not sent (displays success message with localhost note).
• File Uploads Not Working: Verify file upload directory permissions (/media/mod_easy_contact/uploads/). Check file size limits (default 10MB). Ensure allowed file types are correctly specified.
• Validation Not Working: Ensure jQuery is loaded. Check browser console for JavaScript errors. Verify validation messages are configured for required fields.
• CAPTCHA Not Displaying: Check that CAPTCHA image is loading (check browser console). Verify com_ajax is working correctly. Clear Joomla cache.
• Styling Issues: Check if your template's CSS is overriding the module styles. Use browser developer tools to inspect elements. Add custom CSS via the Additional CSS field or your template's custom CSS file.
• Two-Column Layout Not Working: Verify "Two Columns" is selected in Form Layout. Check that breakpoint is set correctly. Ensure fields are not marked as full-width unnecessarily.
• Form Presets Not Applying: Ensure you have selected a preset from the dropdown before clicking "Apply Preset". Check browser console for JavaScript errors.
• File Download Links Not Working: Verify files exist in upload directory. Check file permissions. Ensure com_ajax is accessible. Verify filename matches security pattern.
• Multiple Instances Conflict: Each instance should have unique module IDs. Verify module IDs are different. Check that form field names include module ID.
• Responsive Issues: Check that your template supports responsive design. Verify that custom CSS is not overriding responsive styles. Test on different devices and screen sizes.