=== Jobicy Remote Jobs Feed === Contributors: creatis Tags: remote jobs, job board, employment Requires at least: 5.5 Tested up to: 7.0 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.