=== Jobicy Remote Jobs Feed ===
Contributors: creatis
Tags: remote jobs, job board, employment
Requires at least: 5.5
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display fresh remote jobs from Jobicy.com on your WordPress site via a simple shortcode.

== Description ==

Power up your WordPress site with the **Jobicy Remote Jobs Feed** plugin, the ultimate tool for displaying fresh, high-quality remote job listings from [Jobicy.com](https://jobicy.com/). Whether you run a community blog, a resource hub for professionals, or simply want to add value for your visitors, this plugin seamlessly integrates a dynamic job board onto your pages.

Engage your audience and increase time-on-site by providing a constantly updated stream of remote opportunities. With extensive customization options and two powerful display modes, you have complete control over the job feed's appearance and content.

**Key Features:**

* **Simple Shortcode Integration:** Add a complete job board to any post or page in seconds using the simple `[jobicy_jobs]` shortcode.
* **Live AJAX Filtering:** In "User Filter" mode, visitors can instantly search and filter jobs by keywords, location, and category without any page reloads, providing a smooth and professional user experience.
* **Curated Job Feeds:** Use the "Admin-Defined" mode to create highly specific, pre-filtered job boards. Display only jobs matching certain keywords (e.g., "Marketing"), categories ("Software Development"), or locations ("USA Only") to perfectly match your site's niche.
* **Deep Customization:** From the settings panel, you can control the number of jobs displayed, toggle company logos, and choose how users interact with job listings.
* **Two Viewing Modes:**
    * **Modal Window:** Let users view full job descriptions in an elegant pop-up modal without ever leaving your site.
    * **Direct Redirect:** Send users directly to the original job posting on Jobicy.com, with the option to open links in a new tab.
* **Lightweight and Efficient:** The plugin is built to be fast and fetches jobs on-demand, ensuring no negative impact on your site's performance.

== Installation ==

1. Upload the plugin folder `jobicy-jobs` to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings -> Jobicy Jobs to configure the plugin.
4. Use the `[jobicy_jobs]` shortcode in your posts or pages.


== Frequently Asked Questions ==

= How do I add the job feed to a page? =

Simply insert the shortcode `[jobicy_jobs]` into the content of any post, page, or widget that supports shortcodes. The job feed will appear in that location.

= What is the difference between "User Filtering" and "Admin-Defined Feed"? =

These are the two main modes for the plugin, which you can select in `Settings > Jobicy Jobs`.
* **User Filtering** displays search and filter fields (keywords, location, category) above the job list. This allows your website visitors to search for jobs that interest them.
* **Admin-Defined Feed** hides the public search fields. Instead, the job feed will only show jobs that match the filter criteria you have pre-configured in the plugin's settings page. This is perfect for creating niche job boards (e.g., a page showing only "React Developer" jobs).

= Can I override the admin settings using the shortcode? =

Yes, but only when using the "Admin-Defined Feed" mode. You can use attributes in the shortcode to create multiple, uniquely filtered job boards. For example: `[jobicy_jobs tag="marketing" geo="europe" count="15"]` will display 15 marketing jobs from Europe, overriding what you set in the main settings.

= Where do the job listings come from? =

All job listings are fetched in real-time directly from the official Jobicy API (`https://jobicy.com/api/v2/remote-jobs`). This ensures the listings are always current.

= Will this plugin slow down my website? =

No. The plugin is designed to be lightweight. It only fetches data from the Jobicy API when a visitor loads a page containing the shortcode. The AJAX filtering is also highly efficient, ensuring a fast experience for the user without heavy server load.

= How do I customize the appearance of the job list? =

The plugin comes with clean, modern styling that should fit most themes. You can control basic display options like showing/hiding company logos in the settings. For more advanced styling, you can override the plugin's CSS rules in your theme's `style.css` file. The main container class is `.jobicy-container`.


== External Services ==

This plugin connects to the Jobicy API (`https://jobicy.com/api/v2/remote-jobs`) to fetch job listings. This is its core functionality.
The following data is sent with each API request:
* The number of jobs to fetch.
* Filter criteria selected by the user or administrator (keywords, location, category).

This service is provided by Jobicy.
* Terms of Service: https://jobicy.com/terms-and-conditions
* Privacy Policy: https://jobicy.com/privacy-policy

== Changelog ==

= 1.0.6 =
* Refactored the plugin to enqueue external CSS and JS files instead of using inline styles and scripts, following WordPress best practices.

= 1.0.5 =
* Initial public release after feedback.

= 1.0 =
* Initial release.