Hooks and Filters Reference

WP Sell Services exposes action hooks and filter hooks throughout its codebase. Every hook listed here is verified in the source code with file location and parameters.

Using Hooks

// Actions execute code at specific points
add_action( 'wpss_order_status_changed', 'my_func', 10, 3 );
function my_func( $order_id, $new_status, $old_status ) {
    // Your code here
}

// Filters modify data before it is used
add_filter( 'wpss_review_window_days', fn( $days ) => 14 );

Plugin Lifecycle Actions

Hook	Parameters	File
`wpss_loaded`	`Plugin $plugin`	`Plugin.php:261`
`wpssadapterinitialized`	`EcommerceAdapterInterface $adapter`	`IntegrationManager.php:124`
`wpssregisterfield_types`	`FieldManager $manager`	`FieldManager.php:59`
`wpsswoocommerceadapter_init`	`WooCommerceAdapter $adapter`	`WooCommerceAdapter.php:162`

wpss_loaded is the primary extension hook. All Pro features register here:

add_action( 'wpss_loaded', function( $plugin ) {
    // Plugin is ready - register extensions
}, 10, 1 );

Service Actions

Hook	Parameters	File
`wpssservicecreated`	`int $post_id, array $data`	`ServiceManager.php:144`
`wpssserviceupdated`	`int $service_id, array $data`	`ServiceManager.php:225`
`wpssbeforeservice_deleted`	`int $service_id`	`ServiceManager.php:259`
`wpssservicemeta_saved`	`int $postid, WPPost $post`	`ServiceMetabox.php:1052`
`wpssrestservice_created`	`int $serviceid, WPREST_Request $request`	`ServicesController.php:321`
`wpssrestservice_updated`	`int $serviceid, WPREST_Request $request`	`ServicesController.php:386`
`wpssrestservice_deleted`	`int $service_id, bool $force`	`ServicesController.php:431`
`wpssservicesyncedtowc_product`	`int $serviceid, int $productid`	`WCProductProvider.php:454`

Moderation Actions

Hook	Parameters	File
`wpssserviceapproved`	`int $service_id, string $notes`	`ModerationService.php:181`
`wpssservicerejected`	`int $service_id, string $reason`	`ModerationService.php:233`
`wpssservicepending_moderation`	`int $service_id`	`ModerationService.php:273`

Order Actions

Hook	Parameters	File
`wpssorderstatus_changed`	`int $orderid, string $newstatus, string $old_status`	`OrderService.php:196`
`wpssorderstatus_{status}`	`int $orderid, string $oldstatus`	`OrderService.php:197`
`wpssordercreated`	`int $order_id, string $status`	`ManualOrderPage.php:716`
`wpssorderaccepted`	`int $order_id`	`OrdersController.php:564`
`wpssorderrejected`	`int $order_id, string $reason`	`OrdersController.php:582`
`wpssorderstarted`	`int $order_id`	`OrdersController.php:598`
`wpssorderdelivered`	`int $order_id`	`OrdersController.php:613`
`wpssordercompleted`	`int $order_id, object $order`	`OrderWorkflowManager.php:685`
`wpssordercancelled`	`int $orderid, int $userid, string $reason`	`OrderService.php:427`
`wpssorderdisputed`	`int $orderid, int $openedby, string $reason`	`OrdersController.php:670`
`wpssordermessage_created`	`int $messageid, int $orderid, int $user_id`	`OrdersController.php:406`
`wpssorderrequirements_submitted`	`int $order_id, array $requirements`	`OrdersController.php:839`
`wpssafterstatuschangenotification`	`int $orderid, string $newstatus, string $old_status`	`OrderWorkflowManager.php:638`
`wpsssendrequirementsreminderemail`	`int $orderid, int $remindernum, string $message`	`OrderWorkflowManager.php:338`
`wpssrequirementstimeout`	`int $orderid, bool $autostart`	`OrderWorkflowManager.php:472`
`wpssaftercheckout_process`	`int $orderid, array $orderdata`	`WCCheckoutProvider.php:332`

Delivery Actions

Hook	Parameters	File
`wpssdeliverysubmitted`	`int $deliveryid, int $orderid`	`DeliveryService.php:127`
`wpssdeliveryaccepted`	`int $order_id`	`DeliveryService.php:168`
`wpssrevisionrequested`	`int $order_id, string $reason`	`DeliveryService.php:234`
`wpssrequirementssubmitted`	`int $orderid, array $fielddata, array $attachments`	`RequirementsService.php:461`

