The Change Password app adds a dedicated tab to the J2Commerce My Profile page on the frontend. Logged-in customers can update their Joomla account password without leaving the store.
The form validates both fields client-side and server-side, shows inline error messages for empty or mismatched passwords, and displays a confirmation message on success. The app also provides an email tag that adds a link to the Change Password tab in your email templates.
Requirements
- PHP 8.3 or later
- Joomla 6.0.0 or later
- J2Commerce 6.6.6 or later
Purchase and Download
The Change Password app is a separate add-on available from the Change Password. It is not included with the core J2Commerce 6 component.
Step 1: Go to the J2Commerce website -> Apps.
Step 2: Locate the Change Password app -> click View Details -> Add to cart -> Checkout.
Step 3: Go to My Downloads under your profile menu at the top right corner and search for the app. Click Available Versions -> View Files -> Download.
Install the App
Install the app with the Joomla installer.
- In the Joomla admin, go to System -> Install -> Extensions.
- Upload the plugin ZIP file or use the Install from URL option.
%20(1).webp)
Enable the App
After installing, enable the app. You can open the Apps list in two ways.
Option A: Click the J2Commerce icon at the top right corner -> Apps.
Option B: Go to Components in the left sidebar -> J2Commerce -> Apps.
Find Change Password and click the X. It turns into a green checkmark when the app is enabled.
Configure the App
Click the Change Password title to open the plugin configuration screen.
Basic Tab
| Setting | What It Does | Default | Options |
|---|---|---|---|
| Display Quick Icon | Shows a quick icon for this app on the J2Commerce dashboard. Needs the J2Commerce Quick Icon plugin installed and enabled. | No | Yes, No |
| Quick Icon Title | The label on the quick icon. Shown only when Display Quick Icon is Yes. | J2Commerce Change Password | Text |
| Layout | The frontend framework used for the Change Password tab. Default follows the layout selected in the J2Commerce configuration. | Default | Layouts offered by your J2Commerce installation |
Email Instructions Tab
These settings control the [CHANGE_PASSWORD_INSTRUCTIONS] tag. Place the tag in an email template to add a block with a button that links to the My Profile page.
| Setting | What It Does | Default | Options |
|---|---|---|---|
| Add Instructions to Emails | Shows the change-password instructions wherever the tag is placed. When set to No, the tag stays blank. | Yes | Yes, No |
| My Profile Page | The My Profile menu item the email button links to. Only published J2Commerce My Profile menu items are listed. | None selected | Published My Profile menu items |
| Instructions Text | Optional. Replaces the default sentence above the button: "To choose your own password, sign in and open the Change Password tab in My Profile." | Empty | Editor text |
My Profile Page and Instructions Text appear only when Add Instructions to Emails is Yes. The email button reads "Open My Profile to Change Your Password".
Warning
If no My Profile page is selected, or the selected menu item is unpublished or deleted, emails do not include the instructions. The tab shows a warning in that case. Create a published My Profile menu item and select it.
After adjusting settings, click Save or Save & Close.
How It Works
When a logged-in customer visits their My Account page on the frontend, a Change Password tab appears in the profile navigation alongside any other profile tabs.
Clicking the tab shows a form with two fields:
- New Password: the customer's desired new password
- Confirm Password: must match the New Password field exactly
When the customer clicks Change Password:
- The button shows a loading spinner while the request processes.
- If both fields pass validation, the password is updated immediately.
- A green success message appears: "Password Updated Successfully."
- The form clears so the fields are ready for another change.
Inline error messages appear directly below the relevant field.
Validation and Error Messages
| Situation | Message Shown |
|---|---|
| New Password field left empty | "New Password Required" |
| Confirm Password field left empty | "Confirm Password Required" |
| Passwords do not match | "Password Field Mismatch" |
| Server-side save error | "New Password Save Problem" |
| Success | "Password Updated Successfully" |
Tips
- The tab only appears for logged-in users. Guest visitors do not see it.
- The app uses your Joomla site's password strength and minimum length requirements.
- With Display Quick Icon on, the icon links to the plugin configuration page from the J2Commerce dashboard.
- Child templates pick up layout overrides for this app from their parent template.
Troubleshooting
The Change Password Tab Does Not Appear on the My Profile Page
Cause: The plugin is not enabled, or the customer is not logged in.
Solution:
- Go to J2Commerce -> Apps and verify Change Password has a green checkmark.
- Confirm the customer is logged into a Joomla user account on the frontend.
- Go to System -> Manage -> Extensions, search for Change Password, and verify the plugin status is Enabled.
Password Change Fails with a Generic Error
Cause: A server-side error occurred during the save, such as a session timeout or a Joomla security token mismatch.
Solution:
- Ask the customer to refresh the My Profile page to get a fresh session token.
- Try the password change again.
- If the error persists, check System -> System Information -> PHP Error Log for details.
Quick Icon Does Not Appear on the Dashboard
Cause: The J2Commerce Quick Icon plugin is not installed or not enabled, or Display Quick Icon is set to No.
Solution:
- Go to J2Commerce -> Apps and confirm the Change Password plugin is enabled.
- Click Change Password to open its configuration.
- Set Display Quick Icon to Yes.
- Verify a label is entered in the Quick Icon Title field.
- Go to System -> Manage -> Extensions, search for J2Commerce Quick Icons, and confirm it is enabled.
- Click Save in the Change Password configuration and reload the J2Commerce dashboard.
Email Does Not Show the Change Password Instructions
Cause: The tag is missing from the template, Add Instructions to Emails is No, or no published My Profile page is selected.
Solution:
- Add
[CHANGE_PASSWORD_INSTRUCTIONS]to the email template. - Open the Email Instructions tab and set Add Instructions to Emails to Yes.
- Select a published J2Commerce My Profile menu item in My Profile Page.
