fluent_support_ticket_create_validation_rules

---

This filter hook allows you to retrieve validation rules for ticket and modify it.

Parameters

• '$rules' (array) Validation rules for ticket

Usage

add_filter('fluent_support/ticket_create_validation_rules', function ($rules) {
    // ...do something
    return $rules;
}, 10, 1);

Reference

apply_filters('fluent_support/ticket_create_validation_rules', $rules)

This filter is located in
fluent-support/app/Http/Requests/TicketRequest.php

fluent_support_ticket_create_validation_messages

---

This filter hook allows you to retrieve validation messages for a ticket and modify it.

Parameters

• '$messages' (array) Validation messages for a ticket

Usage

add_filter('fluent_support/ticket_create_validation_messages', function ($messages) {
    // ...do something
    return $messages;
}, 10, 1);

Reference

apply_filters('fluent_support/ticket_create_validation_messages', $messages)

This filter is located in
fluent-support/app/Http/Requests/TicketRequest.php

fluent_support_customer_ticket_priorities

---

This filter hook allows you to retrieve customer ticket priority list and modify it.

Parameters

• '$priorities' (array) Customer ticket priority list

Usage

add_filter('fluent_support/customer_ticket_priorities', function ($priorities) {
    // ...do something
    return $priorities;
}, 10, 1);

Reference

apply_filters('fluent_support/customer_ticket_priorities', [ 'normal' => __('Normal', 'fluent-support'), 'medium' => __('Medium', 'fluent-support'), 'critical' => __('Critical', 'fluent-support') ])

This filter is located in
fluent-support/app/Services/Helper.php

fluent_support_admin_ticket_priorities

---

This filter hook allows you to retrieve admin ticket priority list and modify it.

Parameters

• '$priorities' (array) Admin ticket priority list

Usage

add_filter('fluent_support/admin_ticket_priorities', function ($priorities) {
    // ...do something
    return $priorities;
}, 10, 1);

Reference

apply_filters('fluent_support/admin_ticket_priorities', [ 'normal' => __('Normal', 'fluent-support'), 'medium' => __('Medium', 'fluent-support'), 'critical' => __('Critical', 'fluent-support') ])

This filter is located in
fluent-support/app/Services/Helper.php

fluent_support_ticket_status_groups

---

This filter hook allows you to retrieve ticket status groups and modify it.

Parameters

• '$statusGroups' (array) Ticket status groups

Usage

add_filter('fluent_support/ticket_status_groups', function ($statusGroups) {
    // ...do something
    return $statusGroups;
}, 10, 1);

Reference

apply_filters('fluent_support/ticket_status_groups', [ 'open' => ['new', 'active'], 'active' => ['active'], 'closed' => ['closed'], 'new' => ['new'], 'all' => [] ])

This filter is located in
fluent-support/app/Services/Helper.php

fluent_support_changeable_ticket_statuses

---

This filter hook allows you to retrieve changeable ticket status groups and modify it.

Parameters

• '$ticketStatus' (array) Changeable ticket status groups

Usage

add_filter('fluent_support/changeable_ticket_statuses', function ($ticketStatus) {
    // ...do something
    return $ticketStatus;
}, 10, 1);

Reference

apply_filters('fluent_support/changeable_ticket_statuses', $ticketStatus)

This filter is located in
fluent-support/app/Services/Helper.php

fluent_support_ticket_statuses

---

This filter hook allows you to retrieve ticket statuses and modify it.

Parameters

• '$ticketStatuses' (array) Ticket statuses

Usage

add_filter('fluent_support/ticket_statuses', function ($ticketStatuses) {
    // ...do something
    return $ticketStatuses;
}, 10, 1);

Reference

apply_filters('fluent_support/ticket_statuses', [ 'new' => __('New', 'fluent-support'), 'active' => __('Active', 'fluent-support'), 'closed' => __('Closed', 'fluent-support'), ])

This filter is located in
fluent-support/app/Services/Helper.php

fluent_support_accepted_ticket_mimes

---

This filter hook allows you to retrieve accepted mimes and modify it.

Parameters

• '$mimes' (array) Accepted mimes

Usage

add_filter('fluent_support/accepted_ticket_mimes', function ($mimes) {
    // ...do something
    return $mimes;
}, 10, 1);

Reference

apply_filters('fluent_support/accepted_ticket_mimes', $mimes)

This filter is located in
fluent-support/app/Services/Helper.php

fluent_support_mime_groups

---

This filter hook allows you to retrieve mime groups and modify it.

Parameters

• '$mimeGroups' (array) Mime groups

Usage

