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>