We are on social networks
Telegram
Go to contacts
0
Wishlist
0
Compare
Module catalog
0
0

OpenCart Modules — Questions & Answers

Instructions for Installing an Extension with a Modifier

Before starting the installation of any extension, we strongly recommend creating a backup of your website files and database. This will allow you to quickly restore the site in case of errors or incompatibility.

  1. Download the extension file that matches your OpenCart version from our website or your personal account.
  2. Log in to the admin panel and go to Extensions → Extension Installer.
  3. Click the “Upload” button, select the extension file, and wait for the upload process to complete.
  4. After a successful installation, you will see the message “Success: You have modified extensions!”. This means the extension file has been processed correctly.
  5. Next, go to Extensions → Modifications and click the “Refresh” button to apply the changes made by the modifier.
  6. Be sure to check access permissions. Go to System → Users → User Groups, select the required group, click “Select All”, and save the changes.

After completing all the steps above, the extension will be fully installed and ready for use. If necessary, you can proceed to its settings or immediately check how it works on the storefront.

Frequently Asked Questions and Common Issues

Error 500 means that the site cannot process the request due to a critical PHP error. It most often occurs after installing a module, modifier, or editing files.

How to find the cause of the error:

  1. Go to the admin panel: System → Tools → Error Log. The most recent site errors are displayed at the bottom of the log.
  2. If the log is empty, enable error logging: System → Settings → Server → Log Errors → Yes.
  3. If you have FTP access, open the file storage/logs/error.log or logs/error.log. This file contains detailed error descriptions.
  4. If errors are not displayed at all, temporarily add the following lines to the .htaccess file in the site root:
php_value display_errors 1
php_value display_startup_errors 1
php_value error_reporting E_ALL

⚠ After fixing the error, it is recommended to remove these lines for security reasons.

This message appears during module installation when OpenCart does not have access to the file system.

Possible solutions:

  1. The easiest way is to install the modifier localcopy.ocmod.xml , which allows installing modules without using FTP.
  2. Alternatively, configure FTP manually: System → Settings → FTP, where you need to specify the host, username, password, and port.

OpenCart indicates that it does not have permission to write files to a specific directory. This usually happens during module installation or update.

  1. Install the modifier localcopy.ocmod.xml .
  2. Go to Extensions → Modifications and refresh the cache.
  3. Reinstall the module.

There may be several reasons:

  1. The module files were not copied to the server.
  2. Access permissions were not granted to the user group.
  3. The module does not have a settings page.
  4. This is a modifier — it works in the background and does not appear in the menu.

This message means that your user group does not have permission to view or manage the module.

  1. Go to System → Users → User Groups and enable the required permissions.
  2. Make sure the module files physically exist on the server.
  3. Verify that the module version matches your OpenCart version.

The installation file must meet OpenCart requirements:

  1. The file name must have the .ocmod extension.
  2. The archive must be in .zip format.
  3. Inside the archive there must be installation files and an upload folder.

The installation archive is structured incorrectly. The upload folder must be present in the root of the archive, even if it is empty.

This means you are trying to install the modifier again. Before reinstalling, you need to remove the previous version.

  1. Add the module manually in Design → Layouts.
  2. There may be a compatibility issue with the theme.
  3. Refresh the modification and template cache.

In most cases, this issue is related to access permissions or cache.

  1. Check whether the module files exist on the server.
  2. Enable permissions for the administrator user group.
  3. Refresh the modification and template cache.