Use SignalPress → sp_capture Builder to compose sample sp_capture() calls without writing syntax by hand. The builder updates a live code preview as you edit fields and includes a Copy code button for pasting into your theme or plugin.
Open it from the left admin menu after System Logs and before Integrations. Any user with SignalPress access can open the page — see Permissions and Access.
For the underlying API, see Capturing Events with sp_capture() and JavaScript capture.
Signal fields
| Field | Purpose |
|---|---|
| Event name | First argument — normalized snake_case identifier |
| Source | Optional source in the options array |
| Services | Optional service targeting — see below |
| Environment | Site default or production / staging / development / local |
| Project | Default project label from Settings |
| Distinct ID, User ID, Client ID, Session ID, Correlation ID, Event ID | Identity and tracing fields — Event Context and Options |
| WordPress user ID | Attach or suppress the logged-in user (0 suppresses) |
Blank optional fields are omitted from the generated call.
Services picker
The Services control is a multi-select field styled like Select2:
- Click the field and choose one or more enabled integrations from the dropdown
- Selected integrations appear as removable tags inside the field
- Type to filter the list; use arrow keys and Enter to pick
- Leave the field empty to broadcast to every eligible integration — the generated code omits
services— Service Targeting
Only integrations that are active, licensed, and enabled appear in the list.
The generated code uses a fixed example payload (one, two, three) for the second argument. Replace those properties with your real event data when you paste the call into your project.
PHP and JavaScript preview
Use the PHP / JavaScript toggle in the preview panel to switch output format:
- PHP —
sp_capture( 'event', array( ... ), array( ... ) ); - JavaScript —
sp_capture( 'event', { ... }, { ... } );(same server-side API via JavaScript capture)
The preview wraps long lines inside the panel. Copy the result with Copy code.
Example workflow
- Open sp_capture Builder
- Set Event name to
checkout_completed - Add Source
my-plugin - Select Local and PostHog under Services
- Switch to JavaScript if the call belongs in theme or block editor code
- Click Copy code and paste into your project
- Replace the sample payload with real order data
- Confirm delivery on Recent Activity or the service Logs tab — Connection Tests and Delivery Log
What to read next
- Capturing Events with sp_capture() — API reference and return values
- Event Context and Options — every options field
- Service Targeting — service IDs and broadcast behavior
- JavaScript capture — browser POST and REST requirements
- Your First Connection Test — verify integrations before composing calls