Introduction
Easy Ajax Contact is a Joomla module provides a customizable contact form with Ajax functionality, allowing users to send emails without reloading the page. This documentation covers the installation, configuration, and usage of the Easy Ajax Contact module.
Installation
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: EasyAjaxContact_UNZIP.zip
Unzipping the Package
Use any file unzipper tool or WinRAR to unzip the EasyAjaxContact_UNZIP.zip package. After unzipping, you will find the following contents:
- Folder Joomla 3: This extension is compatible with Joomla 3.x. In this folder, you will find the installation file named
mod_easy_contact_X.x.zip
. - Folder Joomla 4 & 5: The extension is also designed for seamless integration with Joomla 4.x and Joomla 5.x. This folder contains the installation file named
mod_easy_contact_X.x.zip
. - ReadMe.txt: Contains vital information about the current version of the extension.
Installing the Extension
To install the extension, log in to the backend of your Joomla website.
- For Joomla 3: Navigate to Extensions > Extension Manager, then click on the "Upload Package File" tab. Click "Browse" to select the appropriate installation file, then click "Upload and Install."
- For Joomla 4 & 5: 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.
Configuration
After installation, the module needs to be configured to suit your requirements. Access the module settings by navigating to Extensions > Modules, and find Easy Ajax Contact in the list.
General Settings
- Form Heading: Enter the heading for the contact form.
- Form Width: Specify the width of the form in pixels or percentage (default is
400px
).
Email Settings
- Recipient Email: Enter the recipient's email address (default is
xyz@yourmail.com
). - Email Subject: Enter the subject line for the email (default is
New email from Easy Ajax Contact Form
). - Email Body: Enter the content of the email. Use placeholders for form data (default is
Here goes your email body content
).
Form Settings
- Add Fields: Click the "Add" button to add fields to the form. The fields can be configured using the subform feature in Joomla.
Styling Settings
- Button Color: Select the background color for the submit button (default is
#0078E7
). - Button Text Color: Select the text color for the submit button (default is
#ffffff
). - Button Width: Specify the width of the submit button (default is
100%
). - Label Typography: Customize the typography for the form labels, including font size, weight, transform, style, decoration, line height, letter spacing, and text shadow.
Language Settings
- Submit Button Text: Enter the text for the submit button (default is
Submit
). - Success Message: Enter the message displayed after successfully sending an email (default is
Email sent successfully
). - Failure Message: Enter the message displayed when the email fails to send (default is
Failed to send email
). - Captcha Message: Enter the message displayed when the captcha is required (default is
Captcha is required
). - Captcha Label: Enter the label for the captcha field (default is
CAPTCHA Label
). - Wrong Captcha Text: Enter the message displayed when the wrong captcha is entered (default is
The captcha you have entered is wrong.
). - Captcha Change Text: Enter the text for changing the captcha (default is
Not readable? Change text.
).
Advanced Settings
- Additional CSS: Add custom CSS to further style the form (optional).
Features
Once configured, assign the module to a position on your Joomla template and publish it. The Easy Ajax Contact form will display and function according to your settings, allowing users to send messages without page reloads.
- Ajax Functionality: Sends emails without reloading the page.
- Customizable Fields: Add and configure various form fields.
- Email Notifications: Send emails to the specified recipient with customizable subject and body.
- Captcha Support: Optional captcha field to prevent spam.
- Styling Options: Customize the form's appearance with various styling settings.
- Multilingual Support: Customize messages and labels in different languages.
FAQ
-
How do I change the email recipient?
- Adjust the Recipient Email setting under Email Settings.
-
Can I add custom fields to the form?
- Yes, use the Add Fields option under Form Settings to add custom fields.
-
How do I change the form's appearance?
- Customize the form's appearance using the options under Styling Settings.
-
Is it possible to enable captcha?
- Yes, enable and configure captcha settings under Language Settings.
Troubleshooting
- Form Not Displaying: Ensure the module is assigned to a visible template position and published. Verify the settings are configured correctly.
- Emails Not Sending: Check the Recipient Email and Email Subject settings. Ensure your Joomla site's email configuration is correctly set up.
- Styling Issues: Adjust the Styling Settings to fix any appearance issues.