Vendor Actions

Hook	Parameters	File
`wpssvendorregistered`	`int $userid, array $profiledata`	`VendorService.php:131`
`wpssvendorprofile_updated`	`int $userid, array $filtereddata`	`VendorService.php:250`
`wpssvendorvacationmodechanged`	`int $user_id, bool $enabled, string $message`	`VendorService.php:299`
`wpssvendortier_changed`	`int $user_id, string $tier`	`VendorService.php:340`
`wpssvendorlevel_promoted`	`int $userid, string $newlevel, string $current_level`	`OrderWorkflowManager.php:539`
`wpssvendorlevel_updated`	`int $user_id, string $level`	`SellerLevelService.php:299`
`wpssvendorstatus_updated`	`int $vendor_id, string $status`	`VendorsPage.php:1583`
`wpssvendorcommission_updated`	`int $vendor_id, float $rate`	`VendorsPage.php:1884`
`wpssvendorcontacted`	`int $vendorid, int $userid, int $service_id, string $message, array $attachments`	`AjaxHandlers.php:2052`

Financial Actions

Hook	Parameters	File
`wpsscommissionrecorded`	`int $orderid, array $commission, int $vendorid`	`CommissionService.php:116`
`wpsswithdrawalrequested`	`int $withdrawalid, int $vendorid, float $amount`	`EarningsService.php:344`
`wpsswithdrawalprocessed`	`int $withdrawal_id, string $status, object $withdrawal`	`EarningsService.php:489`
`wpssautowithdrawal_created`	`int $withdrawalid, int $vendorid, float $amount`	`EarningsService.php:866`
`wpsstipsent`	`int $tipid, int $orderid, int $vendorid, int $customerid, float $amount, string $message`	`TippingService.php:171`

Dispute Actions

Hook	Parameters	File
`wpssdisputeopened`	`int $disputeid, int $orderid, int $opened_by, array $data`	`DisputeService.php:132`
`wpssdisputeevidence_added`	`int $disputeid, int $userid`	`DisputeService.php:248`
`wpssdisputestatus_changed`	`int $disputeid, string $status, string $oldstatus`	`DisputeService.php:334`
`wpssdisputeresolved`	`int $disputeid, string $resolution, object $dispute, float $refundamount`	`DisputeService.php:400`
`wpssdisputeresponse_submitted`	`int $messageid, int $disputeid, int $user_id`	`DisputeWorkflowManager.php:193`
`wpssdisputeescalated`	`int $disputeid, string $reason, int $escalatedby`	`DisputeWorkflowManager.php:321`
`wpssdisputecancelled`	`int $disputeid, int $userid, string $reason`	`DisputeWorkflowManager.php:463`

Review, Request, and Proposal Actions

Hook	Parameters	File
`wpssreviewcreated`	`int $reviewid, int $orderid`	`ReviewService.php:120`
`wpssreviewreply_created`	`int $review_id`	`ReviewsController.php:542`
`wpssbuyerrequest_created`	`int $post_id, array $data`	`BuyerRequestService.php:112`
`wpssbuyerrequest_updated`	`int $request_id, array $data`	`BuyerRequestService.php:164`
`wpssbuyerrequeststatuschanged`	`int $requestid, string $status, string $oldstatus`	`BuyerRequestService.php:425`
`wpssrequestconvertedtoorder`	`int $orderid, int $requestid, int $proposal_id, object $request, object $proposal`	`BuyerRequestService.php:704`
`wpssproposalsubmitted`	`int $proposalid, int $requestid, int $vendorid, array $proposaldata`	`ProposalService.php:136`
`wpssproposalupdated`	`int $proposalid, array $updatedata`	`ProposalService.php:229`
`wpssproposalaccepted`	`int $proposal_id, object $proposal, object $request`	`ProposalService.php:283`
`wpssproposalrejected`	`int $proposal_id, object $proposal, string $reason`	`ProposalService.php:331`
`wpssproposalwithdrawn`	`int $proposal_id, object $proposal`	`ProposalService.php:373`
`wpssproposaldeleted`	`int $proposal_id, object $proposal`	`ProposalService.php:665`

Milestone and Extension Actions