add_filter('fluent_support/mime_groups', function ($mimeGroups) {
    // ...do something
    return $mimeGroups;
}, 10, 1);

Reference

apply_filters('fluent_support/mime_groups', $mimeGroups)

This filter is located in
fluent-support/app/Services/Helper.php

fluent_support_portal_base_url

---

This filter hook allows you to retrieve portal base url and modify it.

Parameters

• '$baseUrl' (string) Portal base url

Usage

add_filter('fluent_support/portal_base_url', function ($baseUrl) {
    // ...do something
    return $baseUrl;
}, 10, 1);

Reference

apply_filters('fluent_support/portal_base_url', $baseUrl)

This filter is located in
fluent-support/app/Services/Helper.php

fluent_support_can_user_add_tags_to_customer

---

This filter hook allows you to retrieve user can add tags permission and modify it.

Parameters

• '$canAddTags' (boolean) User can add tags or not permission

Usage

add_filter('fluent_support/can_user_add_tags_to_customer', function ($canAddTags) {
    // ...do something
    return $canAddTags;
}, 10, 1);

Reference

apply_filters('fluent_support/can_user_add_tags_to_customer', $canAddTags)

This filter is located in
fluent-support/app/Services/FluentCRMServices.php,
fluent-support/app/Services/Helper.php

fluent_support_custom_field_render

---

This filter hook allows you to retrieve custom fields data and modify it.

Parameters

• '$value' (string) Custom fields value
• '$scope' (string) Specifies whether it is for admin or public use

Note: $fieldType represents the type of custom field, whether it is a text field, number field, etc.

Usage

add_filter('fluent_support/custom_field_render_' . $fieldType , function ($value, $scope) {
    // ...do something
    return $value;
}, 10, 2);

Reference

apply_filters('fluent_support/custom_field_render_' . $fieldType, $value, $scope)

This filter is located in
fluent-support/app/Models/Ticket.php

fluent_support_ticket_custom_fields

---

This filter hook allows you to retrieve the ticket custom fields and modify them. Core returns an empty array; Fluent Support Pro fills it with the custom fields configured in the ticket form (`CustomFieldsService::getFieldLabels('admin')`). The result is used in the admin app, the ticket model, the Fluent Forms feed integration and the Pro Slack, Telegram and Discord notifications.

Parameters

• '$customFields' (array) Ticket custom fields, keyed by field slug

Usage

add_filter('fluent_support/ticket_custom_fields', function ($customFields) {
    // ...do something
    return $customFields;
}, 10, 1);

Reference

apply_filters('fluent_support/ticket_custom_fields', [])

This filter is located in
fluent-support/app/Models/Ticket.php,
fluent-support/app/Hooks/Handlers/Menu.php,
fluent-support/app/Services/Integrations/FluentForm/FeedIntegration.php,
fluent-support-pro/app/Services/Integrations/Slack/SlackNotification.php,
fluent-support-pro/app/Services/Integrations/Telegram/TelegramNotification.php,
fluent-support-pro/app/Services/Integrations/Discord/DiscordNotification.php

fluent_support_disabled_ticket_fields

---

This filter hook allows you to retrieve disable ticket fields and modify it.

Parameters

• '$fields' (array) Disable ticket fields

Usage

add_filter('fluent_support/disabled_ticket_fields', function ($fields) {
    // ...do something
    return $fields;
}, 10, 1);

Reference

apply_filters('fluent_support/disabled_ticket_fields', [])

This filter is located in
fluent-support-pro/app/Hooks/filters.php,
fluent-support/app/Http/Controllers/UploaderController.php,
fluent-support/app/Services/CustomerPortalService.php,
fluent-support/app/Services/Tickets/TicketService.php

fluent_support_create_ticket_data

---

This filter hook allows you to retrieve ticket and customer data and modify it.

Parameters

• '$ticketData' (array) Ticket data
• 'customer' (object) Customer data

Usage

add_filter('fluent_support/create_ticket_data', function ($ticketData, $customer) {
    // ...do something
    return $ticketData;
}, 10, 2);

Reference

apply_filters('fluent_support/create_ticket_data', $ticketData, $customer)

This filter is located in
fluent-support/app/Services/Tickets/TicketService.php

fluent_support_custom_field_required_before_ticket_create

---

This filter hook allows you to change the validation rules for a ticket a customer submits from the customer portal. Add a rule to make a field required, or remove one. Fluent Support Pro uses it to require the custom fields marked as required.

Parameters

• '$dataRules' (array) Validation rules, with two keys:
  • 'required_fields' (array) Field name => rule. Default ['title' => 'required', 'content' => 'required']. Custom fields use custom_data.{slug}
  • 'error_messages' (array) {field}.{rule} => message shown when the rule fails

