Search Over 30,000 FREE Plugins from the Official WordPress Plugin Directory Repository

Interserve Data Feeds

Interserve Job Openings, office contact details, stories, and other goodies automatically pulled from our data feed and displayed on your site.

Creates custom post types for the various data feeds from https://data.interserve.org and automatically imports data from those feeds once a day.

Shortcodes

  • [isdata_contact_list] shows an unordered list of office names in alpha order
  • [isdata_contact_map] shows a google map with pins for each office, linking to the office detail page
  • [isdata_job_related n="10" location="locations" profession="professions" duration="durations"] shows a table of jobs that are similar to the current displayed job or search terms, or if there are no current terms it shows the newest priority jobs. Each job links to its detail page. Each taxonomy term links to a related search.
  • [isdata_contact_nearest] shows a link to an office in the same country as the user IP address. Requires geoip php module installed.
  • [isdata_job_list n="10" location="locations" profession="professions" duration="durations"] shows a table of jobs exactly matching the currently displayed job or search terms. If there are no current terms, it shows the newest priority jobs. Each job links to its detail page. Each taxonomy term links to a related search.
  • [isdata_job_search] shows a search form with location, profession, duration and a free text field. It is aware of any pre-set taxonomy terms and will automatically set them in the field values. Use this with an [isdata_job_list] field to implement a job search page.
  • [isdata_story_related n="10" location="locations" profession="professions"] ditto for stories
  • [isdata_story_list n="10" location="locations" profession="professions"] ditto for stories
  • [isdata_story_search] ditto for stories
  • [isdata_profession_list] shows an unordered list of the profession taxonomy, with counts
  • [isdata_location_list] shows an unordered list of the location taxonomy, with counts
  • [isdata_duration_list] shows an unordered list of the duration taxonomy, with counts
  • [isdata_statistics] shows a two column table of random stats about Interserve. Use [isdata_statistics name="Updated"] to show the date and time the stats were last updated on data.interserve.org. Use name="Jobs" to return just the number for the count of job openings. This works for any of the other numbers reported by the bare tag.
  • [isdata_child_pages] shows the pages that are children of this page. It is not related to any of the isdata data sets: it is included as a utility / tool to help build navigation of your site.

In the above, shortcode parameters are

  • n="10" means restrict the number of items in the list to 10. Range 1..50
  • location="locations" means display only items matching the taxonomy slugs for locations. You can use a comma separated list like location="central-asia,india" if you want more than one location. If it doesn't work as expected, check the spelling of the shortcode slug by hovering over a link to that term on the public part of the site. Omit this parameter to show all locations
  • profession="professions" as above eg profession="education,other"
  • duration="durations" as above eg duration="elective"

Widgets

  • Job Openings: shows a context aware list of related job openings with links to view them. You can set the number of openings to display.
  • Stories: shows a context aware list of related stories with links to view them. You can set the number of stories to display.
  • Child Pages: shows pages that are children of the current page

Settings

The Plugin settings page is in the Settings menu

Author Interserve
Profile
Contributors itmatio
Tags jobs, rss, stories

Requires at least PHP5.4 (namespace support)

  1. Upload to the /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. Edit wp-config.php and add define("DISABLE_WP_CRON", true);
  4. Set up a cron job to call the cron.php (see the codex for wp_cron)

The feed update takes a long time: several minutes on first load, and 20+ seconds for each refresh so it needs to be run as a real system cron job that calls wp-cron.php once every 12 hours at the most. See Why WP-Cron Sucks. Note: the feed data is only updated once a day, so calling more often than once every 12 hours is a waste of CPU time and bandwidth. Repeat abusers will be blacklisted.

The plugin settings page (in the Settings main menu) has two fields for each custom post type. Use this to insert raw html or a shortcode into the page above or below a singular job posting, story, contact etc.

If a google maps API key is provided, a google map showing the location of each office will be displayed underneath the office contact details.

0.1 24 March 2013

  • Initial release ok

0.1.1 23 Oct 2014

  • Bug fix: curl problems with sslverify and http 1.1
  • Bug fix: searching for job IDs was broken

1.0 29 Oct 2014

  • Release to wordpress.org as an official plugin (for easier distribution of updates)

= 1.1 31 Jan 2017 * Fixes for PHP7.1 to remove php warnings * search by job and story id in the search forms * improvements to [isdata_statistics] so that single values can be used by themselves eg in big numbers * add [isdata_contact_nearest] to display link to nearest office

to do

  • country vision statements
  • use Schema.org for job openings, organisation addresses, stories
  • You must not have a page with a permalink the same as one of the isdata post types, or undefined weirdness will occur. So a page named /job/ or /story/ etc will not work as expected. Try using the plural form or making some other change to the permalink eg /jobs/ or /openings/ instead of /job/; /our-stories/ instead of /story/; /where-we-work/ instead of /locations/ etc

  • Typical use on a page would be just a blank page with two related shortcodes eg [isdata_job_search] [isdata_job_list] which provide a search form and a search results page

  • The widgets show related jobs or stories. They are smart: they know what other jobs / stories are currently displayed on the page so they adapt to show similar ones with the same location / duration / profession / etc

  • iThemes Security plugin may cause the search form to stop working. When you click the Search button it will give a 403 forbidden message. To fix it, disable "Filter Suspicious Query Strings in the URL" in the System Tweaks of the iThemes Security settings.

Share  
Download
Version 1.1.3

Requires WordPress version: 3.5.1 or higher

Compatible up to: 4.7.2

Last Updated 01 Feb 2017

Date Added: 29 Oct 2014

Plugin Homepage

Evaluation
star1
star2
star3
star4
star5

0 stars
0 ratings
216 downloads

Compatibility

Not Enough Data

Reports:
Works: 0
Broken: 0