Hook	Parameters	File
`wpssmilestonecreated`	`int $milestoneid, int $orderid, array $milestone`	`MilestoneService.php:111`
`wpssmilestonesubmitted`	`int $milestoneid, int $orderid`	`MilestoneService.php:263`
`wpssmilestoneapproved`	`int $milestoneid, int $orderid, float $amount`	`MilestoneService.php:311`
`wpssmilestonerejected`	`int $milestoneid, int $orderid, string $feedback`	`MilestoneService.php:360`
`wpssextensionrequest_created`	`int $requestid, int $orderid, array $data`	`ExtensionRequestService.php:246`
`wpssextensionrequest_approved`	`int $request_id, object $request`	`ExtensionRequestService.php:363`
`wpssextensionrequest_rejected`	`int $request_id, object $request`	`ExtensionRequestService.php:447`

Other Actions

Hook	Parameters	File
`wpssmessagesent`	`object $message, object $conversation`	`ConversationService.php:223`
`wpssnotificationcreated`	`int $notificationid, int $userid, string $type, array $data`	`NotificationService.php:80`
`wpssportfolioitem_created`	`int $itemid, int $vendorid, array $data`	`PortfolioService.php:194`
`wpssportfolioitem_updated`	`int $item_id, array $data`	`PortfolioService.php:289`
`wpssportfolioitem_deleted`	`int $item_id, object $item`	`PortfolioService.php:339`
`wpssaddoncreated`	`int $addonid, int $serviceid, array $addon_data`	`ServiceAddonService.php:143`
`wpssaddonupdated`	`int $addonid, array $updatedata`	`ServiceAddonService.php:229`
`wpssaddondeleted`	`int $addon_id, object $addon`	`ServiceAddonService.php:353`
`wpsssettingstab_{tab}`	(none)	`Settings.php:985`
`wpssadvancedsettings_sections`	(none)	`Settings.php:1317`

Filters

Provider Registration

Filter	File	Default
`wpssecommerceadapters`	`IntegrationManager.php:67`	WooCommerce only
`wpsspaymentgateways`	`Plugin.php:813`	Test gateway (debug)
`wpsswalletproviders` [PRO]	`Plugin.php:825`	Empty
`wpssstorageproviders` [PRO]	`Plugin.php:837`	Empty
`wpssemailproviders` [PRO]	`Plugin.php:849`	Empty
`wpssanalyticswidgets` [PRO]	`Plugin.php:861`	Empty

Service Wizard Limits

Filter	File	Free Default
`wpssservicemax_packages`	`ServiceWizard.php:116`	3
`wpssservicemax_gallery`	`ServiceWizard.php:126`	4
`wpssservicemax_videos`	`ServiceWizard.php:136`	1
`wpssservicemax_extras`	`ServiceWizard.php:146`	3
`wpssservicemax_faq`	`ServiceWizard.php:156`	5
`wpssservicemax_requirements`	`ServiceWizard.php:166`	5
`wpssservicewizard_features`	`ServiceWizard.php:175`	All false

Data Filters

Filter	Parameters	File
`wpssformatprice`	`$formatted, $price, $currency`	`functions.php:68`
`wpss_currency`	`$currency`	`functions.php:91`
`wpssplatformname`	`$platform_name`	`functions.php:117`
`wpssisvendor`	`$isvendor, $userid`	`functions.php:331`
`wpssordernumber_prefix`	`$prefix` (default `'WPSS-'`)	`functions.php:385`
`wpssdisputenumber_prefix`	`$prefix` (default `'DSP-'`)	`functions.php:397`
`wpsscurrencysymbols`	`$symbols`	`functions.php:490`
`wpsscurrencyformat`	`$format, $symbol, $currency`	`functions.php:517`
`wpss_currencies`	`$currencies`	`functions.php:564`
`wpssorderstatuses`	`$statuses`	`functions.php:620`
`wpssmaxupload_size`	`$upload_max`	`functions.php:834`
`wpssallowlaterequirementssubmission`	`$allow_late`	`functions.php:888`
`wpsswalletmanager`	`null`	`functions.php:1029`

Template Filters

Filter	Parameters	File
`wpssgettemplate_part`	`$template, $slug, $name`	`functions.php:165`
`wpssgettemplate`	`$template, $template_name, $args`	`functions.php:211`
`wpsslocatetemplate`	`$template, $templatename, $templatepath`	`TemplateLoader.php:318`
`wpssdashboardsection_template`	`$template_path, $section`	`UnifiedDashboard.php:418`

URL and Taxonomy Filters

