Notifications - Overview

WP Career Board Pro extends the Free plugin’s notification system in two ways: it feeds extra events into the in-app notification bell that employers and candidates see inside their dashboards, and it adds Pro email types for job alerts, credit top-ups, and low credit balance warnings.

In-App Notification Bell

The notification bell itself - the badge, the dropdown, and the unread count - is rendered by the Free plugin in the Employer Dashboard and Candidate Dashboard blocks. Pro’s role is to write notification rows on additional career-board events, so the bell shows them automatically.

Events Pro Adds to the Bell

Event	Who receives it	Message example
Application submitted	Employer	“Jane Doe applied for Senior PHP Developer”
Application submitted	Candidate	“Your application for Senior PHP Developer was submitted”
Application status changed	Candidate	“Your application for Senior PHP Developer is now Shortlisted”
Job approved	Employer	“Your job ‘Senior PHP Developer’ has been approved”
Job rejected	Employer	“Your job ‘Senior PHP Developer’ was not approved”
Job expired	Employer	“Your job ‘Senior PHP Developer’ has expired”

All notifications are stored in the wcb_notifications database table. The is_read flag is set to 0 on insert. The bell badge count reflects the number of unread rows for the current user.

Pro Email Notifications

The Pro notifications module registers three additional transactional emails into the Free plugin’s email registry (via the wcb_registered_emails filter), so they appear alongside the Free emails. You can customise the subject line and enable or disable each one from Career Board → Settings → Emails.

Job Alert Digest

• Email ID: job-alert
• Recipient: Candidate
• Trigger: wcbp_send_alert_email action - fired when the Job Alerts module finds new jobs matching a candidate’s saved search
• Content: A list of matching job titles with direct links

Credit Top-Up Confirmation

• Email ID: credit-topup
• Recipient: Employer
• Trigger: wcbp_credits_topped_up action - fired whenever credits are added to an employer’s account (purchase, admin top-up, or mapped product/subscription)
• Default subject: “Credits added to your account”
• Content: Confirmation of the credits added and updated balance

Low Credit Balance Warning

• Email ID: low-balance
• Recipient: Employer
• Trigger: wcbp_credits_low action - fired when an employer’s balance drops to the configured low-balance threshold
• Default subject: “Your credit balance is low”
• Content: Balance warning and a prompt to purchase more credits

Email Template Customisation

All Pro emails use the same templating system as Free emails, so customisation works the same way:

• Theme override (recommended): Drop a file at wp-content/themes/your-theme/wp-career-board/emails/{slug}.php, where {slug} is the email ID above (for example wp-career-board/emails/credit-topup.php). The theme override always wins.
• Plugin templates: The Pro defaults ship in modules/notificationspro/templates/emails/ and are added to the lookup chain via the wcb_email_template_dirs filter. You can register your own directory with the same filter.

Configuring Email Settings

1. Go to Career Board → Settings → Emails
2. Toggle any email on or off
3. Edit the subject line for each email type
4. Click Save

Changes take effect immediately for the next triggered email.