Usage

add_filter('fluent_support/custom_field_required_before_ticket_create', function ($dataRules) {
    $dataRules['required_fields']['client_priority'] = 'required';
    $dataRules['error_messages']['client_priority.required'] = __('Please choose a priority', 'my-plugin');
    return $dataRules;
}, 10, 1);

Reference

$this->app->applyCustomFilters('custom_field_required_before_ticket_create', $dataRules)

The plugin adds the fluent_support/ prefix, so hook into fluent_support/custom_field_required_before_ticket_create.

This filter is located in
fluent-support/app/Http/Controllers/CustomerPortalController.php

fluent_support_custom_field_required_by_conditions_before_ticket_create

---

This filter hook allows you to change the validation rules for a portal ticket based on what the customer submitted, for example to require a field only for one product. It runs after `fluent_support/custom_field_required_before_ticket_create` and the product requirement setting. Fluent Support Pro uses it to drop required custom fields whose display conditions do not match.

Parameters

• '$data' (array) Rules and submitted values:
  • 'required_fields' (array) Field name => rule
  • 'error_messages' (array) {field}.{rule} => message
  • 'custom_data' (array) Submitted custom field values, keyed by slug (sanitized)
  • 'default_data' (array) Submitted ticket_title and ticket_content, plus ticket_product_id and ticket_client_priority when sent

Only required_fields and error_messages are used from the returned array. If both are missing, the ticket is rejected with an "Invalid form data submitted" error.

Usage

add_filter('fluent_support/custom_field_required_by_conditions_before_ticket_create', function ($data) {
    if ((int) ($data['default_data']['ticket_product_id'] ?? 0) === 12) {
        $data['required_fields']['custom_data.order_id'] = 'required';
        $data['error_messages']['custom_data.order_id.required'] = __('Order ID is required', 'my-plugin');
    }
    return $data;
}, 10, 1);

Reference

$this->app->applyCustomFilters('custom_field_required_by_conditions_before_ticket_create', $data)

The plugin adds the fluent_support/ prefix, so hook into fluent_support/custom_field_required_by_conditions_before_ticket_create.

This filter is located in
fluent-support/app/Http/Controllers/CustomerPortalController.php

fluent_support_previous_ticket_widgets_limit

---

This filter hook allows you to retrieve previous ticket widgets limit and modify it.

Parameters

• '$limit' (integer) Previous ticket widgets limit

Usage

add_filter('fluent_support/previous_ticket_widgets_limit', function ($limit) {
    // ...do something
    return $limit;
}, 10, 1);

Reference

apply_filters('fluent_support/previous_ticket_widgets_limit', 10)

This filter is located in
fluent-support/app/Http/Controllers/TicketController.php

fst_menu_url_base

---

This filter hook allows you to retrieve fluent support admin url base data and modify it.

Parameters

• '$urlBase' (string) Fluent support admin url base

Usage

add_filter('fst_menu_url_base', function ($urlBase) {
    // ...do something
    return $urlBase;
}, 10, 1);

Reference

$urlBase = apply_filters( 'fst_menu_url_base', admin_url('admin.php?page=fluent-support#/') )

This filter is located in
fluent-support/app/Services/Tickets/TicketStats.php

fst_quick_links

---

This filter hook allows you to retrieve list of quick links data and modify it.

Parameters

• '$quickLinks' (array) List of quick links

Usage

add_filter('fst_quick_links', function ($quickLinks) {
    // ...do something
    return $quickLinks;
}, 10, 1);

Reference

apply_filters('fst_quick_links', $quickLinks)

$quickLinks is used here as an illustrative variable to represent the raw array value found in the main filter, demonstrating the quick links data such as active tickets, total tickets, etc.

This filter is located in
fluent-support/app/Services/Tickets/TicketStats.php

fluent_support_ticket_content_before_render

---

This filter hook allows you to modify ticket content before WordPress formatting (wpautop, make_clickable, links_add_target) is applied. Use it to sanitize, transform, or enrich raw ticket HTML before it reaches the browser.

Parameters

• $content (string) The raw ticket content as stored in the database
• $ticket (object) The ticket object

Usage

add_filter('fluent_support/ticket_content_before_render', function ($content, $ticket) {
    // modify content before formatting
    return $content;
}, 10, 2);

Reference

apply_filters('fluent_support/ticket_content_before_render', $ticket->content, $ticket)

This filter is located in
fluent-support/app/Http/Controllers/TicketController.php,
fluent-support/app/Services/CustomerPortalService.php

