WordPress integration

Install and connect

1. Choose WordPress in Streakfox setup.
2. Download the plugin. In WordPress, open Plugins → Add plugin → Upload plugin, upload the ZIP and activate it.
3. In Streakfox, choose Get connection code, then copy the code.
4. In WordPress → Settings → Streakfox, paste it, choose LearnDash lesson completed or Approved member comment, and click Connect Streakfox.
5. Complete the chosen action as a signed-in test member. Back in Streakfox, choose Check my connection, then Go live when progress is confirmed.

That’s it. Keys and member identity are configured automatically. Connection codes work once and expire after 10 minutes. The plugin follows your program’s test/live status automatically on its next scheduled check; reload its settings page to check immediately. Advanced settings hold course restrictions and manual connection fields.

The plugin adds the widget for signed-in members. It creates the same stable, pseudonymous identity for the widget and server events, and refreshes signed identity tokens for protected rewards and Proof. It does not send member email addresses to Streakfox.

What counts

• LearnDash: each completed lesson counts once per member and course. The integration uses LearnDash’s learndash_lesson_completed hook. Enter a LearnDash course ID to track only that course, or leave it at 0 for all courses. Re-marking the same lesson complete does not create another contribution.
• Comments: a signed-in member’s comment counts once when approved, including comments created through the WordPress REST API. Pending, spam, anonymous comments and pingbacks do not count. Unapproving a previously counted comment does not reverse progress.
• Custom actions: select Custom server hook and call this only after your own backend confirms success:

do_action('streakfox_action_completed', $wordpress_user_id, 'completion:YOUR_STABLE_COMPLETION_ID');

Reuse the completion ID for retries of the same action. Use a new ID for a genuinely new completion. The plugin currently connects one Streakfox program per WordPress installation.

Delivery and troubleshooting

Events are saved in a local WordPress queue before sending. Each new completion schedules a background delivery; the recurring job also checks the queue every minute. Temporary network failures, rate limits and server errors retry with the same event ID and timestamp. Credential errors stop with a visible error; fix the connection, then choose Retry failed events.

Accepted means Streakfox received the request. It does not by itself prove that member progress has updated. Complete setup using the processed-progress check in Streakfox.

WordPress cron runs when the site receives traffic. Configure your host’s scheduled cron for reliable delivery on quiet sites. If LearnDash is selected but inactive, the settings page shows an explanation.

Signed-in pages must not be shared between members by a page cache. The identity endpoint requires the WordPress session and REST nonce and returns private, non-cacheable responses. Never place the two secret keys in a page, browser script or public repository.

Test mode uses a separate identity from live mode. Test progress will not carry over when the program goes live. Use a dedicated test account while configuring rewards.

Rewards and follow-up

The widget reveals an earned coupon or reward link only after checking the member’s signed identity. Create and secure the actual coupon or resource in your shop/course platform; that platform controls redemption and access.

For email follow-up, connect your automation provider using the follow-up recipe. The WordPress plugin does not send emails. Keep a mapping between your pseudonymous member hash and your provider’s contact identity in your own integration.

Proof

The plugin sends completed actions independently of widget visibility, including for control members. Signed identity is supplied automatically. Finish setup and test the action before starting Proof.