Iron gForce Custom Capabilities

Plugin Documentation

Iron gForce Custom Features

Everything you need to understand and implement the advanced capabilities available in the Iron gForce plugin for your job board.

Office Hierarchy Display

Display office locations in a structured, hierarchical format based on Greenhouse’s parent-child relationships.

What It Does
  • Shows offices in a tree structure (e.g., State → City → Office)
  • Automatically builds hierarchy from Greenhouse API data
  • Supports unlimited nesting levels
  • Alphabetically sorts options at each level
  • Toggle between hierarchical and flat list display
How It Works
  • Reads parent_id relationships from Greenhouse office data
  • Builds N-level tree structure automatically
  • Parent offices are styled distinctly from child offices
  • Indentation indicates hierarchy depth
Example Hierarchy
North Carolina (State – Parent)
├── Charlotte (City – Child)
└── Raleigh (City – Child)
└── Downtown Raleigh (Office – Grandchild)

Admin Configuration

Location: Iron gForce → [Your Job Board] → Search Tab → Office Hierarchy

Available Settings
  • Enable Tiered Office Display: Toggle between hierarchical tree structure or flat alphabetical list
    • Enabled: Offices shown in parent-child tree structure with indentation
    • Disabled: Offices shown as a simple alphabetical list
  • Maximum Hierarchy Depth: Control how many levels of hierarchy to display
    • 0 (Unlimited): Show all levels (State → City → Office → etc.)
    • 1: Show only top level (e.g., States only)
    • 2: Show two levels (e.g., States + Cities)
    • 3: Show three levels (e.g., States + Cities + Offices)
CSS Classes for Styling
  • .irongforce-hierarchical-select-container — Main container for hierarchical select
  • .irongforce-select-depth-0 — Root level items (bold, light background)
  • .irongforce-select-depth-1 — First child level (indented)
  • .irongforce-select-depth-2 — Second child level (more indented)
  • .irongforce-select-depth-3 — Third child level
  • .irongforce-select-depth-4 — Fourth child level
  • .irongforce-select-depth-5 — Fifth child level
  • .irongforce-select-parent — Any item that has children
  • .irongforce-select-child — Items without children
Best For
  • Companies with offices in multiple states/regions
  • Organizations with complex geographic structures
  • Job boards where location filtering is important
  • Sites that want to reduce dropdown clutter with logical groupings

How It Looks

Admin Settings for Office Hierarchy

Admin Settings (Search Tab → Office Hierarchy)

Frontend Dropdown View

Frontend Dropdown (Customer View)

Translation & Text Override System

Customize any text that appears on your job board without modifying code. Supports multiple languages and persists through plugin updates.

What It Does
  • Change any text, labels, or messages that appear on your job listings
  • Supports multiple languages or custom terminology
  • Changes persist through plugin updates
Setup Instructions
  1. Directory Setup: Create the directory /wp-content/irongforce-translations/ in your WordPress installation
  2. Translation Files: Create JSON files with the naming convention:
    • irongforce-{job-board-token}-translations.json
    • Example: irongforce-mycompany-translations.json
    • Note: Special characters in your token (hyphens, spaces, etc.) are replaced with underscores. For example, token my-company uses filename irongforce-my_company-translations.json
  3. File Permissions: Ensure the web server can read the files (644 permissions)
  4. Automatic Loading: Files are automatically loaded based on your job board configuration
File Structure Example
{
  "departments": {
    "Engineering": "Tech Team",
    "Sales": "Revenue Team"
  },
  "locations": {
    "New York, NY": "NYC Office",
    "Remote": "Work from Home"
  },
  "metadata": {
    "employment_type": {
      "Full-time": "Full Time Position",
      "Contract": "Contractor Role"
    },
    "job_function_2": {
      "Backend Development": "Server-side Engineering"
    }
  }
}
Supported Translation Fields
  • departments — Department/team names from Greenhouse
  • locations — Office locations and geographic data
  • metadata — Custom fields from Greenhouse including:
    • employment_type — Full-time, Part-time, Contract, etc.
    • job_function_2 — Specific job function categories
    • Any other custom metadata fields from your Greenhouse setup

Need assistance with setup or additional override keys? Contact our support team for guidance.

Advanced Search & Filtering

Enhanced search capabilities with custom redirects, dynamic filtering, and support for Greenhouse custom fields.