fluent_support_ticket_content_after_render

---

This filter hook allows you to modify ticket content after WordPress formatting (wpautop, make_clickable, links_add_target) has been applied. Use it to further transform or wrap the fully formatted HTML before it is returned to the admin view or Customer Portal.

Parameters

• $content (string) The formatted ticket content after WordPress processing
• $ticket (object) The ticket object

Usage

add_filter('fluent_support/ticket_content_after_render', function ($content, $ticket) {
    // modify content after formatting
    return $content;
}, 10, 2);

Reference

apply_filters('fluent_support/ticket_content_after_render', $ticketContent, $ticket)

This filter is located in
fluent-support/app/Http/Controllers/TicketController.php,
fluent-support/app/Services/CustomerPortalService.php

fluent_support_min_serial_number

---

This filter hook allows you to programmatically override the minimum public ticket serial number. The value returned sets the floor for the next serial number Fluent Support assigns — if the highest existing serial number is already above your value, the next number will still increment from there.

Parameters

• $minNumber (int) The minimum serial number from Global Settings

Usage

add_filter('fluent_support/min_serial_number', function ($minNumber) {
    return 5000; // force serial numbers to start at 5000 at minimum
}, 10, 1);

Reference

apply_filters('fluent_support/min_serial_number', $minNumber)

This filter is located in
fluent-support/app/Models/Ticket.php

fluent_support_ticket_prefix

---

This filter hook allows you to override the public ticket number prefix on a per-ticket or per-product basis. The prefix is prepended to the serial number to form the display ticket number (e.g., `FS-1042`). Return an empty string to suppress the prefix for a specific ticket or product.

Parameters

• $prefix (string) The global prefix from Global Settings (may be empty)
• $ticket (object|null) The ticket object, or null when called outside a ticket context
• $productId (int|null) The product ID of the ticket, or null if no product is assigned

Usage

add_filter('fluent_support/ticket_prefix', function ($prefix, $ticket, $productId) {
    // assign a different prefix per product
    $prefixes = [
        12 => 'BIL-',
        15 => 'TEC-',
    ];
    return $prefixes[$productId] ?? $prefix;
}, 10, 3);

Reference

apply_filters('fluent_support/ticket_prefix', $prefix, $ticket, $productId)

This filter is located in
fluent-support/app/Models/Ticket.php

fluent_support_widgets_by_name

---

This filter hook allows you to register a custom widget for the `GET widgets` REST endpoint. `{name}` is the requested widget/filter name (the `filter` request parameter, e.g. `ticket_sidebar`).

Parameters

• $widgets (array) Widget payload to return — default []
• $data (array) Sanitized request data. For ticket_sidebar, includes a loaded ticket (with its customer relation)

Usage

add_filter('fluent_support/widgets/ticket_sidebar', function ($widgets, $data) {
    $widgets[] = [
        'title' => 'My Widget',
        'content' => 'Hello ' . $data['ticket']->customer->full_name,
    ];
    return $widgets;
}, 10, 2);

Note: {name} is sanitized to [a-zA-Z0-9_\-]+ before the filter is built, and any leading fluent_support_ in the requested name is stripped first.

Reference

apply_filters('fluent_support/widgets/' . $filter, [], $data)

This filter is located in
fluent-support/app/Http/Controllers/WidgetsController.php

fluent_support_ticket_source_filter_options

---

This filter hook allows you to change the ticket sources offered by the advanced filter's Source field (Fluent Support Pro) and the workflow "Ticket Source" condition. Add an entry for a custom source you write to `fs_tickets.source`. The `__none__` key matches tickets with no recorded source (older tickets); it is left out of the workflow condition.

Parameters

• '$options' (array) Source slug => label. Defaults: web, email, agent_initiated, mcp, telegram, slack, whatsapp, awesome-support, freshdesk, helpscout, js-helpdesk, support-candy, zendesk, __none__

Usage

add_filter('fluent_support/ticket_source_filter_options', function ($options) {
    $options['my_chat_widget'] = __('Chat widget', 'my-plugin');
    return $options;
}, 10, 1);

Reference

apply_filters('fluent_support/ticket_source_filter_options', $options)

This filter is located in
fluent-support/app/Models/Ticket.php

fluent_support_ticket_close_activity_source

---

This filter hook allows you to mark a ticket close as a system event when an agent's reply closes the ticket. Return `automatic` or `automation` and the activity line reads as a system event instead of something the replying agent did. Fluent Support Pro uses it for inactive-ticket auto-close.

Available since Fluent Support 2.4.7.

Parameters

