June 1, 2025

Service Reminder System - User Manual

Version 2.2.0

Overview

The Brozar Service Reminder System is a comprehensive WordPress plugin that automatically sends email reminders to customers before their service due dates. It features a sophisticated email content hierarchy, granular disable options, and secure automation.

Key Features:

  • Automatic Reminders: Sends emails before due dates
  • Manual Reminders: Available as an option to send reminders manually as well
  • Overdue Notifications: Follows up on overdue services
  • Email Content Hierarchy: Flexible fallback system for email content
  • Granular Controls: Disable reminders globally or individually
  • Secure Automation: Token-based server cron endpoint
  • Import/Export: Bulk data management
  • Testing Tools: Verify system functionality

Initial Setup

Step 1: Plugin Activation

  1. Navigate to Plugins in your WordPress admin
  2. Activate the "Brozar Service Reminder System" plugin
  3. You'll see a new menu item "Service Reminder" in your admin sidebar

Step 2: Basic Configuration

  1. Go to Service Reminder > Reminder Settings
  2. Configure these essential settings:
    • Reminder Timing: How many weeks before due date to send reminder (default: 8 weeks)
    • Overdue Reminder: When to send overdue reminders (1 or 2 weeks after due date)
    • Admin Notification Email: Email for admin notifications
    • Global CC Email: Optional email to receive copies of all reminders
    • Global BCC Email: Optional blind copy email

Step 3: Email Signature Setup

  1. In Reminder Settings, scroll to "Global Email Signature"
  2. Add your company signature that will appear on all emails
  3. You can include:
    • Company contact information
    • Phone numbers
    • Website links
    • Images/logos

Creating Service Types

Service Types categorise your different services and define default email content.

Step 1: Add Service Type

  1. Go to Service Reminder > Service Types
  2. Click Add New Service Type
  3. Fill in:
    • Name: e.g., "Annual Maintenance", "Safety Inspection"
    • Email Subject Template: e.g., "Service Reminder - {company_name}"
    • Default Email Content: Standard message for this service type
    • Booking Page URL: Link where customers can book services

Step 2: Organise Service Types

  • You can create parent/child relationships
  • Example structure:
    • HVAC Services
      • Annual Maintenance
      • Emergency Repairs
    • Safety Services
      • Fire Safety Inspection
      • Security System Check

Adding Service Reminders

Step 1: Create New Reminder

  1. Go to Service Reminder > Add New Reminder
  2. Enter a descriptive title (e.g., "ABC Corp - Annual HVAC Service")

Step 2: Service Reminder Details

Fill in the customer information:

  • Company Name: Customer's business name
  • Contact First Name: Primary contact person
  • Contact Last Name: Contact's surname
  • Email: Where reminders will be sent
  • Phone Number: Customer's phone
  • Address: Service location
  • Service Due Date: When service is due

Step 3: Select Service Type

  • Choose the appropriate service type from the dropdown
  • This determines the email subject and default content

Step 4: Email Content

  • Individual Email Content: Custom content for this specific reminder
  • Leave empty to use the service type default content (recommend this to set it up under service type at least, this content will be used for all reminders under the same service type)
  • The system uses a hierarchy: Individual → Service Type → Global Fallback → System Default

Step 5: Reminder Settings

Configure reminder behavior:

  • Disable ALL reminders: Turns off all reminders for this customer
  • Disable before due reminders: Only turns off pre-due reminders
  • Disable overdue reminders: Only turns off overdue reminders

Email Content System

The plugin uses a sophisticated 4-level hierarchy for email content:

Priority 1: Individual Reminder Content (Highest)

  • Set in each reminder's "Email Details" section
  • Overrides all other content
  • Use for special cases or custom messages

Priority 2: Service Type Default Content (Recommended)

  • Set when creating/editing service types
  • Used when no individual content is specified
  • Good for standardised service messages

Priority 3: Global Fallback Content

  • Set in Reminder Settings
  • Used when neither individual nor service type content exists
  • Provides system-wide consistency

Priority 4: System Default (Lowest)

  • Built-in fallback message
  • Always available as last resort
  • Default text will display like this 'Your service is due soon. Please contact us to schedule your appointment.'

Email Structure

Every email automatically includes:

  1. Greeting: "Hi [Contact First Name],"
  2. Content: From the hierarchy above
  3. Booking Link: If configured for the service type
  4. Signature: Global signature from settings

Reminder Settings

