I am in the process of updating this plugin.
See my latest article Concerning the SimplyHired API Plugin for more information.
Comments are closed.
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.
Hello Ronnie. You indicated you may know what might be causing all these errors. I still get errors like:
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
when I try to update the page in admin (with the shortcode in there). The results page tells me there was an error in my query, view API call XML.
Not sure what is causing it since I am using [joblist query="waiter" location="MN"] as the shortcode. The XML tests fine in the plugin setup area.
I’d really like to get this up and running. Any ideas?
THank you,
Kevin
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?
Hello,
I have installed the plugin on the web site jobs.factumpress.com . I created several pages which link to different job categories (Chemistry, ) and subcategories (Analytical Chemistry, Inorganic Chemistry, ). Everything works well, except pagination. When user tries to look at the second or other pages he is linked to the URL = jobs.factumpress.com/home/page/n instead of jobs.factumpress.com/home/chemistry/page/n (for n-th page of Chemistry search) or jobs.factumpress.com/home/chemistry/inorganic-chemistry/page/n (for for n-th page of Inorganic Chemistry). Moreover, when I enter in my browser “jobs.factumpress.com/home/chemistry/page/10″ I am not linked to the 10th page, but to the first page instead.
It seems to be very strange since on your demo website you also have several job categories and everything works excellent.
Thank you in advance
http://brite-media.com/?page_id=5
same error as those above.
please help
I’m getting the following errors:
Warning: Invalid argument supplied for foreach() in /htdocs/WEB_SITES/nrp/wp-content/plugins/wp-simplyhired-api/shortcodes.php on line 92
Warning: Division by zero in htdocs/WEB_SITES/nrp/wp-content/plugins/wp-simplyhired-api/wp-simplyhired.php on line 165
any ideas?
Hi I am interssted in your backfill api for my wordpress site/blog. It is a customisation of appthemes, jobroller and I would appreciate some guidance or reasonable price (startup) for adding the functionality of the backfill. I am available on skype username hkidane.
Please come back to me!!
Kind regards,
Hermon
Please help with the following error.
Warning: Invalid argument supplied for foreach() in /home/content/52/7569052/html/wp-content/plugins/wp-simplyhired-api/widget-simplyhired-jobs.php on line 61
After reading all the comments on this board, I couldn’t figure out what is going wrong.
Thanks
Is your demo site using the plugin or the advance api?
Any way to limit the number of results per page?
Also, anybody know how to turn the XML outputted from this plugin or the API into an RSS feed? It’s outputting an XML file, I’m just clueless about how to add a stylesheet to it.
Hi Ronnie,
I have tried to configure however it does not seem to be working this is the output from the API query.
http://api.simplyhired.co.uk/a/jobs-api/xml-v2/q-recruitment/pn-1?pshid=19183&ssty=3&cflg=r&clip=78.145.23.57
Please help as the site is otherwise looking finished…
THANKS A LOT…
Hermon
I want to display say 100 listings instead of 10. I was looking through the files looking for a setting for the default listings and figured I just ask you which file it is exactly, or is it a field in the table where I change the setting from showing 10 listings per page to however many listings I want to display as the default. It is a quick fix for the pagination problem I get within the listings themselves….for ex:
say there is 163 listings…..the page shows the first 10, then when we click for the next page, the system just show the very same 10 listings it showed previously with the same 163 results. Another problem is is a job listing sorted by sales comes up with 15 listings, when you paginate to page 2, the results come up with the original category showing the first ten listings of a total of 163. Kind of strange that it is not passing the filter, nor keeping the pagination straight…….anyway, I figure if I just list out the first 100 of any filter I use, I will eliminate the issue for most of the filtered pages I am using.
If you get back any time soon, you will save me the time of going through the entire script looking for that particular setting where you are limiting the amount of listings displayed per query to 10.
Thanks in Advance,
Robert
I found the answer.
You can control the number of listings per page by editing the following file:
shortcodes.php
Go find the following function:
function wphsa_joblist_shortcode($atts) {
extract(shortcode_atts(array(
‘query’ => ”,
‘location’ => ”,
‘title’ => ‘Sample Job Listing’,
‘number’ => 10,
), $atts));
change the following line
‘number’ =>10,
to
‘number’ =>25,
the function should now look like:
function wphsa_joblist_shortcode($atts) {
extract(shortcode_atts(array(
‘query’ => ”,
‘location’ => ”,
‘title’ => ‘Sample Job Listing’,
‘number’ => 25,
), $atts));
The results will now give you at least 25 listings per page if enough listings are available.
Thanks for the Plugin,
Robert
Hi
Thanks for a great plugin. Can you please tell me how to change the results if no jobs are available in a particular state.
Instead of an error message, I want the result page to display “Sorry! no jobs are available in your State.”
Thanks in advance
This is one big piece of crap
Nice plugin – there are a couple big misses though: capability to see the paid listings received by the job board (those otherwise shown on top of the backfill results), and capability to post a job. I would be more than happy to pay for a plugin that does this, but without these features (it’s what makes the job board, anyway), I have no use for the plugin unfortunately :-/
Hello Sir.
Thank you for the plugin… my XML viewing is not working…. below is the URL generated by the plugin which produces an error, and one from my settings page.
From WP Plugin
http://api.simplyhired.com/a/jobs-api/xml-v2/q-onet:%2853*%29+/l-/ws-10/pn-1/sb-dd?pshid=33035&ssty=2&cflg=r&jbd=heavyequipmentoperator.jobamatic.com&clip=67.174.214.49
From jobamatic advanced settings
http://api.simplyhired.com/a/jobs-api/xml-v2/q-crane?pshid=33035&ssty=2&cflg=r&jbd=heavyequipmentoperator.jobamatic.com&clip=67.174.214.49
Hi sir,
if you this link http://heavy-equipmentoperator.com/crane-operator-jobs-in-texas/
you will see error
There was an error in your query! View API call XML
and xml link is
http://api.simplyhired.com/a/jobs-api/xml-v2/q-onet:%2853*%29+crane?pshid=33035&ssty=2&cflg=r&jbd=heavyequipmentoperator.jobamatic.com&clip=99.22.48.6
Hello. I’m creating a new site and I really like your plug-in!
Unfortunately I’m having a bit of trouble with it. On my home page, under “Job Board,” all the results seem to display okay, but after clicking on page “2, 3, or 4+,” I only get an error page that reads, “Not Found” and “The requested URL /job-board/page/2 was not found on this server.”
I would really love for this function to work because I think the plug-in is quite helpful. Please help. Many Thanks!
Site: http://ninefifteenmedia.com/
WOW. I am in love with this plugin – superb! Where can we donate?
I was looking at the buildz site – looks great. Would be nice to incorporate the filters feature and maybe a search box to search through the result set. May try to add it myself, but if you’ve got a new version coming soon… pretty please?
I am trying to create a new site for bilingual jobs site, but I am do not seem to be able to create a “bilingual” search because there is not a code for bilingual from O*net.
If I use the the jobamatic framed page I can do this as a keyword but it is not as nice as using the XML.
Sincerely,
Joe
Is there a way to set to show listings for ALL jobs in my area or i have to pick 1 code for just 1 job field like say construction or nurse. I dont want to make page for every diff occupation. I would like to show on my site like it does using my direct url?
Is there a way to have different ONET codes for different queries — I am trying to focus on an industry, which will have multiple two digit ONET codes. thanks
Hi
Have not implemented yet but I have a question. How does this work with multiple sites so that commission get paid across the board instaed of individually please?
Also, is there somewhere to chnage the backling jobs for different sites or the same site with different pages?
Thanks for help
Great extension! Thank you!!!
Question, On my job listing pages (using the short code) at the bottom you can click to view additional pages, however I do not have the pages created so it gives me a 404 error. Is their a way to display all or many more listings per page?
Thank you for your help!
Hi, What an excellent plugin. I have been testing it on my localhost and everything works great when I use the base page only. If I use the shortcode and create extra pages then they work fine for the first page results but once you click on the second page it takes you to the base page second page. Therefore the results are not consistent. This is the same that it does on your Plugin demo but I show that it has been fixed in the construction job board. Any chance that you share the solution?
By the way I am testing 0.3.1
I have the plugin running a site but the pagination doesn’t seem to work. I click on any of the numbers at the bottom for other results and it never goes past the first page.
Any thoughts? Thanks!
Any idea when you will have this working?
Still getting “There was an error in your query! View API call XML” on my page.
Publisher ID: is in (withheld for privacy)
Jobboard Url: is in (withheld for privacy)
Niche O*NET Code: 43-40*
Shortcode in page: [joblist query="customer+AND+service" location="DE"]
Also, the plugin makes the page editor get all crammed up into one column, even though I have it set up for 2 columns. Weird.
JK
Pager is not working .I have put [joblist query=""] shortcode on the page
Ok, so I got the plugin working and made some changes on a demo site http://wenotice.net/demo3/jobs. I removed the Onet from the query so I can specify only a title and a more flexible search. Simplyhired was not adequately categorizing the jobs I need in Onet categories so using the Onet identifier was producing any results. This brought on the feature request that Onet be an option and not a requirement. So the option to use or not use Onet via radio button maybe, would be great. Then we can just enter the query in the page using shortcode.
Now, after I removed Onet from the query I found the pagination to have shortcomings with the base job board page option. This page is tied to pagination, therefore I can only have one job board page per site. For example when I create a 2nd jobs page http://wenotice.net/demo3/more-jobs with a different shortcode query, the page 1 results work great, but the pagination contains the base job board page option and does not pagination for the current jobs page but the page entered in the base job board page option in settings.
So request #2 is to have a for pagination to function when using multiple job board pages.
Thanks
Jimmy Tango
Jimmy, I am in the process of updating this plugin. See my latest article Concerning the SimplyHired API Plugin for more information.