Modify the string value passed to the “source” field of an external resource, ie: Bullhorn, during a sync that creates or updates remote records. Default is “{Site Name} Website”, ie: “ACME Staffing Website”. Use the $context argument to narrow the modification to only certain types of external data.
Since 3.1.1
apply_filters( 'matador_data_source_description', string $source, string $context, array $data, array $submission );Parameters
string $source: The source value. This defaults to “{Site Name} Website”, ie: “ACME Jobs” as the name of a website would result in “ACME Jobs Website”.
string $context: The context of the source. The value is “submission” when creating a job submission or web response and “candidate” when creating a new candidate record and is also be used by Matador Jobs Pro All Access extensions when creating other types of externally synced data.
array $data: The array of parsed data that will be submitted.
array $submission: The array of raw data submitted by the user.
Information
This hook is used by the Matador Source Tracking feature at priority 25 to append information about the traffic source if available. Use of this filter may override that when called at priority 26 or higher. If you wish to disable that behavior, unhook the function as described in the developer notes of the Matador Source Tracking doc.
External dataset may have character limits on the source. Matador Jobs will often wrap the output of this filter in a string truncation function to adhere to limits and prevent errors. Here are some important known character limits for external dataset source fields:
- Bullhorn:
- 200 Characters for Candidate & ClientContact
- 100 Characters for Submission/Web Response
- 15 Characters for Lead
Usage Examples
Modify the default value for all use cases.
Modify the default only when creating Job Submissions or Web Responses.
Modify the source with custom data from the form submission.
A more complex example
Source
The source for this filter can be found at /matador-jobs-pro/includes/bullhorn/class-bullhorn-candidate.php:1058.