automattic / wp-job-manager

Manage job listings from the WordPress admin panel, and allow users to post jobs directly to your site.

WP Job Manager

Description

WP Job Manager is a lightweight job listing plugin for adding job-board like functionality to your WordPress site. Being shortcode based, it can work with any theme (given a bit of CSS styling) and is really simple to setup.

Documentation

Documentation for the core plugin and add-ons can be found on the docs site here. Please take a look before requesting support because it covers all frequently asked questions!

Contributing and reporting bugs

You can contribute code to this plugin via GitHub: https://github.com/Automattic/WP-Job-Manager and localizations via https://translate.wordpress.org/projects/wp-plugins/wp-job-manager

Thanks to all of our contributors.

Support

Use the WordPress.org forums for community support where we try to help all users. If you spot a bug, you can log it (or fix it) on Github where we can act upon them more efficiently.

If you need help with one of our add-ons, please raise a ticket in our help desk.

If you want help with a customization, please consider hiring a developer! http://jobs.wordpress.net/ is a good place to start.

Installation

Automatic installation

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don't even need to leave your web browser. To do an automatic install, log in to your WordPress admin panel, navigate to the Plugins menu and click Add New.

In the search field type "WP Job Manager" and click Search Plugins. Once you've found the plugin you can view details about it such as the point release, rating and description. Most importantly of course, you can install it by clicking Install Now.

Manual installation

The manual installation method involves downloading the plugin and uploading it to your web server via your favorite FTP application.

• Download the plugin file to your computer and unzip it
• Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installation's wp-content/plugins/ directory.
• Activate the plugin from the Plugins menu within the WordPress admin.

wp-job-manager's Issues

Job listings created via the admin interface do not show an expires date.

Job listings created via the admin interface do not show an expires date. When a job listing is creating through the front end submission form, an expires date is created as expected.

I've included a screenshot below for reference. The top listing was created through the admin interface, whereas the bottom was through the front end submission form. Notice the expiration date is missing in the Expires column for the admin created listing.

Status wording for Job Status: Publish

I'm confused why the job status is called Publish instead of Published?

Suggestion for Template tags / future enhancement

For easier enhancements of the plugin I would suggest an additional Template tag like

the_job_data( $args = null, $post = null ) / get_the_job_data( $args = null, $post = null)

where you can specify the returned fields in an $args array similar as done in other WordPress native functions.

With this approach it would be easy to add new data fields within the plugin and the args and also the result could be also sent though a thirdparty filter and thirdparty data fields could be included without changes in the plugin or duplication of whole the__/get_the__ functions.

Suggestion copied from here: http://wordpress.org/support/topic/suggestion-for-template-tags-future-enhancement

Job Feed

I'm having problems getting this job feed to validate:

http://akrua.com/?feed=job_feed

http://feedvalidator.org/check.cgi?url=http%3A%2F%2Fakrua.com%2F%3Ffeed%3Djob_feed

I've spoken to the guys over at Astoundify who authored this theme and they told me to post a bug here.

Invalid argument supplied for foreach() job-submit.php on line 38

Seeing lots of these in our Error Log:

PHP Warning: Invalid argument supplied for foreach() in /wp-content/plugins/wp-job-manager/templates/job-submit.php on line 38

Jobs not displaying

Hi,

I've just installed this but when you use the 'jobs' shortcode it displays the following:

I've found that this issues has cropped up before, I've applied the suggested changes and nothing has effected it.

Any ideas?

Feature Request: Simple Paid Listings - Multiple email address for payment notification

This feature request if for the Simple Paid Listings add-on.

When a user completes and pays for a new job listing, a payment notification is sent to the WordPress administrative email.

It would be great if we can modify the email addresses which get passed to wp_mail() within the send_admin_email() method in abstract-class-wp-job-manager-spl-gateway.php

Add "Approve" icon in actions column

The action icons are great, but there should probably also be one for "Approve" when a job is pending: http://screencloud.net/v/y6sk

