Fix Page Not Found Error After Installing OpenCart Extensions
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:
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.