The Eshop adapter adds JoomDonation EShop 4.x and 5.x as a source in J2Commerce Migrator. It moves products, orders, customers and related store data into J2Commerce 6.
Use it when you are moving a store from EShop to J2Commerce, on the same server or from a remote database.
Requirements
- J2Commerce 6.0.0 or later.
- The J2Commerce Migrator component, version 6.1.10 or later, installed and enabled.
- PHP 8.3 or later.
- PHP
memory_limitof 256 MB or more for large catalogs. - EShop 4.x or 5.x, either installed on this Joomla site or reachable as a remote database.
- The J2Commerce App Reviews plugin, only if you want to migrate reviews.
Installation
- Update J2Commerce Migrator to 6.1.10 or later.
- In Joomla, go to System -> Install -> Extensions.
- Upload the Eshop adapter package.
The plugin is enabled automatically on a new install. The Eshop card then appears on the Migrator dashboard.
Settings
The plugin has no settings of its own. Connection details are set in the Migrator component: use the Configure Connection button on the Eshop card.
Running a Migration
The dashboard card shows one of these states: Not installed, Installed but disabled, or Ready to migrate. With a remote source it shows that an EShop source was detected on the remote database.
- Open the J2Commerce Migrator dashboard.
- On the Eshop card, click Configure Connection if the source is a remote database.
- Click Start Migration.
The migration covers these groups: Lookups, Tax & Geozones, Catalog Foundation, Products, Customers, Promotions, Orders and Reviews. EShop store settings, categories, tags and plugin configurations are also migrated.
Post-Sync Tools
The Tools page has these groups. Post-sync passes run automatically after the product sync and can be re-run.
| Tool | What It Does |
|---|---|
| Sync Tax Classes, Sync Master Variants, Migrate Product Images, Audit Product Options | Runs individual post-migration passes. |
| Link Product Articles | Creates and links Joomla articles for migrated products that have no product source article. |
| Sync Products | Re-runs the product sync in strict order: categories, articles, then products, per batch. |
| Repair Content | Repairs migrated articles with empty JSON columns and rebuilds the category tree. |
| Rebuild Product Images | Re-copies and re-links product images from EShop into the J2Commerce image folders. |
What Is Not Migrated
- Customer groups and tax customer groups.
- Catalog discounts: use J2Commerce coupons or special prices.
- Product labels, product Q&A, wishlists and quote/RFQ records.
- Postcode-range geozone rules: J2Commerce supports country and zone rules only.
- Secondary-language records.
- EShop plugins with no J2Commerce equivalent.
Troubleshooting
- "This plugin needs J2Commerce Migrator 6.1.10 or later." Update the component, then install the plugin again.
- EShop (com_eshop) was not found. Migrate from a remote database instead, using the connection settings.
- Reviews are skipped. Install the J2Commerce App Reviews plugin and run the migration again.
- Category paths look wrong. Run Joomla Rebuild Category Paths, or use Repair Content.
- Products have no articles or images. Run Link Product Articles or Rebuild Product Images.
Uninstalling
Uninstall the plugin from System -> Manage -> Extensions. Data already migrated stays in J2Commerce.