Job alerts
You can let members and visitors save a job search and get an email when new jobs match it.
How people create alerts
Section titled “How people create alerts”- Alert me button. It is on the job listings toolbar and saves the current search words and filters. Members are subscribed at once. Visitors type their email first.
- Job Alerts block (
wcb/job-alerts, shortcode[wcbp_job_alerts]). It shows only to signed-in members. Members pick Instant, Daily or Weekly and click Subscribe. The block saves the current search words and the category, job type, location, salary and remote filters. It also lists Active Alerts, where members can delete an alert.
The default frequency is Daily.
Guest alerts
Section titled “Guest alerts”Visitors without an account can save an alert with their email address.
- The visitor types an email and clicks Alert me.
- The button changes to “Check your email to confirm”.
- The visitor gets the email “Confirm your job alert” and clicks the link.
- Nothing is sent until the link is clicked.
Every alert email has an unsubscribe link that works without signing in. The emails also carry one-click unsubscribe headers.
After 5 alert requests from one IP address, further requests are refused for an hour.
Manage alerts as a member
Section titled “Manage alerts as a member”On the candidate dashboard, open Job Alerts. A member can change an alert’s frequency or delete it there.
Settings
Section titled “Settings”Go to Career Board → Settings → Job Alerts.
| Setting | Default | What it does |
|---|---|---|
| Guest alerts | On | Lets visitors without an account save an alert with their email. Turn it off to show the Alert me button to members only. |
| Alerts per person | 10 | The most alerts one member or one email address can keep (1 to 100). |
The same tab lists the saved alerts, 50 per page. It shows the subscriber (the email for guests), the search, the frequency, when the alert was last sent and its status. A guest alert shows “Waiting for email confirmation” until it is confirmed.
What gets matched
Section titled “What gets matched”An alert matches a job when the job meets every criterion set on the alert. Empty criteria are ignored.
- Keyword - every word must appear in the job title, description or company name.
- Category, Job type, Location, Experience, Tag - the job must have one of the alert’s terms.
- Board - the job must be on the alert’s board. An alert with no board matches all boards.
- Company - the job must belong to that company.
- Salary minimum - a job whose top salary is below it does not match.
- Salary maximum - a job whose bottom salary is above it does not match.
- Remote - only jobs marked remote.
A job with no salary set is not excluded by the salary criteria. Only confirmed alerts are sent.
When emails go out
Section titled “When emails go out”| Frequency | When |
|---|---|
| Instant | When a job becomes public: approved, published automatically or scheduled. Each job is sent once, so reopening or re-approving it does not send it again. |
| Daily | Once a day at 8:00 (UTC) |
| Weekly | Mondays at 8:00 (UTC) |
Daily and weekly emails list only the jobs published since the alert was last sent. Imported jobs do not send alerts unless you return true from the wcbp_alerts_notify_on_import filter.
Daily and weekly emails run on WP-Cron. On a low-traffic site, set up a real server cron that runs wp cron event run --due-now so they go out on time.
Emails
Section titled “Emails”Set the sender name and address under Career Board → Settings → Emails. The alert emails are listed there as Job Alert Digest and Confirm Job Alert (guest), so you can edit their subject and text. Use an SMTP plugin for reliable delivery.
Email is the built-in channel. Add-ons can add channels, such as Slack or SMS, with the wcbp_alert_dispatch_channels filter. The email channel fires wcbp_send_alert_email.
REST API
Section titled “REST API”| Action | Route | Who |
|---|---|---|
| List your alerts | GET /wcb/v1/alerts |
Signed-in member |
| Create an alert | POST /wcb/v1/alerts |
Member, or a visitor with an email when guest alerts are on |
| Update an alert | PUT /wcb/v1/alerts/{id} |
Alert owner, or wcb/manage-settings |
| Delete an alert | DELETE /wcb/v1/alerts/{id} |
Alert owner, or wcb/manage-settings |
| Unsubscribe | GET or POST /wcb/v1/alerts/{id}/unsubscribe/{token} |
Anyone with the signed link |
Update changes the frequency, search words, filters and board. Creating a guest alert returns needsConfirm: true.
Privacy
Section titled “Privacy”Job alerts are part of WordPress Export Personal Data and Erase Personal Data requests. This covers alerts a member created while signed in and alerts a guest subscribed to with an email address.