How to Include Application Name in Email Templates of Websites that Generated with PHPMaker 9.0.2.

If you pay attention to the email templates that are used by your web applications which generated by PHPMaker up to version 9, there is no application name was included in the email templates. The impact is, if your users are using more than one web application that you created by using PHPMaker, then there is the possibility of receiving some emails that use the same Subject. This could be happened since those email templates do not include the application name in the Subject section in order to distinguish between one web application with another. I am sure that this is not good and should be improved in order to distinguish those emails.

This following customization will solve the problem. We will include the application name in all email templates (at least at the Subject section) that used by your web application by customizing all of email templates (request password, activate password, change password, registration, and notify of inserting/editing records or audit trail) and some PHPMaker template files. This customization is very useful, not only for your users, but also for you as a developer if you are creating many web applications. After implementing it, then you don't have to worry anymore how to distinguish emails that received by your users regarding the related web application since the Subject has included the application name.

Please note that some part of the customization below is related to this article. You have to implement it before doing the customization below.

Updated on July 22, 2012: This customization has been implemented in PHPMaker version 9.0.3, it matches to each other, and as a result, it works properly.

Updated on September 5, 2012: This customization has been implemented in PHPMaker version 9.0.4, it matches to each other, and as a result, it works properly.

Updated on November 29, 2012: This customization has been implemented in PHPMaker version 9.1.0, it matches to each other, and as a result, it works properly.

Updated on February 9, 2013: This customization has been implemented in PHPMaker version 9.2.0, it matches to each other, and as a result, it works properly.

Updated on June 17, 2013: This customization below has been handled by using MasinoFixedWidthSite extension. You don’t need to implement the customization below if you use my extensions together with the original PHPMaker Template and Extension files.

[hidepost]

1. Open your C:\Program Files\PHPMaker 9\languages\english.xml file, and find this code:

   </global>
   

   before that line, please insert the following code:

   	<phrase id="SubjectRequestPasswordConfirmation" value="Request Password Confirmation in"/>
   	<phrase id="SubjectSendNewPassword" value="New Password in"/>
   	<phrase id="SubjectChangePassword" value="Password Changed in"/>
   	<phrase id="SubjectRegistrationInformation" value="Registration Information in"/>
   

   Do the same way with your another .xml language. For example, I am also using Indonesian, then I will insert the following code into my C:\Program Files\PHPMaker 9\languages\indonesian.xml file:

   	<phrase id="SubjectRequestPasswordConfirmation" value="Konfirmasi Permintaan Kata Sandi di"/>
   	<phrase id="SubjectSendNewPassword" value="Kata Sandi Baru di"/>
   	<phrase id="SubjectChangePassword" value="Kata Sandi Berhasil Diganti di"/>
   	<phrase id="SubjectRegistrationInformation" value="Informasi Pendaftaran di"/>
   

2. Open your \Script\audittrail.php file, find this code and make sure it is located inside the SendEmailOnAdd function::

   		$Email->ReplaceSender(EW_SENDER_EMAIL); // Replace Sender
   

   before that line, please insert the following code:

   		// Begin of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   		$Email->ReplaceSubject($Language->Phrase("RecordInserted").' '.$Language->ProjectPhrase("BodyTitle"));
   		$Email->ReplaceContent('<!--$ApplicationName-->', $Language->ProjectPhrase("BodyTitle"));
   		// End of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   

3. Still in that \Script\audittrail.php file, find again this code and make sure it is located inside the SendEmailOnEdit function:

   		$Email->ReplaceSender(EW_SENDER_EMAIL); // Replace Sender
   

   before that line, please insert the following code:

   		// Begin of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   		$Email->ReplaceSubject($Language->Phrase("RecordUpdated").' '.$Language->ProjectPhrase("BodyTitle"));
   		$Email->ReplaceContent('<!--$ApplicationName-->', $Language->ProjectPhrase("BodyTitle"));
   		// End of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   

4. Open your \Script\share-script.php file, and find this code:

   			$Email->ReplaceSender(EW_SENDER_EMAIL); // Replace Sender
   

   before that line, please insert the following code:

   			// Begin of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   			$Email->ReplaceSubject($Language->Phrase("RecordDeleted").' '.$Language->ProjectPhrase("BodyTitle"));			
   			$Email->ReplaceContent('<!--$ApplicationName-->', $Language->ProjectPhrase("BodyTitle"));
   			// End of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   

5. Open your \Script\update-script.php file, and find this code:

   			$Email->ReplaceSender(EW_SENDER_EMAIL); // Replace Sender
   

   before that line, please insert the following code:

   			// Begin of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   			$Email->ReplaceSubject($Language->Phrase("RecordUpdated").' '.$Language->ProjectPhrase("BodyTitle"));
   			$Email->ReplaceContent('<!--$ApplicationName-->', $Language->ProjectPhrase("BodyTitle"));
   			// End of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   

6. Open your \Script\changepwd.php file, and find this code:

                   $Email->ReplaceSender(EW_SENDER_EMAIL); // Replace Sender
   

   before that line, please insert the following code:

                   // Begin of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
                   $Email->ReplaceSubject($Language->Phrase("SubjectChangePassword").' '.$Language->ProjectPhrase("BodyTitle"));
                   // End of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   

7. Open your \Script\register.php file, and find this code:

                               $Email->ReplaceSender(EW_SENDER_EMAIL); // Replace Sender
   

   before that line, please insert the following code:

                               // Begin of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
                               $Email->ReplaceSubject($Language->Phrase("SubjectRegistrationInformation").' '.$Language->ProjectPhrase("BodyTitle"));
                               // End of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   

8. Open your \Script\forgotpwd.php file, and find this code:

                           $Email->ReplaceSender(EW_SENDER_EMAIL); // Replace Sender
   

   before that line, please insert the following code:

                           // Begin of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   						$Email->ReplaceSubject($Language->Phrase("SubjectRequestPasswordConfirmation").' '.$Language->ProjectPhrase("BodyTitle"));
                           // End of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   

9. Open your \Script\activatepassword.php file, and find this code:

   	$Email->ReplaceSender(EW_SENDER_EMAIL); // Replace Sender
   

   before that line, please insert the following code:

   	// Begin of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   	$Email->ReplaceSubject($Language->Phrase("SubjectSendNewPassword").' '.$Language->ProjectPhrase("BodyTitle"));
   	// End of modification Displaying Application Name in Email Template, by Masino Sinaga, June 5, 2012
   

10. Open your \Script\forgotpwd-en.txt file, and find this code:

    Subject: Password Request
    

    then replace it with the following code:

    Subject: <!--$Subject-->
    

11. Open your \Script\changepwd-en.php file, and find this code:

    Subject: Password Changed
    

    then replace it with the following code:

    Subject: <!--$Subject-->
    

12. Open your \Script\registeren.php file, and find this code:

    Subject: Registration Information
    

    then replace it with the following code:

    Subject: <!--$Subject-->
    

13. Open your \Script\requestpwd-en.txt file, and find this code:

    Subject: Request Password Confirmation
    

    then replace it with the following code:

    Subject: <!--$Subject-->
    

14. Still in that \Script\notify-en.txt file, find again this code:

    Record status changed:
    

    then replace it with the following code:

    Record status changed in <!--$ApplicationName-->:
    

15. Finally, re-generate your script files using PHPMaker as always.

[/hidepost]