Introduction
Both the blocks and shortcodes provided by Matador Jobs’ Recruiter Profiles Extension can display several different links, each of which has an associated default text:
| Link | Default Display Text |
|---|---|
| Single Post Link (individual recruiter info page) | ‘More Info’ |
| Call Link | ‘Let’s Call’ |
| Linkedin Profile | ‘LinkedIn Profile’ |
| Facebook Profile | ‘Facebook Profile’ |
| Email (mailto link) | Displays the recruiter’s email address |
| Office Phone (tel link) | Displays the office telephone number |
| Mobile Phone (tel link) | Displays the mobile telephone number |
You may find you want to modify one or more of these defaults to your own text. Below you will find the steps necessary to do this.
Identifying the relevant filter
The first step is to identify which filter can be used to modify the text that you want to change:
| Link | Filter |
|---|---|
| Single Post Link | matador_extension_recruiters_single_link_text |
| Call Link | matador_extension_recruiters_call_link_text |
| LinkedIn Profile | matador_extension_recruiters_linkedin_link_text |
| Facebook Profile | matador_extension_recruiters_facebook_link_text |
| Email (mailto link) | matador_extension_recruiters_email_link_text |
| Office Phone | matador_extension_recruiters_office_tel_link_text |
| Mobile Phone | matador_extension_recruiters_mobile_tel_link_text |
To modify the default text of the single post link we will be using the ‘matador_extension_recruiters_single_link_text filter. Here’s a quick look at this filter in context:
/**
* Modify the text for the recruiter's single link.
*
* @since 1.0.0
*
* @param string $default_text Default link text, "More Info".
* @param int $recruiter_id Recruiter ID for context.
* @return string Filtered single link text.
*/
$link_text = $link_text ?: apply_filters( "matador_extension_recruiters_single_link_text", "More Info", $recruiter_id );
Hook a function to the relevant filter
Next, we want to use this filter to modify the string which the extension’s code receives to display for the recruiter single link.
add_filter( 'matador_extension_recruiters_single_link_text', 'modify_single_link_text' );
function modify_single_link_text( ) {
// Whatever string we return here will be displayed as the link text.
return 'See More';
}
We can also make use of the $recruiter_id parameter to make more sophisticated modifications:
add_filter( 'matador_extension_recruiters_single_link_text', 'modify_single_link_text' );
function modify_single_link_text( $recruiter_id ) {
$recruiter_name = get_the_title( $recruiter_id );
$link_text = "Find out more about" . $recruiter_name;
return '$link_text;
}
Index of filters & their arguments:
/**
* Modify the recruiter's office telephone link text.
*
* @since 1.0.0
*
* @param string $meta_value The initial meta value or default link text.
* @param int $recruiter_id Recruiter ID for context.
* @return string Filtered office telephone link text.
*/
apply_filters( 'matador_extension_recruiters_office_tel_link_text', $meta_value, $recruiter_id );
/**
* Modify the recruiter's mobile telephone link text.
*
* @since 1.0.0
*
* @param string $meta_value The initial meta value or default link text.
* @param int $recruiter_id Recruiter ID for context.
* @return string Filtered mobile telephone link text.
*/
apply_filters( 'matador_extension_recruiters_mobile_tel_link_text', $meta_value, $recruiter_id );
/**
* Modify the recruiter's email link text.
*
* @since 1.0.0
*
* @param string $meta_value The initial meta value or default link text.
* @param int $recruiter_id Recruiter ID for context.
* @return string Filtered email link text.
*/
apply_filters( "matador_extension_recruiters_email_link_text", $meta_value, $recruiter_id );
/**
* Modify the text for the recruiter's single link.
*
* @since 1.0.0
*
* @param string $default_text Default link text, "More Info".
* @param int $recruiter_id Recruiter ID for context.
* @return string Filtered single link text.
*/
apply_filters( "matador_extension_recruiters_single_link_text", "More Info", $recruiter_id );
/**
* Modify the recruiter's LinkedIn profile link text.
*
* @since 1.0.0
*
* @param string $default_text Default link text, "LinkedIn Profile".
* @param int $recruiter_id Recruiter ID for context.
* @return string Filtered LinkedIn profile link text.
*/
apply_filters( "matador_extension_recruiters_linkedin_link_text", "LinkedIn Profile", $recruiter_id );
/**
* Modify the recruiter's Facebook profile link text.
*
* @since 1.0.0
*
* @param string $default_text Default link text, "Facebook Profile".
* @param int $recruiter_id Recruiter ID for context.
* @return string Filtered Facebook profile link text.
*/
apply_filters( "matador_extension_recruiters_facebook_link_text", "Facebook Profile", $recruiter_id );
/**
* Modify the recruiter call link text.
*
* @since 1.0.0
*
* @param string $default_text Default link text, "Let's Call".
* @param int $recruiter_id Recruiter ID for context.
* @return string Filtered link text.
*/
$link_text = apply_filters( "matador_extension_recruiters_call_link_text", "Let's Call", $recruiter_id );