Filter uncanny-learndash-groups

ulgm_add_invite_user_last_name_required

Filters whether the last name field is required when inviting users to a managed group.

add_filter( 'ulgm_add_invite_user_last_name_required', $callback, 10, 1 );

Description

Filters whether the "Last Name" field is required when inviting a new user to a group. Return `false` to make the field optional. This filter fires in the frontend template for adding users to a group.


Usage

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

Parameters

$ulgm_current_managed_group_id (mixed)
This parameter is a boolean value that determines whether the last name field is required when inviting a user.

Return Value

The filtered value.


Examples

<?php
/**
 * Conditionally make the last name field required for inviting users to a group.
 *
 * This filter allows developers to override the default behavior and make the
 * 'Last name' field a required input when inviting a new user to a group.
 *
 * @param bool   $is_required              The current requirement status of the last name field. Defaults to true.
 * @param int|null $group_id               The ID of the group being managed. Null if no group is currently managed.
 *
 * @return bool True if the last name field should be required, false otherwise.
 */
function my_custom_ulgm_require_last_name_for_invites( $is_required, $group_id ) {
	// Example: Make the last name field required for all groups except group ID 123.
	if ( $group_id !== null && $group_id == 123 ) {
		return false; // Not required for group ID 123.
	}

	// For all other cases, respect the default or other applied filters.
	// If you want to make it *always* required regardless of group, you could simply return true.
	// If you want to *never* require it, return false.
	return $is_required;
}
add_filter( 'ulgm_add_invite_user_last_name_required', 'my_custom_ulgm_require_last_name_for_invites', 10, 2 );

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/templates/frontend-uo_groups/users-table-actions.php:491

<div class="uo-row">
												<label for="last-name">
													<div class="uo-row__title">
														<?php _e( 'Last name*', 'uncanny-learndash-groups' ); ?>
													</div>
												</label>
												<input class="uo-input"
														<?php if ( true === apply_filters( 'ulgm_add_invite_user_last_name_required', true, GroupManagementInterface::$ulgm_current_managed_group_id ) ) { ?>
															required="required"
														<?php } ?>
														type="text" name="last_name"
														id="last-name"
														value="">
											</div>


Scroll to Top