MasinoForgotPwd10 extension will customize your Forgot Password page in web applications that generated by PHPMaker 10. You will see a new panel in this page so that the Forgot Password form will become eye-catching. The panel will auto-adjust to the maximum width of the your web application. This extension also has the ability to hide the breadcrumb links that generated by PHPMaker 10. By default, PHPMaker 10 will generate the breadcrumb links on the Forgot Password page. By using MasinoForgotPwd10 extension, then by default, the breadcrumb links will be hidden. I don’t see the functionality of this breadcrumb links on the Forgot Password page, so it is better to hide it by default.
This extension will also handle the multi language email template that being used by Forgot Password business-logic. If your web application is running the multi language feature, then your web application users will receive the email based on the selected language they chose. In addition, the Subject email will include your application name. This is very useful for your users to distinguish the email belongs to which web application. Therefore, they will not get confused if they are using some of your web applications that generated by PHPMaker. As we have already known, PHPMaker has not handled all these things, yet!
From the generated Forgot Password page, now you can either display or hide the Captcha (security code) by adjusting the related setting in the generated (ewcfg10.php) file. The same way also if you want to display or hide the breadcrumb links, and also if you want to change the panel type of the Forgot Password page. In other words, each time you want to change the settings and see the result you don’t have to re-generate the script files. All you have to do is by adjusting the related setting from the generated configuration file.
To display or hide the Captcha on the Forgot Password page, then adjust the following code from your ewcfg10.php file:
define("MS_SHOW_CAPTCHA_ON_FORGOT_PASSWORD_PAGE", FALSE, TRUE); // <-- Switch FALSE (second param) to TRUE if you want to display Captcha on the Forgot Pwd page
To display or hide the breadcrumb links on the Forgot Password page, then adjust the following code from your ewcfg10.php file:
define("MS_SHOW_BREADCRUMBLINKS_ON_FORGOTPWD_PAGE", FALSE, TRUE);
To adjust the panel type on the Forgot Password page, then adjust the following code from your ewcfg10.php file:
define("MS_FORGOTPWD_FORM_PANEL_TYPE", "panel-default", TRUE); // available: panel-default, panel-primary, panel-success, panel-warning, panel-danger, panel-info
To switch the window type from default to popup for the Forgot Password page, then make sure you have the following code from your ewcfg10.php file become:
define("MS_FORGOTPWD_WINDOW_TYPE", "popup", TRUE); // available: default, popup. Modified by Masino Sinaga, May 22, 2014
The other setting that related to the Forgot Password page in the configuration file is that we can adjust the business logic for requesting the unencrypted password. By default, PHPMaker 10 will get the unencrypted password from database and send it immediately to the user without sending the first email that contains the password activation code. Change FALSE become TRUE from the following setting if you don't want to implement the same logic that implemented for the encrypted password to the unencrypted password:
define("MS_SEND_PASSWORD_DIRECTLY_IF_NOT_ENCRYPTED", FALSE, TRUE);
However, in order to adjust the default setting of those last two settings above, then you can define them from the Advanced setting of MasinoForgotPwd10 extension, under the Tools -> Extensions -> MasinoForgotPwd10 -> Advanced tab. Especially for Captcha setting on the Forgot Password Page, you can define the default setting of it from the Security -> Advanced -> User Login Options -> Password Recovery Page of PHPMaker.
Please note that in order to display all the changes in the Forgot Password page properly, then you have to enable also MasinoCustomCSS10 and MasinoCaptcha10 extensions. The reason for this, since the custom CSS code which will customize the Forgot Password page will be generated using MasionCustomCSS10 extension, and the Captcha code will be generated by using MasinoCaptcha10 extension.
Updated on October 8, 2013: Now the date of reset password is saved into the User Profile.
Updated on October 10, 2013: Some code customization that related to other extensions.
Updated on November 19, 2013: Fixed: Captcha not showing on the Forgot Password form if MasinoFixedWidthSite10 extension is enabled.
Updated on April 23, 2014: Added: The KnownFieldOptions setting from extension side, so that you can choose whether to display "Email", "Username", or "EmailOrUsername" in "forgotpwd.php" page.
Updated on April 24, 2014: Fixed: The "Email" field name in recordset is static, should be dynamically, based on PROJ.SecEmailFld value of PHPMaker side.
Updated on May 22, 2014: Added: Popup or Default options to display the Request Password Form as the popup window or as the normal page (as you have been using until now).
Updated on May 31, 2014: Fixed: missing the ability of focus on the first textbox when the popup dialog window is being shown.
Last Updated on June 3, 2014: Enhanced: handling also for either Email or Username individual option properly using jQuery code, besides using EmailOrUsername option.
As the conclusion and recap, here is the advantage of MasinoForgotPwd10 extension:
- A new option for displaying the Request Password Form as a popup window. However you may still use the default option for the normal page.
- A new panel for the Forgot Password so that the form will become eye-catching. You can even change the panel style from the generated configuration (ewcfg10.php) file.
- The ability to hide or display the breadcrumb links on the Forgot Password page (default is hidden). Simply adjust the related setting in the generated configuration (ewcfg10.php) file.
- The ability to display the Captcha security code without having to re-generate the script files. Simply adjust the related setting in the generated configuration (ewcfg10.php) file.
- When the Forgot Password page is loaded, then the mouse cursor will automatically focus on the Email input box.
- Supports for the multi-language email template. You can add your own email template language based on the existing one in the extension.
- The email Subject has included the web application name to distinguish and make sure the email came from which web application.
- The date of reset password is now saved into the User Profile of user, so that this will also update the last date of changing password.
- Now you can choose from the extension side whether to display Email or Username or EmailOrUsername field in the generated forgotpwd.php page.