• '$source' (string) Empty for a close by the person replying
• '$ticket' (object) Ticket object

Usage

add_filter('fluent_support/ticket_close_activity_source', function ($source, $ticket) {
    if (defined('MY_PLUGIN_CLOSING_TICKETS')) {
        return 'automation';
    }
    return $source;
}, 10, 2);

Reference

apply_filters('fluent_support/ticket_close_activity_source', '', $ticket)

This filter is located in
fluent-support/app/Services/Tickets/TicketService.php

fluent_support_contact_search_partial_allowed

---

This filter hook allows you to decide whether the current agent may search contacts by part of a name or email when creating a ticket for a customer. By default only agents with the `fst_sensitive_data` permission can. Other agents find a customer by their full email address only. Support staff and administrators are never offered as contacts.

Available since Fluent Support 2.4.7.

Parameters

• '$allowed' (boolean) Whether the agent has the fst_sensitive_data permission

Usage

add_filter('fluent_support/contact_search_partial_allowed', function ($allowed) {
    return $allowed || current_user_can('manage_options');
}, 10, 1);

Reference

apply_filters('fluent_support/contact_search_partial_allowed', PermissionManager::currentUserCan('fst_sensitive_data'))

This filter is located in
fluent-support/app/Modules/Customers/CustomerController.php

fluent_support_tickets_list

---

This filter hook allows you to modify a page of the admin ticket list before it is returned.

Parameters

• '$tickets' (object) Paginated tickets (LengthAwarePaginator)

Usage

add_filter('fluent_support/tickets_list', function ($tickets) {
    // ...do something
    return $tickets;
}, 10, 1);

Reference

apply_filters('fluent_support/tickets_list', $tickets)

This filter is located in
fluent-support/app/Http/Controllers/TicketController.php

fluent_support_ticket_view_data

---

This filter hook allows you to modify the data returned for the single ticket screen in the admin.

Parameters

• '$data' (array) Ticket view response: ticket, responses, agent_id and, when present, watchers and fluentcrm_profile
• '$ticket' (object) The viewed ticket
• '$scheduledRows' (object) Unsent scheduled replies (Collection), kept out of responses

Usage

add_filter('fluent_support/ticket_view_data', function ($data, $ticket, $scheduledRows) {
    // ...do something
    return $data;
}, 10, 3);

Reference

apply_filters('fluent_support/ticket_view_data', $data, $ticket, $scheduledRows)

This filter is located in
fluent-support/app/Http/Controllers/TicketController.php

fluent_support_custom_field_labels

---

This filter hook supplies the ticket custom field definitions used by `Ticket::customData()`. Fluent Support Pro answers it; without Pro it returns an empty array and tickets have no custom data.

Parameters

• '$fields' (array) Custom field definitions keyed by field slug
• '$scope' (string) admin or public (customer portal)

Usage

add_filter('fluent_support/custom_field_labels', function ($fields, $scope) {
    // ...do something
    return $fields;
}, 10, 2);

Reference

apply_filters('fluent_support/custom_field_labels', [], $scope)

This filter is located in
fluent-support/app/Models/Ticket.php

fluent_support_custom_fields_rendered

---

This filter hook supplies the rendered custom fields shown in the admin ticket sidebar. Fluent Support Pro answers it.

Parameters

• '$renderedFields' (array) Rendered custom fields
• '$customer' (object) The ticket's customer
• '$scope' (string) Always admin here

Usage

add_filter('fluent_support/custom_fields_rendered', function ($renderedFields, $customer, $scope) {
    // ...do something
    return $renderedFields;
}, 10, 3);

Reference

apply_filters('fluent_support/custom_fields_rendered', [], $ticket->customer, 'admin')

This filter is located in
fluent-support/app/Http/Controllers/TicketController.php

fluent_support_schedule_response

---

This filter hook schedules an agent reply instead of sending it, when the reply request contains `scheduled_at`. Fluent Support Pro answers it; if nothing returns response data, the request fails with "Scheduling replies needs Fluent Support Pro."

Parameters

• '$responseData' (array|null) null until a handler schedules the reply; return the response data
• '$data' (array) The reply payload
• '$agent' (object) The replying agent
• '$ticket' (object) Ticket data
• '$scheduledAt' (int) Unix timestamp to send at

Usage

add_filter('fluent_support/schedule_response', function ($responseData, $data, $agent, $ticket, $scheduledAt) {
    // ...do something
    return $responseData;
}, 10, 5);

Reference

apply_filters('fluent_support/schedule_response', null, $data, $agent, $ticket, $scheduledAt)

This filter is located in
fluent-support/app/Http/Controllers/ResponseController.php