https://github.com/bestpractical/rt-extension-mergeusers

https://github.com/bestpractical/rt-extension-mergeusers

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/bestpractical/rt-extension-mergeusers
• Owner: bestpractical
• Created: 2009-09-16T13:49:53.000Z (over 15 years ago)
• Default Branch: master
• Last Pushed: 2024-09-09T19:52:03.000Z (3 months ago)
• Last Synced: 2024-09-10T00:20:11.549Z (3 months ago)
• Language: Perl
• Homepage: http://search.cpan.org/dist/RT-Extension-MergeUsers
• Size: 225 KB
• Stars: 5
• Watchers: 8
• Forks: 4
• Open Issues: 4
• Metadata Files:
  • Readme: README
  • Changelog: Changes

Awesome Lists containing this project

README

        
NAME

    RT::Extension::MergeUsers - Merges two users into the same effective

    user

RT VERSION

    Works with RT 4.0, 4.2, 4.4, 5.0.

DESCRIPTION

    This RT extension adds a "Merge Users" box to the User Administration

    page, which allows you to merge the user you are currently viewing with

    another user on your RT instance.

    It also adds "MergeInto" and "UnMerge" functions to the RT::User class,

    which allow you to programmatically accomplish the same thing from your

    code.

    It also provides a version of CanonicalizeEmailAddress, which means that

    all e-mail sent from secondary users is displayed as coming from the

    primary user.

INSTALLATION

    Be sure to also read "UPGRADING" if you are upgrading.

    perl Makefile.PL

    make

    make install

        May need root permissions

    Edit your /opt/rt5/etc/RT_SiteConfig.pm

        If you are using RT 4.2 or greater, add this line:

            Plugin('RT::Extension::MergeUsers');

        For RT 4.0, add this line:

            Set(@Plugins, qw(RT::Extension::MergeUsers));

        or add RT::Extension::MergeUsers to your existing @Plugins line.

    Clear your mason cache

            rm -rf /opt/rt5/var/mason_data/obj

    Restart your webserver

UPGRADING

    If you are upgrading from 0.03_01 or earlier, you must run

    bin/rt-update-merged-users. This script will create MergedUsers

    Attributes so RT can know when you're looking at a user that other users

    have been merged into. If you don't run this script, you'll have issues

    unmerging users. It can be safely run multiple times, it will only

    create Attributes as needed.

UTILITIES

  rt-clean-merged-users

    When a user with another user merged into it is shredded, the attributes

    on that user are also shredded, but the merged user will remain, along

    with attributes that may point to the now missing user id. This script

    cleans up attributes if the merged-into user record is now gone. These

    users will then be converted back to regular unmerged users.

  rt-merge-users

    A command-line tool to merge one user into another

CAVEATS

  RT::Shredder and Merged Users

    Merging a user effectively makes it impossible to load the merged user

    directly. Attempting to access the old user resolves to the merged-into

    user. Because of this, MergeUsers has some extra code to help

    RT::Shredder clean up these merged records to avoid leaving merged user

    records in the DB while removing the user they were merged into.

    When running RT::Shredder on a user record with other users merged into

    it, the merged users are Unmerged before the initial user record is

    shredded. There are two options to handle these newly unmerged users:

    1.  Re-run your shredder command with the same or similar options. The

        unmerged user records will now be accessible and, depending on your

        shredder options, they will likely be shredded on the second run. If

        you have multiple layers of merged users, you may need to run

        shredder multiple times.

    2.  MergeUsers will log the unmerged users at the info level so you can

        pull the user ids from the log and shred them manually. This is most

        likely to be useful if you are shredding one specific user (and all

        merged accounts).

AUTHOR

    Best Practical Solutions, LLC 

BUGS

    All bugs should be reported via email to

        L

    or via the web at

        L.

LICENSE AND COPYRIGHT

    This software is Copyright (c) 2014-2023 by Best Practical Solutions

    This is free software, licensed under:

      The GNU General Public License, Version 2, June 1991