manifest / integrations / wp-breezyhr-jobs-board
Breezy Jobs Board
A custom WordPress plugin that replaces Breezy HR's default embed widget with a self-hosted, filterable jobs board.
by Collins Kiprono · github.com/collinkiprono/wp-breezyhr-jobs-board · website
★ 0stars
0forks
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/collinkiprono/wp-breezyhr-jobs-board/archive/refs/heads/main.zipA custom WordPress plugin that replaces Breezy HR's default embed widget with a self-hosted, filterable jobs board.
Features
- Fast, reliable loading — Pulls open positions from Breezy's public JSON feed on a schedule you set (15 minutes to daily), caching results in the WordPress database so pages load fast and don't depend on Breezy's uptime.
- Automatic department buttons — Quick-link buttons are generated automatically from whatever departments are set on your jobs in Breezy (
Settings > each job > Department, inside Breezy). - Live search & filters — A live search box (title / department / location), plus Work Setup (on-site / fully remote / region-restricted remote) and Country filters.
- Rich job cards — Each job card shows department, location/remote tag, employment type, and salary (when Breezy has one set), plus a "Quick Apply" button that opens the job's Breezy application page in a new tab.
- SEO-friendly — All markup is server-rendered (not injected via AJAX), so search engines can still crawl every job listing normally.
- Department-specific landing pages — Use
[breezy_jobs department="Engineering"]to pre-filter a page to a single department.
Installation
- In WordPress:
Plugins > Add New > Upload Plugin, choosebreezy-jobs-board.zip, thenInstall Now > Activate. - Go to
Settings > Breezy Jobsand confirm the subdomain matches your Breezy HR URL. Click Refresh Now to pull jobs immediately. - Add the shortcode
[breezy_jobs]to any page (e.g. your Careers page).
Usage
Show all jobs:
[breezy_jobs]
Pre-filter to one department:
[breezy_jobs department="Engineering"]
Notes
- Department filters work best when every job in Breezy has a Department assigned. If a job has no department set, it won't group correctly on the board — set departments under each job's details in Breezy (e.g. Strategy, Media, Data, Post Production, Engineering, Operations, etc.).
- Uninstalling the plugin removes its scheduled cron event but leaves cached job data in place unless you delete it manually.
Requirements
- WordPress site with a Breezy HR account and public job listings enabled.
License
Add your chosen license here (e.g. MIT, GPLv2 — GPLv2 or later is required if distributing via the official WordPress.org plugin directory).