Helper Functions for Permissions

I'd love to write some extensions for this once you're out of beta. At first glance, I see a couple of areas that will need updated in order to be able to do some of the things I want.

For example, in account-signin.php, you have checks like this:

$account_required = get_option( 'job_manager_submission_requires_account' ) == 1 ? true : false;

I'd love to see all of these kind of checks use helper functions that have filters on them, that way I can easily modify the behavior.

As an example of one extension I want to write, is a tie-in for my Restrict Content Pro plugin that would make it possible to restrict job submission to just users that have a paid subscription.

While the example permission check listed above doesn't really apply to this scenario, you get the idea :D

Link Job Location to Google Maps

I'd love to see an option to automatically link the Job Location link to a Google Map: http://screencloud.net/v/tQ2R

Empty list when just one job is added + jQuery error

Hi,

Great plugin. However, I've added just one job and it doesn't show up on the list.

I also see an error in the console:
Uncaught TypeError: Object # has no method 'on'

The moment I add another dummy job, everything is back to normal. The jQuery error seems to be just a side effect of nothing showing up on the list when there's just one listing.

Regards.

Illegal string offset 'show_tags'

I have tried to get the Job Tags plugin to work with Jobify, but its throwing some weird warnings below the map search buttons:

Warning: Illegal string offset ‘show_tags’ in /wp-content/plugins/wp-job-manager-tags/includes/class-job-manager-job-tags-shortcodes.php on line 34

Warning: Illegal string offset ‘show_tags’ in /wp-content/plugins/wp-job-manager-tags/includes/class-job-manager-job-tags-shortcodes.php on line 34

I did a basic install, followed the setup doc and even tried to delete and re-install with no luck.

Can anyone help?

schema.org markup

http://schema.org/JobPosting

Undefined index errors on job update

When updating a job from the front-end dashboard, I'm getting some undefined index errors: http://screencloud.net/v/xcfj

Job Listings Page Out of Alignment - [jobs] Shortcode

I'm able to see the job listings, but the entire framework is out of alignment for some reason. I'm unable to find any css conflicts (and I changed my theme to twenty twelve to be sure), so it has to be an issue w/ the way that the code is being output. All of the other shortcodes are working fine. I've already tried to fix this w/ the solution outlined in pull #4 - Properly set jQuery as a dependency, but it still looks the same. Here's a link to the page so that you can get a better idea of what I'm looking at:

http://jointeamextreme.com/?page_id=21

Any ideas?

BTW - Great Plugin!

View Job Listing triggers Page Not Found if Permalink settings are set to 'Post Name'

I am having this issue on wordpress 3.5.1 with the Sahifa theme.

I am going through various troubleshooting processes, but would like to know if other people can duplicate this issue.

Bad URL if nothing given for Application email/URL

If a person does not give or submit an Application email/URL, then the resulting page with the Apply for Job button contains a URL which just leads the person to their localhost (using Safari on OS X).

Awesome plugin and thanks for all of your work.

Jobs don't display once published to [jobs] shortcode

Bug?

When i've created and published a number of jobs and then browse the [jobs] shortcode I don't see any jobs posted.

antispambot

http://codex.wordpress.org/Function_Reference/antispambot

That will allow you to ditch your encoding method as well as some JavaScript. Pretty neat. Just found out about it.

"Author" meta box for the Custom Post Type

The “Author” drop-down is missing in the post editor for your Jobs Custom Post Type, so I can’t reassign a job listing to another active Wordpress (admin) author.

I’ve tried adding ‘author’ to the supports array for the custom post type, like this:

'supports' => array( 'title', 'editor', 'custom-fields', 'author' )

That's on Line# 188 in the file “class-wp-job-manager-post-types.php... yet the author meta still doesn’t show up. And yes, I’ve looked under the “Screen Options” tab to make sure it’s not unchecked. ;) but it doesn’t even show up there as an option.

Am I going about this the wrong way, or missing something else? Thanks!
(Latest Wordpress 3.6.1 and latest WP Job Manager 1.2.0)

