Filter uncanny-automator-pro

uap_option_all_flsupport_ticket_priorities

Filters ticket priorities for Fluent Support allowing customization of available priority levels.

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

Description

Filters the available ticket priorities for Fluent Support in Uncanny Automator. Developers can modify the list of priorities displayed, allowing for custom or dynamic priority options within Automator recipes. This filter fires when Automator retrieves ticket priorities.


Usage

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

Parameters

$option (mixed)
This parameter contains the label for the ticket priority option.

Return Value

The filtered value.


Examples

<?php
/**
 * Example of filtering Uncanny Automator's Fluent Support ticket priorities.
 * This example will add a new custom priority option to the list.
 *
 * @param array $ticket_priorities The array of existing ticket priorities.
 * @return array The modified array of ticket priorities.
 */
add_filter( 'uap_option_all_flsupport_ticket_priorities', function( $ticket_priorities ) {

    // Check if the input is an array, as expected.
    if ( ! is_array( $ticket_priorities ) ) {
        return $ticket_priorities;
    }

    // Add a new custom priority.
    // The keys are typically slugified versions of the priority names.
    $ticket_priorities['very_high'] = array(
        'ID'   => 'very_high', // Internal identifier
        'name' => esc_html__( 'Very High', 'your-text-domain' ), // User-facing label
        'slug' => 'very_high', // Used for matching/identification
    );

    // You could also modify existing priorities, for example, by changing their labels:
    // if ( isset( $ticket_priorities['normal'] ) ) {
    //     $ticket_priorities['normal']['name'] = esc_html__( 'Standard', 'your-text-domain' );
    // }

    return $ticket_priorities;
}, 10, 1 );

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

uncanny-automator-pro/src/integrations/fluent-support/helpers/flsupport-pro-helpers.php:56

public function all_ticket_priorities( $label, $option_code, $args = array() ) {

		if ( ! $label ) {
			$label = esc_attr__( 'Priority', 'uncanny-automator-pro' );
		}

		$args = wp_parse_args(
			$args,
			array(
				'uo_include_any' => false,
				'uo_any_label'   => esc_attr__( 'Any priority', 'uncanny-automator-pro' ),
			)
		);

		$options = array();

		if ( $args['uo_include_any'] ) {
			$options[-1] = $args['uo_any_label'];
		}

		$option = array(
			'option_code'     => $option_code,
			'label'           => $label,
			'input_type'      => 'select',
			'required'        => true,
			'options'         => $this->get_all_ticket_priorities_options( $options ),
			'relevant_tokens' => array(),
		);

		return apply_filters( 'uap_option_all_flsupport_ticket_priorities', $option );
	}

Scroll to Top