=== Recruitly ===
Contributors: recruitly
Tags: recruitly, job board, recruitment software
Requires at least: 4.5
Tested up to: 6.8.2
Stable tag: 2.0.38
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Transform your WordPress site into a professional job board with Recruitly.

== Description ==

**Recruitly is a GDPR-compliant recruitment solution that helps agencies and businesses manage and display job listings effortlessly.**

The Recruitly WordPress Plugin connects seamlessly with your Recruitly.io account, providing a robust job board experience. Using dynamic shortcodes, you can customise job listings, search forms, widgets, and more to fit your website’s needs.

### Key Features:
- **Job Listings and Search:** Display jobs with powerful search and filter options.
- **Dynamic Widgets:** Showcase job sectors, tags, recent jobs, and more.
- **Customisable Shortcodes:** Control layout and display with a variety of shortcodes.
- **GDPR Compliance:** Ensure secure and compliant data handling.

> **Note:** A subscription with [Recruitly.io](https://recruitly.io) is required to use this plugin.

== Installation ==

1. Upload the `recruitly-wp` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Recruitly -> Settings** in the admin area to configure the plugin.
4. Use the shortcodes listed below to display job-related content on your website.

== Shortcodes ==

### Core Job Features:
- `[recruitly_jobs]`
  Displays a list of jobs with pagination.

- `[recruitly_job_search]`
  Renders a job search form for users to filter job listings.

- `[recruitly_jobs_count]`
  Shows the total count of active jobs.

### Widgets and Additional Features:
- `[recruitly_job_sector_widget]`
  Displays jobs by sectors.

- `[recruitly_job_tag_widget]`
  Displays jobs filtered by tags.

- `[recruitly_jobs_recent]`
  Shows a list of recent jobs.

- `[recruitly_job_language_list]`
  Lists the required languages for a job.

- `[recruitly_job_cities suffix="jobs"]`
  Displays a list of job cities. The optional `suffix` parameter customises the city display (e.g., "London jobs").

### Job Details (Single Job View Only):
The following shortcodes are available for use when viewing a single job post. These shortcodes display specific information about the job being viewed:

- `[recruitly_job_image]`
  Displays the main image or logo associated with the job. If no image is set, a default placeholder image will be shown.

- `[recruitly_job_web_field fieldname="description"]`
  Displays the content of a specified custom field for the job. Replace `"description"` with the desired field name.

- `[recruitly_job_recruiter_image]`
  Shows the profile image of the recruiter assigned to the job. A default image will appear if no recruiter image is available.

- `[recruitly_job_location displayfield="city"]`
  Displays the job's location. Use the `displayfield` attribute to specify whether to show the city, region, or town. If the job is remote, "Remote" will be displayed.

- `[recruitly_job_recruiter_languages]`
  Lists the languages spoken by the recruiter responsible for the job.

== Frequently Asked Questions ==

= Do I need a Recruitly.io subscription to use this plugin? =
Yes, a subscription with Recruitly.io is required for the plugin to function.

= How can I display job listings? =
Use the `[recruitly_jobs]` shortcode to display job listings. Combine it with `[recruitly_job_search]` to allow filtering.

= Can I customise the job board? =
Yes, the plugin provides multiple shortcodes and widgets to customise your job board.

== Changelog ==

= 2.0.16 =
* Initial stable release.

= 2.0.20 =
* Enhanced functionality and bug fixes.

= 2.0.21 =
* Added the `[recruitly_job_cities]` shortcode for listing job cities dynamically.

**Example:**
`[recruitly_job_cities]`
or
`[recruitly_job_cities suffix="jobs"]`

= 2.0.22 =
* Added help guide with examples.

= 2.0.23 =
* Added help guide with examples.

= 2.0.24 =
* Fix shortcode search filter issue.

= 2.0.25 =
* Added optional job_county filter to the [recruitly_jobs] shortcode for more flexible job listings.

= 2.0.26 =
* Fix issue with multiple industries in taxonomies.

= 2.0.27 =
* Fix issue with multiple industries in taxonomies.

= 2.0.28 =
* Fix issue with multiple sectors in taxonomies.

= 2.0.29 =
* Fix issue logger issue.

= 2.0.30 =
* Add additional recruiter fields.

= 2.0.31 =
* Fix character encoding issues.

= 2.0.32 =
* Fix character encoding issues.

= 2.0.33 =
* Fix character encoding issues.

= 2.0.34 =
* Fixed HTML rendering in job short description field - changed from escaped text to properly rendered HTML.

= 2.0.35 =
* Fixed Sector Dropdown Filtering Issue.

= 2.0.36 =
* Fixed Html Encoding Issues on shortcodes.

= 2.0.37 =
* Apply buttons now open the job page from your Recruitly job board (the applyUrl synced with each job) instead of the legacy apply widget. Jobs synced before this version keep working via the legacy link.
* Fixed the apply pop-up losing its shaded background while open. Other scripts on the page (cookie consent banners, chat widgets) could make the shading disappear as soon as you clicked a field.

= 2.0.38 =
* Plugin styles and scripts are now versioned with the plugin version, so browsers and CDNs pick up front-end fixes as soon as you update instead of serving cached copies from the previous release.

== Upgrade Notice ==

= 2.0.28 =
Version 2.0.28 has a breaking change, Please upgrade to 2.0.29.