Abstract get_listings

https://github.com/mikejolley/WP-Job-Manager/blob/4cd06049c1a2edc4bd0db8fb3a24e7301ae23cf2/includes/class-wp-job-manager-ajax.php#L21

Would be nice if the method to query the jobs simply returned a WP_Query object so it can be used elsewhere, and doesn't force the output of the HTML.

So then another method would be introduced and attached to the AJAX callback that would call get_listings() and loop through the returned data, outputting the template files.

But right now if a theme or plugin wants to query jobs elsewhere (say for an interactive map :)) they need to recreate the entire method basically, which doesn't play too well with future updates.

Thoughts?

Add a new field for "Company Description"

I think a missing feature for job submissions is a text field for company description.

Error if categories enabled but none exist

The job category is required when editing or submitting a job, but if the admin hasn't created any categories, there is an error that is impossible to get past: http://screencloud.net/v/x5KI

I don't think this is really an issue, but perhaps a good place to implement a check at some point.

Portuguese Translation

Hi Mike,

I downloaded WP Job Manager and the language files. I opened the job_manager-pt_PT.po and job_manager-pt_PT.mo files, poedit shows me on the footer that the file was translated 22%. I don't no if poedit this correct or not.

To solve the "missing" problem, I translated the entire file, but the plugin don't work with my translation. Can I send my file to you ? If there is a missing text, you could update the translation.

Logo upload from WP Admin Dashboard

The front-end dashboard has an upload field for the logo, but the admin metabox version does not. Any chance of getting an upload button there too?

Bug: Property of non-object

When first going to the All Job Listings page (before creating any jobs), I get this set of errors: http://screencloud.net/v/c3YL

Add "start date" field to Job Listing?

How would I go about adding a start date field to the job listing? Is this a feature that would need to be added? I'm under a deadline, so if you could point me in the right direction to adding this, it would be most appreciated. If possible, I'd also like to add a job number as well.

Thanks.

Submission Form Allignment

I've tried using with a few different themes and the job submission form fields allign to the left.
Is it something I'm doing incorrectly or is it something which needs to be fixed?
Thanks for you help & the plugin!

search_categories attribute in [jobs] shortcode is not working

search_categories is not working in [jobs] shortcode. Shortcode attribute 'search_categories' is not matching. To fix the problem change output_jobs method in includes\class-wp-job-manager-shortcodes.
current version:

extract( $atts = shortcode_atts( apply_filters( 'job_manager_output_jobs_defaults', array(
'per_page' => get_option( 'job_manager_per_page' ),
'orderby' => 'featured',
'order' => 'DESC',
'show_filters' => true,
'show_categories' => get_option( 'job_manager_enable_categories' ),
'categories' => ''
) ), $atts ) );
$categories = array_filter( array_map( 'trim', explode( ',', $categories ) ) );

my version:

extract( $atts = shortcode_atts( apply_filters( 'job_manager_output_jobs_defaults', array(
'per_page' => get_option( 'job_manager_per_page' ),
'orderby' => 'featured',
'order' => 'DESC',
'show_filters' => true,
'show_categories' => get_option( 'job_manager_enable_categories' ),
'search_categories' => ''
) ), $atts ) );

    $categories = array_filter( array_map( 'trim', explode( ',', $search_categories ) ) );

Feature request: Set expiration date, and as specific date instead of number of days

As of now, there is code to look for a set job duration when the post is saved (job status changed), and it will go to the default (30 days) if nothing is set. I'm guessing this was implemented for the "WC Paid Listings" plugin where you can sell packages with various number of days for the listing - not sure though as I haven't tried it out.

Feature request(s):

• Manually set expiration date (as date)
• If activated, don't allow expiration date to be later than chosen number of days ahead in options

2 Widgets

Howdy Mike,

I'm just wondering if it's possible to have 2 widgets??

I currently have one in the side bar but I'm looking to add another one which is slightly styled differently...

