Filter
uncanny-automator
automator_microsoft_teams_specializations
Filters available Microsoft Teams specializations for use with automations, allowing for customization before integration.
add_filter( 'automator_microsoft_teams_specializations', $callback, 10, 1 );
Description
Filters the list of Microsoft Teams specializations available for automation. Developers can add or remove specialization options, such as 'standard', 'educationClass', or 'educationStaff', to customize team creation workflows. This hook runs before the specialization options are displayed to the user.
Usage
add_filter( 'automator_microsoft_teams_specializations', 'your_function_name', 10, 1 );
Parameters
-
$specializations(mixed) - This parameter contains an array of available specialization options for creating a Microsoft Teams team, each mapped to a unique key and a human-readable label.
Return Value
The filtered value.
Examples
add_filter(
'automator_microsoft_teams_specializations',
function( $specializations ) {
// Add a new custom specialization for 'Project Teams' if it doesn't already exist.
// This is useful for differentiating project-specific teams from standard ones.
if ( ! isset( $specializations['projectTeam'] ) ) {
$specializations['projectTeam'] = esc_html_x( 'Project Team', 'Microsoft Teams', 'uncanny-automator' );
}
// Remove the 'educationStaff' specialization if it's no longer relevant for this instance.
// This might be done if the plugin is used in a non-educational context where this option is confusing.
if ( isset( $specializations['educationStaff'] ) ) {
unset( $specializations['educationStaff'] );
}
return $specializations;
},
10, // Default priority
1 // Number of accepted arguments
);
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/integrations/microsoft-teams/actions/microsoft-teams-create-team.php:132
private function get_specialization_options() {
$specializations = array(
'standard' => esc_html_x( 'Standard', 'Microsoft Teams', 'uncanny-automator' ),
'educationClass' => esc_html_x( 'Education - Class Team', 'Microsoft Teams', 'uncanny-automator' ),
'educationStaff' => esc_html_x( 'Education - Staff Team', 'Microsoft Teams', 'uncanny-automator' ),
'educationProfessionalLearningCommunity' => esc_html_x( 'Education - Professional Learning Community', 'Microsoft Teams', 'uncanny-automator' ),
);
$specializations = apply_filters( 'automator_microsoft_teams_specializations', $specializations );
return automator_array_as_options( $specializations );
}