Email templates

Email templates

Admin Tools can be configured (in the Configure WAF page) to send out emails when an attack is blocked. You can configure the contents and layout of these email messages using this page.

Editing an email template

Each email template consists of the following elements:

Reason

The kind of attack this email template applies to. If no specific email template is found, Admin Tools will use the one with its reason set to "All".

Subject

The subject line of the email message you will be receiving. You can use certain variables (see below).

Published

Only the email templates with Published set to Yes will be taken into account.

Frequency limit

When the "Enable security exception email throttling" option is enabled in the Configure WAF page these options will define the maximum number of emails you are going to receive. You can set the number of emails and the amount of time. For example setting 5 emails in 1 hour means that if 5 emails for this Reason have been sent in the last 1 hour Admin Tools will not send out any more emails about it.

Body

The body text of the email message. You can use full HTML and certain variables (see below).

The variables you can use are enclosed in square brackets and are always in uppercase. The available variables are:

  • [IP] Blocked IP address

  • [LOOKUP] Direct link to the ip lookup service

  • [REASON] The detected kind of the attack

  • [DATE] Date and time of the attack

  • [URL] Attacked URL. THIS IS POTENTIALLY UNSAFE. You are advised to NOT include this in your emails to avoid attackers triggering Cross Site Scripting (XSS) attacks.

  • [USER] Username of the attacker (if the user is logged in)

  • [COUNTRY] Country of the attacker (you need the Akeeba GeoIP plugin enabled)

  • [CONTINENT] Continent of the attacker (you need the Akeeba GeoIP plugin enabled)

  • [UA] User agent of the attacker. THIS IS POTENTIALLY UNSAFE. You are advised to NOT include this in your emails to avoid attackers triggering Cross Site Scripting (XSS) attacks.

  • [SITENAME] The name of your site.

Cookies Notification - Action required

This website uses cookies to provide user authentication and improve your user experience. Please indicate whether you consent to our site placing these cookies on your device. You can change your preference later, from the controls which will be made available to you at the bottom of every page of our site.