Settings & configuration

WP-PFWorkflow configuration options. Most settings are managed through WordPress filters rather than a dedicated settings page, giving developers full programmatic control.

Core settings

Setting	Default	Filter	Description
Retention days	30	`pfw_retention_days`	Days to keep execution logs and timeline events. 0 = disable cleanup.
Failure notification	immediate	`pfw_failure_notification_mode`	`off` or `immediate`. Sends email to admin when a workflow fails.
Failure recipients	`{admin_email}`	`pfw_failure_notification_recipients`	Override who receives failure emails. Array of email addresses.
Abandoned cart threshold	varies	`pfw_abandoned_cart_threshold_minutes`	Minutes before a cart is considered abandoned.

Cron configuration

Cron task	Schedule	Description
`pfw_cron_tick`	Every 5 minutes	Processes the execution queue (up to 25 jobs), fires scheduled workflows, dispatches abandoned carts, polls HTTP endpoints.
`pfw_retention_daily`	Daily	Deletes logs and timeline events older than the retention window.
`pfw_outbound_retry_sweep`	Hourly	Retries failed outbound webhook deliveries. Max 5 attempts per request, then moves to DLQ.

The 5-minute interval is registered as pfw_every_five_minutes. If you need more frequent ticks, add a custom cron schedule via cron_schedules filter and hook into pfw_cron_tick.

Execution limits

Limit	Default	Description
Max steps per execution	250	Configurable via filter `pfw_max_execution_steps`. Min 10, max 1000.
Queue batch size	25	Jobs processed per `pfw_cron_tick`.
Heartbeat rate limit	1 per 30s per IP	Admin pixel heartbeat rate limit.

Database tables

All plugin data lives in WordPress tables prefixed with {prefix}pfw_:

Table	Purpose
`pfw_execution_logs`	Node-level execution log entries
`pfw_execution_timeline`	Timeline events per execution
`pfw_queue`	Internal execution queue (delays, retries, events)
`pfw_remote_queue`	Remote command queue for wp-executor
`pfw_remote_workers`	Remote worker registry
`pfw_connected_accounts`	OAuth2 connected account credentials
`pfw_webhook_sample_store`	Captured webhook samples
`pfw_event_store`	Event store for idempotency/dedup
`pfw_event_subscription_store`	Event subscriptions
`pfw_audit_trail`	Audit trail of all actions
`pfw_workflow_approvals`	Approval gate records
`pfw_execution_cancellations`	Execution cancellation requests
`pfw_outbound_request_log`	Outbound webhook log + DLQ
`pfw_oauth_state`	OAuth2 in-flight state rows
`pfw_abandoned_cart`	WooCommerce abandoned cart snapshots