Iron gForce Custom Capabilities

Iron gForce Custom Features Guide

This guide outlines the custom features available in the Iron gForce plugin that can be implemented on your website to enhance your job board functionality.

Featured Jobs System

Highlight important job postings to make them stand out on your job board.

What it does:

  • Allows you to mark specific jobs as “featured”
  • Featured jobs can be displayed prominently or styled differently
  • Easy management through the WordPress admin interface

How to use it:

  1. Go to your WordPress admin → Iron gForce → Featured Jobs
  2. Search and select jobs you want to feature
  3. Use bulk actions to feature/unfeature multiple jobs at once
  4. Featured jobs will appear with special styling on your job listings

Display Implementation:

  • Sidebar Display: Featured jobs appear in a dedicated sidebar next to the main job listings
  • Layout Classes: The main container gets has-featured-jobs class when featured jobs exist
  • CSS Classes for Styling:
    • .irongforce-layout-wrapper.has-featured-jobs – Main container with featured jobs
    • .irongforce-featured-jobs – Featured jobs sidebar container
    • .irongforce-featured-jobs-list – List of featured jobs
    • .irongforce-featured-job – Individual featured job item
    • .irongforce-featured-job-title – Featured job title
    • .irongforce-featured-job-meta – Featured job metadata container
    • .irongforce-featured-job-department – Department information
    • .irongforce-featured-job-location – Location information
    • .irongforce-featured-job-time – Employment type
    • .irongforce-featured-job-date – Job posting date
  • Responsive Design: Sidebar collapses on mobile devices (991px and below)

Translation & Text Override System

Customize any text that appears on your job board without modifying code.

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

Technical Implementation:

  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 (where {job-board-token} is your specific job board token)
    • Example: irongforce-mycompany-translations.json
  3. File Structure: The JSON file should contain translations for job data fields: 
    {
  "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"
    }
  }
}
  4. File Permissions: Ensure the web server can read the files (644 permissions)
  5. Automatic Loading: Files are automatically loaded based on your job board configuration

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 and dynamic filtering.

What it does:

  • 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

Available features:

Search Redirect

Shortcode: [irongforce_search_redirect]

  • 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

Technical Implementation:

  • Search Form Page: Add [irongforce_search_redirect job_board="your-token" redirect_page="/careers/"] to any page
  • Results Page: Use [irongforce job_board="your-token"] on your designated results page
  • Required Parameters:
    • job_board – Your job board token (required)
    • redirect_page – URL of the results page (required)
  • 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
  • URL Parameters: The redirect passes these query parameters:
    • keys – Keyword search terms
    • teams – Department/team filter
    • location – Location filter
  • Auto-filtering: The results page automatically applies filters based on URL parameters

Example URL after redirect:
yoursite.com/careers/?keys=engineer&teams=Engineering&location=New+York

Dynamic Filters

  • 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 (alternative to standard location)

Hierarchical Location & Department Dropdowns

Smart dropdown menus that show parent-child relationships.

What it does:

  • Location dropdowns show City → State → Country relationships
  • Department dropdowns can show team hierarchies
  • 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

Technical Implementation:

  • Data Source: Analyzes office names and department structures from Greenhouse API
  • Relationship Detection:
    • Locations: “City, State” format creates State → City relationships
    • Departments: Nested team structures from Greenhouse hierarchy
  • 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

Getting Started

To implement any of these features on your website:

  1. Contact Support: Reach out to discuss which features best fit your needs
  2. Setup Consultation: We’ll help configure the features for your specific requirements
  3. Implementation: Features can be added to existing pages or new dedicated job board pages
  4. Customization: Styling and layout can be customized to match your brand
  5. Training: We provide guidance on managing featured jobs and other admin functions

Support & Customization

All features can be customized to match your brand and specific requirements. Contact our support team to discuss:

  • Custom styling and layouts
  • Additional functionality
  • Integration with your existing website
  • Training for your team

This documentation covers the main features available in Iron gForce. Additional custom development may be available upon request.

Questions?