Hooks Filters

Woo Sell Services provides actions and filters for customizing behavior without modifying plugin files. Use these hooks in your theme’s functions.php or a custom plugin.

Actions — Order Workflow

Hook	Parameters	Purpose
wbcom_wss_order_status_updated	$order_id, $new_status, $old_status	Service order status changes
wss_order_requirement_submitted	$order_id, $order, $item_id, $pid, $product, $vendor_id	Customer submits requirements
wss_order_meta_update_requirement_save	$order_id, $item_id, $_POST, $pid, $urls	Requirement data saved to order meta
wss_after_order_conversation	$order_id, $order, $item_id, $product_id, $product, $sender_id, $recipient_id, $attachment	New conversation message sent
wss_final_delivery	$order_id, $order, $item_id, $product_id, $product	Vendor submits final delivery
wss_accept_final_delivery	$order_id, $order, $item_id, $product_id, $product, $sender_id, $recipient_id	Customer accepts delivery
wss_reject_final_delivery	$order_id, $order, $item_id, $product_id, $product, $sender_id, $recipient_id	Customer rejects delivery
wss_after_review_submitted	$product_id, $author_id, $order, $customers, $comment, $ratings	Review submitted
woo_sell_before_redirect_to_service	$order_id	Before post-purchase redirect

Actions — Display (Service Order Page)

Hook	Parameters	Purpose
before_wss_service_info_section	$order_id	Before service info section
after_wss_service_info_section	$order_id	After service info section
before_wss_requirement_data_section	$order_id	Before requirements section
after_wss_requirement_data_section	$order_id	After requirements section
after_wss_requirement_data_display	—	After filled requirements display
before_wss_conversation_section	—	Before conversation section
before_wss_conversation_form_wrapper	$order_id	Before conversation form
before_wss_display_single_conversation	—	Before individual message display
after_wss_display_single_conversation	—	After individual message display
after_wss_conversation_section	$order_id	After conversation section
wss_add_custom_message_after_conversation	$order_id	Custom message area after conversation
before_wss_vendor_rating	—	Before vendor rating section
before_wss_review_form	—	Before review form
before_wss_final_wrapper	—	Before final page wrapper
after_wss_single_content	—	After all single order content

Actions — Requirement Form Template

Hook	Purpose
before_wss_order_requirements_section	Before requirement form
after_wss_requirement_form_fields	After form fields, before submit
after_wss_order_requirements_section	After requirement form

Actions — Filled Requirements Display

Hook	Purpose
before_wss_display_filled_single_requirement	Before filled requirement display
after_wss_display_filled_single_requirement	After filled requirement display

Actions — Customer/Vendor Order Lists

Hook	Parameters	Purpose
wss_before_customer_manage_orders	—	Before customer orders list
wss_after_customer_manage_orders	—	After customer orders list
wss_before_vendor_manage_orders	—	Before vendor orders list
wss_after_vendor_manage_orders	—	After vendor orders list
wss_add_column_heading_in_order_table	—	Add custom column headings
wss_add_column_in_order_table	$item	Add custom column data
wss-add-tab-woo-service-status	—	Add custom tab to status widget
wss_after_account_services_pagination	—	After order list pagination

Actions — Notifications

Hook	Purpose
before_wss_notifications_table	Before notifications table
after_wss_notifications_table	After notifications table
before_wss_notifications_pagination	Before notification pagination
after_wss_notifications_pagination	After notification pagination
before_wss_no_notifications_message	Before “no notifications” message
after_wss_no_notifications_message	After “no notifications” message

Actions — Subscription Service Page

Hook	Parameters	Purpose
before_wss_subscription_service_info_section	$status, $subscription_id	Before subscription info
after_wss_subscription_service_info_section	$status, $subscription_id	After subscription info
wss_between_header_product_info_container	—	Between header and product info
wss_before_sell_product	—	Before product display
after_wss_sell_product	—	After product display
after_wss_conversation_container	—	After subscription conversation

Actions — User Status

Hook	Parameters	Purpose
woo_sell_service_before_display_user_status	$user_id	Before online status badge
woo_sell_service_after_display_user_status	$user_id	After online status badge

