ulgm_group_course_report_columns

Description

Usage

add_filter( 'ulgm_group_course_report_columns', 'your_function_name', 10, 1 );

Return Value

The filtered value.

Examples

// Add a custom column to the Uncanny LearnDash Groups course report for additional user information.
add_filter( 'ulgm_group_course_report_columns', 'my_custom_group_course_report_columns', 10, 1 );

function my_custom_group_course_report_columns( $columns ) {
    // Add a new column for 'user_login_id' which corresponds to the WordPress user ID.
    // This can be useful for internal referencing or custom integrations.
    $columns['user_login_id'] = __( 'User ID', 'uncanny-learndash-groups' );

    // Example of reordering columns: Move 'group_name' to be after 'user_email'.
    if ( isset( $columns['group_name'] ) ) {
        $group_name_column = array( 'group_name' => $columns['group_name'] );
        unset( $columns['group_name'] );
        // Find the index of 'user_email' and insert 'group_name' after it.
        $user_email_key = array_search( 'user_email', array_keys( $columns ) );
        if ( $user_email_key !== false ) {
            $new_columns = array_slice( $columns, 0, $user_email_key + 1, true );
            $new_columns = array_merge( $new_columns, $group_name_column, array_slice( $columns, $user_email_key + 1, null, true ) );
            $columns = $new_columns;
        }
    }

    // Example of removing a column: Remove the 'transcript_page_url' column.
    if ( isset( $columns['transcript_page_url'] ) ) {
        unset( $columns['transcript_page_url'] );
    }

    return $columns;
}

Placement

This code should be placed in the functions.php file of your active theme, a custom plugin, or using a code snippets plugin.

Source Code

src/classes/reports/group-reports-interface.php:119

public static function get_column_translations() {
		return apply_filters(
			'ulgm_group_course_report_columns',
			array(
				'user_name'           => __( 'Username', 'uncanny-learndash-groups' ),
				'first_name'          => __( 'First Name', 'uncanny-learndash-groups' ),
				'last_name'           => __( 'Last Name', 'uncanny-learndash-groups' ),
				'user_email'          => __( 'Email', 'uncanny-learndash-groups' ),
				'percent_completed'   => __( '% Complete', 'uncanny-learndash-groups' ),
				'course_time'         => __( 'Course Time', 'uncanny-learndash-groups' ),
				'date_completed'      => __( 'Date Completed', 'uncanny-learndash-groups' ),
				'date_enrolled'       => __( 'Date Enrolled', 'uncanny-learndash-groups' ),
				'course_name'         => sprintf( _x( '%s Name', 'LearnDash: Course Name', 'uncanny-learndash-groups' ), learndash_get_custom_label( 'course' ) ),
				'group_name'          => sprintf( _x( '%s Name', 'LearnDash: Group Name', 'uncanny-learndash-groups' ), learndash_get_custom_label( 'group' ) ),
				'transcript_page_url' => __( 'Transcript', 'uncanny-learndash-groups' ),
			)
		);
	}