With the Job Alerts plugin, registered users on your site can create job alerts based on searches (by keyword, location keyword, category) which are delivered by email either daily, weekly or fortnightly.
Note: Geolocation and Radius settings on the Alerts page are added by the Job Manager Geolocation plugin, and do not exist in the core WPJM plugin or any addons made by Automattic.
Installation
To install this plugin, please refer to the guide here: https://wordpress.org/support/article/managing-plugins/#installing-plugins
Setup
To get this plugin working, first create a page and call it something along the lines of “My Alerts”. Inside the page content add the shortcode:
[job_alerts]This will house the page where users setup and manage their alerts after becoming users of your site.
Please note that it is not currently possible to allow unregistered or non-logged-in users to create Alerts, as an account is required to manage them.
Once you have your page setup, you can head over to Job Listings > Settings > Job Alerts to configure the plugin’s settings.
- Alert Email Content – This option controls the content of your alerts emails. Emails are plain text.
- Alert Duration – Entering a number here will cause a users alerts to expire are X days. When expired, the user can login 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.
- Emails Permission Checkbox – Add a permission checkbox to the alert form, so the user can only create alerts after authorizing to receive emails.
Using Job Alerts
The job alerts page (which you setup above) will at first show a blank table as no alerts are configured. Click ‘add alert’ to begin. This will show the add alert form:
When you’ve setup your alert click ‘save’. It will then be activated and displayed in the table:
Hovering over an alert will give you the option to:
- Delete the alert
- Disable or enable the alert
- Preview the alert (view matching results) and
- Edit the alert
- Send Now
.
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.
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:
define('DISABLE_WP_CRON', true);
If you see that line, remove it, or set it to false..
Please also see our troubleshooting for email.
Wrong “from” email address
Alert emails are set up to be sent from “noreply@yourwebsite.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 “noreply@yourwebsite.com“
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.
../wp-job-manager-alerts/templates/content-email_job_listing.php, 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.