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