With the Job Alerts plugin, registered users on your site can create job alerts based on searches (by keyword, location keyword, category) delivered by email daily, weekly or fortnightly.
Note: the Job Manager Geolocation plugin adds Geolocation and Radius settings on the Alerts page and does not exist in the core WPJM plugin or any addons made by Automattic.
To install this plugin, please refer to the guide here: https://wordpress.org/support/article/managing-plugins/#installing-plugins
To get this plugin working, create a page and call it something like “My Alerts”. Inside the page content, add the shortcode:
This will house the page where users set up and manage their alerts.
Once you set up your page, you can head to Job Listings > Settings > Job Alerts to configure the plugin’s settings.
- Account Required – Only allow registered users to create job alerts.
- Alert Form Fields – What job listings properties a user can set up alerts for. If job categories, tags or types are disabled or empty, they will always be hidden from alerts too.
- Brand Color – Customize the link and button colors used in the e-mails
- Alert Email Content – Customize the text content of the job alert emails
- Alert Duration – Entering a number here will cause a user’s alerts to expire are X days. When it expires, the user can log in to their alerts page to re-enable them for another X days.
- Alert matches – Enable this to ensure that an email is only sent if jobs are found that match your alert. If this is disabled, an email will be sent every time the alert is checked, even if there are no matches.
- Alerts Page ID – Select the page where you have placed the [job_alerts] shortcode so the add-on knows where to link users to view their alerts.
Using Job Alerts
Creating an Alert
When visitors search for jobs on the page with the [jobs] shortcode, they will see an ‘Add Alert’ link among the secondary actions. Clicking this link will open a modal where they can provide their e-mail (if logged out), set up alert frequency and confirm the alert subscription.
Subscribers will receive regular e-mails according to the schedule they set. E-mails will contain new jobs only — jobs listed since their last e-mail for that alert.
The e-mail footer contains links to manage or delete the particular alert.
When accounts are not required, these links contain a magic token that verifies to the My Alerts page that the user can manage alerts for that e-mail address.
The my alerts page (which you set up above) will list any alerts they have set up, and let them edit them or add new ones.
For unregistered users who open this page from an e-mail sent to them, they will see all the alerts set up for their e-mail.
Alerts have the option to:
- Check the results
- Send the alert
- Edit the alert
- Disable the alert
- Delete the alert
Alerts can be moderated on the Job Manager -> Job Alerts screen:
As for the specific fields you can choose from,
alert_frequency can have the values
These can be further customized by using
job_manager_alerts_alert_schedules filter – read more about that on the Job Alerts snippets page
How Alerts Are Sent
Once an alert is created (or enabled) a WordPress cron event will be scheduled. When this event is triggered, the alert will be sent and another cron will be scheduled. This process will repeat while the alert is active.
Different Results when using Send Now vs scheduled emails
Only job listings created after the previous email schedule, will be included in the next email. This is to prevent sending the same job listing multiple times.
For example, if the alert is set to daily, and the last email was sent out on 1 January, only job listings created after 1 January will be included in the 2 January email.
This differs to using Send Now button in the Alerts page. The Send Now email will include all job listings that matches the filter, regardless of when the listings were posted.
Ensuring cron jobs are triggered for low traffic sites
WP Cron jobs are triggered when the site is visited by a user or bot. If you want cron jobs to trigger more often or more reliably, consider this tutorial for setting up a ‘real’ cron job.
Emails aren’t getting sent
Ensure WP cron is not disabled if you are not using ‘real cron’, as mentioned above. Check for this in your wp-config file:
If you see that line, remove it, or set it to
Please also see our troubleshooting for email.
Wrong “from” email address
Alert emails are set up to be sent from “email@example.com“ by default.
However, with some hosts, if this address doesn’t exist as a mail account on your server, then it may be replaced, so you will find alert emails being sent from an email address belonging to your hosting provider.
If this happens, you can fix it by creating a mail account with your host for “firstname.lastname@example.org“
Customizing the Alerts Form
Please note that we cannot provide support for customizing this plugin.
Make sure to check out how to override templates.
The templates you can override for Job Alerts are:
../wp-job-manager-alerts/templates/alert-form.php, which is the form used when creating a new job listing alert from the my alerts page.
../wp-job-manager-alerts/templates/add-alert-modal.php, which is the modal used when creating a new job listing alert from the job search page.
../wp-job-manager-alerts/templates/emails/ contains templates which generates the content used in the Alerts notification email.
../wp-job-manager-alerts/templates/my-alerts.php, which displays the job listing alerts, on the page containing the `[job_alerts]` shortcode.