A Plugin that provides tools to utilize the SimplyHired web services API for Job-a-matic niche job boards.
Host your own WordPress job board powered by the SimplyHired API. This plugin allows users to search for jobs, browse jobs by location or by category, track job clicks and link directly to each job.
Customizable widgets are also included in this plugin.
You will need to register and obtain a Job-a-matic account in order to use this plugin.
Download WP-SimplyHired API ver 0.3.1 at the WordPress Plugin Repository
Plugin Settings
The plugin cannot read your Job-a-matic account settings, so you have to set those up here as well.
- Publisher ID
- (required) Publisher id assigned to you by SimplyHired.
- Jobboard Url
- (required) Url to your Job-a-matic board.
- Niche O*NET Code
- (required) This is the top of your niche. This O*NET code will relationally refine your search results.
- A 2-6 digit O*NET code in the form ##-####. Minimum 2 digits. Use of a wildcard(*) is acceptable.
- O*NET code can be found here. [link]
- Job Posting Cost
- Not required, but advisable!
- Job Posting Days
- Not required, but advisable!
Job Board Settings
- Base job board page
- This is not really used right now, but will shortly for permalink purposes.
- Show Backfill?
- Check this box to always show backfill results (default). You will probably want to leave this on to fill out your job listings.
Shortcode Syntax
You can generate job pages by adding a new page from your Admin dashboard. Name your page and insert the joblist shortcode with your parameters into the page and save it.
The shortcode will add its arguments within your O*NET category, unless over-ridden via the shortcode itself. The only required value is query.
example: [joblist query="wordpress+AND+developer" location="CA"]
Later versions will create pages automatically and include user-search capability. Until then, this is something to get you up and going with highly targeted base job pages and complete control with directory like structure.
I am looking for people to do translations. Since the focus of this plugin is mainly North American jobs, I am looking primarily for Spanish and French translations. Please use my Contact Form if interested.
Plugin Demo
The plugin is live on this website and can be accessed via the Web Development Jobs page. There are a few sub-category job pages that branch down from there.
This plugin is being reworked from a custom theme that uses the SimplyHired XML API for a construction job board at the Buildz.Net. This website will show all of the front-end features that will be soon incorporated into the WP-SimplyHired API plugin.
An example widget can be seen in the sidebar to the right labeled “WP Plugin Jobs”.
Helpful Links
[...] WP-SimplyHired API [...]
[...] WP-SimplyHired API [...]
Thesis 18 on WP 304 with cache
Thanks for the report.
Hi, please tell me why does the plug-in display the first several jobs with a colored background, and the label ‘Sponsored Results’? What does this mean?
Many thanks
Nick
Nick – The sponsored (or featured) jobs are coming from SimplyHired and they will generate revenue for your Job-a-matic account when clicked on.
Sometimes you will get a full page of sponsored jobs, just a few, or none at all. It will depend on the job search keywords and location that generates the listing.
As of now, there is not a way to control the number of sponsored job listings. I wish there were. I think for a more professional look, it would be nice to just get a few to throw up at the top & bottom of the page.
I hope this answers your question. If you have any others, let me know.
Hi,
I configured the plugin exactly the way you had said. I cannot see any jobs getting pulled though.
-igor
You should be getting an error message with a link to view the API XML. Click that link and post the Url from the address bar here so I can see what is up.
I don’t get any error nor it displays anything. Is there a way for me to generate somekind of error so that we can see the real issue.
Thanks
-igor
Minimum requirements are your Publisher ID, Jobboard Url, the Broad O*NET code in the Admin settings AND you have to create a job page with a shortcode for your Joblist.
Awsome Plugin..Thanks for your help !!
Love to see more of future releases…
Thanks! I am running a little behind schedule, but should have full search and easier configuration in next update.
Hello. I have been trying to get the plugin to work, but when I attempt to save the page in Admin, I get multiple “Invalid Argument” errors in shortcode.php and a “Cannot modify header” error in pluggable.php. I have checked the configuration over and over and the shortcode I am using is [joblist query="design" location="55104"] I have also tried it without the location option. Same errors.
Running 3.0.1. Has this error come up before?
Thank you for creating a plugin for this service!
Kevin
Kevin – no, I have not received that error. Is that the complete error message?
There is a stabler version (0.3.1) that I just released today. If that does not fix the problem, then let me know.
Hello Ronnie. Yes the errors still occur even after upgrading to the 3.1 version. Triple checked all entries and settings and I get this when saving the page:
Warning: Invalid argument supplied for foreach() in /home2/caprworg/public_html/wp-content/plugins/wp-simplyhired-api/shortcodes.php on line 28
Warning: Invalid argument supplied for foreach() in /home2/caprworg/public_html/wp-content/plugins/wp-simplyhired-api/shortcodes.php on line 28
Warning: Invalid argument supplied for foreach() in /home2/caprworg/public_html/wp-content/plugins/wp-simplyhired-api/shortcodes.php on line 59
Warning: Cannot modify header information – headers already sent by (output started at /home2/caprworg/public_html/wp-content/plugins/wp-simplyhired-api/shortcodes.php:28) in /home2/caprworg/public_html/wp-includes/pluggable.php on line 890
Is your plugin using jquery to parse the XML? Maybe I have a conflict somewhere? I really would like to start using the plugin, rather than forcing it with the iframe method.
Kevin, sorry for the delay. Been pretty busy lately.
I think I know what is going on here. Will get back to you shortly.
So I know nothing about coding, or this short code your talking about – I’m having the same problem, nothing is showing up. How do I do this?!?!
Thank you!
You need to create a page a put the shortcode into it per the plugin setup instructions. The shortcode generates your joblist for you.
Sir,
I have configured my board but not show any error or any jobs. you can see my jobs at
http://beyondhunt.jobamatic.com/a/jobs/find-jobs
i am sending you my job board plugin setting image. Please guide me how i can able to show jobs in my site.
I am waiting your Quick Response.
Thanks
Did you put the shortcode [joblist query=""] on your job page?
Publisher ID pshid=26978
Jobboard Url jbd=beyondhunt.jobamatic.com
Broad O*NET Code 11-0000
Your settings look good. There is another version I just released, upgrade, and make sure you have a job page created with the shortcode entered into it.
Thanks for Reply
That code enter and show this erroy
There was an error in your query! View API call XML
This XML file does not appear to have any style information associated with it. The document tree is shown below.
There would be no style information in the XML. It will either contain the output from your API query or an error.
What is the link to view the XML? Knowing the link will allow me to diagnose your problem.
my link are
http://www.beyondhunt.com/njobs
here are xml error
I know the page link. I need the XML link to the error. It is not showing on your job page, but you can get the link and error message from the plugin settings page after updating. Post that link here.
Hi,
I can’t get this to work. I get following error on my job page:
There was an error in your query! View API call XML
On my job page, I have this: [joblist query=""]
I have configured my settings thus:
Publisher ID 28670
Jobboard Url (removed)
Niche O*NET Code 15-10**
Any ideas? As you can see, my jobomatic page lists jobs just fine. But I cannot get the plugin to work on my blog (removed)
Only one asterisk in your ONET setting. (I use 15-10* as well)
You need a query in your shortcode. It cannot be blank. If you want everything in for your ONET, then do a query for “the” or some other common word. The API call makes this a requirement, and outside of that option, it is all you can really do.
Ok, I did that, and it works now. But how can I make the results to match what i have on my jobamatic site? I am using these key words both on my jobamatic site and my blog:
startup developer software engineer
Also, is there a way to have the “post a job” on my blog, without using the widget? I’d like to use my blog as the primary place for job listing, and not my jobamatic site. you can see it now at decodedpathways.com/startupgigs
Try this query:
startup+AND+developer+AND+software+AND+engineer
Currently I only have the button in the widget. If it is desirable to have this with the job listings, that would be possible. In the meantime you can add the button to your page along with the content that you added above the listings. There is not much to the link, it just goes to your Job-a-matic page.
Tried it, but it does not match. Besides, I set my jobamatic site to only pull in 100 jobs from backfill, but on my blog, it’s pulling hundreds. How can i limit it to only display what I have on jobamatic?
Then, if a job is posted on my jobamatic site, will this plugin display it on my blog? Currently, there is no job posted, but in the event that this happens, I’d like it to display on my blog.
Lastly, how can I display job categories, and not just the states to limit the search to when I select a state from the pull down list, i get the XML error. so it seems when it doe snot find anything, instead of saying “no jobs found”, it displays the XML error. Is this on purpose?
I’d have to find a way to do everything on the blog, rather than a link back to jobamatic…because I do all the work on the blog.
First, you have to understand that this plugin is still in development. I am adding to it as quick as I can.
The API is not going to match what Job-a-matic has, and thus, neither will the plugin. The API was designed to give publishers more control over the results that are displayed. As such, I designed the plugin with fine-tuning of niches without having to jump through too many hoops. This is where the ONET code comes in.
Job postings, I do not know yet. Have not received a job posting to test that with yet. I will cross that bridge when I come to it, or somebody else comes to it.
Job categories are easy. Look at my job page here. I created different pages for each. In a future update, I will make it easier to list and define the categories.
You are still going to have to link to Job-a-matic for job posting. The results are linked to SimplyHired (new tab). Can’t really get around that right now, but I am working on some alternatives. ;0)
I did not notice the bug on the State drop down. I will check into that.
Im getting the query error, However, my XML file looks fine. Here is the link to the XML file generated from the error page.
http://api.simplyhired.com/a/jobs-api/xml-v2/q-onet:%2827-10*%29+%22design%22/l-%22IL%22/ws-10/pn-1/sb-dd?pshid=28692&ssty=2&cflg=r&jbd=fijispark.jobamatic.com&clip=98.222.69.167
This is the shortcode I used: [joblist query="design" location="IL"]
Here is the link to the job page: http://fijispark.com/v2/jobs/
Please help. Thanks!
Nevermind, Please disregard. I am using the CKeditor plugin with wordpress and it was automatically enclosing the shortcode in paragraph tags which caused it not to work. I fixed it and now it works. Thanks anyway and GREAT PLUGIN!!
Well that is good to know.
BTW, you have your job listings hidden and requires you to click that down arrow to reveal the list. Is there a reason why you would want to do that?