Document the behaviour when deleting or removing a user

[johnbillion]

Need to document what happens to author attribution when a user is deleted or when a user is removed from a site within a Multisite network.

• Is the user still attributed?
  • User deleted: no
  • Multisite user removed: yes (needs verifying)
• Can the user still edit posts they are attributed to?
  • User deleted: nope
  • Multisite user removed: no
• Does the plugin remove the attribution connections in the database?
  • No
• Does the plugin gracefully skip attribution connections that use user IDs that don't exist?
  • It should but this needs verifying, for example when editing a post that is attributed to a user who has subsequently been deleted

A future task will cover improving the UX when deleting or removing a user, for example by presenting the option to reassign or remove attribution for the user.

[mdrovdahl]

Hi @johnbillion =)

Sharing that we used Authorship on a recent Team 51 project and used the below to re-attribute content when deleting a user. Note, we're only handling posts of type podcast and post here, that should be adjusted/generalized for re-use.

/**
 * When a user is deleted, and "attribute all content to" another author is chosen,
 * assign the Authorship taxonomy relationship to all the re-attributed posts.
 */
function reassign_on_delete( $deleted_user_id, $reassigned_user_id ) {
	// If we're not attributing content to another user, bail early.
	if ( empty ( $reassigned_user_id ) ) {
		return;
	}
	// Unhook the Authorship function that modifies the query.
	remove_action( 'pre_get_posts', 'Authorship\action_pre_get_posts', 9999 );
	// Get the taxonomy term IDs that point to the two users.
	$old_author_term_object = get_term_by( 'name', $deleted_user_id, 'authorship' );
	$old_author_term_id     = $old_author_term_object->term_id;
	$new_author_term_object = get_term_by( 'name', $reassigned_user_id, 'authorship' );
	if ( $new_author_term_object ) {
		$new_author_term_id = $new_author_term_object->term_id;
	} else {
		// No Authorship term was found, so create one.
		$new_author_term_array = wp_insert_term( $reassigned_user_id, 'authorship', array( 'slug' => $reassigned_user_id ) );
		$new_author_term_id    = $new_author_term_array['term_id'];
	}
	// Get all the posts where this user is the WP Core author.
	$args         = array(
		'post_type'      => array( 'podcast', 'post' ),
		'posts_per_page' => -1,
		'post_status'    => 'publish',
		'author'         => $reassigned_user_id,
	);
	$author_posts = new \WP_Query( $args );
	if ( $author_posts->have_posts() ) {
		while ( $author_posts->have_posts() ) {
			$author_posts->the_post();
			// Check whether this post is associated to any Authorship terms.
			$terms = wp_get_post_terms( get_the_ID(), 'authorship' );
			if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) {
				foreach ( $terms as $term ) {
					if ( ( int ) $deleted_user_id === ( int ) $term->name && ( int ) $deleted_user_id === ( int ) $term->slug ) {
						// Remove the old author association.
						wp_remove_object_terms( get_the_ID(), $term->slug, 'authorship' );
						// Add the new author association.
						wp_add_object_terms( get_the_ID(), $new_author_term_id, 'authorship' );
					}
				}
			} else {
				wp_add_object_terms( get_the_ID(), $new_author_term_id, 'authorship' );
			}
		}
	}
	wp_reset_postdata();
	// Re-hook the Authorship function that modifies the query.
	add_action( 'pre_get_posts', 'Authorship\action_pre_get_posts', 9999 );
}