Invite Friends

Email-invite system. Customers fire invitations to a list of email addresses. Pairs with the Referral Program — invitees who register through the email get the same WELCOME coupon + sponsor reward path.

What It Does

How Customers See It

Drop the shortcode on any page (registration page, account dashboard, sidebar widget):

[wkwp_invite_friends_form max_emails="5" message_field="yes"]

Customer fills emails + message → submits → "Sent!" confirmation. Friends receive a personalised invite email with the referral link baked in.

The link-share + share-button row that replaced the embedded form lives on the Wallet Central right rail:

Setup

Wallet → Settings → Referral → Invite Friends

What Friends See

• Standard WC-mailer email
• Subject: customisable
• Body: customisable, contains the customer's referral link
• Friend signs up via the link → goes through the Referral Program flow

What If the Email Already Has an Account?

Existing-user invites are detected and stored as "Already on site" rows. No email is sent to existing accounts. Customer's invitation count still increments — visible in their referral panel.

This avoids spamming existing customers with redundant invites.

Email Failure Handling

If your SMTP fails for any reason:

• DB row is kept (not rolled back)
• Customer sees "Sent" in the form (no scary error)
• Admin gets a log entry (wkwp_invite_friends_mail_failed action)
• Retry tooling (custom or third-party) can pick up unsent rows later

This way customers never see SMTP failures and invitations are recoverable.

Storage

Each invitation = one row tracking:

• Inviter's user ID
• Recipient email
• State: invited / already_on_site / signed_up / bounced
• Sent timestamp (NULL until SMTP succeeds)
• Linked user_id when invitee registers

UNIQUE on (inviter, email) — re-inviting the same address from the same sender updates the row, doesn't duplicate.

Conversion Path

When an invitee whose email matches an invitation row registers:

1. Row state flips to signed_up
2. Standard referral attribution kicks in
3. On first completed order → inviter rewarded per Referral Program

Common Scenarios

Add invite form to footer widget

Use a Shortcode widget → drop the shortcode in. Done.

Track invite-driven signups

Admin → Wallet → Referral → Invitations lists all rows. Filter by state, sender, or date. Bulk actions: re-send mail, mark bounced, export CSV.

Higher limits for VIP customers

Filter the daily limit per-user (see dev section).

Block invites globally without removing the shortcode

Toggle "Enable" → OFF. Shortcode renders a "currently disabled" message.

Anti-Spam

• Daily limit enforced server-side
• Per-submit cap enforced server-side
• Inviter must be logged in
• Nonce required on every submit
• Email format validation per address

For higher abuse environments, add a CAPTCHA via a hook on the form render.

When Something Goes Wrong

add_action( 'wkwp_invite_friends_mail_failed', function( $invitation_id, $email, $error ) {
    // queue into your job runner
    wp_schedule_single_event( time() + 600, 'my_invite_retry', [ $invitation_id ] );
}, 10, 3 );

add_filter( 'wkwp_invite_friends_daily_limit', function( $limit, $user_id ) {
    if ( in_array( 'vip', wp_get_user_role_slugs( $user_id ), true ) ) {
        return 100;
    }
    return $limit;
}, 10, 2 );

Related

• Referral Program
• Multilevel Referral
• Email Notifications
• Shortcodes