Submission Reminder

The Submission Reminder function tracks user submissions and sends automated email reminders to users who haven’t posted recently. Encourage continued engagement by reminding users to create new listings or content.

Overview

Keep your community active by automatically reaching out to users who haven’t submitted content in a while. The function tracks submission history per post type and sends configurable reminder emails to encourage new submissions.

Key Features

• Automatic submission tracking per user
• Per-post-type tracking
• Configurable reminder intervals
• Customizable email templates
• Multiple notification schedules
• Placeholder support for personalization
• Sync existing posts to tracking data
• Daily cron-based email sending

Setup Instructions

Step 1: Enable the Function

1. Navigate to Voxel Toolkit → Functions in your WordPress admin
2. Find Submission Reminder in the list
3. Toggle the switch to enable the function
4. Click Save Changes

Step 2: Select Post Types to Track

1. Choose which post types should have submission tracking
2. Common choices: Places, Events, Jobs, Products
3. Click Save Changes

Step 3: Configure Reminder Notifications

1. For each post type, create reminder notifications
2. Set the time interval (e.g., 7 days, 2 weeks)
3. Customize email subject and message
4. Enable the notification
5. Click Save Changes

Step 4: Sync Existing Posts (Optional)

If you have existing posts, use the sync feature to populate tracking data based on historical submissions.

Configuration Options

Notification Settings

Setting	Description
Time Value	Number for the time interval
Time Unit	Hours, days, weeks, or months
Subject	Email subject line
Message	Email body content
Enabled	Whether this notification is active

Available Placeholders

Placeholder	Description
{user_name}	User’s display name
{user_email}	User’s email address
{days_since_last}	Days since last submission
{time_value}	Configured time interval value
{time_unit}	Configured time unit
{post_type}	Post type label (e.g., “Places”)
{total_submissions}	User’s total submissions count
{submissions_[post_type]}	Submissions for specific post type
{site_name}	Your website name
{site_url}	Your website URL

Example Email Template

7-Day Reminder

Subject: Time to add a new {post_type} on {site_name}!

Hi {user_name},

It's been {days_since_last} days since your last {post_type} submission on {site_name}. We'd love to see more content from you!

Your submission stats:
- Total submissions: {total_submissions}
- {post_type} submissions: {submissions_places}

Visit {site_url} to submit a new {post_type}.

Thanks for being part of our community!

Best regards,
{site_name} Team

How It Works

Tracking Process

1. User publishes a post (or post goes to pending)
2. Function records submission in user meta
3. Submission count is incremented
4. Last submission date is updated

Reminder Process

1. Daily cron job checks for users needing reminders
2. Compares last submission date against configured intervals
3. Sends email to eligible users
4. Records that reminder was sent (prevents duplicate sends)

Use Cases

Directory Sites

Remind business owners to keep their listings updated and add new locations.

Event Platforms

Encourage event organizers to post upcoming events regularly.

Job Boards

Prompt employers to post new job openings periodically.

Marketplace Sites

Remind sellers to add new products or update existing listings.

Tracked Data

The function stores the following data in user meta:

• voxel_toolkit_submissions_[post_type] – Submission count per post type
• voxel_toolkit_total_submissions – Total submissions across all types
• voxel_toolkit_last_submission_[post_type] – Last submission date per type
• voxel_toolkit_last_submission_any – Most recent submission date
• voxel_toolkit_last_reminder_[post_type]_[id] – When reminder was last sent

Troubleshooting

Reminders Not Sending

• Verify the function is enabled
• Check WordPress cron is running
• Ensure notifications are enabled for the post type
• Verify users have submission history
• Check email delivery (use SMTP plugin)

Tracking Data Missing

• Use the Sync feature to import existing post data
• Ensure post types are selected in settings
• Only tracks publish/pending status changes

Duplicate Reminders

• Function prevents same reminder within 24 hours
• Check that reminder meta is being saved correctly