Suggestion: Plugin name change?

Googling WP Job Manager you'll see: http://wordpress.org/plugins/job-manager/

I feel that the names are so similar that people may install "Job Manager" instead of
"WP Job Manager" I think having a more unique name will set this plugin apart from the other job plugin and reduce confusion when installing the plugin from Plugins > Add New > Install Plugins

Thoughts?

Job Alerts - Is there any way to only send job alerts for new jobs?

I have set up the job alerts on my site and every e-mail contains the historical jobs as well as the new jobs. Is there any way to only send alerts for new jobs that were added since the previous alert?
Thanks.

Bulk approve

It'd be awesome if jobs could be approved in bulk.

RSS feed for all jobs

I might just be missing it completely, but is there a facility for subscribing to a feed which includes all jobs?

Thanks!

[jobs] add option to show only a certain job type

Upload Resume

You should consider building a resume upload section in this plugin. Great work does far.

Allow for native color pick option in WP Job Manager settings

Currently we have a hex value text field but it would be much more user friendly to use a color picker.

IE8 bug when loading more jobs

IE8 errors when clicking on the "Load more jobs" button.

Prepending "var " to page = $(this).data( 'page ); in ajax-filters.js fixes the error.

Add paging ("show more") links to shortcodes with filtering disabled

Job Posting details do not display in Chrome / Firefox

When I use internet explorer and look at a specific job, the job type (Full Time) and location are displayed beneath the job title. In Chrome / Firefox, this is not displayed and there is just an empty space. Does anyone else have this issue? Please refer to www.jobsinbda.com to test.

Language bug in Job Categories and Job Type

When set Job Categories and Job Type in Thai language, when create job list it said ‘job categories/type is a required field’ when using English works fine.

Add option to browse or sort by category

At the moment there doesn't seem to be a way to show jobs from a specific category. Without this, categories aren't very useful.

Change Root Slug From 'job' To Custom

Is it possible to change the root slug site-url/job/job-title to something else?
For example site-url/employment/job-title or site-url/employment/employment-opportunities/job-title

I think I can do the second half of the latter using categories, but the 'jobs' section of the link is the primary problem.

Thank You,
Joshua

Logo distorted

When uploading a logo that is not exactly 64x6x, it gets squished: http://screencloud.net/v/tjiz

Job description error 404

I've updated to version 1.1.3 this morning and since the update, I can't see the job description, I have an error 404 showing up. I've tried to uninstall the plugin and reinstall it with no success

Incorrect formatted spanish translation gives error/warning creating a page

Creating a page in a spanish drupal (3.6 drupal, 1.0.5 plugin) showed the following error:

Warning: sprintf() [<a href='function.sprintf'>function.sprintf</a>]: Too few arguments in wp-content/plugins/wp-job-manager/includes/admin/class-wp-job-manager-cpt.php on line 216

The problem was caused by an incorrect translation, languages/job_manager-es_ES.po:73 should be:

msgstr "Borrador de oferta laboral actualizada. <a target=\"_blank\" href=\"%2\">Pre-visualizar oferta</a>"

instead of:

msgstr "Borrador de oferta laboral actualizada. <a target=\"_blank\" href=\"%2$s\">Pre-visualizar oferta</a>"

Company Logo Size

It doesn't appear the size argument passed in the_company_logo() is applied at any point, showing the full size image.

Unable to change company logo when editing a job

When editing a job with an existing company logo, changing the logo causes the job's "post_status" to be changed to "preview" in the database so it appears the job has been deleted.

Looking into the code, it appears as though upload_image() is called more than once. The first time, the upload succeeds and the image is saved correctly, but the second time the upload fails and returns the "Specified file failed upload test." error.

Bug in Job Listings

When location is set as "New York, New York", the listings page drops the second "York"

Here's the link:
http://serviceinternships.com/all-internships/

1. Jazz at Lincoln Center drops the second "York"
2. On the Media is listed as Manhattan, New York - that displays fine