How to Fix "Page Not Found" Error After Installing OpenCart Extensions (Version 4)

After installing an OpenCart extension and navigating to Extensions > Modules > Purpletree Extensions, you may encounter a "Page Not Found!" error when trying to enable the extension. The error message states:
"Page Not Found! - The page you are looking for could not be found! Please contact your administrator if the problem persists."
Cause:
This issue is typically caused by an incorrect filename for the extension's OCMOD file. OpenCart requires the modification file to have a specific name format recognized correctly.
Solution:
Step 1: Uninstall the Extension
Navigate to Extensions > Extensions > Modules in the OpenCart admin panel.
Locate the extension causing the issue.
Click Uninstall to remove the extension.
- Then uninstall from the installer and delete the extension.
Complete uninstall extension guide for opencart 4.
Step 2: Check and Rename the extension File in the correct format
Ensure that the file name follows the correct format. If the file name includes extra numbers (e.g., version indicators), rename it as follows:
Check if the file name includes extra numbers, version indicators, or incorrect formatting. Follow these steps to correct it:
If the file name has extra numbers (e.g., purpletree_multivendor.5.ocmod), remove the number so that it becomes purpletree_multivendor.ocmod.
If the file name includes version indicators (e.g., purpletree_productdesigner.9.ocmod), remove the number so that it becomes purpletree_productdesigner.ocmod.
If the file name contains unnecessary characters (e.g., purpletree_sendsms.13.ocmod), rename it to purpletree_sendsms.ocmod.
A general example: Purpletree_extension.12.ocmod should be renamed to Purpletree_extension.ocmod
Incorrect Name | Correct Name |
---|---|
purpletree_multivendor.5.ocmod | purpletree_multivendor.ocmod |
purpletree_productdesigner.9.ocmod | purpletree_productdesigner.ocmod |
purpletree_sendsms.13.ocmod | purpletree_sendsms.ocmod |
Step 3: Reinstall the Extension
Navigate back to Extensions > Installer in the OpenCart admin panel.
Upload the correctly named OCMOD file.
Once installed, go to Extensions > Extensions > Modules and enable the extension.
Step 4: Verify the Extension
Navigate to Extensions > Modules > Purpletree Extensions.
Click Edit for the extension you are trying to enable.
It should now open without the "Page Not Found" error.
Conclusion
By ensuring the OCMOD file is correctly named and reinstalling the extension, you can resolve the "Page Not Found" error in OpenCart 4. If the issue persists, consider checking for additional errors in the Error Logs under System > Maintenance > Error Logs.