Recovero icon
eCommerce & WooCommerce

Recovero hooks reference

Recovero 1.3.0 has 33 actions and 60 filters, read directly from its source code on Nov 19, 2026. The list updates automatically when a new version is released.

How to use these hooks

Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.

functions.phpyour child theme
// Run your own code when Recovero fires an action
add_action( 'ppl_acrw_cart_recovered', function( $cart_id, $data ) {
	// Your code runs here.
}, 10, 2 );

// Change a value Recovero is about to use
add_filter( 'ppl_acrw_rate_limit', function( $value, $arg2 ) {
	// Change $value here.
	return $value;
}, 10, 2 );

Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.

All hooks

  • includes/carts/class-ppl-acrw-cart-service.php line 178 · used in 2 places
    /**
     * Fires when a cart is marked recovered.
     */
    do_action( 'ppl_acrw_cart_recovered', $cart_id, $data );
  • includes/core/class-ppl-acrw-rate-limit.php line 38 · used in 2 places
    /**
     * Filters the number of requests a client may make to a public endpoint within
     * its window. Return 0 to switch the limit off.
     */
    apply_filters( 'ppl_acrw_rate_limit', (int) $limit, (string) $bucket );
  • includes/templates/class-ppl-acrw-template-renderer.php line 196 · used in 2 places
    /**
     * This filter is documented below.
     */
    apply_filters( 'ppl_acrw_render_replacements', $map, $cart, $context );
  • includes/carts/class-ppl-acrw-cart-service.php line 105
    /**
     * Filters the maximum number of carts processed per abandonment sweep.
     */
    apply_filters( 'ppl_acrw_abandon_batch_size', 100 );
  • includes/core/class-ppl-acrw-install.php line 61
    /**
     * Fires after the plugin finishes activating.
     */
    do_action( 'ppl_acrw_activated' );
  • includes/admin/class-ppl-acrw-admin-service.php line 109
    /**
     * Filters the capability required to access the admin area.
     */
    apply_filters( 'ppl_acrw_admin_capability', 'ppl_acrw_manage_carts' );
  • includes/admin/class-ppl-acrw-admin-service.php line 93
    /**
     * Fires after the admin menu is registered, allowing add ons to add their own
     * submenus under the Cart Recovery menu.
     */
    do_action( 'ppl_acrw_admin_menu', $cap );
  • includes/campaigns/class-ppl-acrw-campaigns-service.php line 132
    /**
     * Filters an amount converted from a shopper currency to the store base
     * currency, for currency switchers that use their own rates.
     */
    apply_filters( 'ppl_acrw_amount_to_base_currency', $converted, $amount, $currency, $base );
  • includes/rest/class-ppl-acrw-rest-service.php line 349
    /**
     * Fires after the capture beacon processes a request.
     */
    do_action( 'ppl_acrw_beacon_captured', $cart_id, $contact );
  • includes/carts/class-ppl-acrw-cart-service.php line 204
    /**
     * Fires before a cart and its related rows are deleted.
     */
    do_action( 'ppl_acrw_before_cart_deleted', $cart_id );
  • includes/recovery/class-ppl-acrw-recovery-service.php line 317
    /**
     * Fires when a recovery link is opened, before the cart is restored.
     */
    do_action( 'ppl_acrw_before_recover', $cart, $token );
  • includes/templates/class-ppl-acrw-template-renderer.php line 358
    /**
     * Filters the block type registry.
     */
    apply_filters( 'ppl_acrw_block_defaults', $defaults );
  • includes/templates/class-ppl-acrw-template-renderer.php line 330
    /**
     * Filters the block types offered in the builder palette.
     */
    apply_filters( 'ppl_acrw_builder_palette_types', $types );
  • includes/templates/class-ppl-acrw-template-renderer.php line 295
    /**
     * Filters the label on the primary recovery button.
     */
    apply_filters( 'ppl_acrw_button_label', __( 'Complete your order', 'recovero-cart-recovery-for-woocommerce' ) );
  • includes/campaigns/class-ppl-acrw-campaigns-service.php line 172
    /**
     * Filters whether a campaign matches a cart, enabling custom segmentation
     * rules.
     */
    apply_filters( 'ppl_acrw_campaign_matches', $pass, $campaign, $cart, $conditions );
  • includes/campaigns/class-ppl-acrw-campaigns-service.php line 286
    /**
     * Fires after a campaign and its steps are saved.
     */
    do_action( 'ppl_acrw_campaign_saved', $id, $data, $steps );
  • includes/queue/class-ppl-acrw-queue-service.php line 278
    /**
     * Fires after steps added to a live campaign are queued for carts that were
     * already in its sequence.
     */
    do_action( 'ppl_acrw_campaign_steps_backfilled', $campaign_id, $added );
  • includes/frontend/class-ppl-acrw-frontend-service.php line 188
    /**
     * Filters the capture script configuration passed to the frontend.
     */
    apply_filters( 'ppl_acrw_capture_config', $config );
  • includes/carts/class-ppl-acrw-capture-service.php line 211
    /**
     * Filters the minimum seconds between passive capture writes for a session
     * during ordinary browsing.
     */
    apply_filters( 'ppl_acrw_capture_debounce', 60 );
  • includes/rest/class-ppl-acrw-rest-service.php line 156
    /**
     * Filters the public capture permission result.
     */
    apply_filters( 'ppl_acrw_capture_permission', $allowed, $request );
  • includes/carts/class-ppl-acrw-capture-service.php line 135
    /**
     * Fires after the capture service is wired up.
     */
    do_action( 'ppl_acrw_capture_registered', $this );
  • includes/frontend/class-ppl-acrw-frontend-service.php line 169
    /**
     * Filters the checkout field selectors used by the capture beacon.
     */
    apply_filters( 'ppl_acrw_capture_selectors', array( 'email' => array( 'form.checkout #billing_email', '.wc-block-checkout #email', '.wc-block-checkout input[type="email"]', '#billing_email', '#billing-email' ), 'first_name' => array( '#billing-first_name', '#billing_first_name', '#shipping-first_name', '#shipping_first_name' ), 'last_name' => array( '#billing-last_name', '#billing_last_name', '#shipping-last_name', '#shipping_last_name' )... );
  • includes/carts/class-ppl-acrw-cart-service.php line 148
    /**
     * Fires when a cart becomes abandoned. The queue service listens here to
     * schedule the recovery sequence.
     */
    do_action( 'ppl_acrw_cart_abandoned', $cart_id, $cart );
  • includes/carts/class-ppl-acrw-capture-service.php line 369
    /**
     * Fires after a cart snapshot has been persisted.
     */
    do_action( 'ppl_acrw_cart_captured', $cart_id, $snapshot, $cart );
  • includes/carts/class-ppl-acrw-capture-service.php line 351
    /**
     * Fires once per cart, the first time a shopper email is linked to it, which
     * is the moment the cart becomes recoverable.
     */
    do_action( 'ppl_acrw_cart_contact_captured', $cart_id, $snapshot );
  • includes/recovery/class-ppl-acrw-recovery-service.php line 1022
    /**
     * Fires when a paid order converts a cart.
     */
    do_action( 'ppl_acrw_cart_converted', (int) $cart->id, $order, $status );
  • includes/carts/class-ppl-acrw-capture-service.php line 1027
    /**
     * Filters the country resolved for a captured cart.
     */
    apply_filters( 'ppl_acrw_cart_country', $country, $ip );
  • includes/carts/class-ppl-acrw-cart-service.php line 222
    /**
     * Fires after a cart and its related rows are deleted.
     */
    do_action( 'ppl_acrw_cart_deleted', $cart_id );
  • includes/carts/class-ppl-acrw-capture-service.php line 583
    /**
     * Fires when the shopper empties a saved cart. The queue listens here and
     * cancels the cart's pending reminders.
     */
    do_action( 'ppl_acrw_cart_emptied', (int) $row->id );
  • includes/queue/class-ppl-acrw-queue-service.php line 772
    /**
     * Filters whether a saved cart still has something worth emailing about.
     */
    apply_filters( 'ppl_acrw_cart_has_purchasable_items', $purchasable, $cart );
  • includes/carts/class-ppl-acrw-cart-repository.php line 597
    /**
     * Fires when a duplicate cart is closed in favour of another one.
     */
    do_action( 'ppl_acrw_cart_merged', $from_id, $into_id, $reason );
  • includes/recovery/class-ppl-acrw-recovery-service.php line 486
    /**
     * Fires after the WooCommerce cart is rebuilt from a saved cart.
     */
    do_action( 'ppl_acrw_cart_restored', $cart, $unavailable, $reduced );
  • includes/carts/class-ppl-acrw-capture-service.php line 316
    /**
     * Filters the cart snapshot before it is written.
     */
    apply_filters( 'ppl_acrw_cart_snapshot', $snapshot, $cart, $existing );
  • includes/admin/class-ppl-acrw-carts-table.php line 315
    /**
     * Fires after a bulk action runs on carts.
     */
    do_action( 'ppl_acrw_carts_bulk_action', $action, $ids );
  • includes/recovery/class-ppl-acrw-recovery-service.php line 156
    /**
     * Filters the order statuses that mark a cart as purchased or recovered.
     */
    apply_filters( 'ppl_acrw_converting_order_statuses', array_values( $statuses ) );
  • includes/core/class-ppl-acrw-i18n.php line 101
    /**
     * Filters the detected shopper language code.
     */
    apply_filters( 'ppl_acrw_current_language', $lang );
  • includes/stats/class-ppl-acrw-stats-service.php line 218
    /**
     * Filters the dashboard summary payload.
     */
    apply_filters( 'ppl_acrw_dashboard_summary', $summary, $days );
  • includes/core/class-ppl-acrw-install.php line 85
    /**
     * Fires after the plugin is deactivated.
     */
    do_action( 'ppl_acrw_deactivated' );
  • includes/core/class-ppl-acrw-settings.php line 98
    /**
     * Filters the default setting values.
     */
    apply_filters( 'ppl_acrw_default_settings', $defaults );
  • includes/templates/class-ppl-acrw-template-renderer.php line 599
    /**
     * Filters the background colour of the email canvas.
     */
    apply_filters( 'ppl_acrw_email_bg', '#f3f4f6', $template );
  • includes/core/class-ppl-acrw-settings.php line 302
    /**
     * Filters whether an email address is excluded from cart capture and recovery
     * emails.
     */
    apply_filters( 'ppl_acrw_email_excluded', $excluded, $email );
  • includes/templates/class-ppl-acrw-template-renderer.php line 610
    /**
     * Filters the logo URL shown in the email header.
     */
    apply_filters( 'ppl_acrw_email_logo_url', (string) $this->settings->get( 'email_logo_url' ), $cart );
  • includes/events/class-ppl-acrw-event-repository.php line 86
    /**
     * Fires after a recovery event is recorded.
     */
    do_action( 'ppl_acrw_event_recorded', $type, $data, $id );
  • includes/core/class-ppl-acrw-i18n.php line 269
    /**
     * Filters the locale resolved from a language slug.
     */
    apply_filters( 'ppl_acrw_language_locale', $locale, $language );
  • includes/core/class-ppl-acrw-i18n.php line 154
    /**
     * Filters the languages offered for templates and campaign conditions.
     */
    apply_filters( 'ppl_acrw_languages', $languages );
  • includes/class-ppl-acrw-bootstrap.php line 117
    /**
     * Fires after all plugin services are registered.
     */
    do_action( 'ppl_acrw_loaded', $c );
  • includes/core/class-ppl-acrw-logger.php line 40
    /**
     * Filters whether a log line is written.
     */
    apply_filters( 'ppl_acrw_logging_enabled', true, $level, $message );
  • includes/emails/class-ppl-acrw-mailer.php line 160
    /**
     * Filters the outgoing email arguments right before send.
     */
    apply_filters( 'ppl_acrw_mail_args', array( 'to' => $cart->email, 'subject' => $subject, 'body' => $body, 'headers' => $headers, ), $cart, $step );
  • includes/emails/class-ppl-acrw-mailer.php line 400
    /**
     * Filters the recovery email headers.
     */
    apply_filters( 'ppl_acrw_mail_headers', $headers, $cart );
  • includes/campaigns/class-ppl-acrw-campaigns-service.php line 81
    /**
     * Filters the campaign matched for a cart.
     */
    apply_filters( 'ppl_acrw_matched_campaign', $campaign, $cart );
  • includes/queue/class-ppl-acrw-queue-service.php line 589
    /**
     * Filters the maximum send attempts before a message is marked failed.
     */
    apply_filters( 'ppl_acrw_max_send_attempts', 4 );
  • includes/templates/class-ppl-acrw-template-renderer.php line 78
    /**
     * Filters the merge tags exposed in the editor and supported at render.
     */
    apply_filters( 'ppl_acrw_merge_tags', $tags );
  • includes/recovery/class-ppl-acrw-recovery-service.php line 689
    /**
     * Filters how soon after sending a pixel request is treated as a prefetch
     * rather than a genuine open, in seconds. Return 0 to count every request.
     */
    apply_filters( 'ppl_acrw_open_prefetch_window', 30, $row );
  • includes/carts/class-ppl-acrw-capture-service.php line 504
    /**
     * Lets other components handle the order to cart linkage, for example the
     * recovery service which attributes recovered revenue.
     */
    do_action( 'ppl_acrw_order_created_for_cart', $cart, $order );
  • includes/queue/class-ppl-acrw-queue-service.php line 725
    /**
     * Filters how long an unpaid order holds the cart's reminders, in seconds.
     * After this the payment is treated as abandoned and reminders go out.
     */
    apply_filters( 'ppl_acrw_pending_payment_grace', HOUR_IN_SECONDS, $cart );
  • includes/queue/class-ppl-acrw-queue-service.php line 314
    /**
     * Filters the maximum messages attempted in one request.
     */
    apply_filters( 'ppl_acrw_queue_batch_size', $chunk );
  • includes/core/class-ppl-acrw-rate-limit.php line 99
    /**
     * Filters the client identifier used for rate limiting, for example to read a
     * trusted proxy header on a site behind a load balancer.
     */
    apply_filters( 'ppl_acrw_rate_limit_client', $ip );
  • includes/queue/class-ppl-acrw-queue-service.php line 479
    /**
     * This action is documented in
     * includes/recovery/class-ppl-acrw-recovery-service.php
     */
    do_action( 'ppl_acrw_reconcile_order', $paid_order );
  • includes/recovery/class-ppl-acrw-recovery-service.php line 372
    /**
     * Filters the redirect destination after a cart is restored.
     */
    apply_filters( 'ppl_acrw_recover_redirect', $destination, $cart );
  • includes/emails/class-ppl-acrw-mailer.php line 308
    /**
     * Filters the recovery URL placed in emails.
     */
    apply_filters( 'ppl_acrw_recovery_url', $url, $cart );
  • includes/templates/class-ppl-acrw-template-renderer.php line 115
    /**
     * Filters the fully rendered email HTML before sending.
     */
    apply_filters( 'ppl_acrw_rendered_email', $html, $template, $cart, $context );
  • includes/rest/class-ppl-acrw-rest-service.php line 128
    /**
     * Fires after the plugin registers its REST routes, letting add ons register
     * additional routes in the same namespace.
     */
    do_action( 'ppl_acrw_rest_routes', $this );
  • includes/carts/class-ppl-acrw-capture-service.php line 777
    /**
     * Filters the restorable cart contents stored on the snapshot.
     */
    apply_filters( 'ppl_acrw_restorable_contents', $contents, $cart );
  • includes/carts/class-ppl-acrw-capture-service.php line 803
    /**
     * Filters the extra cart item data saved with a line for restoring.
     */
    apply_filters( 'ppl_acrw_restorable_item_data', $extra, $item );
  • includes/recovery/class-ppl-acrw-recovery-service.php line 452
    /**
     * Filters the extra cart item data (product add ons, bundles, personalisation)
     * passed back to WooCommerce for a restored line.
     */
    apply_filters( 'ppl_acrw_restore_item_data', $item_data, $line, $cart );
  • includes/stats/class-ppl-acrw-stats-service.php line 97
    /**
     * Filters the list of dates recomputed by the stats rollup.
     */
    apply_filters( 'ppl_acrw_rollup_days', $days );
  • includes/core/class-ppl-acrw-settings.php line 169
    /**
     * Filters the sanitized settings before they are merged and stored.
     */
    apply_filters( 'ppl_acrw_sanitized_settings', $clean, $values );
  • includes/core/class-ppl-acrw-install.php line 746
    /**
     * Fires after default templates and the starter campaign are seeded.
     */
    do_action( 'ppl_acrw_seeded' );
  • includes/queue/class-ppl-acrw-queue-service.php line 204
    /**
     * Fires after a recovery sequence is scheduled for a cart.
     */
    do_action( 'ppl_acrw_sequence_scheduled', $cart_id, $campaign, $steps );
  • includes/class-ppl-acrw-bootstrap.php line 102
    /**
     * Filters the list of service ids booted by the plugin. Add ids for services
     * registered on the container via the container itself.
     */
    apply_filters( 'ppl_acrw_services', array_keys( $services ), $c );
  • includes/carts/class-ppl-acrw-capture-service.php line 268
    /**
     * Fires when a converted cart releases its session key so the shopper's next
     * cart can be captured.
     */
    do_action( 'ppl_acrw_session_released', (int) $existing->id );
  • includes/core/class-ppl-acrw-settings.php line 238
    /**
     * Filters a single plugin setting value.
     */
    apply_filters( 'ppl_acrw_setting', $value, $key );
  • includes/core/class-ppl-acrw-settings.php line 337
    /**
     * Fires after settings are saved.
     */
    do_action( 'ppl_acrw_settings_updated', $merged, $values );
  • includes/carts/class-ppl-acrw-capture-service.php line 636
    /**
     * Filters whether the current request should capture the cart.
     */
    apply_filters( 'ppl_acrw_should_capture', true );
  • includes/queue/class-ppl-acrw-queue-service.php line 542
    /**
     * Short circuits a send. Return false to cancel this row without sending, for
     * example from a custom suppression list.
     */
    apply_filters( 'ppl_acrw_should_send', true, $cart, $step );
  • includes/core/class-ppl-acrw-health-service.php line 94
    /**
     * Filters how many minutes a pending job may be overdue before the scheduler
     * is treated as stalled.
     */
    apply_filters( 'ppl_acrw_stalled_threshold_minutes', 15 );
  • includes/templates/class-ppl-acrw-template-library.php line 310
    /**
     * Filters the starter templates installed on activation. Add or modify
     * templates here to ship custom designs.
     */
    apply_filters( 'ppl_acrw_starter_templates', $templates );
  • includes/stats/class-ppl-acrw-stats-service.php line 139
    /**
     * Fires after the daily stats rollup completes.
     */
    do_action( 'ppl_acrw_stats_rolled_up', $days );
  • includes/campaigns/class-ppl-acrw-step-repository.php line 103
    /**
     * Filters the computed delay in seconds for a step.
     */
    apply_filters( 'ppl_acrw_step_delay_seconds', $seconds, $step );
  • includes/core/class-ppl-acrw-i18n.php line 230
    /**
     * Fires after the plugin switches the active language.
     */
    do_action( 'ppl_acrw_switched_language', $language );
  • includes/templates/class-ppl-acrw-templates-service.php line 304
    /**
     * Filters the allowed HTML for template bodies.
     */
    apply_filters( 'ppl_acrw_template_allowed_html', $allowed );
  • includes/templates/class-ppl-acrw-templates-service.php line 92
    /**
     * Fires after a template is saved.
     */
    do_action( 'ppl_acrw_template_saved', $id, $data );
  • includes/recovery/class-ppl-acrw-recovery-service.php line 122
    /**
     * Filters the order statuses that leave a cart open (or reopen it).
     */
    apply_filters( 'ppl_acrw_unpaid_order_statuses', array( 'pending', 'failed', 'cancelled', 'refunded', 'checkout-draft', 'draft', 'auto-draft', 'trash' ) );
  • includes/recovery/class-ppl-acrw-recovery-service.php line 585
    /**
     * Filters the unsubscribe confirmation message.
     */
    apply_filters( 'ppl_acrw_unsubscribe_message', $message );
  • includes/emails/class-ppl-acrw-mailer.php line 330
    /**
     * Filters the unsubscribe URL placed in emails.
     */
    apply_filters( 'ppl_acrw_unsubscribe_url', $url, $cart );
  • includes/carts/class-ppl-acrw-cart-service.php line 258
    /**
     * Fires after a shopper unsubscribes, once for each of their carts.
     */
    do_action( 'ppl_acrw_unsubscribed', (int) $id );
  • includes/core/class-ppl-acrw-i18n.php line 88
    /**
     * Filters the current language code. Provided by WPML.
     */
    apply_filters( 'wpml_current_language', null );
  • includes/core/class-ppl-acrw-i18n.php line 259
    /**
     * Filters the locale for a language code. Provided by WPML.
     */
    apply_filters( 'wpml_locale', '', $language );
  • includes/core/class-ppl-acrw-i18n.php line 206
    /**
     * Switches the active language. Provided by WPML.
     */
    do_action( 'wpml_switch_language', $language );
  • includes/frontend/class-ppl-acrw-frontend-service.php line 138
    apply_filters( 'ppl_acrw_load_capture_script', $load );
  • includes/campaigns/class-ppl-acrw-campaigns-service.php line 119
    apply_filters( 'wcml_raw_price_amount', 1.0, $currency );
  • includes/core/class-ppl-acrw-i18n.php line 126
    apply_filters( 'wpml_active_languages', null, array( 'skip_missing' => 0 ) );

Generated from Recovero's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.

Done for you

Rather have it built for you?

Tell us what should change and we’ll write and test the code using these hooks.

Plugin customisation

from $149

New features or changed behaviour, without editing the plugin’s files.

  • Built as a companion plugin, so updates never wipe it
  • Exact quote before we start
  • Tested on staging, then deployed

Typical turnaround: 3–7 business days

Choose this

Not sure which fits? Describe what you need and we’ll suggest the simplest option.

Can't find the right hook?

We can build the customisation for you. Describe what you need: