matador_get_the_bullhorn_lead_form() Template Function

matador_get_the_bullhorn_lead_form( array $args ): string

Outputs a Bullhorn Lead Form.

This article is for Matador Jobs Pro All-Access Subscribers who install the Matador Jobs Pro Bullhorn Lead Form Extension only.

Description

The matador_get_the_bullhorn_lead_form() template function returns a lead form string generated based on passed arguments.

Parameters

array $args (optional): A associative array of arguments of the following shape:

• array|string $fields A single-dimensional indexed array of field names or a comma-separated list of field names to include. Accepts any registered form fields and 'contact_type'. Default is the value of the settings option or [ 'name', 'email', 'companyName', 'contact_type', 'resume', 'message'];. Note that fields related to compliance, spam prevention, and others added by extensions will be included automatically.

If you include the contact_type field, you should also include and require the resume field. If you do not, Candidates will submitted without a resume for processing, creating a record in Bullhorn with very minimal data to consider them with.

• array|string $require A single-dimensional indexed array of field names or a comma-separated list of field names to require. Accepts any registered form fields and 'contact_type'. Default is the value of the settings option or all default $fields.
• string $type The lead form type. Accepts 'contact' and 'lead'. Defaults to the value of the settings optipon.
• array|string $class: A space-separated string or single-dimensional indexed array of CSS class names to append to the enclosing HTML wrapper. Default is empty string.

Return

string $form A formatted string of the generated lead form based on the passed arguments.

Examples

<?php // omit opening php tag
$form = matador_get_the_bullhorn_lead_form();

<?php // omit opening php tag
$form = matador_get_the_bullhorn_lead_form( [ 'fields' => [ 'name', 'email', 'phone', 'companyName', 'contact_type', 'resume', 'message' ], 'require' => [ 'name', 'email', 'companyName', 'contact_type', 'resume', 'type' => 'lead', 'class' => 'my-theme-classname' ] );