Global Email Settings

  • Global CC Email: Receives copy of all reminders
  • Global BCC Email: Receives blind copy of all reminders
  • Global Fallback Email Content: System-wide default content

Global Disable Options

  • Disable Before Due Reminders: Stops all pre-due reminders globally
  • Disable After Due Reminders: Stops all overdue reminders globally
  • These override individual settings

Reminder Schedule

  • Reminder Timing: Weeks before due date (1-52 weeks)
  • Overdue Reminder: 1 or 2 weeks after due date

Admin Notifications

  • Admin Notification Email: Receives alerts about severely overdue services

Managing Reminders

List View Features

The main reminders list shows:

  • Company Name: With disable status indicators
  • Service Due Date: When service is due
  • Reminder Date: When reminder will be sent
  • Last Sent: Most recent reminder activity
  • Required Action: Status-based recommendations
  • Manual Action: Send immediate reminders

Filtering Options

  • Service Type: Filter by service category
  • Date Range: Filter by due date range
  • Reminder Status: All, overdue, disabled, enabled
  • Disable Status: Filter by disable settings

Quick Actions

  • Quick Edit: Modify due dates directly from list
  • Send Manual Reminder: Send immediate reminder
  • Reset History: Clear reminder sending history
  • Update Due Date: Bulk update to next year

Bulk Actions

  • Update Due Date to Next Year: For multiple reminders
  • Reset Reminder History: Clear history for multiple reminders

Import/Export

Exporting Data

  1. Go to Service Reminder > Import/Export
  2. Click Export to CSV
  3. Downloads all reminders with complete data

Importing Data

  1. Prepare CSV file with required columns:
    • Required: Title, Company Name, Email, Service Due Date, Service Type
    • Optional: Contact names, phone, address, email content, etc.
  2. Date Format: Use DD/MM/YYYY (e.g., 15/12/2024)
  3. Phone Numbers: Prefix with apostrophe to preserve leading zeros (e.g., '0412345678)
  4. Upload file and click Import from CSV

CSV Format Example:

copy codeTitle,Company Name,Email,Service Due Date,Service Type,Contact First Name "ABC Corp Service","ABC Corporation","john@abc.com","15/12/2024","Annual Maintenance","John"

Testing System

Test Reminders

  1. Go to Service Reminder > Test Reminders
  2. Use Reminder Date Calculator:
    • Enter a due date
    • See when reminders would be sent
    • Copy dates to test form
  3. Run Tests:
    • Select test date
    • Choose reminder type (regular or overdue)
    • View which emails would be sent

Test Emails

From individual reminder edit pages:

  1. Enter test email address
  2. Click Send Test Email
  3. Verify content and formatting

Monitoring & Logs

Reminder Logs

  1. Go to Service Reminder > Reminder Logs
  2. View:
    • Recent Activity: System actions and errors
    • Next Scheduled Check: When reminders will run
    • Secure Cron Information: Server setup details
    • System Health Check: Component status

Debug Information (for developers)

  • Shows all reminders with their status
  • Indicates which reminders are disabled
  • Displays overdue status and history

Dashboard Widget

  • Quick stats on main dashboard
  • Shows totals, overdue count, upcoming reminders
  • Highlights global disable status

Advanced Features

Auto Update Settings

  1. Go to Service Reminder > Auto Update Settings
  2. Configure automatic due date updates for severely overdue services
  3. Set threshold (1-12 months)
  4. Enable/disable automatic updates
  5. Run manual updates when needed

Troubleshooting

Reminders Not Sending

  1. Check Global Settings:
    • Verify reminders aren't globally disabled
    • Check email settings in Reminder Settings
  2. Check Individual Settings:
    • Ensure specific reminders aren't disabled
    • Verify email addresses are correct
  3. Check System Status:
    • Go to Reminder Logs
    • Review System Health Check
    • Check recent activity logs

Email Content Issues

  1. Verify Content Hierarchy:
    • Check if individual content is set
    • Verify service type default content
    • Ensure global fallback is configured
  2. Test Email Function:
    • Use test email feature
    • Check email formatting
    • Verify booking links work
  3. Check Loading:
    • Plugin uses optimised loading
    • Only loads features when needed
    • Minimal frontend impact

This comprehensive system provides powerful reminder automation while maintaining flexibility and control over your service reminder process with no speed impact on your site. Please report if you see any bugs and I will debug them and release a new fixed version soon.

Ready for Action?

Brozar Tech empowering small businesses with top-notch digital solutions from web design and development to SEO optimization and content creation, we help you succeed in the online world.
Let's Go!
linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram