Advanced configuration options

Caching

Use global means that this module’s content will be cached according to your Joomla’s global cache settings.

No caching means that no content from this module will be cached.

This option is provided by Joomla.

Form Instance

If you use more than one Classic forms on your website, even on different pages, you need to give each one of them a unique number to differentiate them from each other.

Send Results CC

Enter email addresses here if you want the form to be sent in carbon copy.

Send Results BCC

Enter email addresses here if you want the form to be sent in blind carbon copy.

Reply To this address

Enter email addresses where replies should be sent to.

Activate Reply To

If set to Yes, a “Reply to” field will appear when the email is sent.

Auto Reset Fields

Yes means that all fields will be cleared when the user submits the form.

No means that the values entered by the user will remain after the form is submitted.

Note

With the JForm type, No is automatically used.

Name of CSS Class

Enter the name of the CSS class that will be used with the form.

Space After Labels

Amount of pixels between the labels to the left of the form and their input fields.

Redirect URL

Enter a Website address where the user should be redirected after submitting the form. Make sure you enter a fully formed URL.

Example: http://www.unlikelysource.com/

Use Captcha

With the JForm type:

To be able to use Captcha, you can follow the procedure on the Joomla Website.

This will produce a captcha looking like this:

_images/advanced_options01.png

Note

If you don’t have a Google account and don’t want to create one, you can use a Captcha extension available in the Joomla Extensions Directory.

With the Classic form type:

Set to No Captcha if you don’t want any Captcha protection.

Image Captcha creates an image including a background rectangle, characters the user will have to type and lines blurring the image.

_images/advanced_options02.png

Text Captcha creates a simple character string the user has to type.

_images/advanced_options03.png

Directory to Write Captchas

An absolute path where captchas will be written.

Example : /var/www/application/images

Make sure that the repository is writable.

URL for Captcha Directory

URL matching the directory specified above.

Captcha Word Length

Number of characters the user will need to enter.

Captcha Font Size

Size of the characters in the captcha image.

Captcha Width

Width in pixels of the captcha image.

Captcha Height

Height in pixels of the captcha image.

Captcha Text Color

The color of the characters in the captcha image.

Captcha Lines Color

The color of the lines partially hiding the characters in the captcha image.

Captcha Background Color

The color of the captcha image background.

Error Text Color

The color in which error messages are displayed to the user.

Success Text Color

The color in which success messages are displayed to the user.

Name of Anchor Tag

After submitting the form, the user is redirected to the anchor tag mentioned here. By default, this tag is placed at the beginning of the form.

The name of the tag must start with #. Example : #tag

Number of Upload Fields

Determines the number of attachments users can or must send through the form.

Upload Field Label

The label for the upload fields.

Allowed Attachment Filenames

List of approved filename extensions, separated by commas. For security reasons, Joomla will prevent any user from sending executable content, for instance a .php file.

Are upload fields required?

If set to Yes, submitting the form will fail with an error if an upload field is empty.

Note

This new feature is only available with the JForm type.

Directory to Save Attachments

An absolute path to the directory in which attachments sent by users will be saved.

Send Me an Email Field Label

The label for field Send Me an Email, set below.

Send Me an Email Field

If set to Yes, users can ask to receive a copy of the form that they send.

Send User an Email Automatically

If set to Yes, users will always receive a copy of the form that they send.

Send User a Custom Message

If the Send User an Email Automatically option is set to Yes, you can fill out this section to send your user a custom message.

Email Check

If set to Yes, the data entered in the From field is validated and must follow the format emailaccount@domain.

Note

With the JForm type, this validation occurs automatically.

Include Article Title

If set to Yes, the Joomla article title is automatically included in a hidden field added to the email.

Test Mode

If set to Yes, the form is used in test mode.

Override rendering

Set this option to Yes if you want to use your own template to modify the module’s display. To get you started, you can copy the mod_simpleemailform/tmpl/default_custom.php.dist and name it default_custom.php.

You can also give your custom file another name, but you will have to insert your chosen name on line 7 of the default.php template file.

Override strings

Set this option to Yes if you want to use Joomla’s language overrides feature. Searching for constants with “MOD_SIMPLEEMAILFORM” will give you a list of all the strings that can be overriden in this module.

Thanks to this feature, you won’t lose your changes the next time you update Simple Email Form.

Module Tag

The html tag used for the module. This option is provided by Joomla.

Bootstrap Size

The number of columns used in the module. This option is provided by Joomla.

Header Tag

The HTML tag used for module headers and titles. This option is provided by Joomla.

Header Class

The CSS class used for module headers and titles. This option is provided by Joomla.

Module Style

The option used to override the template style. It is provided by Joomla.