Actions — Settings and Multi-Vendor

Hook	Purpose
wbwss_add_general_setting_options	Add custom fields to settings page
wss_dokan_vender_order	Dokan vendor order page
wss_wcfm_vender_order	WCFM vendor order page

Filters — Role and Access Control

Filter	Parameters	Purpose
wss_allowed_vendors	$roles	Override vendor roles
wss_allowed_customers	$roles	Override customer roles
woo_sell_services_is_product_author	$user_id, $product_id	Override product author check
woo_sell_service_conversation	$bool, $status, $item_id, $order_id	Control conversation access

add_filter( 'wss_allowed_vendors', function( $roles ) {
    $roles[] = 'freelancer';
    return $roles;
} );

Filters — Display Customization

Filter	Parameters	Purpose
woo_sell_service_user_online_status	$status, $user_id	Override online/offline status
wss_service_widget_statuses	$statuses	Customize status widget items
wbcom_wss_order_statuses	$statuses	Customize order statuses
wss_filter_service_price	$price, $product_id	Override price display
wss_conversation_heading	$heading	Override conversation heading
wss_order_started_heading	$heading	Override order started heading
wss_order_requirement_heading	$heading	Override requirements heading
wss_order_completed_heading	$heading	Override order completed heading
wss_filter_order_review_heading	$heading	Override review section heading
wss_notification_message	$message, $notification	Override notification text
wss_single_error_message	$message	Override access error message
wss_add_column_heading_in_order_table	$columns	Filter order table column headings

Filters — URLs, Pages, and Redirect

Filter	Parameters	Purpose
wss_services_page	$url	Override service page URL
woo_sell_redirect_to_service	$should_redirect, $order_id	Control post-purchase redirect
wcfm_services_provider_url	$url	Override WCFM provider page URL

Filters — Queries and Data

Filter	Parameters	Purpose
wss_customer_manage_service_arguments	$args	Filter customer order query args
wss_order_level_co_author_arguments	$args	Filter co-author query args
wss_get_meta_data_orders_for_vendors	$query, $ids	Filter vendor order meta query
wss_post_id_query	$query, $user_id	Filter post ID query
wss_order_item_data_query	$query	Filter order item data query
wss_single_order_conversation_query_product_author	$query, $table, $author_ids, $order_id, $item_id	Filter conversation query
wss_order_args_auto_complete_service_order	$args, $statuses	Filter auto-complete order query args
wss_conversation_query_auto_complete_service_order	$query, $order_id, $item_id	Filter auto-complete conversation query

Filters — Notifications and Cron

Filter	Parameters	Purpose
wss_cron_notification_args	$args, $notification_setting	Filter cron notification query args
wss_cron_hpos_notification_args	$args, $notification_setting	Filter HPOS cron notification args
wss_customer_notification	$setting_value	Filter notification interval setting
wss_notifications_user	$user_id	Override notification user
wss_live_notification_title	$title	Filter live popup notification title
wss_live_notification_content	$content, $notification	Filter live popup notification content
wss_live_notification_response	$response, $notification	Filter live notification response

Filters — Technical

Filter	Parameters	Purpose
wss_get_allowed_mime_types	$mime_types	Filter allowed upload MIME types
wss_public_localized_params	$params	Filter JavaScript localized parameters
wss_notifications_per_page	$per_page	Change notifications pagination count
wb_wss_get_public_template	$path, $template, $args	Override template file path
wss_set_template_public_path	$path, $template, $args	Override template public path
woo_sell_services_addon_template_path	$path	Override theme template directory
wss_enable_submit_requirement_email	$bool	Control requirement email sending
wss_hide_subscription_renewal_order	$bool	Hide renewal orders from service lists
wss_wp_editor_buttons	$buttons, $editor_id	Filter conversation editor toolbar buttons
woo_sell_service_guest_checkout_notice	$message, $order_id	Customize guest checkout warning

// Allow SVG uploads in conversations
add_filter( 'wss_get_allowed_mime_types', function( $types ) {
    $types['svg'] = 'image/svg+xml';
    return $types;
} );