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 );
	}

Scroll to Top