Documentation
LiteShoper Bulk Email — Full Guide
On this page
- Overview
- Installation
- SMTP setup
- Plugin settings
- Compose a campaign
- Recipient segments
- Cron & queue
- Tracking & unsubscribe
- Tutorial
- Troubleshooting
Overview
LiteShoper Bulk Email (liteshop-bulk-email) sends newsletters and promotional campaigns to your customer database using a reliable background queue — without a third-party ESP.
Features
- HTML campaign composer with personalization placeholders
- Segments: all customers, buyers, affiliates, dropship partners, etc.
- Draft, schedule, queue, send-now, duplicate, cancel
- Open/click tracking (optional)
- HMAC-signed unsubscribe links
- Suppression list for bounces and opt-outs
Installation
Install liteshop-bulk-email with marketplace license.
SMTP setup
Required for production. Configure before sending campaigns:
Admin → Settings → Email — enter SMTP host, port, username, password, encryption.
Send a test email from settings to verify delivery.
Plugin settings
Bulk Email → Settings
| Setting | Description |
|---|---|
| Batch size | Emails per cron run (1–100, default 20) |
| Cron URL | Full URL with secret token — copy to server cron |
| Init batch on admin load | 0 recommended (cron only); >0 also sends when admin pages load |
| Hourly cap | 0 = unlimited |
| Tracking enabled | Open/click pixels |
| Auto-suppress failures | Add repeated failures to suppression list |
Compose a campaign
Bulk Email → Compose
- Enter subject and HTML body.
- Select recipient segment.
- Send test to your admin email.
- Save draft, schedule for later, or queue immediately.
Recipient segments
Includes store customers, recent buyers, active affiliates, dropship partners, and more depending on installed plugins.
Cron & queue
Schedule server cron every 2–5 minutes:
GET https://your-store.com/cron/bulk-email?token=YOUR_SECRETOptional &limit=50 to override batch size for one run.
Monitor progress under Bulk Email campaign list and detail view.
Tracking & unsubscribe
- Open pixel:
/bulk-email/track/open?token=… - Click redirect:
/bulk-email/track/click?token=… - Unsubscribe:
/bulk-email/unsubscribe?email=…&token=…
Manage blocks under Bulk Email → Suppressions.
Tutorial
- Configure SMTP.
- Set up cron URL on server.
- Compose “Welcome” email to small test segment.
- Send test → queue → watch cron process → verify inbox.
Troubleshooting
- Cron 403 — wrong or missing token in URL
- Could not send test — SMTP misconfigured; check Mailer error
- Stuck in queue — cron not running; check server cron logs
- Invalid unsubscribe link — expired or tampered token