Migrate from OXID eShop
In principle, a migration between the OXID eShop and O3-Shop is possible, but we recommend a new installation to get a clean installation.
Requirements for a migration
Please ensure that all requirements are met:
You start with an error-free Composer installation of the OXID eShop version 6.4.3 Community Edition. For older shop versions, please perform the update offered by OXID eSales to version 6.4.3 before you start the migration. Newer OXID shops (> 6.4.3) cannot be migrated. The migration only supports Community Editions. The migration of Professional or Enterprise Editions is not supported.
The OXID eShop was installed via the package ‘oxid-esales/oxideshop-project’. Check if ‘oxid-esales/oxideshop-project’ is mentioned as name in the file composer.json, located in the main directory of your shop. If you use a different package composition, please check its components manually to determine if they can be replaced.
You have made a full backup of your installation (Files and Database) before proceeding with a migration
Perform migration
Replace packages
Open a terminal window and navigate to the main store directory. Exectue the commands:
isdev= && composer show oxid-esales/testing-* | grep -q . && isdev="1"
composer require -W o3-shop/shop-metapackage-ce:^1.0 --no-scripts --no-plugins
composer remove oxid-esales/testing-library oxid-esales/oxideshop-ide-helper --dev --no-scripts --no-plugins
composer require -W o3-shop/testing-library:^1.0 o3-shop/shop-ide-helper:^1.0 --dev --no-plugins --no-scripts
composer config extra.incenteev-parameters.dist-file 'vendor/o3-shop/testing-library/test_config.yml.dist' --no-plugins
composer remove oxid-esales/oxideshop-metapackage-ce --no-scripts --no-plugins
if [ -n "${isdev}" ]; then composer require o3-shop/shop-metapackage-ce:^1.0; else composer require --update-no-dev o3-shop/shop-metapackage-ce:^1.0; fi
Confirm all overwrite requests with ´y´.
If the Azure theme should be explicitly installed:
composer remove oxid-esales/azure-theme --dev
Data migration
vendor/bin/oe-eshop-db_migrate migrations:migrate
Complete migration
In the case of additional packages installed by OXID or individual compositions of the shop project, please check which packages need to be replaced from oxid-esales to o3-shop.
Overview of the packages replaced by O3-Shop and their versions
OXID package |
OXID version |
O3-Shop package |
O3-Shop version |
|---|---|---|---|
oxid-esales/oxideshop-project |
dev-b-6.0-ce |
o3-shop/o3-shop |
dev-b-1.0-ce |
oxid-esales/oxideshop-metapackage-ce |
6.4.3 |
o3-shop/shop-metapackage-ce |
1.0.0 |
oxid-esales/oxideshop-ce |
6.10.3 |
o3-shop/shop_ce |
1.0.0 |
oxid-esales/oxideshop-composer-plugin |
5.2.2 |
o3-shop/shop-composer-plugin |
1.0.0 |
oxid-esales/oxideshop-facts |
2.4.0 |
o3-shop/shop-facts |
1.0.0 |
oxid-esales/oxideshop-unified-namespace-generator |
2.2.0 |
o3-shop/shop-unified-namespace-generator |
1.0.0 |
oxid-esales/oxideshop-doctrine-migration-wrapper |
3.3.0 |
o3-shop/shop-doctrine-migration-wrapper |
1.0.0 |
oxid-esales/oxideshop-db-views-generator |
1.3.0 |
o3-shop/shop-db-views-generator |
1.0.0 |
oxid-esales/codeception-page-objects |
2.3.0 |
o3-shop/codeception-page-objects |
1.0.0 |
oxid-esales/codeception-modules |
1.4.2 |
o3-shop/codeception-modules |
1.0.0 |
oxid-esales/flow-theme |
3.8.1 |
o3-shop/flow-theme |
1.0.0 |
oxid-esales/wave-theme |
1.6.2 |
o3-shop/wave-theme |
1.0.0 |
oxid-esales/azure-theme |
* |
currently discontinued |
|
oxid-esales/oxideshop-demodata-installer |
1.3.0 |
o3-shop/shop-demodata-installer |
1.0.0 |
oxid-esales/oxideshop-demodata-ce |
6.0.4 |
o3-shop/shop-demodata-ce |
1.0.0 |
oxid-esales/paypal-module |
6.4.1 |
o3-shop/paypal-module |
1.0.0 |
oxid-esales/gdpr-optin-module |
2.3.3 |
o3-shop/gdpr-optin-module |
1.0.0 |
oxid-professional-services/usercentrics |
1.2.1 |
o3-shop/usercentrics |
1.0.0 |
oxid-esales/testing-library |
8.1.0 |
o3-shop/testing-library |
1.0.0 |
oxid-esales/oxideshop-ide-helper |
4.1.0 |
o3-shop/shop-ide-helper |
1.0.0 |
oxid-esales/developer-tools |
1.1.0 |
o3-shop/developer-tools |
1.0.0 |
oxid-esales/php-selenium |
1.0.5 |
o3-shop/php-selenium |
1.0.0 |
oxid-esales/mink-selenium-driver |
1.1.2 |
o3-shop/mink-selenium-driver |
1.0.0 |