=== Recruitly ===
Contributors: recruitly
Tags: recruitly, job board, recruitment software
Requires at least: 4.5
Tested up to: 6.8.2
Stable tag: 2.0.34
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.

== Upgrade Notice ==

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