Filter	Parameters	File
`wpssserviceslug`	`$slug` (default `'service'`)	`ServicePostType.php:184`
`wpssbuyerrequest_slug`	`$slug` (default `'buyer-request'`)	`BuyerRequestPostType.php:112`
`wpssserviceposttypeargs`	`$args`	`ServicePostType.php:106`
`wpssservicetag_args`	`$args`	`ServicePostType.php:168`
`wpssservicecategorytaxonomyargs`	`$args`	`ServiceCategoryTaxonomy.php:118`
`wpssservicetagtaxonomyargs`	`$args`	`ServiceTagTaxonomy.php:103`
`wpssbuyerrequestposttype_args`	`$args`	`BuyerRequestPostType.php:96`

Order, Commission, and API Filters

Filter	Parameters	File
`wpssorderstatus_transitions`	`$transitions, $from, $to`	`OrderService.php:290`
`wpsscommissionrate`	`$rate, $order, $vendorid, $serviceid`	`CommissionService.php:163`
`wpssproposalorder_revisions`	`$revisions, $proposal, $request`	`BuyerRequestService.php:628`
`wpssmaxorder_quantity`	`$max`	`SingleServiceView.php:743`
`wpssapicontrollers`	`$controllers`	`API.php:76`
`wpssapipublic_settings`	`$settings`	`API.php:346`
`wpssbatchmax_requests`	`$max` (default 25)	`API.php:571`
`wpssapicors_origins`	`$origins`	`API.php:641`
`wpsssettingstabs`	`$tabs`	`Settings.php:161`
`wpss_blocks`	`$blocks`	`BlocksManager.php:93`
`wpssratelimits`	`$limits, $action`	`RateLimiter.php:243`

Miscellaneous Filters

Filter	Parameters	File
`wpssreviewwindow_days`	`$days`	`ReviewService.php:420`
`wpssautoapprove_reviews`	`$auto_approve` (default true)	`ReviewsController.php:350`
`wpssvendorregistration_open`	`$open` (default true)	`VendorsController.php:380`
`wpssautoapprove_vendors`	`$auto_approve` (default true)	`VendorsController.php:390`
`wpssdeliveryallowedfiletypes`	`$types`	`DeliveryService.php:374`
`wpssrequirementsallowedfiletypes`	`$types`	`RequirementsService.php:411`
`wpsswithdrawalmethods`	`$methods`	`EarningsService.php:575`
`wpsssearchresults`	`$results, $query, $args`	`SearchService.php:121`
`wpsssearchsuggestions`	`$suggestions, $query`	`SearchService.php:498`
`wpssrelatedservices_args`	`$args, $service`	`SingleServiceView.php:647`
`wpsscartcheckout`	`$result, $cart, $userid, $paymentmethod`	`CartController.php:378`
`wpssavailablepayment_methods`	`$methods`	`CartController.php:395`
`wpsssellerlevels`	`$levels`	`SellerLevelsController.php:284`
`wpssrestservice_data`	`$data, $service, $request`	`ServicesController.php:608`
`wpsscanaccessdashboardsection`	`$allowed, $section, $user_id`	`UnifiedDashboard.php:173`
`wpssdashboardsections`	`$sections, $userid, $isvendor`	`UnifiedDashboard.php:243`
`wpssdashboardsection_titles`	`$titles`	`UnifiedDashboard.php:371`
`wpssservicetowcstatus_map`	`$statusmap, $newstatus, $old_status`	`WooCommerceAdapter.php:388`

SEO and Email Filters

Filter	Parameters	File
`wpssserviceschema`	`$schema, $service_id`	`SchemaMarkup.php:183`
`wpssservicelist_schema`	`$schema`	`SchemaMarkup.php:221`
`wpsscategoryschema`	`$schema, $term`	`SchemaMarkup.php:280`
`wpsspersonschema`	`$schema, $user_id`	`SchemaMarkup.php:328`
`wpssvendorpage_schema`	`$schema, $user_id`	`SchemaMarkup.php:375`
`wpssorganizationschema`	`$schema`	`SchemaMarkup.php:406`
`wpssopengraph_data`	`$data, $service_id`	`SEO.php:257`
`wpsssitemappost_types`	`$post_types`	`SEO.php:321`
`wpss_breadcrumbs`	`$breadcrumbs, $service_id`	`SEO.php:387`
`wpssnotificationemail_content`	`$content, $subject, $user_id, $data`	`NotificationService.php:1195`
`wpssvendorwelcomeemailcontent`	`$content, $user, $platform_name`	`NotificationService.php:994`
`wpssadminvendornotificationcontent`	`$content, $user`	`NotificationService.php:1049`
`wpssemaildata`	`$email`	`EmailService.php:642`

Hooks & Filters Reference