wp-job-manager
Last commit date
.githooks
1 week ago
assets
1 week ago
includes
1 week ago
languages
1 week ago
lib
2 months ago
templates
1 week ago
vendor
1 week ago
LICENSE
5 years ago
readme.txt
6 days ago
release.config.json
1 week ago
uninstall.php
2 years ago
wp-job-manager-autoload.php
2 years ago
wp-job-manager-deprecated.php
2 years ago
wp-job-manager-functions.php
1 week ago
wp-job-manager-template.php
3 months ago
wp-job-manager.php
1 week ago
wpml-config.xml
2 years ago
readme.txt
207 lines
| 1 | === WP Job Manager === |
| 2 | Contributors: mikejolley, automattic, adamkheckler, alexsanford1, annezazu, cena, chaselivingston, csonnek, davor.altman, donnapep, donncha, drawmyface, erania-pinnera, fjorgemota, jacobshere, jakeom, jeherve, jenhooks, jgs, jonryan, kraftbj, lamdayap, lschuyler, macmanx, nancythanki, orangesareorange, rachelsquirrel, renathoc, ryanc413, richardmtl, scarstocea |
| 3 | Tags: jobs, careers, company, hiring, job board |
| 4 | Requires at least: 6.4 |
| 5 | Tested up to: 7.1 |
| 6 | Requires PHP: 7.4 |
| 7 | Stable tag: 2.4.6 |
| 8 | License: GPLv3 |
| 9 | License URI: http://www.gnu.org/licenses/gpl-3.0.html |
| 10 | |
| 11 | Create a careers page for your company website, or build a public job board for your community. |
| 12 | |
| 13 | == Description == |
| 14 | |
| 15 | WP Job Manager is a **lightweight** job listing plugin for adding job board 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. |
| 16 | |
| 17 | = Features = |
| 18 | |
| 19 | * Add, manage, and categorize job listings using the familiar WordPress UI. |
| 20 | * Searchable & filterable ajax powered job listings added to your pages via shortcodes. |
| 21 | * Frontend forms for guests and registered users to submit & manage job listings. |
| 22 | * Allow job listers to preview their listing before it goes live. The preview matches the appearance of a live job listing. |
| 23 | * Each listing can be tied to an email or website address so that job seekers can apply to the jobs. |
| 24 | * Searches also display RSS links to allow job seekers to be alerted to new jobs matching their search. |
| 25 | * Allow logged in employers to view, edit, mark filled, or delete their active job listings. |
| 26 | * Job statistics for employers about job listing views and search impressions. |
| 27 | * Developer friendly code - Custom post types, endpoints & template files. |
| 28 | |
| 29 | The plugin comes with several shortcodes to output jobs in various formats, and since its built with Custom Post Types you are free to extend it further through themes. |
| 30 | |
| 31 | [Read more about WP Job Manager](https://wpjobmanager.com/). |
| 32 | |
| 33 | = Documentation = |
| 34 | |
| 35 | Documentation for the core plugin and extensions can be found [on the docs site here](https://wpjobmanager.com/documentation/). Please take a look before requesting support because it covers all frequently asked questions! |
| 36 | |
| 37 | = Demo = |
| 38 | |
| 39 | For a real-life example site, check out [jobs.blog](https://jobs.blog), built by the WP Job Manager team! To try out the plugin in an expendable demo site, click the Live Preview button above. |
| 40 | |
| 41 | = Extensions = |
| 42 | |
| 43 | The core WP Job Manager plugin is free and always will be. It covers all functionality we consider 'core' to running a simple job board site. |
| 44 | |
| 45 | Additional, advanced functionality is available through extensions. Not only do these extend the usefulness of the core plugin, they also help fund the development and support of core. |
| 46 | |
| 47 | You can browse available extensions after installing the plugin by going to `Job Manager > Marketplace`. Our popular extensions include: |
| 48 | |
| 49 | **[Applications](https://wpjobmanager.com/add-ons/applications/)** |
| 50 | |
| 51 | Allow candidates to apply to jobs using a form & employers to view and manage the applications from their job dashboard. |
| 52 | |
| 53 | **[WooCommerce Paid Listings](https://wpjobmanager.com/add-ons/wc-paid-listings/)** |
| 54 | |
| 55 | Paid listing functionality powered by WooCommerce. Create custom job packages which can be purchased or redeemed during job submission. Requires the WooCommerce plugin. |
| 56 | |
| 57 | **[Resume Manager](https://wpjobmanager.com/add-ons/resume-manager/)** |
| 58 | |
| 59 | Resume Manager is a plugin built on top of WP Job Manager which adds a resume submission form to your site and resume listings, all manageable from WordPress admin. |
| 60 | |
| 61 | **[Job Alerts](https://wpjobmanager.com/add-ons/job-alerts/)** |
| 62 | |
| 63 | Allow registered users to save their job searches and create alerts which send new jobs via email daily, weekly or fortnightly. |
| 64 | |
| 65 | **[Job Manager Pro Bundle](https://wpjobmanager.com/add-ons/bundle/)** |
| 66 | |
| 67 | You can get the above extensions and several others at discount with our [WPJM Pro Bundle](https://wpjobmanager.com/add-ons/bundle/). Take a look! |
| 68 | |
| 69 | = Contributing and reporting bugs = |
| 70 | |
| 71 | You can contribute code to this plugin via GitHub: [https://github.com/Automattic/WP-Job-Manager](https://github.com/Automattic/WP-Job-Manager) and localizations via [https://translate.wordpress.org/projects/wp-plugins/wp-job-manager](https://translate.wordpress.org/projects/wp-plugins/wp-job-manager) |
| 72 | |
| 73 | Thanks to all of our contributors. |
| 74 | |
| 75 | = Support = |
| 76 | |
| 77 | 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](https://github.com/Automattic/WP-Job-Manager) where we can act upon them more efficiently. |
| 78 | |
| 79 | If you need help with one of our extensions, [please raise a ticket in our help desk](https://wpjobmanager.com/support/). |
| 80 | |
| 81 | If you want help with a customization, please consider hiring a developer! [http://jobs.wordpress.net/](http://jobs.wordpress.net/) is a good place to start. |
| 82 | |
| 83 | == Installation == |
| 84 | |
| 85 | = Automatic installation = |
| 86 | |
| 87 | 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. |
| 88 | |
| 89 | 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_. |
| 90 | |
| 91 | = Manual installation = |
| 92 | |
| 93 | The manual installation method involves downloading the plugin and uploading it to your web server via your favorite FTP application. |
| 94 | |
| 95 | * Download the plugin file to your computer and unzip it |
| 96 | * Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installation's `wp-content/plugins/` directory. |
| 97 | * Activate the plugin from the Plugins menu within the WordPress admin. |
| 98 | |
| 99 | = Getting started = |
| 100 | |
| 101 | Once installed: |
| 102 | |
| 103 | 1. Create a page called "jobs" and inside place the `[jobs]` shortcode. This will list your jobs. |
| 104 | 2. Create a page called "submit job" and inside place the `[submit_job_form]` shortcode if you want front-end submissions. |
| 105 | 3. Create a page called "job dashboard" and inside place the `[job_dashboard]` shortcode for logged in users to manage their listings. |
| 106 | |
| 107 | **Note when using shortcodes**, if the content looks blown up/spaced out/poorly styled, edit your page and above the visual editor click on the 'text' tab. Then remove any 'pre' or 'code' tags wrapping your shortcode. |
| 108 | |
| 109 | For more information, [read the documentation](https://wpjobmanager.com/documentation/). |
| 110 | |
| 111 | == Frequently Asked Questions == |
| 112 | |
| 113 | = How do I setup WP Job Manager? = |
| 114 | View the getting [installation](https://wpjobmanager.com/document/installation/) and [setup](https://wpjobmanager.com/document/setting-up-wp-job-manager/) guide for advice getting started with the plugin. In most cases it's just a case of adding some shortcodes to your pages! |
| 115 | |
| 116 | = Can I use WP Job Manager without frontend job submission? = |
| 117 | Yes! If you don't setup the [submit_job_form] shortcode, you can just post from the admin backend. |
| 118 | |
| 119 | = How can I customize the job application process? = |
| 120 | There are several ways to customize the job application process in WP Job Manager, including using some extra plugins (some are free on Wordpress.org). |
| 121 | |
| 122 | See: [Customizing the Job Application Process](https://wpjobmanager.com/document/customising-job-application-process/) |
| 123 | |
| 124 | = How can I customize the job submission form? = |
| 125 | There are three ways to customize the fields in WP Job Manager; |
| 126 | |
| 127 | 1. For simple text changes, using a localisation file or a plugin such as https://wordpress.org/plugins/say-what/ |
| 128 | 2. For field changes, or adding new fields, using functions/filters inside your theme's functions.php file: [https://wpjobmanager.com/document/editing-job-submission-fields/](https://wpjobmanager.com/document/editing-job-submission-fields/) |
| 129 | 3. Use a 3rd party plugin such as [https://plugins.smyl.es/wp-job-manager-field-editor/](https://plugins.smyl.es/wp-job-manager-field-editor/?in=1) which has a UI for field editing. |
| 130 | |
| 131 | If you'd like to learn about WordPress filters, here is a great place to start: [https://developer.wordpress.org/plugins/hooks/filters/](https://developer.wordpress.org/plugins/hooks/filters/) |
| 132 | |
| 133 | = How can I be notified of new jobs via email? = |
| 134 | If you wish to be notified of new postings on your site you can use a plugin such as [Post Status Notifier](http://wordpress.org/plugins/post-status-notifier-lite/). |
| 135 | |
| 136 | = What language files are available? = |
| 137 | You can view (and contribute) translations via the [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/wp-job-manager). |
| 138 | |
| 139 | = How do I add the Recent Jobs or Featured Jobs widgets on a block theme? = |
| 140 | Block themes have no classic Widgets screen, but you can still add the Recent Jobs and Featured Jobs widgets through the Site Editor. Go to **Appearance → Editor**, open a template or template part, add the **Legacy Widget** block from the inserter, and choose **Recent Jobs** or **Featured Jobs**. The widget's settings and preview appear right in the editor, just as they do on a classic theme. |
| 141 | |
| 142 | == Screenshots == |
| 143 | |
| 144 | 1. The submit job form. |
| 145 | 2. Submit job preview. |
| 146 | 3. A single job listing. |
| 147 | 4. Job dashboard. |
| 148 | 5. Job listings and filters. |
| 149 | 6. Job listings in admin. |
| 150 | |
| 151 | == Changelog == |
| 152 | |
| 153 | ### 2.4.6 - 2026-08-19 |
| 154 | * Allow reusing a submitter's saved company logo on a new listing (#3082) |
| 155 | * Allow reusing a listing's existing logo on edit when authored by another user (#3060) |
| 156 | * Fix notice dismiss button colliding with core styles (#3036) |
| 157 | * Fix unreadable notice-banner button text on Settings (#3029) |
| 158 | * Decode HTML entities in plain-text job title contexts (#3026) |
| 159 | * Indicate WordPress 7.0 compatibility (#3015) |
| 160 | * Verify the TLS certificate on the geocoding request (#3014) |
| 161 | * Exclude password-protected listings from the promoted jobs feed (#3012) |
| 162 | * Only accept a manual listing expiry from the gated admin edit (#3011) |
| 163 | * Prevent the edit-job form from creating a new listing for an unauthorized or logged-out request. |
| 164 | |
| 165 | * Enforce company-logo attachment ownership when saving a job listing as a draft. |
| 166 | |
| 167 | * Apply the post-password check to the `[job]` and `[job_apply]` shortcodes. |
| 168 | |
| 169 | ### 2.4.5 - 2026-07-01 |
| 170 | * Escape URLs in two sprintf href templates with esc_url() (#2996) |
| 171 | * Validate attachment ownership when reusing a company logo by ID (#2995) |
| 172 | * Honor restrictive filter_post_status=publish for logged-out visitors (#2994) |
| 173 | |
| 174 | ### 2.4.4 - 2026-06-24 |
| 175 | * Fix: Restore the frontend styles and scripts that were missing from the 2.4.3 package. The 2.4.3 release was built without its compiled CSS and JavaScript, leaving the employer job dashboard unstyled and breaking frontend features such as the job application form. (#2990) |
| 176 | |
| 177 | ### 2.4.3 - 2026-06-24 |
| 178 | * Apply the View Job Capability to WordPress search and oEmbed output. |
| 179 | * Apply the View Job Capability to the REST search endpoint (#2984) |
| 180 | * Fail closed correctly when an author filter resolves to no valid IDs (#2983) |
| 181 | * Apply the View Job Capability to job listing feeds (#2982) |
| 182 | * Enforce listing submission limit when publishing a previewed listing (#2981) |
| 183 | * Restore PHP 8.4 test coverage — modernise bootstrap error handler (#2970) |
| 184 | * Fix: Promote button `data-href` attribute now correctly quoted in job listings table. |
| 185 | * Fix: Promote URL in inline script now escaped with `esc_js()`. |
| 186 | * Author filter follow-up: centralize parsing, close AJAX array bypass (#2958) |
| 187 | * Add square-format hint and configurable max size for company logo uploads (#2957) |
| 188 | * "Remove "See what's new in 2.3" from Job Statistics Banner" |
| 189 | * New: The `[jobs]` shortcode now supports an `author` attribute to filter listings by user ID (e.g. `[jobs author="42"]` or `[jobs author="1,2,3"]`) |
| 190 | |
| 191 | ### 2.4.2 - 2026-05-12 |
| 192 | * Fix Job Dashboard actions menu on Safari (#2947) |
| 193 | * Harden submit-form session cookies (#2945) |
| 194 | * Fixes a REST API information disclosure where the body, excerpt, and existence of listings restricted by view-capability were exposed to denied viewers. Restricted listings now return 404 indistinguishable from a missing post, including HEAD probes and listings that are also password-protected. |
| 195 | * Fixes a data-loss bug where editors opening a password-protected listing in the block editor would save empty meta values (location, company name, application target). |
| 196 | * Fixes a series of information disclosure issues affecting password-protected and capability-restricted job listings. |
| 197 | * Harden stats AJAX endpoint input validation and rate limiting (#2938) |
| 198 | * Company logo uploads now accept WebP images by default |
| 199 | * New filter `job_manager_company_logo_allowed_mime_types` allows customizing allowed file types for the company logo field |
| 200 | * The salary currency field on the job submission form now correctly reflects the configured default currency in its placeholder and helper text. |
| 201 | * Filled job listings are no longer exposed via the REST API. |
| 202 | * Job categories are now included in the job RSS feed XML output. |
| 203 | * Added `featured=true` query parameter support to the job RSS feed to allow filtering by featured listings only. |
| 204 | * Fixed PHP 8+ undefined array key warning in the widget caching methods. |
| 205 | * Updated Twitter profile links to use the new `x.com` domain and updated related labels to "X / Twitter" to reflect the platform rebrand. |
| 206 | * Added a Settings link to the plugin action links on the Plugins screen for quicker access to plugin settings. |
| 207 |