This module helps users to merge together duplicate accounts. It uses a hook
system so other modules can do whatever they need to manage their relationships
Users with the right permissions can choose how each user
property should be merged. This includes the ability to merge fields,
referencing entities, and other entities owned by the selected users.
Support for several existing Backdrop modules is built in (see below). An API is
provided so that other modules can provide support for merging their data
associated with users when two users are merged. See
usermerge.api for more
Install this module using the official Backdrop CMS instructions.
Visit the configuration page under Administration > Configuration > People >
User Merge (admin/config/people/usermerge) and select which core properties of
the user entity should be exposed in the review table. By default, no properties
Integration with Other Modules
Integration with other modules is contained in module-specific files in the
Modules supported out of the box:
- Entity Reference (
- Profile (
profile), which is the replacement for the Drupal Profile2 module (
- Real Name (
- User Reference (
user_references), which is a submodule of References (
Additional modules can be supported by providing their own
<module>.usermerge.inc files. This module also provides the
function, which, given two user objects, merges them preserving information from
the "new" account.
Core-specific functionality (default user properties, fields) is managed in
usermerge.usermerge.inc, which also includes support for entities that have a
uid column, and basic display support for non-default user properties that
aren't structured like fields (such as
See some of the existing Backdrop
<module>_usermerge modules for examples of
how to integrate with this module.
Additional documentation is located in the Wiki.
Differences from Drupal 7
These modules were supported by the Drupal 7 version but have been dropped
because there are no corresponding Backdrop modules:
- Multiple E-mail (
- Profile (
profile); the Backdrop Profile module replaces the Drupal Profile2 module (see above)
- RDF (
- User Points (
Bugs and feature requests should be reported in the Issue Queue.
- Ported to Backdrop CMS by Robert J. Lang.
- Originally written for Drupal by Greg Knaddison (greggles).
This project is GPL v2 software.
See the LICENSE.txt file in this directory for complete text.