Connects a Backdrop CMS installation to a legacy WordPress database to migrate user accounts and metadata. It is part of the Acuity WordPress Migration Centre and uses that module's shared database connection.

This module is designed to be an idempotent migration tool: it can be run multiple times to sync changes from WordPress to Backdrop, updating existing users and creating new ones as needed.

When all users have been imported and/or your new Backdrop site is live, you can safely uninstall this module.

To manipulate the user accounts we recommend using the Views Bulk Operations module, for example, to change the user role from the standard Authenticated to a custom role you may have created, or to update an email or newsletter subscription status.

We recommend deleting any unneeded fields we created for the import process once you are happy with the imported data.

This is a beta release for code review and testing.

• Backdrop CMS 1.x
• Acuity WP Migration Centre (acuity_wpmc) — provides the WordPress database connection and the migration dashboard this module registers on.
• A secondary database connection to the WordPress database, defined in settings.php.

Install this module using the official Backdrop CMS instructions at https://docs.backdropcms.org/documentation/extend-with-modules

Add the WordPress database configuration to your settings.php file (see Documentation below), then enable the module (it will enable the Migration Centre as a dependency).

1. Database Configuration

Before running the migration, define the connection to the WordPress database in your site's settings.php. The prefix must be empty to query wp_users directly. host may be 127.0.0.1, localhost, or a remote database host.

$databases['wordpress']['default'] = array(
  'driver' => 'mysql',
  'database' => 'your_wordpress_db_name',
  'username' => 'db_user',
  'password' => 'db_pass',
  'host' => '127.0.0.1',
  'prefix' => '',
);

2. Running the Migration

• Open the Migration Centre dashboard at Configuration → Acuity → WP Migration Centre (admin/config/acuity-wpmc).
• Choose User Migration & Auth.
• On the Settings tab, confirm the batch size (number of users processed per step).
• On the User Import tab, click Run User Migration to begin the batch import. The process is idempotent and can be re-run safely.

3. Data Mapping

The module automatically creates hidden fields to store legacy data.

Migrated users log in with their existing WordPress password — no extra module is required.

• At import, each user's WordPress password hash ($P$… or the phpBB $H$… variant) is copied verbatim into Backdrop's users table.
• The first time a migrated user logs in, Backdrop core itself verifies that legacy hash and, on success, transparently re-saves the password as a modern, more secure Backdrop hash ($S$…, SHA-512). The user notices nothing — they simply use their old password, and it is upgraded in place.
• This is built into Backdrop core (user_check_password() / user_authenticate()), which natively understands WordPress and phpBB password hashes. No companion authentication module is needed for migrated users to log in.

Safeguards:

• Non-destructive re-runs: re-running the migration never overwrites a password that has already been upgraded to a Backdrop $S$ hash.
• User 1: the Backdrop Root Administrator (User 1) password is never touched by the import.
• Blocked members: bbPress members flagged bbp_blocked are imported as disabled accounts, not active ones (the block lives in wp_capabilities, not user_status).

Technical fields (field_wp_guid, field_wp_capabilities, field_wp_user_level) are restricted via hook_field_access(). Only administrators with the administer users permission can view or edit these fields.

The module explicitly suppresses "Account Created" emails ($account->notify = FALSE) to prevent mass emailing during import.

Bio data (field_wp_bio) is imported raw from WordPress. If the source site contained malicious scripts in user bios, they are now in your database. Ensure the Text Format used to display this field filters HTML tags appropriately.

Bugs and Feature requests should be reported in the Issue Queue: https://github.com/backdrop-contrib/acuity_wpuser/issues

• Steve Moorhouse (albanycomputers) (https://github.com/albanycomputers)
• Seeking additional maintainers and contributors.

• Assisted by AI

• Albany Computer Services (https://www.albany-computers.co.uk)
• Albany Web Design (https://www.albanywebdesign.co.uk)
• Albany Hosting (https://www.albany-hosting.co.uk)

This project is GPL v2 software. See the LICENSE.txt file in this directory for complete text.