Answers to the most common problems
When installing modules or modifiers, you may encounter errors. We have collected in this section answers to frequently asked questions and solutions to the most common and common problems.
- Download and install the add-on Localcopy OCMOD;
- After installing this add-on, you need to go to the section Menu -> Extensions -> Modifications and click the button Update Modifications;
- Now you can install other modules.
There are several possible problems and possible solutions:
- The template cache has not been reset - you need to update the cache;
- You previously edited template files through the admin panel in the Menu -> Design -> Theme Editor section, then this file was saved in the database and it is no longer affected by ocmod modifiers, this is an Opencart 3 problem. You need to install a fix and update modifications in admin panel;
- Your template is based on TPL files (*.tpl), while in Opencart 3 templates should be in TWIG format (*.twig). The problem is that ocmod modifiers do not affect TPL files - all changes must be made to these files manually.
There is a bug in the official builds of Opencart 3.0.3.5 - 3.0.3.6 - there modifiers do not work with twig files due to an error in the standard modification /system/modification.xml - the second operation from this modification does not work.
The problem is at the office github and suggested solution: GitHub
Fix modifier following these recommendations, it will replace the file /system/modification.xml file with the correct one.
Solution:
- Make a backup copy of your file /system/modification.xml;
- Download fix modification and install it in your admin;
- Refresh modifier cache;
- Update the twig template cache.
If the module does not respond to your actions, whether it is pressing a button or loading a map, or selecting a date, or any other action that is in the functionality of the module, there is most likely a conflict in JS scripts.
Press F12 on the problem page in the browser - the webmaster panel will open, where on the Console tab you can see conflicts in the scripts, if any. This action is available in Chrome, Opera, Firefox browsers.
- Download and install the add-on Localcopy OCMOD;
- After installing this add-on, you need to go to the section Menu -> Extensions -> Modifications and click the button Update Modifications;
- Now you can install other modules.
Error 500 after installing the module means that some critical error has occurred in php.
To identify the problem, you can:
- Open file logs/error.log on your server. At the end of this file will be all the latest critical errors;
- Open in admin panel Menu -> Tools -> Error Logs - errors are displayed in this place, but not always;
Enable php error output on the screen - add the following code to the end of the .htaccess file:
php_value display_errors 1 php_value display_startup_errors 1 php_value error_reporting E_ALL
Now, instead of error 500, an error code should be displayed, which will indicate the problem.
Possible reasons:
- If you have never uploaded modules via an archive through the admin panel before, you need to install the free Localcopy OCMOD modification according to the instructions and then reinstall the module;
- It is possible that the module being installed does not have its own settings page, and accordingly it will not be in the list of modules.
There are two ways to solve this problem:
1. If this error pops up from the admin when installing the module, you need to install Localcopy OCMOD:
It will be installed without problems through the same add-ons installer, only after installation do not forget to update the modifications and then you can start installing any modules on Opencart 2.
2. You can also solve this error in another way: register access to FTP in the admin panel Menu -> System -> Settings -> Store -> FTP tab.
If you see the message «Access Denied! You do not have permission to access this page. If you need it, contact the administrator» - you need to give administrators the rights to manage the module or page.
Solution: in the Opencart 2 admin panel, go to Menu -> System -> Users -> User Groups and here click «Select All» below both blocks, then «Save».
Another reason for the appearance of this error may be incorrect installation of the module - the files were not loaded into their places. Upload the module files manually to the server or install a fix Localcopy OCMOD and reinstall the module.
In the Opencart 2 admin panel, go to Menu -> System -> Users -> User Groups and here click «Select All» below both blocks, then «Save»
If the module is a single XML file, then its extension must be .ocmod.xml
If the module is an .ocmod.xml archive, then it does not need to be unpacked, but installed as is. Such an archive must contain the upload folder (may be empty), and there may also be modification files: install.xml, install.php, install.sql. There should not be any other files in the root of the archive.
This error means that the upload folder is missing in the uploaded archive. Even if the module has no files other than modifications - this folder must be present in the module's .ocmod.zip archive, then it must remain empty.
This error means that you are trying to install a modifier that is already installed, or perhaps one of your modules has the same ID.
To solve this error, you need to remove the old version of the modification in the Menu -> Modules -> Modifications section before installing.
If you do not have such a module, but the ID matches, then you need to change the value of the <code> parameter in the XML modifier being set, make this parameter unique by adding a few characters.
This error means that you are trying to set an oversized xml modifier.
The number of characters in the ocmod.xml file must not exceed 65535.
To solve the error, you need to split the modification xml file into several parts, the main thing is not to forget to set a unique value for each in <code>, you can add the numbers 1,2,3... to the current value as identifiers parts.
Another solution is to change the type of the fields where modifications are stored in the oc_modification table of the database.
You need to execute the following SQL query:
ALTER TABLE oc_modification CHANGE xml MEDIUMTEXT CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL;- It looks like you installed a module for older versions of this system on Opencart 2.3.x.x, that is, an incompatible module. You need to delete all files of this module, otherwise the error will not disappear;
- Also, this error can occur if the script accesses a non-existent table in the database. That is, the module table was not created during installation. Read the installation instructions and reinstall the module.
There are several reasons why something on the site does not change. This mainly happens in OpenCart 3rd version, but maybe in the 2nd one too.
- You have not updated the modifier cache. It needs to be updated after editing the file if it "passes" through the modifier. Read about modifiers in the documentation and on the forum.
- The TWIG cache has not been updated or disabled. Yes, it is on by default, but it gets in the way when you make changes. It needs to be updated or disabled.
- There were changes through the Template Editor. Here, some edit through the admin panel, and others through FTP. Everywhere it is written that it is better to edit only via FTP, but some still manage to break everything. Therefore, before editing via FTP, it is necessary to delete all changes in Menu -> Design -> Template Editor.
- Editing the wrong files. Yes, and this happens. Either they edit another site, then another template, then they forget to update the browser cache by pressing CTRL+F5, then they try to edit something in the modifier cache, i.e. in the Storage directory, etc. Study the structure carefully. There is information about this in the documentation.
- Host with a delay. Yes, there are hosts that delay changes to files. That is, you edit, and the changes are applied in a minute. In a minute, you can break the entire site, but the hoster is to blame.
- A crooked template or a template with a cache. Some templates are so cached that you start editing, but there are no changes. The fault is the cache of the template itself. This is usually common in multifunctional templates, so study the functionality carefully.
- Download and install the add-on Localcopy OCMOD;
- After installing this add-on, you need to go to the section Menu -> Extensions -> Modifications and click the button Update Modifications;
- Now you can install other modules.