During add-on installation a check is performed to find out if the add-on is compatible with the CS-Cart/Multi-Vendor version, as well as PHP versions and extensions. This information is stored in the <compatibility>
section of addon.xml.
This is how you specify the compatibility of your add-on with specific versions of CS-Cart/Multi-Vendor:
<compatibility>
<core_version>
<min>4.3.2</min>
<max>4.3.6</max>
</core_version>
</compatibility>
Note
You don’t have to specify both <min>
and <max>
. They stand for the earliest and the latest supported versions respectively.
If you try to install this add-on on version 4.3.7, you’ll get the following error:
Warning
Error: Version of your cart (4.3.7) is not supported. Minimal: 4.3.2. Maximal: 4.3.6.
There are two products: CS-Cart (referred to as ULTIMATE
) and Multi-Vendor (referred to as MULTIVENDOR
). You can mark your add-on as compatible with either of them, or with both.
One product:
<compatibility>
<core_edition>MULTIVENDOR</core_edition>
</compatibility>
Multiple products:
<compatibility>
<core_edition>MULTIVENDOR,ULTIMATE</core_edition>
</compatibility>
If you specify MULTIVENDOR
in addon.xml and try to install the add-on on CS-Cart, you’ll see the following error:
Warning
Error: Edition of your cart (ULTIMATE) is not supported. Required: MULTIVENDOR.
You can specify the minimum and maximum supported PHP version:
<compatibility>
<php_version>
<min>5.6.1</min>
<max>7.1.1</max>
</php_version>
</compatibility>
Note
You don’t have to specify both <min>
and <max>
. They stand for the earliest and the latest supported PHP versions respectively.
If you try to install this add-on on a server with version 5.5.9, you’ll get the following error:
Warning
Error: PHP version (5.5.9-1ubuntu4.14) is not supported. Minimal: 5.6.1. Maximal: 7.1.1.
You can specify the required and conflicting PHP extensions for your add-on.
Required extension:
<compatibility>
<php_extensions>
<gd>
<supported>Y</supported>
</gd>
</php_extensions>
</compatibility>
If the required PHP extension (in our case it’s gd) is not installed, you’ll see an error:
Warning
Error: The gd extension should be installed on your server for correct add-on operation.
Specific version of a required extension:
<compatibility>
<php_extensions>
<json>
<min>3.0</min>
<max>4.0</max>
</json>
</php_extensions>
</compatibility>
Note
In this case you don’t have to add <supported>Y</supported>
.
If the PHP extension version is different from the required versions, you’ll see an error:
Warning
Error: The json version (1.3.2) is not supported by the add-on. Minimal: 3.0. Maximal: 4.0.
Conflicting extension:
<compatibility>
<php_extensions>
<gd>
<supported>N</supported>
</gd>
</php_extensions>
</compatibility>
If the conflicting PHP extension (in our case it’s gd) is installed, you’ll see an error:
Warning
Error: The gd extension should be removed from your server for correct add-on operation.
Questions & Feedback
Have any questions that weren't answered here? Need help with solving a problem in your online store? Want to report a bug in our software? Find out how to contact us.