Ep. 51: How to configure the user and the admin email in RSForm!Pro

RSForm!Pro allows you to send custom emails (user and admin emails) upon the form submission.
These two types of email are configured separately in the "Manage forms" area >> Properties, in two corresponding tabs ("User Emails" and "Admin Emails").

This video tutorial explains how to configure the user and the admin email.
We have created a Joomla! form with 5 components: 2 textboxes for the fullname and email, a textarea for the message and a radio group with 2 options "Yes" and "No"(users are receiving a file attachement if this option is set to "Yes").
In the last part of the tutorial, we've included a custom PHP code in the "Email scripts" tab, that allows you to send the user email with a file attachment.

Step 1: User email configuration:

These emails are sent to the user, after the form submission.

1. 1. "From": this is the sender email.
   e.g. you will send user emails on behalf of the site administrator.
2. 2. "From Name": this is the sender name/company.
   e.g. the site administrator name/company.
4. 3. "Reply to": if the user that submitted the form wants to reply, this is where his email is sent.
6. 4. "To" : users that will receive emails from administrators.
7. 5. "Subject": Add the email subject.
8. 6. "Attach file" : RSForm!Pro has a built-in option to send email attachments.

 

Step 2: Admin email configuration:

These emails are sent to the site administrator, after the form submission.

1. 1. "From": this is the sender email.
   e.g. the admin will receive emails with the submission details.
2. 2. "From Name": this is the sender name.
4. 3. "Reply to": Add the reply email.
6. 4. "To" : this is the admin email where the message should be sent.
7. 5. "Subject": :Add the email subject.
8. 6. "Attach file" : RSForm!Pro has a built-in option to send email attachments.

 

Step 3: Email placeholders

You can personalize the user and the admin message with global or specific form placeholders.

Global placeholders

The global placeholders are used for general user details as username, id, email, full name, IP, date name. Emails can also include placeholders for the sitename and URL.

The global placeholder syntax is: {global:placeholder_name}
e.g. {global:username}

1. 1. {global:username}: If the user is registered to your Joomla website, his username will appear when using this placeholder.
2. 2. {global:userid}: If the user is registered to your Joomla website, his user id will appear when using this placeholder.
3. 3. {global:useremail}: If the user is registered to your Joomla website, his email will appear when using this placeholder.
4. 4. {global:fullname}: If the user is registered to your Joomla website, his fullname will appear when using this placeholder.
5. 5. {global:userip}: The IP of the user that submitted the form.
6. 6. {global:date_added}: The date the user submitted the form.
7. 7. {global:sitename}: The name of your site, as defined in your Joomla configuration.
8. 8. {global:siteurl}: The URL of your site.

Form specific placeholders:

RSForm!Pro automatically generates the specific placeholders based on the form components.
The placeholders can be easily added by clicking the "Toggle Quick Add" located on the right side or by simply clicking the email field.

Step 4: Email scripts

The "Email scripts" tab allows you to customize the user and the admin email before they are sent.
In our example, we've used a script which allows you to attach a configured file to the user email, if the radio group option is set to "Yes".

1. if($_POST['form']['Attach File'] == 'Yes')
   $userEmail['files'][] = JPATH_SITE.'/images/cancel.png';