Troubleshooting Issues with the Joomla Email Cloak Plugin

When using Convert Forms, you may encounter issues if you're using email addresses as default values in input fields (value="[email protected]"), inside placeholder text (placeholder="[email protected]"), or in dropdown options (<option value="[email protected]">).

The Joomla Email Cloak plugin attempts to encrypt these email addresses, which breaks the form's functionality and prevents proper submission.

The Solution

To resolve this specific issue in Convert Forms, we've developed the Convert Forms Email Cloak Fix plugin. This plugin prevents the Joomla Email Cloak plugin from interfering with email addresses used within Convert Forms while maintaining email protection elsewhere on your site.

We do not allow cloaking of email addresses in the following cases:

  • Input Fields: value, placeholder, data-value, data-calc-value
  • Select Fields: value attribute in <option> elements
  • Textarea Fields: placeholder attribute
  • Label Elements: text content inside <label> tags

Important: Email addresses that appear as regular text content in your forms (such as in descriptions or HTML fields) will still be properly cloaked by Joomla's Email Cloak plugin, maintaining protection where needed.

Implementation

The Convert Forms Email Cloak Fix plugin comes enabled by default. To verify its status:

  1. Log in to your Joomla administrator
  2. Go to Extensions → Manage → Plugins
  3. Search for the Convert Forms - Email Cloak Fix plugin
  4. Enable the plugin

Important Notes

  • This plugin is only needed if you use Joomla's Content - Email Cloaking plugin.
  • The fix only applies to forms created by Convert Forms.
  • Email addresses elsewhere on your site remain protected by the core Email Cloak plugin.

Email pulled from a custom field is still cloaked

If your form field gets its value from a Joomla custom field via a Smart Tag (for example, a Default Value of {user.field.email}), the email may still arrive cloaked. If the same tag is used in emails like in the BCC field, the submission will fail with an error like: "Invalid address: (bcc)".

This happens because resolving a custom field Smart Tag runs the value through Joomla's content plugins, and Email Cloak replaces the address before it ever reaches the form. The Convert Forms Email Cloak Fix plugin can't catch it, since there's no plain email address left in the form HTML to protect.

Fix: add .rawvalue to the Smart Tag so it returns the field exactly as stored, without running any content plugins:

{user.field.email.rawvalue}

Use this wherever the address is pulled from the custom field (Default Value, BCC, etc.). See Preventing Shortcode Parsing in Custom Fields for the full explanation.

Last updated on Jul 1st 2026 09:07