This article concerns version 2.0.0 and above of the Matador Jobs Pro – Jobs Syndication Feeds add-on. If you’re using a lower version than this, please update.
Matador Jobs Pro – Jobs XML Feeds Add-on comes with many standardised XML feeds to integrate wityh major job boards by default. Hoxever, you may want to restructure or otherwise modify one of these feeds to suit a particular need. This guide will walk you through the steps needed to do this.
If you’re looking to create a fully custom feed, see our how-to guide here.
To modify one of the existing feeds, we need to override its template file in a child theme (just like we would for any other template file we wanted to override on our WordPress site).
If you don’t already have a child theme in place, see here for more details on how this is done.
1. Create files in Child Theme
The default feeds are constructed of two php templates. The first main template loops over all the jobs and renders the second inner template for each of the jobs. The naming convention for these two templates is ‘feed-name.php’ for the main template and ‘feed-name-each.php’ for the inner template rendered for each job. For example, for the indeed feed the files are called indeed.php and indeed-each.php.
To override these indeed feed files, we need to create the following files:
- child-theme/matador/feeds/indeed.php
- child-theme/matador/feeds/each/indeed-each.php
2. Customise the feed content
Once uploaded to your site, these files will replace the default ones supplied by the Matador Jobs Pro Jobs XML Feeds add-on, enabling you to make the customisations you need to. A good place to start for any customisations is to copy the contents of these existing default templates into your custom templates, and modifying things from there – this will help you to avoid missing important / required fields out of the feeds structure.
3. Upload and test
Upload your modified feed templates to your child theme, and give them a test. Make sure you’ve turned the relevant feed on in the add-ons settings (under the ‘Syndication’ tab), and don’t hesitate to try reseting your permalinks if the feed isn’t working as intended.