Capabilities
  • Custom search redirect functionality
  • Dynamic filters that appear based on available job data
  • Advanced location and department filtering
  • Keyword search across job titles and descriptions

How It Looks

FanDuel Careers Search Form

Example: FanDuel Careers homepage search with keyword, team, and location filters

Search Redirect

[irongforce_search_redirect]
Overview
  • Creates a search form that redirects to your main job listings page
  • Maintains search terms and applies them automatically
  • Useful for homepage or landing page search boxes
  • Requires: A target page with the main job listings shortcode
Required Parameters
  • job_board — Your job board token
  • redirect_page — URL of the results page
Optional Parameters
  • button_text — Custom button text (default: “Find your position”)
  • button_color — Button background color (default: #163b6d)
  • button_text_color — Button text color (default: #FFFFFF)
  • teams — Pre-select a department
  • locations — Pre-select a location
Implementation

Search Form Page:

[irongforce_search_redirect job_board="your-token" redirect_page="/careers/"]

Results Page:

[irongforce job_board="your-token"]

Example URL after redirect:

yoursite.com/careers/?keys=engineer&teams=Engineering&location=New+York
URL Parameters Passed
  • keys — Keyword search terms
  • teams — Department/team filter
  • location — Location filter
  • meta_location_only — Meta location filter
  • job_function_2 — Job function filter

Dynamic Filters

How Dynamic Filters Work
  • Filters automatically appear based on your job data
  • Location filters show hierarchical relationships (City → State)
  • Department filters group related positions
  • All filters work together for refined searching
Custom Fields Support
  • Job Function: job_function_2 (array field in Greenhouse)
  • Employment Type: employment_type (Full-time, Part-time, Contract)
  • Schedule Type: schedule_type (Remote, Hybrid, On-site)
  • Job Category: job_category (Engineering, Sales, Marketing, etc.)
  • Meta Location: meta_location_only (alternative to standard location)

Hierarchical Location & Department Dropdowns

Smart dropdown menus that display parent-child relationships for locations and departments, reducing clutter and improving navigation.

What It Does
  • Location dropdowns show parent → child relationships (2 levels)
  • Department dropdowns show parent → child team hierarchies (2 levels)
  • Improves user experience with organized, logical groupings
  • Reduces clutter by grouping related options
How It Works
  • Automatically detects hierarchical relationships in your Greenhouse data
  • Creates nested dropdowns (e.g., “New York” under “United States”)
  • Users can filter by broad categories or specific locations
  • Maintains all parent-child relationships from your ATS

How It Looks

FanDuel Hierarchical Dropdown

Example: FanDuel hierarchical team dropdown with parent-child groupings
Technical Details
  • Data Source: Uses Greenhouse metadata fields stored in WordPress post meta
  • Relationship Detection:
    • Locations: Uses gjlp_parent_location metadata to create parent → child relationships (2 levels)
    • Departments: Uses gjlp_department_parents metadata for parent → child grouping (2 levels)
  • Note: For multi-level hierarchy (3+ levels), use the Office Hierarchy feature instead, which supports unlimited depth via the Greenhouse API
  • Custom Field Support:
    • meta_location — Alternative location field
    • department — Primary department taxonomy
    • office — Office location taxonomy
  • Frontend Implementation: JavaScript handles the hierarchical select interactions
CSS Classes for Styling
  • .irongforce-hierarchical-select-container — Main container
  • .irongforce-hidden-select — Hidden actual select element
  • .irongforce-custom-select — Custom dropdown container
  • .irongforce-select-selected — Selected value display
  • .irongforce-select-items — Dropdown items container
  • .irongforce-select-parent — Parent option styling
  • .irongforce-select-child — Child option styling
  • .irongforce-select-hide — Hidden state class
Configuration Options
  • Parent Labels: Auto-generated (e.g., “All Engineering” for Engineering departments)
  • Child Filtering: Selecting parent shows all child options
  • Mixed Selection: Can filter by parent category or specific child items
Best For
  • Companies with multiple office locations
  • Organizations with complex department structures
  • Sites where users need to filter by geographic regions

Ready to Get Started?

Implement these features on your website with our team’s guidance every step of the way.

01
Contact Support
02
Setup Consultation
03
Implementation
04
Customization
05
Training
Questions?