The WordPress + WooCommerce adapter adds a WordPress lane and a WooCommerce lane to J2Commerce Migrator. It moves content, users, and store data from a WordPress source database into Joomla 6 and J2Commerce 6.
Use it when you are replacing a WordPress or WooCommerce site with Joomla and J2Commerce.
Requirements
- Joomla 6.0.0 or later.
- J2Commerce 6 (
com_j2commerce). - J2Commerce Migrator (
com_j2commercemigrator) 6.1.10 or later, installed and enabled. - Source: WordPress 5.0 or later and WooCommerce 7.1 or later.
- To migrate product reviews: the J2Commerce Product Reviews app, installed and enabled.
Installation
- Install and enable J2Commerce Migrator.
- Go to System -> Install -> Extensions.
- Upload the plugin package.
- Open J2Commerce Migrator. The WordPress + WooCommerce card shows Ready to migrate.
- Click Configure Connection and enter the source database details.
- Click Start Migration.
Settings
The plugin has no settings of its own. It adds two pages, WordPress Migration and WooCommerce Migration, plus a Connection page. Each step has Detect, Migrate, List, and Reset buttons. Migrate All WordPress Content and Migrate All WooCommerce Data run every step on a page.
WordPress Migration Page
| Section | What It Does |
|---|---|
| Lookup & Probe | Probe Source checks the connection and lists WordPress tables. Map User Roles assigns each WordPress role to a Joomla user group or to Skip User (do not migrate). |
| Users | Users creates Joomla accounts using the role mapping. User Meta moves custom user meta to Joomla custom fields. |
| Taxonomy | Categories (under Blog), Term Taxonomy, and Tags. |
| Blog Posts | Posts become articles in the Blog category. Post Meta becomes custom fields. |
| Pages | Pages become articles in the Pages category. Page Hierarchy restores parent-child links. |
| Menus | Menu Types and Menu Items. |
| Uploads & Media | Uploads records media files. Rewrite Body Images changes wp-content/uploads/ paths to images/wordpress/ in article text. |
| Tools | Reset Content Migration and Rebuild Assets & Trees. |
WooCommerce Migration Page
| Section | What It Does |
|---|---|
| Lookup & Probe | Probe Source, Detect HPOS Mode, and Store Settings (name, address, currency, country and state, weight and dimension units, tax behavior). |
| Tax | Tax Classes, Tax Rates, and Tax Locations. |
| Shipping | Shipping Zones, Zone Locations, and Shipping Methods. |
| Product Catalog | Product Categories (under Shop), Attribute Taxonomies, and Attribute Terms. |
| Products | Products, Product Meta, Variations, Variation Meta, and Product Images. |
| Customers | Billing Addresses and Shipping Addresses. |
| Coupons | Coupons and Coupon Meta. |
| Orders | Ensure Order Statuses, Orders, Order Addresses, Order Items, Order Item Meta, Order Tax, Order Shipping, and Order History. |
| Product Reviews | Check Reviews App, then Reviews. |
| Tools | Reset Commerce Migration. |
How It Behaves
- WordPress password hashes are kept. They are rehashed on the user's first login.
- Orders work with both HPOS and legacy post-based WooCommerce storage.
- Run Map User Roles and save the mapping before you migrate users.
- Use Empty Source and the Synced label to see which steps have no rows left.
- The migration log can be exported.
Warning
The reset buttons delete all adapter ID mappings and cannot be undone. Back up your database before you run Rebuild Assets & Trees.
Common Setups
- Click Probe Source on the WordPress page.
- Map roles and save.
- Migrate users, taxonomy, posts, pages, menus, and uploads.
- Switch to the WooCommerce page and migrate tax, shipping, catalog, products, customers, coupons, and orders in that order.
- Run Rebuild Assets & Trees.
Troubleshooting
| Problem | Fix |
|---|---|
| "This plugin requires com_j2commercemigrator to be installed." | Install and enable J2Commerce Migrator, then install the plugin again. |
| "This plugin needs J2Commerce Migrator 6.1.10 or later." | Update the component, then install the plugin again. |
| "Resolve unmapped roles in tile AB first." | Open Map User Roles, assign every role, and click Save Role Mapping. |
| "No WordPress roles found in the source database." | Check that the connection points at a WordPress install with users in wp_usermeta. |
| Category or article saves fail with nested-set errors such as "Out of range value for column 'lft'". | Back up the database and run Rebuild Assets & Trees. |
Uninstalling
- Go to System -> Manage -> Extensions.
- Search for WordPress + WooCommerce.
- Select the plugin and click Uninstall.
Content and store data already migrated stays in Joomla.
